Skip to content
Snippets Groups Projects
CONTRIBUTING.md 998 B
Newer Older
David Schäfer's avatar
David Schäfer committed
# Development Environment
We recommend an virtual python environment for development. The setup process consists of the follwing simply steps:

1. Create a fresh environment with:
   ```sh
   python -m venv saqc_dev
   ```
2. Activate the created environment
   ```
   source saqc_dev/bin/activate
   ```
3. Install the dependencies
   ```sh
   python -m pip install -r requirements.txt
   ```
 
# Testing
SaQC comes with an extensive test suite based on [pytest](https://docs.pytest.org/en/latest/).
In order to run all tests execute:
```sh
python -m pytest .
```

David Schäfer's avatar
David Schäfer committed
# Coding conventions
David Schäfer's avatar
David Schäfer committed
## Naming
David Schäfer's avatar
David Schäfer committed
### Code
We follow the follwing naming conventions
David Schäfer's avatar
David Schäfer committed
- Classes: CamelCase
- Functions: camelCase
David Schäfer's avatar
David Schäfer committed
- Variables/Arguments: snake_case
David Schäfer's avatar
David Schäfer committed
### Test Functions
David Schäfer's avatar
David Schäfer committed
- testnames: [testmodule_]flagTestName
David Schäfer's avatar
David Schäfer committed
 
## Formatting
David Schäfer's avatar
David Schäfer committed
We use (black)[https://black.readthedocs.io/en/stable/] with a line length if 120 characters.
Within the `SaQC` root directory run `black -l 120`
David Schäfer's avatar
David Schäfer committed

## Imports
Only absolute imports are accepted