Tools for charm authors and maintainers
Python Shell Other
Latest commit 316ea7e Nov 30, 2017 @cmars cmars committed with johnsca Add github.com/juju/plans-client commands. (#378)
* Add github.com/juju/plans-client commands.

* terms-client and plans-client now included in charmstore-client 2.2.3
Permalink
Failed to load latest commit information.
.github
charmtools
doc/source
helpers
misc
scripts
snap
tests
tests_functional
.coveragerc
.gitignore
.lbox fix LP URL Dec 4, 2013
.lbox.check
.travis.yml
AUTHORS
COPYING
GPL-3
HACKING.md
MANIFEST.in Use SNAPCRAFT_PROJECT_VERSION and uncached SNAP_REVISION in charm-ver… Nov 1, 2017
Makefile
README.rst
charm.1
requirements.txt
setup.cfg
setup.py
tox.ini #262: Indicate when local layers were used and from where (fixes #258) Oct 13, 2016

README.rst

Juju Charm Tools

travis build

This is a collection of tools to make writing Juju charms easier. See Juju's home page for more information.

https://jujucharms.com/

Installation

To run the latest stable release, use:

sudo snap install charm

You'll also almost certainly want to install Juju as well:

sudo snap install juju --classic

If you want to run the latest pre-release versions, you can use the other snap channels. For example:

sudo snap install charm --channel=edge

The available channels are: stable, candidate, beta, and edge.

Note: While charm-tools is also available on PyPI (for use as a Python dependency) and is generally kept up to date there with stable releases, the snap should always be used instead, if at all possible.

Usage

To see a list of available commands, use:

charm help

The most commonly used commands are the charm life-cycle commands:

charm create    # create a new charm
charm build     # build a charm using layers
charm proof     # validate a charm via the linter
charm login     # login to the charm store
charm push      # push a charm to the store
charm release   # release a pushed charm to the public
charm show      # show information about a charm in the store