@@ -1988,7 +1988,7 @@ <h5 id="frequenz.repo.config--writing-the-noxfilepy">Writing the <code>noxfile.p
19881988which will configure all nox sessions.</ p >
19891989< p > To use the default options, you should call < code > configure()</ code > using one of the < a class ="autorefs autorefs-internal " href ="#frequenz.repo.config.RepositoryType "> repository
19901990types</ a > . For example:</ p >
1991- < div class ="language-python highlight "> < pre > < span > </ span > < code > < span id ="__span-0-1 "> < a id ="__codelineno-0-1 " name ="__codelineno-0-1 " href ="#__codelineno-0-1 "> </ a > < span class ="kn "> from</ span > < span class ="nn "> frequenz.repo.config</ span > < span class ="kn "> import</ span > < span class ="n "> RepositoryType</ span > < span class ="p "> ,</ span > < span class ="n "> nox</ span >
1991+ < div class ="language-python highlight "> < pre > < span > </ span > < code > < span id ="__span-0-1 "> < a id ="__codelineno-0-1 " name ="__codelineno-0-1 " href ="#__codelineno-0-1 "> </ a > < span class ="kn "> from</ span > < span class =" w " > </ span > < span class ="nn "> frequenz.repo.config</ span > < span class =" w " > </ span > < span class ="kn "> import</ span > < span class ="n "> RepositoryType</ span > < span class ="p "> ,</ span > < span class ="n "> nox</ span >
19921992</ span > < span id ="__span-0-2 "> < a id ="__codelineno-0-2 " name ="__codelineno-0-2 " href ="#__codelineno-0-2 "> </ a >
19931993</ span > < span id ="__span-0-3 "> < a id ="__codelineno-0-3 " name ="__codelineno-0-3 " href ="#__codelineno-0-3 "> </ a > < span class ="n "> nox</ span > < span class ="o "> .</ span > < span class ="n "> configure</ span > < span class ="p "> (</ span > < span class ="n "> RepositoryType</ span > < span class ="o "> .</ span > < span class ="n "> LIB</ span > < span class ="p "> )</ span >
19941994</ span > </ code > </ pre > </ div >
@@ -1998,8 +1998,8 @@ <h5 id="frequenz.repo.config--writing-the-noxfilepy">Writing the <code>noxfile.p
19981998the < a class ="autorefs autorefs-internal " href ="nox/default/#frequenz.repo.config.nox.default "> < code > frequenz.repo.config.nox.default</ code > </ a > module,
19991999< a class ="autorefs autorefs-internal " href ="nox/config/#frequenz.repo.config.nox.config.Config.copy "> copying</ a > it and changing whatever you
20002000need to customize. For example:</ p >
2001- < div class ="language-python highlight "> < pre > < span > </ span > < code > < span id ="__span-1-1 "> < a id ="__codelineno-1-1 " name ="__codelineno-1-1 " href ="#__codelineno-1-1 "> </ a > < span class ="kn "> from</ span > < span class ="nn "> frequenz.repo.config</ span > < span class ="kn "> import</ span > < span class ="n "> nox</ span >
2002- </ span > < span id ="__span-1-2 "> < a id ="__codelineno-1-2 " name ="__codelineno-1-2 " href ="#__codelineno-1-2 "> </ a > < span class ="kn "> from</ span > < span class ="nn "> frequenz.repo.config.nox</ span > < span class ="kn "> import</ span > < span class ="n "> default</ span >
2001+ < div class ="language-python highlight "> < pre > < span > </ span > < code > < span id ="__span-1-1 "> < a id ="__codelineno-1-1 " name ="__codelineno-1-1 " href ="#__codelineno-1-1 "> </ a > < span class ="kn "> from</ span > < span class =" w " > </ span > < span class ="nn "> frequenz.repo.config</ span > < span class =" w " > </ span > < span class ="kn "> import</ span > < span class ="n "> nox</ span >
2002+ </ span > < span id ="__span-1-2 "> < a id ="__codelineno-1-2 " name ="__codelineno-1-2 " href ="#__codelineno-1-2 "> </ a > < span class ="kn "> from</ span > < span class =" w " > </ span > < span class ="nn "> frequenz.repo.config.nox</ span > < span class =" w " > </ span > < span class ="kn "> import</ span > < span class ="n "> default</ span >
20032003</ span > < span id ="__span-1-3 "> < a id ="__codelineno-1-3 " name ="__codelineno-1-3 " href ="#__codelineno-1-3 "> </ a >
20042004</ span > < span id ="__span-1-4 "> < a id ="__codelineno-1-4 " name ="__codelineno-1-4 " href ="#__codelineno-1-4 "> </ a > < span class ="n "> config</ span > < span class ="o "> =</ span > < span class ="n "> default</ span > < span class ="o "> .</ span > < span class ="n "> lib_config</ span > < span class ="o "> .</ span > < span class ="n "> copy</ span > < span class ="p "> ()</ span >
20052005</ span > < span id ="__span-1-5 "> < a id ="__codelineno-1-5 " name ="__codelineno-1-5 " href ="#__codelineno-1-5 "> </ a > < span class ="n "> config</ span > < span class ="o "> .</ span > < span class ="n "> opts</ span > < span class ="o "> .</ span > < span class ="n "> black</ span > < span class ="o "> .</ span > < span class ="n "> append</ span > < span class ="p "> (</ span > < span class ="s2 "> "--diff"</ span > < span class ="p "> )</ span >
@@ -2176,7 +2176,7 @@ <h5 id="frequenz.repo.config--api-reference-generation">API reference generation
21762176(< code > site</ code > by defaul).</ p >
21772177< p > If you need to customize the above paths, you can create a new script to use with the
21782178< code > mkdocs-gen-files</ code > plugin as follows:</ p >
2179- < div class ="language-python highlight "> < pre > < span > </ span > < code > < span id ="__span-7-1 "> < a id ="__codelineno-7-1 " name ="__codelineno-7-1 " href ="#__codelineno-7-1 "> </ a > < span class ="kn "> from</ span > < span class ="nn "> frequenz.repo.config.mkdocs</ span > < span class ="kn "> import</ span > < span class ="n "> api_pages</ span >
2179+ < div class ="language-python highlight "> < pre > < span > </ span > < code > < span id ="__span-7-1 "> < a id ="__codelineno-7-1 " name ="__codelineno-7-1 " href ="#__codelineno-7-1 "> </ a > < span class ="kn "> from</ span > < span class =" w " > </ span > < span class ="nn "> frequenz.repo.config.mkdocs</ span > < span class =" w " > </ span > < span class ="kn "> import</ span > < span class ="n "> api_pages</ span >
21802180</ span > < span id ="__span-7-2 "> < a id ="__codelineno-7-2 " name ="__codelineno-7-2 " href ="#__codelineno-7-2 "> </ a >
21812181</ span > < span id ="__span-7-3 "> < a id ="__codelineno-7-3 " name ="__codelineno-7-3 " href ="#__codelineno-7-3 "> </ a > < span class ="n "> api_pages</ span > < span class ="o "> .</ span > < span class ="n "> generate_python_api_pages</ span > < span class ="p "> (</ span > < span class ="s2 "> "my_sources"</ span > < span class ="p "> ,</ span > < span class ="s2 "> "API"</ span > < span class ="p "> )</ span >
21822182</ span > </ code > </ pre > </ div >
@@ -2200,8 +2200,8 @@ <h5 id="frequenz.repo.config--linting-examples-in-the-source-codes-docstrings">L
22002200< li >
22012201< p > Add a < code > conftest.py</ code > file to the root directory containing your source code with the
22022202 following contents:</ p >
2203- < div class ="language-python highlight "> < pre > < span > </ span > < code > < span id ="__span-9-1 "> < a id ="__codelineno-9-1 " name ="__codelineno-9-1 " href ="#__codelineno-9-1 "> </ a > < span class ="kn "> from</ span > < span class ="nn "> frequenz.repo.config.pytest</ span > < span class ="kn "> import</ span > < span class ="n "> examples</ span >
2204- </ span > < span id ="__span-9-2 "> < a id ="__codelineno-9-2 " name ="__codelineno-9-2 " href ="#__codelineno-9-2 "> </ a > < span class ="kn "> from</ span > < span class ="nn "> sybil</ span > < span class ="kn "> import</ span > < span class ="n "> Sybil</ span >
2203+ < div class ="language-python highlight "> < pre > < span > </ span > < code > < span id ="__span-9-1 "> < a id ="__codelineno-9-1 " name ="__codelineno-9-1 " href ="#__codelineno-9-1 "> </ a > < span class ="kn "> from</ span > < span class =" w " > </ span > < span class ="nn "> frequenz.repo.config.pytest</ span > < span class =" w " > </ span > < span class ="kn "> import</ span > < span class ="n "> examples</ span >
2204+ </ span > < span id ="__span-9-2 "> < a id ="__codelineno-9-2 " name ="__codelineno-9-2 " href ="#__codelineno-9-2 "> </ a > < span class ="kn "> from</ span > < span class =" w " > </ span > < span class ="nn "> sybil</ span > < span class =" w " > </ span > < span class ="kn "> import</ span > < span class ="n "> Sybil</ span >
22052205</ span > < span id ="__span-9-3 "> < a id ="__codelineno-9-3 " name ="__codelineno-9-3 " href ="#__codelineno-9-3 "> </ a >
22062206</ span > < span id ="__span-9-4 "> < a id ="__codelineno-9-4 " name ="__codelineno-9-4 " href ="#__codelineno-9-4 "> </ a > < span class ="n "> pytest_collect_file</ span > < span class ="o "> =</ span > < span class ="n "> Sybil</ span > < span class ="p "> (</ span > < span class ="o "> **</ span > < span class ="n "> examples</ span > < span class ="o "> .</ span > < span class ="n "> get_sybil_arguments</ span > < span class ="p "> ())</ span > < span class ="o "> .</ span > < span class ="n "> pytest</ span > < span class ="p "> ()</ span >
22072207</ span > </ code > </ pre > </ div >
@@ -2280,7 +2280,7 @@ <h5 id="frequenz.repo.config--mkdocs-api-reference-generation"><code>mkdocs</cod
22802280< p > If your project provides < em > protobuf</ em > files, you can also generate the API
22812281documentation for them adding one more line to the script provided in the common
22822282section:</ p >
2283- < div class ="language-python highlight "> < pre > < span > </ span > < code > < span id ="__span-13-1 "> < a id ="__codelineno-13-1 " name ="__codelineno-13-1 " href ="#__codelineno-13-1 "> </ a > < span class ="kn "> from</ span > < span class ="nn "> frequenz.repo.config.mkdocs</ span > < span class ="kn "> import</ span > < span class ="n "> api_pages</ span >
2283+ < div class ="language-python highlight "> < pre > < span > </ span > < code > < span id ="__span-13-1 "> < a id ="__codelineno-13-1 " name ="__codelineno-13-1 " href ="#__codelineno-13-1 "> </ a > < span class ="kn "> from</ span > < span class =" w " > </ span > < span class ="nn "> frequenz.repo.config.mkdocs</ span > < span class =" w " > </ span > < span class ="kn "> import</ span > < span class ="n "> api_pages</ span >
22842284</ span > < span id ="__span-13-2 "> < a id ="__codelineno-13-2 " name ="__codelineno-13-2 " href ="#__codelineno-13-2 "> </ a >
22852285</ span > < span id ="__span-13-3 "> < a id ="__codelineno-13-3 " name ="__codelineno-13-3 " href ="#__codelineno-13-3 "> </ a > < span class ="n "> api_pages</ span > < span class ="o "> .</ span > < span class ="n "> generate_python_api_pages</ span > < span class ="p "> (</ span > < span class ="s2 "> "my_sources"</ span > < span class ="p "> ,</ span > < span class ="s2 "> "API-py"</ span > < span class ="p "> )</ span >
22862286</ span > < span id ="__span-13-4 "> < a id ="__codelineno-13-4 " name ="__codelineno-13-4 " href ="#__codelineno-13-4 "> </ a > < span class ="n "> api_pages</ span > < span class ="o "> .</ span > < span class ="n "> generate_protobuf_api_pages</ span > < span class ="p "> ()</ span >
@@ -2401,7 +2401,7 @@ <h4 id="frequenz.repo.config.RepositoryType" class="doc doc-heading">
24012401< span class ="normal "> < a href ="#__codelineno-0-22 "> 22</ a > </ span >
24022402< span class ="normal "> < a href ="#__codelineno-0-23 "> 23</ a > </ span >
24032403< span class ="normal "> < a href ="#__codelineno-0-24 "> 24</ a > </ span >
2404- < span class ="normal "> < a href ="#__codelineno-0-25 "> 25</ a > </ span > </ pre > </ div > </ td > < td class ="code "> < div > < pre > < span > </ span > < code > < span id ="__span-0-9 "> < a id ="__codelineno-0-9 " name ="__codelineno-0-9 "> </ a > < span class ="k "> class</ span > < span class ="nc "> RepositoryType</ span > < span class ="p "> (</ span > < span class ="n "> _enum</ span > < span class ="o "> .</ span > < span class ="n "> Enum</ span > < span class ="p "> ):</ span >
2404+ < span class ="normal "> < a href ="#__codelineno-0-25 "> 25</ a > </ span > </ pre > </ div > </ td > < td class ="code "> < div > < pre > < span > </ span > < code > < span id ="__span-0-9 "> < a id ="__codelineno-0-9 " name ="__codelineno-0-9 "> </ a > < span class ="k "> class</ span > < span class =" w " > </ span > < span class ="nc "> RepositoryType</ span > < span class ="p "> (</ span > < span class ="n "> _enum</ span > < span class ="o "> .</ span > < span class ="n "> Enum</ span > < span class ="p "> ):</ span >
24052405</ span > < span id ="__span-0-10 "> < a id ="__codelineno-0-10 " name ="__codelineno-0-10 "> </ a > < span class ="w "> </ span > < span class ="sd "> """Supported types of repository."""</ span >
24062406</ span > < span id ="__span-0-11 "> < a id ="__codelineno-0-11 " name ="__codelineno-0-11 "> </ a >
24072407</ span > < span id ="__span-0-12 "> < a id ="__codelineno-0-12 " name ="__codelineno-0-12 "> </ a > < span class ="n "> ACTOR</ span > < span class ="o "> =</ span > < span class ="s2 "> "actor"</ span >
0 commit comments