Introduction to AMNES Development¶
The following sections consist of guidelines for AMNES Development and tips for getting started with developing for AMNES. If you want to contribute to AMNES, you should also checkout our Contribution Guidelines.
Getting Started¶
After cloning the repository, you need to prepare your environment by calling Pipenv:
pipenv sync --dev
pipenv shell
You should now install AMNES and AMNES Development Utility as source packages:
pip install -e src
pip install -e dev/src
It is recommended to enable git hooks, to repeat these commands after each checkout:
amnesdev hooks enable
You should now be able to use AMNES commands:
amnes --help
amnesdev --help
Visual Studio Code¶
If you want to use an IDE, we recommend Visual Studio Code as it is supported through our development utility. See AMNES Development Utility for more information.
Directory Structure¶
AMNES uses the following directory structure for its sources:
AMNES-Repository/ # Git Repository
dev/ # AMNES Development Utility and its assets
src/ # Subdirectory for Seperation
amnes/ # AMNES Python Sources
tests/ # AMNES Python Tests
docs/ # AMNES Documentation
The actual AMNES package resides in src
so it will not be automatically imported by pytest.
This allows us to choose whether we want to run the tests against a local or installed version of AMNES.
In addition to this, we are able to access all local AMNES modules after adding the project root directory to the python search path by using the prefix src.amnes.
, regardless whether we use a local or installed version of AMNES by importing modules with the prefix amnes.
.
All AMNES python tests are contained in the tests
directory, which decouples sources and tests.
The AMNES Documentation resides in docs
.
Start Developing¶
To accelerate your development process and automize redundant tasks, you should checkout or custom Development Utility and Development Environment.