Skip to content

Latest commit

 

History

History
62 lines (38 loc) · 2.24 KB

CONTRIBUTING.md

File metadata and controls

62 lines (38 loc) · 2.24 KB
Raw

Submitting an Issue

For Bugs

Before submitting, please ensure that you are using the latests code by performing a git pull.

Please include your operating system, your operating system version number (16.04, 10.6, etc), and the dojo install you are using (setup.bash, docker, etc).

Bugs that do not have this information will be closed.

Contributing to DefectDojo

Here are a few things to keep in mind when making changes to DefectDojo.

Modifying DefectDojo and Testing

Please use these test scripts to test your changes. These are the exact scripts we run in our Travis Build.

For changes that require additional settings, settings.dist.py is the file you want to change. Settings.py is created by setup.bash from settings.dist.py

Python3 version

For compatibility reasons, the code in dev branch should be python3.5 compliant.

Logging

Logging is configured in settings.dist.py.

Specific logger can be added. For example to activate logs related to the deduplication, change the level from DEBUG to INFO in:

          'dojo.specific-loggers.deduplication': {
            'handlers': ['console'],
            'level': 'DEBUG',
            'propagate': False,
        }

Submitting Pull Requests

The following are things to consider before submitting a pull request to DefectDojo.

  1. Ensure all changes made to the code, packages, etc. are reflected in the setup.bash script and the setup.py script.

  2. Make sure that the install is working properly.

  3. All tests found in these test scripts should be passing.

  4. All submitted code should conform to PEP8 standards.

  5. See flake8 built-in commit hooks on how to easily check for for pep8 with flake8 before comitting.

  6. Pull requests should be submitted to the 'dev' branch.

  7. In dev branch, the code should be python 3.5 compliant.