# AxoSyslog CFG Helper
This tool makes configuring [AxoSyslog](https://github.com/axoflow/axosyslog) a bit easier by listing the options of each available driver.
The options are generated from [AxoSyslog v4.13.0](https://github.com/axoflow/axosyslog/releases/tag/axosyslog-4.13.0).
## Quickstart
### Install with pipx
```
pipx install axosyslog-cfg-helper
```
### Or pull the container image
```
docker pull ghcr.io/alltilla/axosyslog-cfg-helper
```
### List the contexts
```
axosyslog-cfg-helper
```
### List the drivers in a context
```
axosyslog-cfg-helper --context parser
```
### List the options of a driver
```
axosyslog-cfg-helper --context parser --driver csv-parser
```
### Example
[](https://raw.githubusercontent.com/alltilla/axosyslog-cfg-helper/assets/example.gif)
## Development
The tool is still in development, but most of the drivers are supported.
Missing features are:
* Proper `rewrite` support.
* Proper `filter` support.
* Drivers defined in `SCL`s.
* Drivers defined with confgen.
Any contribution is welcome :)
### Local setup
The project uses [poetry](https://python-poetry.org/) as a dependency management system.
Building of the option database needs the [neologism](https://github.com/alltilla/neologism) pip package, which gets installed by poetry, however it has another dependency, which is [bison](https://www.gnu.org/software/bison/). Make sure to install bison (at least 3.7.6) on you system if you wan't to develop locally. `make bison` can help with that.
The [Makefile](https://github.com/alltilla/axosyslog-cfg-helper/blob/master/Makefile) consists of some useful commands:
* `make venv` prepares the venv.
* `make bison` downloads bison 3.7.6, builds it and installs it under `/usr/local`.
* You can change the install path with `make bison BISON_INSTALL_PATH=...`
* `make check` runs the unit tests, style-checkers and linters.
* `make format` formats the code.
* `make db` downloads the axosyslog release tarball and generates the option database.
* `make db AXOSYSLOG_SOURCE_DIR=/path/to/axosyslog` creates a tarball from the state of the axosyslog source dir and generates the option database.
* `make package` creates the pip package.
## Community
You can reach out to the AxoSyslog community on Discord:
[](https://discord.gg/E65kP9aZGm)
Raw data
{
"_id": null,
"home_page": "https://github.com/alltilla/axosyslog-cfg-helper",
"name": "axosyslog-cfg-helper",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "axosyslog, configuration, cfg",
"author": "Attila Szakacs",
"author_email": "szakacs.attila96@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3a/48/c6fa1979c472bd33110b34233f1acf12665c10ae260e4c1b7c06c240363f/axosyslog_cfg_helper-1.14.0.tar.gz",
"platform": null,
"description": "# AxoSyslog CFG Helper\n\nThis tool makes configuring [AxoSyslog](https://github.com/axoflow/axosyslog) a bit easier by listing the options of each available driver.\n\nThe options are generated from [AxoSyslog v4.13.0](https://github.com/axoflow/axosyslog/releases/tag/axosyslog-4.13.0).\n\n## Quickstart\n\n### Install with pipx\n```\npipx install axosyslog-cfg-helper\n```\n\n### Or pull the container image\n```\ndocker pull ghcr.io/alltilla/axosyslog-cfg-helper\n```\n\n### List the contexts\n```\naxosyslog-cfg-helper\n```\n\n### List the drivers in a context\n```\naxosyslog-cfg-helper --context parser\n```\n\n### List the options of a driver\n```\naxosyslog-cfg-helper --context parser --driver csv-parser\n```\n\n### Example\n[](https://raw.githubusercontent.com/alltilla/axosyslog-cfg-helper/assets/example.gif)\n\n## Development\nThe tool is still in development, but most of the drivers are supported.\n\nMissing features are:\n * Proper `rewrite` support.\n * Proper `filter` support.\n * Drivers defined in `SCL`s.\n * Drivers defined with confgen.\n\nAny contribution is welcome :)\n\n### Local setup\nThe project uses [poetry](https://python-poetry.org/) as a dependency management system.\n\nBuilding of the option database needs the [neologism](https://github.com/alltilla/neologism) pip package, which gets installed by poetry, however it has another dependency, which is [bison](https://www.gnu.org/software/bison/). Make sure to install bison (at least 3.7.6) on you system if you wan't to develop locally. `make bison` can help with that.\n\nThe [Makefile](https://github.com/alltilla/axosyslog-cfg-helper/blob/master/Makefile) consists of some useful commands:\n * `make venv` prepares the venv.\n * `make bison` downloads bison 3.7.6, builds it and installs it under `/usr/local`.\n * You can change the install path with `make bison BISON_INSTALL_PATH=...`\n * `make check` runs the unit tests, style-checkers and linters.\n * `make format` formats the code.\n * `make db` downloads the axosyslog release tarball and generates the option database.\n * `make db AXOSYSLOG_SOURCE_DIR=/path/to/axosyslog` creates a tarball from the state of the axosyslog source dir and generates the option database.\n * `make package` creates the pip package.\n\n## Community\nYou can reach out to the AxoSyslog community on Discord:\n\n[](https://discord.gg/E65kP9aZGm)\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "Configuration helper for axosyslog.",
"version": "1.14.0",
"project_urls": {
"Homepage": "https://github.com/alltilla/axosyslog-cfg-helper",
"Repository": "https://github.com/alltilla/axosyslog-cfg-helper"
},
"split_keywords": [
"axosyslog",
" configuration",
" cfg"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d6bbc6d7497a38c06d2c3d00abb48eb2bdbae68ef8d65c0e4fdc477be181a630",
"md5": "b9d67ad0ea0c2069d6aa23efb037523d",
"sha256": "54ebe18a3d35ef993ee98cc4daf4e94a1943b59a9bfaf0d3120a99b7d64bcb5d"
},
"downloads": -1,
"filename": "axosyslog_cfg_helper-1.14.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b9d67ad0ea0c2069d6aa23efb037523d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 58964,
"upload_time": "2025-07-08T12:28:47",
"upload_time_iso_8601": "2025-07-08T12:28:47.297167Z",
"url": "https://files.pythonhosted.org/packages/d6/bb/c6d7497a38c06d2c3d00abb48eb2bdbae68ef8d65c0e4fdc477be181a630/axosyslog_cfg_helper-1.14.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3a48c6fa1979c472bd33110b34233f1acf12665c10ae260e4c1b7c06c240363f",
"md5": "313d010ab9b1553525ee6a0a097bdf7e",
"sha256": "3ec343fa84bb614b8b091ad72751ab2cb1edd0650ee92a1924de3f9a9f88fa5b"
},
"downloads": -1,
"filename": "axosyslog_cfg_helper-1.14.0.tar.gz",
"has_sig": false,
"md5_digest": "313d010ab9b1553525ee6a0a097bdf7e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 41958,
"upload_time": "2025-07-08T12:28:48",
"upload_time_iso_8601": "2025-07-08T12:28:48.408605Z",
"url": "https://files.pythonhosted.org/packages/3a/48/c6fa1979c472bd33110b34233f1acf12665c10ae260e4c1b7c06c240363f/axosyslog_cfg_helper-1.14.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-08 12:28:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "alltilla",
"github_project": "axosyslog-cfg-helper",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "axosyslog-cfg-helper"
}
JSON
