# kloch
[](https://knotsanimation.github.io/kloch/)
> [!WARNING]
> Despite being public, this repository is still in development stage and
> have not been tested extensively yet.
``kloch`` _/klˈoʃ/_ is a configuration system for launching software.
Configurations are yaml files referred as "environment profile" which specify
the parameters for one or multiple pre-defined _launchers_.
_Launchers_ are internally defined python objects that specify how to execute
a combinations of options and (optional) command.
In a very abstract way, `kloch` is a system that:
- serialize the arguments passed to a pre-defined function as yaml files.
- execute that function by unserializing the parameters provided at runtime.
`kloch` was initially designed as the environment manager layer when used with
the [rez](https://rez.readthedocs.io) package manager.
## features
- offer a CLI and a public python API
- custom config format for environment profiles:
- inheritance
- inheritance merging rules with token system
- arbitrary profile locations with flexible configuration
- plugin system for launchers
## programming distinctions
- robust logging.
- good amount of unittesting
- good documentation with a lot of doc created at code level
- python 3.7+ support (EOL was in June 2023).
- PyYAML as only mandatory external python dependency.
- flexible "meta" configuration from environment variable or config file.
- clear public and private API
## documentation
Check the detailed documentation at https://knotsanimation.github.io/kloch/
Raw data
{
"_id": null,
"home_page": null,
"name": "kloch",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "environment, kloch, packaging, managing",
"author": "Liam Collod",
"author_email": "monsieurlixm@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/50/ca/90612cb10736239752558e85b0307b19a586c71e819fb7618f20488fe205/kloch-0.11.1.tar.gz",
"platform": null,
"description": "# kloch\n\n[](https://knotsanimation.github.io/kloch/)\n\n\n\n> [!WARNING]\n> Despite being public, this repository is still in development stage and\n> have not been tested extensively yet.\n\n\n\n``kloch`` _/kl\u02c8o\u0283/_ is a configuration system for launching software. \nConfigurations are yaml files referred as \"environment profile\" which specify\nthe parameters for one or multiple pre-defined _launchers_.\n\n_Launchers_ are internally defined python objects that specify how to execute\na combinations of options and (optional) command.\n\nIn a very abstract way, `kloch` is a system that:\n- serialize the arguments passed to a pre-defined function as yaml files.\n- execute that function by unserializing the parameters provided at runtime.\n\n`kloch` was initially designed as the environment manager layer when used with\nthe [rez](https://rez.readthedocs.io) package manager.\n\n## features\n\n- offer a CLI and a public python API\n- custom config format for environment profiles:\n - inheritance\n - inheritance merging rules with token system\n- arbitrary profile locations with flexible configuration\n- plugin system for launchers\n\n## programming distinctions\n\n- robust logging.\n- good amount of unittesting\n- good documentation with a lot of doc created at code level\n- python 3.7+ support (EOL was in June 2023).\n- PyYAML as only mandatory external python dependency.\n- flexible \"meta\" configuration from environment variable or config file.\n- clear public and private API\n\n\n## documentation\n\nCheck the detailed documentation at https://knotsanimation.github.io/kloch/\n\n",
"bugtrack_url": null,
"license": "LICENSE.txt",
"summary": "Environment Manager CLI wrapping package managers calls as serialized config file",
"version": "0.11.1",
"project_urls": {
"Documentation": "https://knotsanimation.github.io/kloch/",
"github": "https://github.com/knotsanimation/kloch",
"homepage": "https://github.com/knotsanimation/kloch",
"issues": "https://github.com/knotsanimation/kloch/issues",
"releasenotes": "https://knotsanimation.github.io/kloch/changelog.html"
},
"split_keywords": [
"environment",
" kloch",
" packaging",
" managing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "015f0474770b8bd2f72af1d6fc24291bc6eae6d361b8994dbbcfd900dd3d7a39",
"md5": "47ca09bd29eb433cb3321cf8b9be8bd1",
"sha256": "3071bc544d865a7879cea32df0e8f376f4f2da18e39c5cd46981d94aa78c1432"
},
"downloads": -1,
"filename": "kloch-0.11.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "47ca09bd29eb433cb3321cf8b9be8bd1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 32612,
"upload_time": "2024-10-26T10:07:15",
"upload_time_iso_8601": "2024-10-26T10:07:15.569461Z",
"url": "https://files.pythonhosted.org/packages/01/5f/0474770b8bd2f72af1d6fc24291bc6eae6d361b8994dbbcfd900dd3d7a39/kloch-0.11.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "50ca90612cb10736239752558e85b0307b19a586c71e819fb7618f20488fe205",
"md5": "dfc4ca92a418d2f84864f2bdd3829eb2",
"sha256": "fe42ac8c3e44d73a3cfbb991db9f3988a4a6cb28f0cbda7032e77b8260a54e9b"
},
"downloads": -1,
"filename": "kloch-0.11.1.tar.gz",
"has_sig": false,
"md5_digest": "dfc4ca92a418d2f84864f2bdd3829eb2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 24364,
"upload_time": "2024-10-26T10:07:16",
"upload_time_iso_8601": "2024-10-26T10:07:16.904473Z",
"url": "https://files.pythonhosted.org/packages/50/ca/90612cb10736239752558e85b0307b19a586c71e819fb7618f20488fe205/kloch-0.11.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-26 10:07:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "knotsanimation",
"github_project": "kloch",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kloch"
}
JSON
