module pycode.build_helper
¶
Short summary¶
module pyquickhelper.pycode.build_helper
Produces a build file for a module following pyquickhelper design.
Functions¶
function |
truncated documentation |
---|---|
Returns the first path which exists in the list. |
|
Builds the build script which builds the setup, run the unit tests and the documentation. |
|
Produces a script which runs the notebook, a documentation server, which publishes… |
|
returns a string which corresponds to a pyproj project |
|
Produces a script which runs a command available through the setup. |
|
Produces a script which runs the notebook, a documentation server, which publishes and other scripts. |
|
Custom logic to reference other currently developped modules. |
|
Less copy/paste. |
|
Runs last replacements. |
Documentation¶
Produces a build file for a module following pyquickhelper design.
-
pyquickhelper.pycode.build_helper.
_default_nofolder
= '__NOFOLDERSHOULDNOTEXIST39__'[source]¶ nickname for no folder
-
pyquickhelper.pycode.build_helper.
choose_path
(*paths)[source]¶ Returns the first path which exists in the list.
- Parameters
paths – list of paths
- Returns
a path
-
pyquickhelper.pycode.build_helper.
get_build_script
(module, requirements=None, port=8067, default_engine_paths=None, additional_local_path=None)[source]¶ Builds the build script which builds the setup, run the unit tests and the documentation.
- Parameters
module – module name
requirements – list of dependencies (not in your python distribution)
port – port for the local pypi_server which gives the dependencies
default_engine_paths – define the default location for python engine, should be dictionary { engine: path }, see below.
additional_local_path – additional paths to add to PYTHONPATH
- Returns
scripts
-
pyquickhelper.pycode.build_helper.
get_extra_script_command
(command, module, requirements, port=8067, blog_list=None, platform='linux', default_engine_paths=None, unit_test_folder=None, unittest_modules=None, additional_notebook_path=None, additional_local_path=None)[source]¶ Produces a script which runs the notebook, a documentation server, which publishes…
- Parameters
command – command to run (notebook, publish, publish_doc, local_pypi, setupdep, run27, build27, copy_dist, any_setup_command, lab)
module – module name
requirements – list of dependencies (not in your python distribution)
port – port for the local pypi_server which gives the dependencies
blog_list – list of blog to listen for this module (usually stored in
module.__blog__
)platform – platform (only Windows)
default_engine_paths – define the default location for python engine, should be dictionary { engine: path }, see below.
unit_test_folder – unit test folders, used for command
run27
additional_notebook_path – additional paths to add when running the script launching the notebooks
additional_local_path – additional paths to add when running a local command
unittest_modules – list of modules to be used during unit tests
- Returns
scripts
The available list of commands is given by function
process_standard_options_for_setup
.
-
pyquickhelper.pycode.build_helper.
get_pyproj_project
(name, file_list)[source]¶ returns a string which corresponds to a pyproj project
- Parameters
name – project name
file_list – file_list
- Returns
string
-
pyquickhelper.pycode.build_helper.
get_script_command
(command, module, requirements, port=8067, platform='linux', default_engine_paths=None, additional_local_path=None)[source]¶ Produces a script which runs a command available through the setup.
- Parameters
command – command to run
module – module name
requirements – list of dependencies (not in your python distribution)
port – port for the local pypi_server which gives the dependencies
platform – platform (only Windows)
default_engine_paths – define the default location for python engine, should be dictionary { engine: path }, see below.
additional_local_path – additional local path to add before running command
setup.py <command>
- Returns
scripts
The available list of commands is given by function
process_standard_options_for_setup
.
-
pyquickhelper.pycode.build_helper.
get_script_module
(command, platform='linux', blog_list=None, default_engine_paths=None)[source]¶ Produces a script which runs the notebook, a documentation server, which publishes and other scripts.
- Parameters
command – command to run (blog)
platform – platform (only Windows)
blog_list – list of blog to listen for this module (usually stored in
module.__blog__
)default_engine_paths – define the default location for python engine, should be dictionary { engine: path }, see below.
- Returns
scripts
The available list of commands is given by function
process_standard_options_for_setup
.
-
pyquickhelper.pycode.build_helper.
private_path_choice
(path)[source]¶ Custom logic to reference other currently developped modules.
-
pyquickhelper.pycode.build_helper.
private_replacement_
(script, paths, key='__ADDITIONAL_LOCAL_PATH__')[source]¶ Less copy/paste.
-
pyquickhelper.pycode.build_helper.
private_script_replacements
(script, module, requirements, port, raise_exception=True, platform='linux', default_engine_paths=None, additional_local_path=None)[source]¶ Runs last replacements.
- Parameters
script – script or list of scripts
module – module name
requirements – requirements - (list or 2-uple of lists)
port – port
raise_exception – raise an exception if there is an error, otherwise, return None
platform – platform
default_engine_paths – define the default location for python engine, should be dictionary { engine: path }, see below.
additional_local_path – additional local path to add to PYTHONPATH
- Returns
modified script
An example for default_engine_paths:
default_engine_paths = { "windows": { "__PY35__": None, "__PY36_X64__": "c:\Python365_x64", "__PY37_X64__": "c:\Python372_x64", "__PY38_X64__": "c:\Python387_x64", "__PY39_X64__": "c:\Python391_x64", }, }
Parameter requirements can a list of requirements, we assume these requirements are available from a local PyPi server. There can be extra requirements obtained from PiPy. In that case, those can be specified as a tuple (requirements_local, requirements_pipy).
The function replaces
rem _PATH_VIRTUAL_ENV_
with an instruction to copy these DLLs. Parameter requirements can be a list or a tuple.