# 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.8.0](https://github.com/axoflow/axosyslog/releases/tag/axosyslog-4.8.0).
## Quickstart
### Install with pipx
```
pipx install 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
[![Example](https://raw.githubusercontent.com/alltilla/axosyslog-cfg-helper/assets/example.gif)](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:
[![Axoflow Discord Server](https://discordapp.com/api/guilds/1082023686028148877/widget.png?style=banner2)](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.8",
"maintainer_email": null,
"keywords": "axosyslog, configuration, cfg",
"author": "Attila Szakacs",
"author_email": "szakacs.attila96@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/bd/eb/1375802f7a98b03b780dcb57a7b09b8be23b6de02a61798299f52deaaf82/axosyslog_cfg_helper-1.10.1.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.8.0](https://github.com/axoflow/axosyslog/releases/tag/axosyslog-4.8.0).\n\n## Quickstart\n\n### Install with pipx\n```\npipx install 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[![Example](https://raw.githubusercontent.com/alltilla/axosyslog-cfg-helper/assets/example.gif)](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[![Axoflow Discord Server](https://discordapp.com/api/guilds/1082023686028148877/widget.png?style=banner2)](https://discord.gg/E65kP9aZGm)\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "Configuration helper for axosyslog.",
"version": "1.10.1",
"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": "7b7c6092e9f45a2f8eff995b9311bb8a316ad6445c50bb5ba1eefbb2b2475ff0",
"md5": "045fe2fbd23c9d635f3bc67d6ac364d3",
"sha256": "511f344efd24f0424ab167119ec4d321c75cb56344b774e9cd0c3caf6baf0607"
},
"downloads": -1,
"filename": "axosyslog_cfg_helper-1.10.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "045fe2fbd23c9d635f3bc67d6ac364d3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 57356,
"upload_time": "2024-09-17T15:10:42",
"upload_time_iso_8601": "2024-09-17T15:10:42.761911Z",
"url": "https://files.pythonhosted.org/packages/7b/7c/6092e9f45a2f8eff995b9311bb8a316ad6445c50bb5ba1eefbb2b2475ff0/axosyslog_cfg_helper-1.10.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bdeb1375802f7a98b03b780dcb57a7b09b8be23b6de02a61798299f52deaaf82",
"md5": "c97937bc78ceb6e4962ecda7377d39a6",
"sha256": "ed6b17f11b217587885605d33bbd6682f0882c268490ce632b096a473a697e7f"
},
"downloads": -1,
"filename": "axosyslog_cfg_helper-1.10.1.tar.gz",
"has_sig": false,
"md5_digest": "c97937bc78ceb6e4962ecda7377d39a6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 40955,
"upload_time": "2024-09-17T15:10:43",
"upload_time_iso_8601": "2024-09-17T15:10:43.868978Z",
"url": "https://files.pythonhosted.org/packages/bd/eb/1375802f7a98b03b780dcb57a7b09b8be23b6de02a61798299f52deaaf82/axosyslog_cfg_helper-1.10.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-17 15:10:43",
"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"
}