Python package environment setup

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/python-package-environment-setup

Curated, evidence-grounded skill and software-tool collections for scientific AI agents, generated by the AgenticScienceBuilder

Install

npx -y skills add HolobiomicsLab/asb-skill-collections --skill python-package-environment-setup

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when when you have cloned a Python package repository and need to verify that the package installs correctly and its test suite passes locally. This is the prerequisite workflow before running pytest or code formatters like black on the package source.

The file declares its own license as CC-BY-4.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

5.9 KB, 965 tokens by cl100k_base, as published. Nobody here has run it

python-package-environment-setup

Summary

Install a Python package from a repository in editable (development) mode with optional development dependencies, enabling local execution of the package's test suite and code quality checks. This skill is essential for contributors who need to validate package functionality before submission.

When to use

When you have cloned a Python package repository and need to verify that the package installs correctly and its test suite passes locally. This is the prerequisite workflow before running pytest or code formatters like black on the package source.

When NOT to use

When you are installing a package for end-user consumption (use pip install package_name from PyPI instead)
When the package does not include a tests/ directory or test suite configuration
When you do not have write permissions to the repository directory (editable installs require local source modification capability)

Inputs

Python repository directory (containing pyproject.toml or setup.py)
pip package manager
Python 3.9+ interpreter

Outputs

Installed package in editable mode
Development dependencies (pytest, black, etc.) installed in active environment
Pytest test suite execution report (pass/fail status for all tests)

How to apply

Navigate to the package repository root directory. Install the package in editable mode using pip install -e .[dev], which allows you to make changes to the source code without reinstalling and simultaneously installs development dependencies (e.g., pytest, code formatters). After installation, verify setup by running the test suite with pytest tests/ to confirm all tests pass. The editable installation mode is critical because it symlinks the package source into your Python environment, enabling rapid iteration and validation of changes.

Related tools

pip (Package manager for installing the package in editable mode with development dependencies specified via extras (e.g., [dev])) — https://pip.pypa.io/
pytest (Test runner for executing the local test suite to validate package installation and functionality) — https://docs.pytest.org/
black (Code formatter applied to verify code style compliance before committing changes) — https://github.com/psf/black
Python (Runtime environment and language in which the package is implemented (3.9+))

Examples

cd lucinamay/biosynfoni && pip install -e .[dev] && pytest tests/

Evaluation signals

pip install -e .[dev] completes without errors and reports successful installation
pytest tests/ returns a summary showing all tests passed (zero failures, zero errors)
The package can be imported in the active Python environment without ImportError or ModuleNotFoundError
Development tools (pytest, black) are available in the environment and can be invoked from the command line
Code formatting check with black --check {source_file_or_directory} completes without format violations, or black {source_file_or_directory} successfully reformats files in place

Limitations

Editable installation requires the source directory to remain accessible; moving or deleting the cloned repository will break the installation
Installation success depends on all transitive dependencies being available and compatible with the specified Python version (biosynfoni requires Python 3.9+; RDKit is installed as a dependency)
The test suite may require external data, network access, or specific system libraries not documented in the article or README
No changelog was found in the biosynfoni repository, limiting visibility into breaking changes or version-specific requirements

Evidence

[other] Install the package in editable mode with development dependencies using pip install -e .[dev]: "Install the package in editable mode with development dependencies using pip install -e .[dev]."
[other] Execute the test suite using pytest tests/ to confirm all tests pass: "Execute the test suite using pytest tests/ to confirm all tests pass."
[other] You can also run the tests locally with the following command: pytest tests/: "You can also run the tests locally with the following command: pytest tests/"
[other] Clone or navigate to the biosynfoni repository root directory: "Clone or navigate to the biosynfoni repository root directory."
[readme] Biosynfoni requires Python 3.9 or later. RDKit is installed as a dependency when installing Biosynfoni.: "Biosynfoni requires Python 3.9 or later. RDKit is installed as a dependency when installing Biosynfoni."
[other] Please use black to format your code before submitting a pull request: "Please use black to format your code before submitting a pull request"