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.0.tar.gz (13.9 kB view details)

Uploaded Source

Built Distributions

gocd-0.11.0-py3-none-any.whl (18.3 kB view details)

Uploaded Python 3

gocd-0.11.0-py2-none-any.whl (18.3 kB view details)

Uploaded Python 2

File details

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

File metadata

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

File hashes

Hashes for gocd-0.11.0.tar.gz
Algorithm Hash digest
SHA256 84f1b62a245eef928d864a8c3a2b177c8a1adc13815d39894c0d699625d37552
MD5 8974ba8c23fddefd95b1728279d1f604
BLAKE2b-256 135f3d645114f7873247ee2257912ac3d89fb55740325715ebc3eddb98d53008

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for gocd-0.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 efcafac3ed213e70b62dc84f05e418bb9caa2102c10204caf25329dc9c3b8395
MD5 11d5ee1d282f5ebe50c727b5b60bfb41
BLAKE2b-256 63726b73ea5d565025dd56f90fc11187cb24c7da3d4500e15b92deb0374433d6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for gocd-0.11.0-py2-none-any.whl
Algorithm Hash digest
SHA256 27088bf12990336b180ad9e109f23e27d812c6ab2ca3f4b41c7fd6fa44791675
MD5 910b1a66693bea49d3131ac7bfe62ba1
BLAKE2b-256 0808d68d0d6361ef86aa2777c474c93c7c1b7119ccf772fc8d2a73891f1fbd9b

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