diff --git a/README.md b/README.md index cf349a6..06509d0 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,21 @@ -# Python Project Template +[![Project Status: WIP – This project is currently under active development.](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip) +[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) +[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](https://coverage.readthedocs.io/) +[![Pytest](https://img.shields.io/badge/tested%20with-pytest-0A9EDC.svg)](https://docs.pytest.org/en/stable/) +[![Pylint](https://img.shields.io/badge/code%20quality-pylint-yellowgreen.svg)](https://www.pylint.org/) +[![Pyright](https://img.shields.io/badge/type%20checked-pyright-blue.svg)](https://github.com/microsoft/pyright) +[![Flake8](https://img.shields.io/badge/linter-flake8-blue.svg)](https://flake8.pycqa.org/en/latest/) +[![Tox](https://img.shields.io/badge/tested%20with-tox-1C1C1C.svg)](https://tox.readthedocs.io/en/latest/) -This project is a template for creating Python projects that follows the Python Standards declared in PEP 621. It uses a pyproject.yaml file to configure the project and Flit to simplify the build process and publish to PyPI. Flit simplifies the build and packaging process for Python projects by eliminating the need for separate setup.py and setup.cfg files. With Flit, you can manage all relevant configurations within the pyproject.toml file, streamlining development and promoting maintainability by centralizing project metadata, dependencies, and build specifications in one place. + +# sr2silo +### Wrangling Short-Read Genomic Alignments for SILO Database + +This project will wrangle short-read genomic aligments, for example from wastewater-sampling, into a format for easy import into the SILO sequencing database. + +## Python Project Layout + +This Project is based on the [Microsoft Python-Package-Template](https://github.com/microsoft/python-package-template) and follows the Python Standards declared in PEP 621. It uses a pyproject.yaml file to configure the project and Flit to simplify the build process and publish to PyPI. Flit simplifies the build and packaging process for Python projects by eliminating the need for separate setup.py and setup.cfg files. With Flit, you can manage all relevant configurations within the pyproject.toml file, streamlining development and promoting maintainability by centralizing project metadata, dependencies, and build specifications in one place. ## Project Organization @@ -9,6 +24,7 @@ This project is a template for creating Python projects that follows the Python - `.devcontainer/devcontainer.json`: Contains the configuration for the development container for VSCode, including the Docker image to use, any additional VSCode extensions to install, and whether or not to mount the project directory into the container. - `.vscode/settings.json`: Contains VSCode settings specific to the project, such as the Python interpreter to use and the maximum line length for auto-formatting. - `src`: Place new source code here. +- `scripts`: Place new source code here, temporary and intermediate works. - `tests`: Contains Python-based test cases to validate source code. - `pyproject.toml`: Contains metadata about the project and configurations for additional tools used to format, lint, type-check, and analyze Python code. diff --git a/pyproject.toml b/pyproject.toml index c113062..440e081 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -52,7 +52,7 @@ Source = "https://github.com/microsoft/python-package-template" Tracker = "https://github.com/microsoft/python-package-template/issues" [tool.flit.module] -name = "python_package" +name = "sr2silo" [tool.bandit] exclude_dirs = ["build","dist","tests","scripts"] diff --git a/src/python_package/__init__.py b/src/sr2silo/__init__.py similarity index 100% rename from src/python_package/__init__.py rename to src/sr2silo/__init__.py diff --git a/src/python_package/hello_world.py b/src/sr2silo/hello_world.py similarity index 100% rename from src/python_package/hello_world.py rename to src/sr2silo/hello_world.py diff --git a/tests/test_methods.py b/tests/test_methods.py index 40b5791..274ff83 100644 --- a/tests/test_methods.py +++ b/tests/test_methods.py @@ -5,7 +5,7 @@ """This is a sample python file for testing functions from the source code.""" from __future__ import annotations -from python_package.hello_world import hello_world +from sr2silo.hello_world import hello_world def hello_test():