| Name | charmcraft JSON |
| Version |
3.5.3
JSON |
| download |
| home_page | None |
| Summary | The main tool to build, upload, and develop in general the Juju charms. |
| upload_time | 2025-08-13 21:06:40 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Charmcraft
[![Charmcraft][charmcraft-badge]](charmcraft-latest)
[![Documentation Status][rtd-badge]](rtd-latest)
[![Tests][tests-badge]](tests-results)
[![Spread][spread-badge]](spread-results)
[![Weekly Spread][weekly-spread-badge]](weekly-spread-results)
**Charmcraft** is the command-line tool for initializing, packaging, and publishing
charms, the software operators used by Juju. With Charmcraft, you can bypass the
boilerplate steps of crafting a charm and focus on what matters — building scalable,
configurable, and easy-to-deploy applications for Juju.
## Basic usage
Charmcraft provides commands to streamline every step of the charm development process,
from initializing your charm project to releasing it on Charmhub.
In your project's root directory, initialize your charm project with basic template
content by running:
```bash
charmcraft init
```
Once you've configured your project to suit the needs of the application you're
charming, build the charm by running:
```bash
charmcraft pack
```
If you're ready to distribute your charm, you can register its name on Charmhub with:
```bash
charmcraft register
```
Upload your charm and any subsequent revisions to Charmhub with:
```bash
charmcraft upload
```
## Installation
Charmcraft is available on all major Linux distributions and macOS.
The recommended way to install Charmcraft on Linux systems is through its
[snap](https://snapcraft.io/charmcraft).
```bash
sudo snap install charmcraft --classic
```
For information on installing Charmcraft on other platforms, refer to our [installation
guide](https://canonical-charmcraft.readthedocs-hosted.com/en/stable/howto/set-up-charmcraft).
## Documentation
The [Charmcraft
documentation](https://canonical-charmcraft.readthedocs-hosted.com/en/stable/) provides
guidance and learning materials for every step of the charming process. Whether you're
new to charming or a seasoned expert, this is the best place to deepen your knowledge.
## Community and support
To get in touch with developers and other
[charmcraft-badge]: https://snapcraft.io/charmcraft/badge.svg
[charmcraft-site]: https://snapcraft.io/charmcraft members of the charming community, reach
out on the [forum](https://discourse.charmhub.io) or in our [Matrix
channel](https://matrix.to/#/#charmhub-charmcraft:ubuntu.com).
You can report any issues or bugs on the project's [GitHub
repository](https://github.com/canonical/charmcraft/issues).
Charmcraft is covered by the [Ubuntu Code of
Conduct](https://ubuntu.com/community/ethos/code-of-conduct).
## Contribute to Charmcraft
Charmcraft is open source and part of the Canonical family. We would love your help.
If you're interested, start with the [contribution guide](CONTRIBUTING.md).
We welcome any suggestions and help with the docs. The [Canonical Open Documentation
Academy](https://github.com/canonical/open-documentation-academy) is the hub for doc
development, including Charmcraft docs. No prior coding experience is required.
## License and copyright
Charmcraft is released under the [Apache-2.0 license](LICENSE)
© 2023-2025 Canonical Ltd.
[charmcraft-badge]: https://snapcraft.io/charmcraft/badge.svg
[charmcraft-site]: https://snapcraft.io/charmcraft
[rtd-badge]: https://readthedocs.com/projects/canonical-charmcraft/badge/?version=latest
[rtd-latest]: https://canonical-charmcraft.readthedocs-hosted.com/en/latest/?badge=latest
[tests-badge]: https://github.com/canonical/charmcraft/actions/workflows/tests.yaml/badge.svg?event=push
[tests-results]: https://github.com/canonical/charmcraft/actions/workflows/tests.yaml
[spread-badge]: https://github.com/canonical/charmcraft/actions/workflows/spread.yaml/badge.svg?event=push
[spread-results]: https://github.com/canonical/charmcraft/actions/workflows/spread.yaml
[weekly-spread-badge]: https://github.com/canonical/charmcraft/actions/workflows/spread-large.yaml/badge.svg
[weekly-spread-results]: https://github.com/canonical/charmcraft/actions/workflows/spread-large.yaml
Raw data
{
"_id": null,
"home_page": null,
"name": "charmcraft",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/48/e7/0528770d02d99ab1d840b69131fba020294e84da734e18fb8f41735fdc63/charmcraft-3.5.3.tar.gz",
"platform": null,
"description": "# Charmcraft\n\n[![Charmcraft][charmcraft-badge]](charmcraft-latest)\n[![Documentation Status][rtd-badge]](rtd-latest)\n[![Tests][tests-badge]](tests-results)\n[![Spread][spread-badge]](spread-results)\n[![Weekly Spread][weekly-spread-badge]](weekly-spread-results)\n\n**Charmcraft** is the command-line tool for initializing, packaging, and publishing\ncharms, the software operators used by Juju. With Charmcraft, you can bypass the\nboilerplate steps of crafting a charm and focus on what matters \u2014 building scalable,\nconfigurable, and easy-to-deploy applications for Juju.\n\n## Basic usage\n\nCharmcraft provides commands to streamline every step of the charm development process,\nfrom initializing your charm project to releasing it on Charmhub.\n\nIn your project's root directory, initialize your charm project with basic template\ncontent by running:\n\n```bash\ncharmcraft init\n```\n\nOnce you've configured your project to suit the needs of the application you're\ncharming, build the charm by running:\n\n```bash\ncharmcraft pack\n```\n\nIf you're ready to distribute your charm, you can register its name on Charmhub with:\n\n```bash\ncharmcraft register\n```\n\nUpload your charm and any subsequent revisions to Charmhub with:\n\n```bash\ncharmcraft upload\n```\n\n## Installation\n\nCharmcraft is available on all major Linux distributions and macOS.\n\nThe recommended way to install Charmcraft on Linux systems is through its\n[snap](https://snapcraft.io/charmcraft).\n\n```bash\nsudo snap install charmcraft --classic\n```\n\nFor information on installing Charmcraft on other platforms, refer to our [installation\nguide](https://canonical-charmcraft.readthedocs-hosted.com/en/stable/howto/set-up-charmcraft).\n\n## Documentation\n\nThe [Charmcraft\ndocumentation](https://canonical-charmcraft.readthedocs-hosted.com/en/stable/) provides\nguidance and learning materials for every step of the charming process. Whether you're\nnew to charming or a seasoned expert, this is the best place to deepen your knowledge.\n\n## Community and support\n\nTo get in touch with developers and other\n[charmcraft-badge]: https://snapcraft.io/charmcraft/badge.svg\n[charmcraft-site]: https://snapcraft.io/charmcraft members of the charming community, reach\nout on the [forum](https://discourse.charmhub.io) or in our [Matrix\nchannel](https://matrix.to/#/#charmhub-charmcraft:ubuntu.com).\n\nYou can report any issues or bugs on the project's [GitHub\nrepository](https://github.com/canonical/charmcraft/issues).\n\nCharmcraft is covered by the [Ubuntu Code of\nConduct](https://ubuntu.com/community/ethos/code-of-conduct).\n\n## Contribute to Charmcraft\n\nCharmcraft is open source and part of the Canonical family. We would love your help.\n\nIf you're interested, start with the [contribution guide](CONTRIBUTING.md).\n\nWe welcome any suggestions and help with the docs. The [Canonical Open Documentation\nAcademy](https://github.com/canonical/open-documentation-academy) is the hub for doc\ndevelopment, including Charmcraft docs. No prior coding experience is required.\n\n## License and copyright\n\nCharmcraft is released under the [Apache-2.0 license](LICENSE)\n\n\u00a9 2023-2025 Canonical Ltd.\n\n[charmcraft-badge]: https://snapcraft.io/charmcraft/badge.svg\n[charmcraft-site]: https://snapcraft.io/charmcraft\n[rtd-badge]: https://readthedocs.com/projects/canonical-charmcraft/badge/?version=latest\n[rtd-latest]: https://canonical-charmcraft.readthedocs-hosted.com/en/latest/?badge=latest\n[tests-badge]: https://github.com/canonical/charmcraft/actions/workflows/tests.yaml/badge.svg?event=push\n[tests-results]: https://github.com/canonical/charmcraft/actions/workflows/tests.yaml\n[spread-badge]: https://github.com/canonical/charmcraft/actions/workflows/spread.yaml/badge.svg?event=push\n[spread-results]: https://github.com/canonical/charmcraft/actions/workflows/spread.yaml\n[weekly-spread-badge]: https://github.com/canonical/charmcraft/actions/workflows/spread-large.yaml/badge.svg\n[weekly-spread-results]: https://github.com/canonical/charmcraft/actions/workflows/spread-large.yaml\n",
"bugtrack_url": null,
"license": null,
"summary": "The main tool to build, upload, and develop in general the Juju charms.",
"version": "3.5.3",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "930f177a471c28b6593d0a53d4cebc285b5ca01863535843dac5090549f10dab",
"md5": "622a2b77b37b346c782ffe2c3b2b440e",
"sha256": "1df3772be3c6d3f55e3c9f9a89f59a3b8c675ffd651af6e0d06d5170cbff6df2"
},
"downloads": -1,
"filename": "charmcraft-3.5.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "622a2b77b37b346c782ffe2c3b2b440e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 233528,
"upload_time": "2025-08-13T21:06:39",
"upload_time_iso_8601": "2025-08-13T21:06:39.044408Z",
"url": "https://files.pythonhosted.org/packages/93/0f/177a471c28b6593d0a53d4cebc285b5ca01863535843dac5090549f10dab/charmcraft-3.5.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "48e70528770d02d99ab1d840b69131fba020294e84da734e18fb8f41735fdc63",
"md5": "ffef473b867f4520e22050a4d9ea0203",
"sha256": "9e3e10af1cb707d3e054a79e328bffd42eb70721255b9e7715fcb66a8c87cf8f"
},
"downloads": -1,
"filename": "charmcraft-3.5.3.tar.gz",
"has_sig": false,
"md5_digest": "ffef473b867f4520e22050a4d9ea0203",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 718620,
"upload_time": "2025-08-13T21:06:40",
"upload_time_iso_8601": "2025-08-13T21:06:40.730580Z",
"url": "https://files.pythonhosted.org/packages/48/e7/0528770d02d99ab1d840b69131fba020294e84da734e18fb8f41735fdc63/charmcraft-3.5.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-13 21:06:40",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "charmcraft"
}
