A Python API for interacting with Go Continuous Delivery
Project description
The reason for this project is to provide a wrapper to easily perform operations against Go. I’ve been writing a lot of shell scripts to interact with Go using curl, but when going a little further than the most basic interactions I’ve always started to feel the need for doing all of this in a proper programming language. I.e. something that is beyond bash.
I’ve chosen to use Python and version 2.6.6 and newer as my target platform, with no external dependencies, to make it really straightforward to install/run on RHEL6 and other similar stable distributions.
This library was created to support a Go CLI, to handle some common scenarios you as an admin or advanced user would do.
API documentation available on read the docs.
Usage
The main interaction point for this library is the Server class, it contains helpers to instantiate the different API endpoints.
An example interaction:
>>> from gocd import Server
>>> server = Server('http://localhost:8153', user='ba', password='secret')
>>> pipeline = server.pipeline('Example-Pipeline')
>>> response = pipeline.history()
>>> bool(response)
True
>>> response.status_code
200
>>> response.content_type
'application/json'
>>> response.is_ok
True
>>> response.body
{"pagination":{"offset":0,"total":1,"page_size":10},"pipelines":[...]"}Style
This project aims to follow the Google Python Style Guide and particularly the section on commenting the code.
Versioning
Semantic versioning is used.
License
MIT License.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file gocd-0.12.0.tar.gz.
File metadata
- Download URL: gocd-0.12.0.tar.gz
- Upload date:
- Size: 14.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0d568059df4268bb038567ee08382b5fe5ae460a1f77224b76a61c28232cfbe1 |
|
| MD5 | 006fdfa7d67e894a70308c47caddb46c |
|
| BLAKE2b-256 | 5c21a3d179d64f204e27e478edc30e5c664ac0dfd852b936d79f06df07b87be1 |
File details
Details for the file gocd-0.12.0-py3-none-any.whl.
File metadata
- Download URL: gocd-0.12.0-py3-none-any.whl
- Upload date:
- Size: 19.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | f338269f5a6826635779a7a676ab8ded91eafd1e682a4228089a423965d7b065 |
|
| MD5 | 64637abe00fda403c9b979f3b7f2f778 |
|
| BLAKE2b-256 | a243f33bd1741d5e8bbdf1f280d9aa900abf945e5cd4a563ba1ef375a16dece8 |
File details
Details for the file gocd-0.12.0-py2-none-any.whl.
File metadata
- Download URL: gocd-0.12.0-py2-none-any.whl
- Upload date:
- Size: 19.6 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 85fec97e24758a1084bc7bcde14e6f7468434f3ae69d42ab4c3df380688aa86d |
|
| MD5 | a510446d923ea3e800a4be07ff21ef85 |
|
| BLAKE2b-256 | 64e1c577346805ac767fcc097e69503ddd30da182759ae6be5acb9a6d2c59eb3 |
