[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE.md)
![Unit Tests](https://github.com/OpenVoiceOS/ovos-core/actions/workflows/unit_tests.yml/badge.svg)
[![codecov](https://codecov.io/gh/OpenVoiceOS/ovos-config/branch/dev/graph/badge.svg?token=CS7WJH4PO2)](https://codecov.io/gh/OpenVoiceOS/ovos-config)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
[![Chat](https://img.shields.io/matrix/openvoiceos-general:matrix.org)](https://matrix.to/#/#OpenVoiceOS-general:matrix.org)
[![GitHub Discussions](https://img.shields.io/github/discussions/OpenVoiceOS/OpenVoiceOS?label=OVOS%20Discussions)](https://github.com/OpenVoiceOS/OpenVoiceOS/discussions)
# OVOS-config
helper package to interact with mycroft config
## Command Line usage
A small helper tool is included to quickly show, get or set config values
<img width="1214" alt="ovos-config" src="https://user-images.githubusercontent.com/25036977/219516755-b454f28f-2a34-4caf-a91f-6182ff68049a.png">
Quick rundown (cli):
* `ovos-config get`
* Loose search (search a key or parts therof):\
\
Given an entry of
{'PHAL': {
'ovos-PHAL-plugin-system': {
'enabled': True
},
'ovos-PHAL-plugin-connectivity-events': {
'enabled': True
},
...
}
`ovos-config get -k phal` would yield **all** PHAL entries and present it to the user (and the path where they were found)
* Strict search (search keys in a distinct location):
`ovos-config get -k /PHAL/ovos-PHAL-plugin-system/enabled`
This will output only the value or exit out if no key is found (root slash indicating a strict search)
* `ovos-config set`
* Searches loosely for keys containing the query string and presents a choice to the user to define a value
`ovos-config set -k phal`
<img width="423" alt="ovos-config2" src="https://user-images.githubusercontent.com/25036977/219526126-dfc547e7-6110-461a-92ba-83e850d03c70.png">
The type is derived from the joined config and thus can be safely cast into the user conf.\
Optionally a value (`-v`) can be sent as an argument.
* `ovos-config autoconfigure`
![image](https://github.com/user-attachments/assets/7a39707e-ac56-498c-a269-337f4de88442)
![image](https://github.com/user-attachments/assets/01ee6b46-c3c2-4fd9-b048-5fe3f074f031)
* `ovos-config show`
* Get a full table of either the joined, user (`-u`), system (`-s`) or remote (`-r`) configuration.
This can be further refined by passing a `--section`, which can be listed with `ovos-config show -l`
Raw data
{
"_id": null,
"home_page": "https://github.com/OpenVoiceOS/ovos-config",
"name": "ovos-config",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/b1/f4/78fd738ac2185815346f584456fd5d0ea82af060267ef56f7b88e2916d3d/ovos-config-0.4.5.tar.gz",
"platform": null,
"description": "[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE.md) \n![Unit Tests](https://github.com/OpenVoiceOS/ovos-core/actions/workflows/unit_tests.yml/badge.svg)\n[![codecov](https://codecov.io/gh/OpenVoiceOS/ovos-config/branch/dev/graph/badge.svg?token=CS7WJH4PO2)](https://codecov.io/gh/OpenVoiceOS/ovos-config)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)\n[![Chat](https://img.shields.io/matrix/openvoiceos-general:matrix.org)](https://matrix.to/#/#OpenVoiceOS-general:matrix.org)\n[![GitHub Discussions](https://img.shields.io/github/discussions/OpenVoiceOS/OpenVoiceOS?label=OVOS%20Discussions)](https://github.com/OpenVoiceOS/OpenVoiceOS/discussions)\n\n# OVOS-config\n\nhelper package to interact with mycroft config\n\n## Command Line usage\n\nA small helper tool is included to quickly show, get or set config values\n\n<img width=\"1214\" alt=\"ovos-config\" src=\"https://user-images.githubusercontent.com/25036977/219516755-b454f28f-2a34-4caf-a91f-6182ff68049a.png\">\n\nQuick rundown (cli):\n\n* `ovos-config get`\n\n * Loose search (search a key or parts therof):\\\n \\\nGiven an entry of\n\n {'PHAL': {\n 'ovos-PHAL-plugin-system': {\n 'enabled': True\n },\n 'ovos-PHAL-plugin-connectivity-events': {\n 'enabled': True\n },\n ... \n }\n\n `ovos-config get -k phal` would yield **all** PHAL entries and present it to the user (and the path where they were found)\n\n\n * Strict search (search keys in a distinct location): \n\n `ovos-config get -k /PHAL/ovos-PHAL-plugin-system/enabled` \n\n This will output only the value or exit out if no key is found (root slash indicating a strict search)\n\n* `ovos-config set` \n\n * Searches loosely for keys containing the query string and presents a choice to the user to define a value\n\n `ovos-config set -k phal`\n\n <img width=\"423\" alt=\"ovos-config2\" src=\"https://user-images.githubusercontent.com/25036977/219526126-dfc547e7-6110-461a-92ba-83e850d03c70.png\">\n\n The type is derived from the joined config and thus can be safely cast into the user conf.\\\n Optionally a value (`-v`) can be sent as an argument.\n\n\n* `ovos-config autoconfigure`\n\n![image](https://github.com/user-attachments/assets/7a39707e-ac56-498c-a269-337f4de88442)\n\n![image](https://github.com/user-attachments/assets/01ee6b46-c3c2-4fd9-b048-5fe3f074f031)\n\n\n* `ovos-config show` \n\n * Get a full table of either the joined, user (`-u`), system (`-s`) or remote (`-r`) configuration.\n This can be further refined by passing a `--section`, which can be listed with `ovos-config show -l`\n\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "ovos-core configuration module",
"version": "0.4.5",
"project_urls": {
"Homepage": "https://github.com/OpenVoiceOS/ovos-config"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ebf0f970459994fc7c1fa854e8fc3a9764203d2628809076c13bb493cc4a13ce",
"md5": "7c02809f8b9ed20e03cfdef5cbfc8e0f",
"sha256": "c381ad8610578284fb7a94004728a79597eff1b1cfbf6b1ec2470639e65ad5e2"
},
"downloads": -1,
"filename": "ovos_config-0.4.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7c02809f8b9ed20e03cfdef5cbfc8e0f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 61244,
"upload_time": "2024-10-27T22:53:11",
"upload_time_iso_8601": "2024-10-27T22:53:11.302060Z",
"url": "https://files.pythonhosted.org/packages/eb/f0/f970459994fc7c1fa854e8fc3a9764203d2628809076c13bb493cc4a13ce/ovos_config-0.4.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b1f478fd738ac2185815346f584456fd5d0ea82af060267ef56f7b88e2916d3d",
"md5": "a76f5da3c8a9f7556df5ef0d62e437f0",
"sha256": "9652f57eb59a63db4f7ae83136621667fd3d51afeb4748db17e47a1c1a3cc088"
},
"downloads": -1,
"filename": "ovos-config-0.4.5.tar.gz",
"has_sig": false,
"md5_digest": "a76f5da3c8a9f7556df5ef0d62e437f0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 23954,
"upload_time": "2024-10-27T22:53:12",
"upload_time_iso_8601": "2024-10-27T22:53:12.570425Z",
"url": "https://files.pythonhosted.org/packages/b1/f4/78fd738ac2185815346f584456fd5d0ea82af060267ef56f7b88e2916d3d/ovos-config-0.4.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-27 22:53:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OpenVoiceOS",
"github_project": "ovos-config",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ovos-config"
}