brainbot's Introduction

brainbot Repo

A framework to experiment with using asyncio coroutines to control 2D objects in a simulation

How to run tools against the code

# create and activate virtual environment
python -m venv venv  # or `py -3.8 -m venv venv`
source venv/Scripts/activate

# install to current environment (with current dir at top of repo) 
pip install .     # "static" install
pip install -e .  # "editable" install (setup.py handles source being under `src/`)

# run app from install
python -m brainbot

# run app directly from local repo (with current dir at top of repo)
cd src/
python -m brainbot

# run tests: path-based 
python -m pytest tests/
python -m pytest tests/test_common.py
python -m pytest tests/sub
# run tests: package syntax
python -m pytest --pyargs tests.sub

# run tests with coverage metrics
python -m pytest --cov tests/
python -m pytest --cov tests/sub
python -m pytest --cov tests.sub

# run linting
pylint src/  # recurses into directory
pylint src/ tests/
pylint brainbot.common  # can use package names to lint what is installed

# run mypy
mypy src/  # recurses into directory tree
mypy src/brainbot/common/util.py

cd src
mypy -p brainbot
mypy -p brainbot.common
mypy -m brainbot.common.util

Running app from PyCharm

Use Default Python Interpreter from PyCharm

For src/, do "Mark Directory" and set as "Sources Root" (folder turns light blue)
Right click on src/brainbot/__main__.py and choose "Run __main__"
- This relies on the Run Configuration having "Add source roots to PYTHONPATH" set to true (the default)

Use local venv

Create venv
Install package into the venv (ex: pip install -e .)
Set venv as the project's Python interpreter in PyCharm
Right click on src/brainbot/__misc__.py and choose "Run __main__"
- Note: This does NOT rely on a Sources Root folder being set or PYTHONPATH in the Run Configuration.

Recommend Projects