Programmatic REST Client for GitLab
Project description
python-gitlab-api: GitLab API
This pacakge provides two things:
- a simple python class based implementation of the GitLab v4 API.
- command-line utilities to query the API via shell
See the ARCHITECTURE file
Starting using the module's classes is pretty easy:
- specify the endpoint, which is URL + authorization token (or anon access)
- use a resouce among the ones provided in gitlab.resource
- use a CRUD operation, among the ones supported for the resource
- pass paramters to the operation to filter the results
In this case it is used a predefined GitLab.com endpoint, with no token paramter passed. The Projects resource used with a Read operation will list some/all projects.
from gitlab.utils import ppjson
from gitlab.resources import Projects
from gitlab.endpoints import GitLabDotCom
ppjson(Projects(GitLabDotCom()).read())
In this case it is used a predefined GitLab.com endpoint, with a token. The Projects resource used with a Read operation will list some/all projects.
from gitlab.utils import ppjson
from gitlab.resources import Projects
from gitlab.endpoints import GitLabDotCom
ppjson(Projects(GitLabDotCom(token='SOME TOKEN')).read({'owned':True}))
## Tokens
Currently only personal access tokens are supported.
Feel free to suggest ways to introduce the support for OAuth2 contacting the author and then proposing a change with a merge request.
Utilities
Some command-line utilties which maps 1:1 to the API resources are provided as entry-points of the python package.
The utlities are meant to be used for quick scripting, but they support environmental variables and dash-dash
parameters, so that they can be used in CICD environment.
Such mapping utilities are meant to return JSON, as provided by the API.
### Package versions
Some basic version management can be used in CICD to automatically release or query about the release version of a package
- get-package-version and get-latest-package-version query the Release resource, and provide either tha latest release version or bump the next patch version based on the latest release version recorded in gitlab
- get-
Contributions
All contribution are welcome, in the best open source tradition.
Before adding missing features, please contact the author first to discuss best ways to do it.
New resources can be added via merge requests directly, as they are supposed to be really easy to add.
Project details
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 Distributions
Built Distribution
Hashes for python_gitlab_api-0.2.29-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a533de7b4d8920b1b7bbeb84f065fe64322ca4c50619feaf9114bf18cf22c987 |
|
MD5 | 3cbf672e947dff412ba4be97dd68643e |
|
BLAKE2b-256 | b2bd227e2338aa0f66b9e2874d8cd2e62dd9bc18f268ecd901534068a045f1bc |