This is a template repository for python module projects.
- Python module/package
- Configuration
- Test
- Build
- Documentation
- Scripts
- Examples
- CI/CD
- Install Python (>= v3.10) and pip (>= 23):
- [RECOMMENDED] Miniconda (v3)
- [arm64/aarch64] Miniforge (v3)
- [Python virtual environment] venv
[OPTIONAL] For DEVELOPMENT environment:
[TIP] Skip this step, if you're going to install the package directly from PyPi or GitHub repository.
2.1. Prepare projects directory (if not exists):
# Create projects directory:
mkdir -pv ~/workspaces/projects
# Enter into projects directory:
cd ~/workspaces/projects2.2. Follow one of the below options [A], [B] or [C]:
OPTION A. Clone the repository:
git clone https://github.com/bybatkhuu/module-python-template.git && \
cd module-python-templateOPTION B. Clone the repository (for DEVELOPMENT: git + ssh key):
git clone git@github.com:bybatkhuu/module-python-template.git && \
cd module-python-templateOPTION C. Download source code:
- Download archived zip file from releases.
- Extract it into the projects directory.
[NOTE] Choose one of the following methods to install the package [A ~ F]:
OPTION A. [RECOMMENDED] Install from PyPi:
# Install from staging TestPyPi:
pip install -i https://test.pypi.org/simple -U my-module01
# Or install from production PyPi:
# pip install -U my-module01OPTION B. Install latest version directly from GitHub repository:
pip install git+https://github.com/bybatkhuu/module-python-template.gitOPTION C. Install from the downloaded source code:
# Install directly from the source code:
pip install .
# Or install with editable mode:
pip install -e .OPTION D. Install for DEVELOPMENT environment:
pip install -e .[dev]
# Install pre-commit hooks:
pre-commit installOPTION E. Install from pre-built release files:
- Download
.whlor.tar.gzfile from releases - Install with pip:
# Install from .whl file:
pip install ./my_module01-[VERSION]-py3-none-any.whl
# Or install from .tar.gz file:
pip install ./my_module01-[VERSION].tar.gzOPTION F. Copy the module into the project directory (for testing):
# Install python dependencies:
pip install -r ./requirements.txt
# Copy the module source code into the project:
cp -r ./src/my_module01 [PROJECT_DIR]
# For example:
cp -r ./src/my_module01 /some/path/project/# Standard libraries
import sys
import logging
# Internal modules
from my_module01 import MyClass
logger = logging.getLogger(__name__)
def main() -> None:
logging.basicConfig(
stream=sys.stdout,
level=logging.INFO,
datefmt="%Y-%m-%d %H:%M:%S %z",
format="[%(asctime)s | %(levelname)s | %(filename)s:%(lineno)d]: %(message)s",
)
# Pre-defined variables (for customizing and testing)
_items = [0.1, 0.2, 0.3, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0]
_config = {
"min_length": 4,
"max_length": 10,
"min_value": 0.0,
"max_value": 1.0,
"threshold": 0.7,
}
# Main example code
logger.info(f"Items before cleaning: {_items}")
_my_object = MyClass(items=_items, config=_config)
_items = _my_object.run()
logger.info(f"Items after cleaning: {_items}")
logger.info("Done!\n")
return
if __name__ == "__main__":
main()👍
my_module01:
min_length: 2
max_length: 100
min_value: 0.0
max_value: 1.0
threshold: 0.5# ENV=LOCAL
# DEBUG=false
# TZ=UTCTo run tests, run the following command:
# Install python test dependencies:
pip install .[test]
# Run tests:
python -m pytest -sv -o log_cli=true
# Or use the test script:
./scripts/test.sh -l -v -cTo build the python package, run the following command:
# Install python build dependencies:
pip install -r ./requirements/requirements.build.txt
# Build python package:
python -m build
# Or use the build script:
./scripts/build.shTo build the documentation, run the following command:
# Install python documentation dependencies:
pip install -r ./requirements/requirements.docs.txt
# Serve documentation locally (for development):
mkdocs serve -a 0.0.0.0:8000 --livereload
# Or use the docs script:
./scripts/docs.sh
# Or build documentation:
mkdocs build
# Or use the docs script:
./scripts/docs.sh -b