A linting and QA check tool for NASL files
Project description
Troubadix
A linting and QA check tool for NASL files
Installation
Requirements
Python 3.7 and later is supported.
Install using pip
pip 19.0 or later is required.
You can install the latest stable release of troubadix from the Python Package Index (pypi) using pip
python3 -m pip install --user troubadix
Install using poetry
Because troubadix is a Python application you most likely need a tool to handle Python package dependencies and Python environments. Therefore we strongly recommend using pipenv or poetry.
You can install the latest stable release of troubadix and add it as a dependency for your current project using poetry
poetry add troubadix
For installation via pipenv please take a look at their documentation.
Development
troubadix uses poetry for its own dependency management and build process.
First install poetry via pip
python3 -m pip install --user poetry
Afterwards run
poetry install
in the checkout directory of troubadix (the directory containing the
pyproject.toml file) to install all dependencies including the packages only
required for development.
Afterwards activate the git hooks for auto-formatting and linting via autohooks.
poetry run autohooks activate
Validate the activated git hooks by running
poetry run autohooks check
Environment Options
| ENV Variable | Default | Description |
|---|---|---|
| NASLINTER_DOCKER_RUN | 'false' |
If we use 'true' we use the Docker with the greenbone/ospd-openvas:stable image from DockerHub to run the tests via openvas-nasl-lint for the check_openvas_lintplugin. If default'false'` is used we expect that openvas is installed local. |
Maintainer
This project is maintained by Greenbone Networks GmbH
Contributing
Your contributions are highly appreciated. Please create a pull request on GitHub. Bigger changes need to be discussed with the development team via the issues section at GitHub first.
License
Copyright (C) 2021-2022 Greenbone Networks GmbH
Licensed under the GNU General Public License v3.0 or later.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file troubadix-22.4.0.tar.gz.
File metadata
- Download URL: troubadix-22.4.0.tar.gz
- Upload date:
- Size: 114.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.8.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 777b4b83ac688a3cf91e77c1bcc9532f2c92dfa941338a39ddf305b5c9c3a71e |
|
| MD5 | a5d2b2e6a680bf7b78073eba83fe093c |
|
| BLAKE2b-256 | 81778d70300aa6511168900d4f124ab293f87694fe16e6ac331da945bdb53282 |
Provenance
File details
Details for the file troubadix-22.4.0-py3-none-any.whl.
File metadata
- Download URL: troubadix-22.4.0-py3-none-any.whl
- Upload date:
- Size: 148.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.8.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6f18ecf3d416a5017b9607165eb70c687252c321e8fa899bd318315e3b185031 |
|
| MD5 | 37f412de4fb2981429785e847d86f16b |
|
| BLAKE2b-256 | 1753ae65584239d15d247df56ff1c0b3f5ca73cb1cd5ae6cc21a108ae60e7206 |
