SnakeInstaller

class snakecdysis.snake_wrapper.SnakeInstaller(soft_path=None, url=None, docs=None, description_tool=None, apptainer_url_files=None, datatest_url_files=None, **kargs)[source]

Bases: object

This class is used to install Snakemake workflows.

Attributes Summary

`apptainer_url_files`	List of tuple with downloaded url and install destination with INSTALL_PATH.
`datatest_url_files`	Tuple with 2 values, first the url of datatest, second download name.
`default_profile`	Path to the directory of config.yaml default profile.
`description_tool`	The header print on terminal when run programme
`docs`	Url of documentation
`get_active_profile`	return the Path to current profile config
`get_active_tools_path`	return the active path of tools config
`git_configfile_path`	Path to the directory of default configfile.yaml file.
`git_tools_path`	Path to the directory of default tools_path.yaml file.
`git_url`	Url of versioning repository (GitHub or GitLab)
`install_mode`	Detect install mode of the soft, can be 'No install', 'local' or 'cluster'
`install_path`	The path of wrapped workflow installation.
`latest_version`	The latest workflow version, read on repository
`snakecdysis_version`	The current workflow version, read on VERSION file
`snakefile`	Path to the main snakemake file.
`snakemake_scripts`	Path to the scripts used on snakemake rules.
`soft_name`	The wrapped workflow name.
`tools_mode`	Detect install mode of the tools soft, can be 'env-modules', 'apptainer', 'conda' or 'env-modules, conda'
`user_profile_config`	Path to the user profile config path setting.
`user_tools_path`	Path to the user tools path setting.
`version`	The current workflow version, read on VERSION file

Methods Summary

`check_and_download_apptainer`()	Download apptainer/apptainer files if provided
`clean_home`()	Reset home's parameters of previous installation
`create_bash_completion`()	Add bash completion for version > 4.4
`fail`()	If installation fail, reset already install files
`get_epilog`()	Function for know the last version of program (can be GitHub or GitLab repository)
`get_last_version`()	Function for know the last version of program (can be GitHub or GitLab repository)
`get_tool_configfile`()	Test path of tools_path.yaml on default install path, home or argument
`tools_version_to_df`([csv_file, ...])	check how tools install and get version to save on file
`write_user_tools_path`()	Check if file is created and then write with modification of apptainer path

Attributes Documentation

apptainer_url_files: List of tuple with downloaded url and install destination with INSTALL_PATH. like INSTALL_PATH/containers/Apptainer.CulebrONT_tools.sif

datatest_url_files: Tuple with 2 values, first the url of datatest, second download name.

default_profile: Path to the directory of config.yaml default profile. install on INSTALL_PATH/default_profile

description_tool

The header print on terminal when run programme

Please add string values ‘VERSION’, ‘GIT_URL’ and ‘DOCS’ and wrapper automatically replace by the good values

docs: Url of documentation

get_active_profile: return the Path to current profile config

get_active_tools_path: return the active path of tools config

git_configfile_path: Path to the directory of default configfile.yaml file. default to INSTALL_PATH/install_files/configfile.yaml

git_tools_path: Path to the directory of default tools_path.yaml file. default to INSTALL_PATH/install_files/tools_path.yaml

git_url: Url of versioning repository (GitHub or GitLab)

install_mode: Detect install mode of the soft, can be ‘No install’, ‘local’ or ‘cluster’

install_path: The path of wrapped workflow installation.

latest_version: The latest workflow version, read on repository

snakecdysis_version: The current workflow version, read on VERSION file

snakefile: Path to the main snakemake file. Search on INSTALL_PATH/snakefiles/snakefile

snakemake_scripts: Path to the scripts used on snakemake rules. Search on INSTALL_PATH/snakemake_scripts

soft_name: The wrapped workflow name.

tools_mode: Detect install mode of the tools soft, can be ‘env-modules’, ‘apptainer’, ‘conda’ or ‘env-modules, conda’

user_profile_config: Path to the user profile config path setting. default to ~/.config/SOFTNAME/config.yaml

user_tools_path: Path to the user tools path setting. default to ~/.config/SOFTNAME/tools_path.yaml

version: The current workflow version, read on VERSION file

Methods Documentation

check_and_download_apptainer()[source]: Download apptainer/apptainer files if provided

clean_home()[source]: Reset home’s parameters of previous installation

create_bash_completion()[source]: Add bash completion for version > 4.4

fail()[source]: If installation fail, reset already install files

get_epilog() → str[source]

Function for know the last version of program (can be GitHub or GitLab repository): check every 30 days to skip request of if no internet connection

Return: epilogTool print at the end of header

get_last_version() → str[source]: Function for know the last version of program (can be GitHub or GitLab repository)

get_tool_configfile()[source]: Test path of tools_path.yaml on default install path, home or argument

tools_version_to_df(csv_file=None, active_tools_list=None, output_file=None)[source]: check how tools install and get version to save on file

write_user_tools_path()[source]: Check if file is created and then write with modification of apptainer path