This section describes how to install nornir_nautobot for development, how to run tests, and make sure you are a good contributor.
main- Reserved for current release
develop- Ready to release code, bases for new PRs
<feature>- Individual feature branches, should be PR'd to
This leverages Python3.8 or later. All features will be tested against 3.8 - 3.11 versions of Python.
This project utilizes Semver versioning. As part of PRs the maintainers should leverage Poetry versioning to support the increase in version numbers. Reference Poetry Version Docs for more information on automatically adjusting the version.
Installing dependencies for local development¶
These steps are also required for using the examples as provided in the repository for demonstration purposes.
Follow these steps to set up your local development environment:
When you install dependencies via Poetry you will get invoke as part of the process.
Running tests locally¶
Docker images are available to provide a consistent development environment from one machine to another. The best practice recommendation is to execute two steps to test:
- Build Docker container image (
- Execute test environment (
- You can execute individual tests as well by looking at the tests with the command
Build Docker container image¶
Invoke tasks have a task to help build the containers. Executing the task with
invoke build will build the Docker image for testing.
The Invoke task to execute the tests are then
invoke tests. This will execute all of the linting and pytest functions on the code.
All tests should be located within the
tests\ directory with
tests\unit for the unit tests. Integration tests should be in the
Testing - Required¶
The following linting tasks are required:
- Basic security tests, should be run on Python3.11
- Black code style
- Code formatting with version 20.8b1. There are some differences in the format between versions 19 and 20.
- Black vs Flake conflicts: When conflicts arise between Black and Flake8, Black should win and Flake8 should be configured as such
Tests - Interim¶
In the interim while the primary project is still in private access, any execution environments (pynautobot or Nautobot itself) should be packaged and stored in
tests\packages for independent installation until the public images are available.