Tools for charm authors and maintainers
Clone or download
johnsca Fix default value for --layer-index option (#462)
* Fix default value for --layer-index option

The implicit default of None for `--interface-service` was somehow
overwriting the actual default for `--layer-index`.

Also fix the security complaint from GitHub with the older Paramiko
version.

* Remove paramiko entirely, as it seems to be unused
Latest commit 1b1a32b Oct 12, 2018
Permalink
Failed to load latest commit information.
.github Request snap info instead of charm version (#346) Sep 26, 2017
charmtools Fix default value for --layer-index option (#462) Oct 12, 2018
helpers Switch to classic confinement (#433) Sep 14, 2018
misc Make all Python scripts follow PEP8, lint code during make check Feb 25, 2013
scripts Fixed version handling (#359) Oct 27, 2017
snap Add support for local layer-index (#460) Oct 11, 2018
tests Remove checks for home directory (#452) Oct 1, 2018
tests_functional Migrate charm-tools to cheetah3 and Py3 compatility (#397) May 10, 2018
.coveragerc Don't unit test __name__ lines Jan 14, 2014
.gitignore Add support for {pre,post}-series-upgrade hooks (#413) Jun 18, 2018
.lbox fix LP URL Dec 4, 2013
.lbox.check add lbox bits Dec 2, 2013
.travis.yml Migrate charm-tools to cheetah3 and Py3 compatility (#397) May 10, 2018
AUTHORS Import upstream version 0.3+bzr128-1~precise1 Mar 8, 2012
COPYING Re-organizing charm-tools to be juju-plugins Aug 27, 2013
GPL-3 Import upstream version 0.3+bzr128-1~precise1 Mar 8, 2012
HACKING.md Fix version in setup.py during install (#458) Oct 3, 2018
MANIFEST.in Use SNAPCRAFT_PROJECT_VERSION and uncached SNAP_REVISION in charm-ver… Nov 1, 2017
Makefile Fix version chars and add pypi release make target (#366) Oct 31, 2017
README.rst #364: Add a snapcraft build badge Oct 31, 2017
charm.1 Import upstream version 0.3+bzr128-1~precise1 Mar 8, 2012
requirements.txt Remove plugs for classic snap (#446) Sep 18, 2018
setup.cfg merge in composer Jul 29, 2015
setup.py Fix default value for --layer-index option (#462) Oct 12, 2018
tox.ini Updates for building k8s charms (#434) Aug 9, 2018

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