Skip to main content
https://travis-ci.org/othalla/py-control-repository.svg?branch=master https://badge.fury.io/py/py-control-repository.svg https://codecov.io/gh/othalla/py-control-repository/branch/master/graph/badge.svg https://api.codacy.com/project/badge/Grade/f631643ebb164aa697cb40c63f6d8375

Py Control Repository is SDK for Pyththon which allows developpers to manage a Puppet Control Repository based on GitHub.

Install

$ pip install py-control-repository

Usage

Get Puppet Environment

control_repository = ControlRepository('myorga', 'my_control_repository', 'token')

puppet_environment = control_repository.get_environment('production')

Get all Puppet Environment

Returns the list of all Puppet Environment.

control_repository = ControlRepository('myorga', 'my_control_repository', 'token')

puppet_environments = control_repository.get_environments()

Get all Puppet Environment names

Returns the list of all Puppet Environment names.

control_repository = ControlRepository('myorga', 'my_control_repository', 'token')

puppet_environment_names = control_repository.get_environment_names()

Create a Puppet Environment

Returns the new Puppet Environment.

control_repository = ControlRepository('myorga', 'my_control_repository', 'token')

new_puppet_environments = control_repository.create_environment('source_environment_name',
                                                                'new_environment_name')

Get Puppetfile

puppetfile = puppet_environment.get_puppetfile()

List Puppet modules in Puppetfile

module_list = puppetfile.list_modules()

Add a forge module

puppetfile.add_forge_module('puppetlabs/apache', version='0.10.1')

Update a forge module

puppetfile.update_forge_module('puppetlabs/apache', '0.11.0')

Remove a forge module

puppetfile.remove_forge_module('puppetlabs/apache')

Add a git module

With no version spicified, it will install the current master branch.

puppetfile.add_git_module('custom_module', 'https://url.my.git/orga/custom_module')

You can specify a specific git reference. Supported are :

  • branch

  • ref

  • tag

  • commit

puppetfile.add_git_module('custom_module',
                          'https://url.my.git/orga/custom_module',
                          reference_type='commit',
                          reference='ae1fe')

Update a git module

Bump module version

puppetfile.update_git_module('mymodule', '12.0.2')

You can also change a module reference type and its value.

For example you have a module deployed by its master branch and want to track it by a specific tag.

puppetfile.update_git_module('mymodule', '1.0.0', reference_type='tag')

Remove a git module

puppetfile.remove_git_module('apache')

Release files for py-control-repository 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for py-control-repository 1.0.0
File Interpreter ABI Platform
py_control_repository-1.0.0-py3-none-any.whl Python 3 none any Details

Release files / py_control_repository-1.0.0-py3-none-any.whl

Download URL py_control_repository-1.0.0-py3-none-any.whl
Size 12.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
59fbd68c006679f072082c671b4a6f70221681fd94ffa03604dc1b94b1f4fb90
BLAKE2b-256 checksum
How to use checksums
796d64ab341c58b873ef9cd2696dce039518c6ce1ff1da1a075e9bdc6f114b53
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.7

Release history Release notifications | RSS feed

This release

1.0.0 This release

1 release file

0.9.0

1 release file

0.7.0

1 release file

0.6.0

1 release file

0.5.0

1 release file

0.4.0

1 release file

0.3.0

1 release file

0.2.1

1 release file

0.2.0

1 release file

0.1.2

1 release file

0.1.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page