BatCave Utilities module.


Keywords
python, programming, utilities
License
MIT
Install
pip install batcave==43.1.1

Documentation

BatCave Python Module

A useful collection of tools for writing Python programs.

Developing

Development is best accomplished using virtualenv or virtualenv-wrapper where a virtual environment can be generated:

mkvirtualenv batcave
python -m pip install --upgrade pip
pip install --upgrade --upgrade-strategy eager setuptools wheel
pip install --upgrade --upgrade-strategy eager flit
Windows: flit install --deps all
Linux: flit install -s --deps all

To update the current development environment

python -m pip install --upgrade pip
pip install --upgrade --upgrade-strategy eager setuptools wheel
Windows: pip freeze | %{$_.split('==')[0]} | %{pip install --upgrade $_}
Linux: pip freeze | grep -v '^\-e' | cut -d = -f 1 | xargs -n1 pip install --upgrade

Testing

Static Analysis

The static analysis test can be run with

pylint batcave
flake8 batcave
mypy batcave

Unit Tests

The unit tests can be run with

python -m unittest -v [tests.test_suite[.test_class[.test_case]]]

Building

The build can be run with

flit build

Publishing a Release

This is the procedure for releasing BatCave

  1. Validate all issues are "Ready for Release"
  2. Update CHANGELOG.md
  3. Run the publish workflow against the Production environment
  4. Validate GitHub release
  5. Validate PyPi
  6. Move issues to "Closed" and label res::complete
  7. Close Milestone
  8. Update source in Perforce