Write a message to the juju log

Control a system service

Fire a data_ready, data_lost, start, or stop event on a given service.

Given the name of a registered service, return its service definition.

Local unit ID

Get relation information

Run an APT command, checking output and retrying if the fatal flag is set to True. :param: cmd: str: The apt command to run. :param:

Juju charm configuration

A list of relation_ids

Register a hook

A list of related units

The relation ID for the current relation hook

The scope for the current relation hook

Helper method that tests a set of relation data and returns True if all of the `required_keys` are present.

Install one or more packages

Generate a md5 hash of the contents of 'path' or None if not found

Create a directory

Update local apt cache

Return url without querystring or fragment

Returns True if the source can be handled. Otherwise returns a string explaining why it cannot

Return the root directory of the current charm

Returns a list of packages that require installation

Flushes any entries from function cache where the key is found in the function+args

Adds the given device entry to the /etc/fstab file

Remove the given mountpoint entry from /etc/fstab

Retrieve the relation data for each unit involved in a realtion and, if complete, store it in a list under `self[self.name]`. This

Try to download and unpack the source. Return the path to the unpacked files or raise UnhandledSource.

Install a file tree from a remote source The specified source should be a url of the form: scheme://[host]/path[#[option=value][&...

Determine if a registered service is ready, by checking its 'required_data'. A 'required_data' item can be any mapping type, and is

Returns True if all of the `required_keys` are available from any units.

Load previous copy of config from disk so that current values can be compared to previous values. :param path: File path

Return /etc/lsb-release in a dict

Handle the current hook by doing The Right Thing with the registered services.

Translate the relation settings from a single unit into a list of arguments to be passed to the Docker container. This may be called

Return previous value for this key, or None if there is no "previous" value.

Update all files for one or more registered services, and, if ready, optionally restart them. If no service names are given,

Get the json represenation of a unit's relation

Get a list of relation types supported by this charm

Get a nested dictionary of relation data for all related units

Get relations of a specific relation ID

The remote unit for the current relation hook

Save an indicator that the given service is no longer data_ready.

Save an indicator that the given service is now data_ready.

Stop one or more registered services, by name. If no service names are given, stops all registered services.

Get the unit ID for the remote unit

Determine if the given service was previously data_ready.

Returns True if all of the required_keys are available.

:param volumes: List of mutable data volumes to create. :type volumes: list :param named_volumes: Mapping of names to mutable

Can accept either a list of arg strings, or a kwarg mapping of arg names to values. If kwargs are given, the names are prepended

Register a list of services, given their definitions. Traditional charm authoring is focused on implementing hooks. That is,

Add a user to a group

Add a user to the system

Hold one or more packages

Purge one or more packages

Upgrade all packages

Cache return values for multiple executions of func + args For example:: @cached def unit_get(attribute): pass

Return true if the value for this key has changed since the last save.