Skip to content

barbara73/sqlalchemy_uow

Repository files navigation

sqlalchemy-uow

Unit of Work for SQLAlchemy project


PyPI Status Documentation License LastCommit Code Coverage Contributor Covenant

Developers:

Setup

Set up the environment

  1. Run make install, which installs Poetry (if it isn't already installed), sets up a virtual environment and all Python dependencies therein.
  2. Run source .venv/bin/activate to activate the virtual environment.

Install new packages

To install new PyPI packages, run:

$ poetry add <package-name>

Auto-generate API documentation

To auto-generate API document for your project, run:

$ make docs

To view the documentation, run:

$ make view-docs

Tools used in this project

  • Poetry: Dependency management
  • hydra: Manage configuration files
  • pre-commit plugins: Automate code reviewing formatting
  • pdoc: Automatically create an API documentation for your project

Project structure

.
├── .flake8
├── .github
│   └── workflows
│       ├── ci.yaml
│       └── docs.yaml
├── .gitignore
├── .pre-commit-config.yaml
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── config
│   ├── __init__.py
│   └── config.yaml
├── data
├── makefile
├── models
├── notebooks
├── poetry.toml
├── pyproject.toml
├── src
│   ├── scripts
│   │   ├── fix_dot_env_file.py
│   │   └── versioning.py
│   └── sqlalchemy_uow
│       └── __init__.py
└── tests
    └── __init__.py