Skip to main content

A Python API for interacting with Go Continuous Delivery

Project description

Coverage Status Build Status Documentation Status Latest Version Downloads Python versions Package status

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gocd-0.11.1.tar.gz (13.9 kB view details)

Uploaded Source

Built Distributions

gocd-0.11.1-py3-none-any.whl (18.4 kB view details)

Uploaded Python 3

gocd-0.11.1-py2-none-any.whl (18.4 kB view details)

Uploaded Python 2

File details

Details for the file gocd-0.11.1.tar.gz.

File metadata

  • Download URL: gocd-0.11.1.tar.gz
  • Upload date:
  • Size: 13.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for gocd-0.11.1.tar.gz
Algorithm Hash digest
SHA256 d64dd439dc0384aa90918cb6ba727735554088881fc4215b6102462179a2b65a
MD5 e2d29ac83f4e7590429e40618e43f095
BLAKE2b-256 3b8c4dbb5d104573203d810e6232c7d21d92d59a0f58acc0b0f21aba66f751d9

See more details on using hashes here.

File details

Details for the file gocd-0.11.1-py3-none-any.whl.

File metadata

File hashes

Hashes for gocd-0.11.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d201f23a07bdca72d5e08f406f7297a2464efbb765607d17451259b4b7a2ea83
MD5 60e5fdefb248eafdc4fe718406facb93
BLAKE2b-256 87b3eea6b87ac7e1e91d6f98fcb3fbe81601a9f2ba0df21b0c2ff43b1e202fd6

See more details on using hashes here.

File details

Details for the file gocd-0.11.1-py2-none-any.whl.

File metadata

File hashes

Hashes for gocd-0.11.1-py2-none-any.whl
Algorithm Hash digest
SHA256 9fbb1d3fdc7bf27750633a890b24ceb354c89f4eec1a8bf421550862d7d505ad
MD5 c82185b541df47e3a3a805ac77196275
BLAKE2b-256 44aed8e699b06ea72d8b8d67daef5759e2abf6a5701dbecd2632372a10463f32

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page