The official python library for the Linode API v4 in python.
pip install linode_api4
Building from Source
To build and install this package:
- Clone this repository
See the Install on a Linode example project for a simple use case demonstrating many of the features of this library.
Tests live in the
tests directory. When invoking tests, make sure you are
in the root directory of this project. To run the full suite across all
supported python versions, use tox:
Running tox also runs pylint and coverage reports.
The test suite uses fixtures stored as JSON in
test/fixtures. These files
contain sanitized JSON responses from the API - the file name is the URL called
to produce the response, replacing any slashes with underscores.
Test classes should extend
test.base.ClientBaseCase. This provides them
LinodeClient object that is set up to work with
tests. Importantly, any GET request made by this object will be mocked to
retrieve data from the test fixtures. This includes lazy-loaded objects using
this client (and by extension related models).
When testing against requests other than GET requests,
equivalent methods for other HTTP verbs) can be used in a
with block to
mock out the intended request type. These functions accept the relative path
from the api base url that should be returned, for example:
# this should return the result of GET /linode/instances/123 with self.mock_post('/linode/instances/123'): linode = self.client.linode.instance_create('g6-standard-2', 'us-east') self.assertEqual(linode.id, 123) # passes
This library is documented with Sphinx. Docs live in the
The easiest way to build the docs is to run
sphinx-autobuild in that
Classes and functions inside the library should be annotated with sphinx-compliant docstrings which will be used to automatically generate documentation for the library. When contributing, be sure to update documentation or include new docstrings where applicable to keep the library's documentation up to date and useful.
Missing or inaccurate documentation is a bug. If you notice that the documentation for this library is out of date or unclear, please open an issue to make us aware of the problem.