# Kidash [](https://github.com/chaoss/grimoirelab-kidash/actions?query=workflow:tests+branch:main+event:push) [](https://coveralls.io/r/chaoss/grimoirelab-kidash?branch=main) [](https://badge.fury.io/py/kidash)
Kidash is a tool for managing Kibana-related dashboards from the command line. The standard GrimoireLab dashboards
are available in the [Sigils](https://github.com/chaoss/grimoirelab-sigils) repository.
## Requirements
* Python >= 3.10
You will also need some other libraries for running the tool, you can find the
whole list of dependencies in [pyproject.toml](pyproject.toml) file.
## Installation
There are several ways to install Kidash on your system: packages or source
code using Poetry or pip.
### PyPI:
Kidash can be installed using pip, a tool for installing Python packages.
To do it, run the next command:
```
$ pip install kidash
```
### Source code
To install from the source code you will need to clone the repository first:
```
$ git clone https://github.com/chaoss/grimoirelab-kidash
$ cd grimoirelab-kidash
```
Then use pip or Poetry to install the package along with its dependencies.
#### Pip
To install the package from local directory run the following command:
```
$ pip install .
```
In case you are a developer, you should install kidash in editable mode:
```
$ pip install -e .
```
#### Poetry
We use [poetry](https://python-poetry.org/) for dependency management and
packaging. You can install it following its [documentation](https://python-poetry.org/docs/#installation).
Once you have installed it, you can install kidash and the dependencies:
```
$ poetry install
```
To spaw a new shell within the virtual environment use:
```
$ poetry shell
```
## Usage
- Get a list of all options with:
```
$ kidash --help
```
- Import a dashboard:
```buildoutcfg
kidash -g -e <elasticsearch-url>:<port> --import <local-file-path>
example: kidash -g -e https://admin:admin@localhost:9200 --import ./overview.json
```
- Export a dashboard:
```buildoutcfg
kidash -g -e <elasticsearch-url> --dashboard <dashboard-id>* --export <local-file-path> --split-index-pattern
example: kidash -g -e https://admin:admin@localhost:9200 --dashboard overview --export overview.json
```
## License
Licensed under GNU General Public License (GPL), version 3 or later.
Raw data
{
"_id": null,
"home_page": "https://chaoss.github.io/grimoirelab/",
"name": "kidash",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "development, grimoirelab",
"author": "GrimoireLab Developers",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/a4/99/0f48345d38746398c1958415bf45df32f43dade628202fc1da41eddef621/kidash-1.1.1.tar.gz",
"platform": null,
"description": "# Kidash [](https://github.com/chaoss/grimoirelab-kidash/actions?query=workflow:tests+branch:main+event:push) [](https://coveralls.io/r/chaoss/grimoirelab-kidash?branch=main) [](https://badge.fury.io/py/kidash)\n\nKidash is a tool for managing Kibana-related dashboards from the command line. The standard GrimoireLab dashboards\nare available in the [Sigils](https://github.com/chaoss/grimoirelab-sigils) repository.\n\n## Requirements\n\n * Python >= 3.10\n\nYou will also need some other libraries for running the tool, you can find the\nwhole list of dependencies in [pyproject.toml](pyproject.toml) file.\n\n## Installation\n\nThere are several ways to install Kidash on your system: packages or source \ncode using Poetry or pip.\n\n### PyPI:\n\nKidash can be installed using pip, a tool for installing Python packages. \nTo do it, run the next command:\n```\n$ pip install kidash\n```\n\n### Source code\n\nTo install from the source code you will need to clone the repository first:\n```\n$ git clone https://github.com/chaoss/grimoirelab-kidash\n$ cd grimoirelab-kidash\n```\n\nThen use pip or Poetry to install the package along with its dependencies.\n\n#### Pip\nTo install the package from local directory run the following command:\n```\n$ pip install .\n```\nIn case you are a developer, you should install kidash in editable mode:\n```\n$ pip install -e .\n```\n\n#### Poetry\nWe use [poetry](https://python-poetry.org/) for dependency management and \npackaging. You can install it following its [documentation](https://python-poetry.org/docs/#installation).\nOnce you have installed it, you can install kidash and the dependencies:\n```\n$ poetry install\n```\nTo spaw a new shell within the virtual environment use:\n```\n$ poetry shell\n```\n\n## Usage\n\n- Get a list of all options with:\n```\n$ kidash --help\n```\n\n- Import a dashboard:\n```buildoutcfg\nkidash -g -e <elasticsearch-url>:<port> --import <local-file-path>\nexample: kidash -g -e https://admin:admin@localhost:9200 --import ./overview.json\n```\n\n- Export a dashboard:\n```buildoutcfg\nkidash -g -e <elasticsearch-url> --dashboard <dashboard-id>* --export <local-file-path> --split-index-pattern\nexample: kidash -g -e https://admin:admin@localhost:9200 --dashboard overview --export overview.json\n```\n\n## License\n\nLicensed under GNU General Public License (GPL), version 3 or later.\n",
"bugtrack_url": null,
"license": "GPL-3.0+",
"summary": "GrimoireLab script to manage Kibana dashboards from the command line",
"version": "1.1.1",
"project_urls": {
"Bug Tracker": "https://github.com/chaoss/grimoirelab-kidash/issues",
"Homepage": "https://chaoss.github.io/grimoirelab/",
"Repository": "https://github.com/chaoss/grimoirelab-kidash"
},
"split_keywords": [
"development",
" grimoirelab"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c7536c042fb333c20e55e540ce6540bc63a4f9a3aeb87487e25f41373d103c17",
"md5": "e122e3eeb21e62cd3af8e95bf36c9f59",
"sha256": "e73c403d4403351d2f3df968cf6bf80e9bd77126e2536c0b46b3e19e853ad07c"
},
"downloads": -1,
"filename": "kidash-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e122e3eeb21e62cd3af8e95bf36c9f59",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 28823,
"upload_time": "2025-10-10T15:42:26",
"upload_time_iso_8601": "2025-10-10T15:42:26.066382Z",
"url": "https://files.pythonhosted.org/packages/c7/53/6c042fb333c20e55e540ce6540bc63a4f9a3aeb87487e25f41373d103c17/kidash-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a4990f48345d38746398c1958415bf45df32f43dade628202fc1da41eddef621",
"md5": "afdf22b7ffd9a3fe508f5ed0c81ffdcf",
"sha256": "14301985b7d2fc5dee0e49e3ebbc70bd0d35c693599c814932fd9b5b6d73c8ac"
},
"downloads": -1,
"filename": "kidash-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "afdf22b7ffd9a3fe508f5ed0c81ffdcf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 32881,
"upload_time": "2025-10-10T15:42:27",
"upload_time_iso_8601": "2025-10-10T15:42:27.744752Z",
"url": "https://files.pythonhosted.org/packages/a4/99/0f48345d38746398c1958415bf45df32f43dade628202fc1da41eddef621/kidash-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-10 15:42:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "chaoss",
"github_project": "grimoirelab-kidash",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kidash"
}
JSON
