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

Uploaded Source

Built Distributions

gocd-0.12.1-py3-none-any.whl (19.6 kB view details)

Uploaded Python 3

gocd-0.12.1-py2-none-any.whl (19.6 kB view details)

Uploaded Python 2

File details

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

File metadata

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

File hashes

Hashes for gocd-0.12.1.tar.gz
Algorithm Hash digest
SHA256 9314f1f7ebdbff3bd177057889a3d1d022dd83672f5770bab8b4561254c9c98e
MD5 c4e326bb1e7f11cd2e981de1f50986eb
BLAKE2b-256 e7235397cab1097fca7ef9ec6125e86a6c04db5798c3a71e711c16bd469bb1e6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for gocd-0.12.1-py3-none-any.whl
Algorithm Hash digest
SHA256 49fbf79bbbcbbf2569145aa13af0ddd30e321288e4937acc3e6db6fceeff885c
MD5 9fb018268a4a30d6523490b3d677b659
BLAKE2b-256 ba335309434431e8d7bdd86cdf18b9c87e17adb0b4fa15efb3c259d9087aafcd

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for gocd-0.12.1-py2-none-any.whl
Algorithm Hash digest
SHA256 1287925c3096fb04e77b83226bd9fa605eb60ae9579d9437c42c73ddb8817706
MD5 8e305a206c6643ed4d366a55eff16b1c
BLAKE2b-256 53ba7998a70cac61c802a8b805d131308c1b4a7ea3df340432d6422536a3b35a

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