Changelog#
v3.7.0 (2022-07-28)#
Feature#
Allow sort/ordering for project releases (
b1dd284
)cli: Add a custom help formatter (
005ba93
)Add support for iterations API (
194ee01
)groups: Add support for shared projects API (
66461ba
)issues: Add support for issue reorder API (
8703324
)namespaces: Add support for namespace existence API (
4882cb2
)Add support for group and project invitations API (
7afd340
)projects: Add support for project restore API (
4794ecc
)Add support for filtering jobs by scope (
0e1c0dd
)Add
asdict()
andto_json()
methods to Gitlab Objects (08ac071
)api: Add support for instance-level registry repositories (
284d739
)groups: Add support for group-level registry repositories (
70148c6
)Add ‘merge_pipelines_enabled’ project attribute (
fc33c93
)Support validating CI lint results (
3b1ede4
)cli: Add support for global CI lint (
3f67c4b
)objects: Add Project CI Lint support (
b213dd3
)Add support for group push rules (
b5cdc09
)api: Add support for
get
for a MR approval rule (89c18c6
)
Fix#
Support array types for most resources (
d9126cd
)Use the [] after key names for array variables in
params
(1af44ce
)runners: Fix listing for /runners/all (
c6dd57c
)config: Raise error when gitlab id provided but no config section found (
1ef7018
)config: Raise error when gitlab id provided but no config file found (
ac46c1c
)Add
get_all
param (and--get-all
) to allow passingall
to API (7c71d5d
)Results returned by
attributes
property to show updates (e5affc8
)Enable epic notes (
5fc3216
)cli: Remove irrelevant MR approval rule list filters (
0daec5f
)Ensure path elements are escaped (
5d9c198
)
Documentation#
cli: Showcase use of token scopes (
4a6f8d6
)projects: Document export with upload to URL (
03f5484
)Describe fetching existing export status (
9c5b8d5
)authors: Add John (
e2afb84
)Document CI Lint usage (
d5de4b1
)users: Add docs about listing a user’s projects (
065a1a5
)Update return type of pushrules (
53cbecc
)Describe ROPC flow in place of password authentication (
91c17b7
)readme: Remove redundant
-v
that breaks the command (c523e18
)
v3.6.0 (2022-06-28)#
Feature#
downloads: Allow streaming downloads access to response iterator (#1956) (
b644721
)api: Support head() method for get and list endpoints (
ce9216c
)api: Implement HEAD method (
90635a7
)users: Add approve and reject methods to User (
f57139d
)api: Convert gitlab.const to Enums (
c3c6086
)Add support for Protected Environments (
1dc9d0f
)users: Add ban and unban methods (
0d44b11
)docker: Provide a Debian-based slim image (
384031c
)Support mutually exclusive attributes and consolidate validation to fix board lists (#2037) (
3fa330c
)client: Introduce
iterator=True
and deprecateas_list=False
inlist()
(cdc6605
)
Fix#
Documentation#
api: Add separate section for advanced usage (
22ae101
)api: Document usage of head() methods (
f555bfb
)projects: Provide more detailed import examples (
8f8611a
)projects: Document 404 gotcha with unactivated integrations (
522ecff
)variables: Instruct users to follow GitLab rules for values (
194b6be
)api: Stop linking to python-requests.org (
49c7e83
)api: Fix incorrect docs for merge_request_approvals (#2094) (
5583eaa
)api-usage: Add import os in example (
2194a44
)Drop deprecated setuptools build_sphinx (
048d66a
)usage: Refer to upsteam docs instead of custom attributes (
ae7d3b0
)ext: Fix rendering for RequiredOptional dataclass (
4d431e5
)Documentation updates to reflect addition of mutually exclusive attributes (
24b720e
)Use
as_list=False
orall=True
in Getting started (de8c6e8
)
v3.5.0 (2022-05-28)#
Feature#
Fix#
Documentation#
v3.4.0 (2022-04-28)#
Feature#
Fix#
Documentation#
api-docs: Docs fix for application scopes (
e1ad93d
)
v3.3.0 (2022-03-28)#
Feature#
object: Add pipeline test report summary support (
a97e0cf
)
Fix#
Support RateLimit-Reset header (
4060146
)
Documentation#
v3.2.0 (2022-02-28)#
Feature#
Fix#
Documentation#
Enable gitter chat directly in docs (
bd1ecdd
)Add delete methods for runners and project artifacts (
5e711fd
)Add retry_transient infos (
bb1f054
)Add transient errors retry info (
b7a1266
)artifacts: Deprecate artifacts() and artifact() methods (
64d01ef
)Revert “chore: add temporary banner for v3” (#1864) (
7a13b9b
)
v3.1.1 (2022-01-28)#
Fix#
Documentation#
v3.1.0 (2022-01-14)#
Feature#
Fix#
cli: Add missing list filters for environments (
6f64d40
)Use url-encoded ID in all paths (
12435d7
)members: Use new *All objects for *AllManager managers (
755e0a3
)api: Services: add missing
lazy
parameter (888f332
)broken URL for FAQ about attribute-error-list (
1863f30
)remove default arguments for mergerequests.merge() (
8e589c4
)remove custom URL encoding (
3d49e5e
)
Documentation#
v3.0.0 (2022-01-05)#
Feature#
docker: Remove custom entrypoint from image (
80754a1
)cli: Allow options from args and environment variables (
ca58008
)api: Support file format for repository archive (
83dcabf
)Add support for
squash_option
in Projects (a246ce8
)cli: Do not require config file to run CLI (
92a893b
)api: Add support for Topics API (
e7559bf
)Add delete on package_file object (
124667b
)Add support for
projects.groups.list()
(68ff595
)api: Add support for epic notes (
7f4edb5
)Remove support for Python 3.6, require 3.7 or higher (
414009d
)api: Add project milestone promotion (
f068520
)api: Add merge trains (
fd73a73
)api: Add merge request approval state (
f41b093
)api: Add project label promotion (
6d7c88a
)objects: Support delete package files API (
4518046
)objects: List starred projects of a user (
47a5606
)build: Officially support and test python 3.10 (
c042ddc
)objects: Support Create and Revoke personal access token API (
e19314d
)Default to gitlab.com if no URL given (
8236281
)Allow global retry_transient_errors setup (
3b1d3a4
)
Fix#
Handle situation where GitLab does not return values (
cb824a4
)Stop encoding ‘.’ to ‘%2E’ (
702e41d
)build: Do not include docs in wheel package (
68a97ce
)api: Delete invalid ‘project-runner get’ command (#1628) (
905781b
)api: Replace deprecated attribute in delete_in_bulk() (#1536) (
c59fbdb
)objects: Rename confusing
to_project_id
argument (ce4bc0d
)Raise error if there is a 301/302 redirection (
d56a434
)build: Do not package tests in wheel (
969dccc
)
Breaking#
The gitlab CLI will now accept CLI arguments and environment variables for its global options in addition to configuration file options. This may change behavior for some workflows such as running inside GitLab CI and with certain environment variables configured. (
ca58008
)stop encoding ‘.’ to ‘%2E’. This could potentially be a breaking change for users who have incorrectly configured GitLab servers which don’t handle period ‘.’ characters correctly. (
702e41d
)A config file is no longer needed to run the CLI. python-gitlab will default to https://gitlab.com with no authentication if there is no config file provided. python-gitlab will now also only look for configuration in the provided PYTHON_GITLAB_CFG path, instead of merging it with user- and system-wide config files. If the environment variable is defined and the file cannot be opened, python-gitlab will now explicitly fail. (
92a893b
)As of python-gitlab 3.0.0, Python 3.6 is no longer supported. Python 3.7 or higher is required. (
414009d
)As of python-gitlab 3.0.0, the default branch for development has changed from
master
tomain
. (545f8ed
)remove deprecated branch protect methods in favor of the more complete protected branches API. (
9656a16
)The deprecated
name_regex
attribute has been removed in favor ofname_regex_delete
. (see https://gitlab.com/gitlab-org/gitlab/-/commit/ce99813cf54) (c59fbdb
)rename confusing
to_project_id
argument in transfer_project toproject_id
(--project-id
in CLI). This is used for the source project, not for the target namespace. (ce4bc0d
)remove deprecated constants defined in gitlab.v4.objects, and use only gitlab.const module (
3f320af
)remove deprecated tag release API. This was removed in GitLab 14.0 (
2b8a94a
)remove deprecated project.issuesstatistics in favor of project.issues_statistics (
ca7777e
)remove deprecated members.all() method in favor of members_all.list() (
4d7b848
)remove deprecated pipelines() methods in favor of pipelines.list() (
c4f5ec6
)python-gitlab will now default to gitlab.com if no URL is given (
8236281
)raise error if there is a 301/302 redirection (
d56a434
)
Documentation#
Switch to Furo and refresh introduction pages (
ee6b024
)Correct documentation for updating discussion note (
ee66f4a
)Rename documentation files to match names of code files (
ee3f865
)project: Remove redundant encoding parameter (
fed613f
)Use annotations for return types (
79e785e
)Update docs to use gitlab.const for constants (
b3b0b5f
)Only use type annotations for documentation (
b7dde0d
)Add links to the GitLab API docs (
e3b5d27
)Fix API delete key example (
b31bb05
)pipelines: Document take_ownership method (
69461f6
)api: Document the update method for project variables (
7992911
)api: Clarify job token usage with auth() (
3f423ef
)Fix a few typos (
7ea4ddc
)Consolidate changelogs and remove v3 API docs (
90da8ba
)Correct documented return type (
acabf63
)
v2.10.1 (2021-08-28)#
Fix#
Documentation#
mergequests: Gl.mergequests.list documentation was missleading (
5b5a7bc
)
v2.10.0 (2021-07-28)#
Feature#
Fix#
api: Do not require Release name for creation (
98cd03b
)
Documentation#
v2.9.0 (2021-06-28)#
Feature#
release: Allow to update release (
b4c4787
)api: Add group hooks (
4a7e9b8
)api: Remove responsibility for API inconsistencies for MR reviewers (
3d985ee
)api: Add MR pipeline manager and deprecate pipelines() method (
954357c
)api: Add support for creating/editing reviewers in project merge requests (
676d1f6
)
Documentation#
v2.8.0 (2021-06-10)#
Feature#
Add keys endpoint (
a81525a
)objects: Add support for generic packages API (
79d88bd
)api: Add deployment mergerequests interface (
fbbc0d4
)objects: Support all issues statistics endpoints (
f731707
)objects: Add support for descendant groups API (
1b70580
)objects: Add pipeline test report support (
ee9f96e
)objects: Add support for billable members (
fb0b083
)Add feature to get inherited member for project/group (
e444b39
)Add code owner approval as attribute (
fdc46ba
)Indicate that we are a typed package (
e4421ca
)Add support for lists of integers to ListAttribute (
115938b
)
Fix#
Catch invalid type used to initialize RESTObject (
c7bcc25
)Ensure kwargs are passed appropriately for ObjectDeleteMixin (
4e690c2
)cli: Add missing list filter for jobs (
b3d1c26
)Change mr.merge() to use ‘post_data’ (
cb6a3c6
)cli: Fix parsing CLI objects to classnames (
4252070
)objects: Return server data in cancel/retry methods (
9fed061
)objects: Add missing group attributes (
d20ff4f
)objects: Allow lists for filters for in all objects (
603a351
)Iids not working as a list in projects.issues.list() (
45f806c
)Add a check to ensure the MRO is correct (
565d548
)
Documentation#
v2.7.1 (2021-04-26)#
fix(files): do not url-encode file paths twice
v2.7.0 (2021-04-25)#
Bug Fixes#
update user’s bool data and avatar (3ba27ffb)
argument type was not a tuple as expected (062f8f6a)
correct some type-hints in gitlab/mixins.py (8bd31240)
only append kwargs as query parameters (b9ecc9a8)
only add query_parameters to GitlabList once (1386)
checking if RESTManager._from_parent_attrs is set (8224b406)
handling config value in _get_values_from_helper (9dfb4cd9)
let the homedir be expanded in path of helper (fc7387a0)
make secret helper more user friendly (fc2798fc)
linting issues and test (b04dd2c0)
handle tags like debian/2%2.6-21 as identifiers (b4dac5ce)
remove duplicate class definitions in v4/objects/users.py (7c4e6259)
wrong variable name (15ec41ca)
tox pep8 target, so that it can run (f518e87b)
undefined name errors (48ec9e0f)
extend wait timeout for test_delete_user() (19fde8ed)
test_update_group() dependency on ordering (e78a8d63)
honor parameter value passed (c2f8f0e7)
objects: add single get endpoint for instance audit events (c3f0a6f1)
types: prevent dir from producing duplicates (5bf7525d)
Features#
add ProjectPackageFile (#1372)
add option to add a helper to lookup token (8ecf5592)
add project audit endpoint (6660dbef)
add personal access token API (2bb16fac)
add import from bitbucket server (ff3013a2)
api,cli: make user agent configurable (4bb201b9)
issues: add missing get verb to IssueManager (f78ebe06)
objects:
add support for resource state events API (d4799c40)
add support for group audit events API (2a0fbdf9)
add Release Links API support (28d75181)
projects: add project access token api (1becef02)
users: add follow/unfollow API (e456869d)
Documentation#
correct ProjectFile.decode() documentation (b180bafd)
update doc for token helper (3ac6fa12)
better real life token lookup example (9ef83118)
v2.6.0 (2021-01-29)#
Features#
support multipart uploads (2fa3004d)
add MINIMAL_ACCESS constant (49eb3ca7)
unit tests added (f37ebf5f)
added support for pipeline bridges (05cbdc22)
adds support for project merge request approval rules (#1199) (c6fbf399)
api:
added wip filter param for merge requests (d6078f80)
added wip filter param for merge requests (aa6e80d5)
add support for user identity provider deletion (e78e1215)
tests: test label getter (a41af902)
Bug Fixes#
docs changed using the consts (650b65c3)
typo (9baa9053)
api:
use RetrieveMixin for ProjectLabelManager (1a143952)
add missing runner access_level param (92669f2e)
base: really refresh object (e1e0d8cb), closes (#1155)
cli:
write binary data to stdout buffer (0733ec6c)
add missing args for project lists (c73e2374)
v2.5.0 (2020-09-01)#
Features#
add support to resource milestone events (88f8cc78), closes #1154
add share/unshare group with group (7c6e541d)
add support for instance variables (4492fc42)
add support for Packages API (71495d12)
add endpoint for latest ref artifacts (b7a07fca)
Bug Fixes#
wrong reconfirmation parameter when updating user’s email (b5c267e1)
tests fail when using REUSE_CONTAINER option (0078f899, closes #1146
implement Gitlab’s behavior change for owned=True (99777991)
v2.4.0 (2020-07-09)#
Bug Fixes#
do not check if kwargs is none (a349b90e)
make query kwargs consistent between call in init and next (72ffa016)
pass kwargs to subsequent queries in gitlab list (1d011ac7)
merge: parse arguments as query_data (878098b7)
Features#
add NO_ACCESS const (dab4d0a1)
add masked parameter for variables command (b6339bf8)
v2.3.1 (2020-06-09)#
revert keyset pagination by default
v2.3.0 (2020-06-08)#
Features#
add group runners api (49439916)
add play command to project pipeline schedules (07b99881)
allow an environment variable to specify config location (401e702a)
api: added support in the GroupManager to upload Group avatars (28eb7eab)
services: add project service list API (fc522218)
types: add dir to RESTObject to expose attributes (cad134c0)
Bug Fixes#
use keyset pagination by default for /projects > 50000 (f86ef3bb)
config: fix duplicate code (ee2df6f1), closes (#1094)
project: add missing project parameters (ad8c67d6)
v2.2.0 (2020-04-07)#
Bug Fixes#
add missing import_project param (9b16614b)
types: do not split single value string in ListAttribute (a26e5858)
Features#
add commit GPG signature API (da7a8097)
add create from template args to ProjectManager (f493b73e)
add remote mirrors API (#1056) (4cfaa2fd)
add Gitlab Deploy Token API (01de524c)
add Group Import/Export API (#1037) (6cb9d923)
v2.1.2 (2020-03-09)#
Bug Fixes#
Fix regression, when using keyset pagination with merge requests. Related to https://github.com/python-gitlab/python-gitlab/issues/1044
v2.1.1 (2020-03-09)#
Bug Fixes#
users: update user attributes
This change was made to migate an issue in Gitlab (again). Fix available in: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/26792
v2.1.0 (2020-03-08)#
Bug Fixes#
do not require empty data dict for create() (99d959f7)
remove trailing slashes from base URL (#913) (2e396e4a)
return response with commit data (b77b945c)
remove null values from features POST data, because it fails with HTTP 500 (1ec1816d)
docs:
fix typo in user memberships example (33889bcb)
update to new set approvers call for # of approvers (8e0c5262)
update docs and tests for set_approvers (2cf12c79)
objects:
add default name data and use http post (70c0cfb6)
update set_approvers function call (65ecadcf)
update to new gitlab api for path, and args (e512cddd)
Features#
add support for user memberships API (#1009) (c313c2b0)
add support for commit revert API (#991) (5298964e)
add capability to control GitLab features per project or group (7f192b4f)
use keyset pagination by default for
all=True
(99b4484d)add support for GitLab OAuth Applications API (4e12356d)
v2.0.1 (2020-02-05)#
Changes#
users: update user attributes
This change was made to migate an issue in Gitlab. See: https://gitlab.com/gitlab-org/gitlab/issues/202070
v2.0.0 (2020-01-26)#
This releases drops support for python < 3.6#
Bug Fixes#
projects: adjust snippets to match the API (e104e213)
Features#
add global order_by option to ease pagination (d1879253)
support keyset pagination globally (0b71ba4d)
add appearance API (4c4ac5ca)
add autocompletion support (973cb8b9)
v1.15.0 (2019-12-16)#
Bug Fixes#
ignore all parameter, when as_list=True 137d72b3, closes #962
Features#
allow cfg timeout to be overrided via kwargs e9a8289a
add support for /import/github aa4d41b7
nicer stacktrace 697cda24
retry transient HTTP errors 59fe2714, closes #970
access project’s issues statistics 482e57ba, closes #966
adding project stats db0b00a9, closes #967
add variable_type/protected to projects ci variables 4724c50e
add variable_type to groups ci variables 0986c931
v1.14.0 (2019-12-07)#
Bug Fixes#
added missing attributes for project approvals 460ed63c
labels: ensure label.save() works 727f5361
project-fork:
copy create fix from ProjectPipelineManager 516307f1
correct path computation for project-fork list 44a7c278
Features#
add audit endpoint 2534020b
add project and group clusters ebd053e7
add support for include_subgroups filter adbcd83f
v1.13.0 (2019-11-02)#
Features#
add users activate, deactivate functionality (32ad6692)
send python-gitlab version as user-agent (c22d49d0)
add deployment creation (ca256a07), closes [#917]
auth: remove deprecated session auth (b751cdf4)
doc: remove refs to api v3 in docs (6beeaa99)
test: unused unittest2, type -> isinstance (33b18012)
Bug Fixes#
projects: support
approval_rules
endpoint for projects (2cef2bb4)
v1.12.1 (2019-10-07)#
Bug Fixes#
fix: fix not working without auth provided
v1.12.0 (2019-10-06)#
Features#
add support for job token
project:
implement update_submodule
add file blame api
user: add status api
Bug Fixes#
cli: fix cli command user-project list
labels: don’t mangle label name on update
todo: mark_all_as_done doesn’t return anything
v1.11.0 (2019-08-31)#
Features#
add methods to retrieve an individual project environment
group labels with subscriptable mixin
Bug Fixes#
projects: avatar uploading for projects
remove empty list default arguments
remove empty dict default arguments
add project and group label update without id to fix cli
v1.10.0 (2019-07-22)#
Features#
add mr rebase method bc4280c2
get artifact by ref and job cda11745
add support for board update 908d79fa, closes #801
add support for issue.related_merge_requests 90a36315, closes #794
Bug Fixes#
improve pickle support b4b5decb
cli:
allow –recursive parameter in repository tree 7969a78c, closes #718, #731
don’t fail when the short print attr value is None 8d1552a0, closes #717, #727
fix update value for key not working b7662039
v1.9.0 (2019-06-19)#
Features#
implement artifacts deletion
add endpoint to get the variables of a pipeline
delete ProjectPipeline
implement eq and hash methods
Allow runpy invocation of CLI tool (python -m gitlab)
add project releases api
merged new release & registry apis
Bug Fixes#
convert # to %23 in URLs
pep8 errors
use python2 compatible syntax for super
Make MemberManager.all() return a list of objects
Re-enable command specific help messages
dont ask for id attr if this is *Manager originating custom action
fix -/_ replacament for *Manager custom actions
fix repository_id marshaling in cli
register cli action for delete_in_bulk
v1.8.0 (2019-02-22)#
docs(setup): use proper readme on PyPI
docs(readme): provide commit message guidelines
fix(api): make reset_time_estimate() work again
fix: handle empty ‘Retry-After’ header from GitLab
fix: remove decode() on error_message string
chore: release tags to PyPI automatically
fix(api): avoid parameter conflicts with python and gitlab
fix(api): Don’t try to parse raw downloads
feat: Added approve & unapprove method for Mergerequests
fix all kwarg behaviour
v1.7.0 (2018-12-09)#
docs: Fix the owned/starred usage documentation
docs: Add a warning about http to https redirects
Fix the https redirection test
docs: Add a note about GroupProject limited API
Add missing comma in ProjectIssueManager _create_attrs
More flexible docker image
Add project protected tags management
cli: Print help and usage without config file
Rename MASTER_ACCESS to MAINTAINER_ACCESS
docs: Add docs build information
Use docker image with current sources
docs: Add PyYAML requirement notice
Add Gitter badge to README
docs: Add an example of pipeline schedule vars listing
cli: Exit on config parse error, instead of crashing
Add support for resource label events
docs: Fix the milestone filetring doc (iid -> iids)
docs: Fix typo in custom attributes example
Improve error message handling in exceptions
Add support for members all() method
Add access control options to protected branch creation
v1.6.0 (2018-08-25)#
docs: Don’t use hardcoded values for ids
docs: Improve the snippets examples
cli: Output: handle bytes in API responses
cli: Fix the case where we have nothing to print
Project import: fix the override_params parameter
Support group and global MR listing
Implement MR.pipelines()
MR: add the squash attribute for create/update
Added support for listing forks of a project
docs: Add/update notes about read-only objects
Raise an exception on https redirects for PUT/POST
docs: Add a FAQ
cli: Fix the project-export download
v1.5.1 (2018-06-23)#
Fix the ProjectPipelineJob base class (regression)
v1.5.0 (2018-06-22)#
Drop API v3 support
Drop GetFromListMixin
Update the sphinx extension for v4 objects
Add support for user avatar upload
Add support for project import/export
Add support for the search API
Add a global per_page config option
Add support for the discussions API
Add support for merged branches deletion
Add support for Project badges
Implement user_agent_detail for snippets
Implement commit.refs()
Add commit.merge_requests() support
Deployment: add list filters
Deploy key: add missing attributes
Add support for environment stop()
Add feature flags deletion support
Update some group attributes
Issues: add missing attributes and methods
Fix the participants() decorator
Add support for group boards
Implement the markdown rendering API
Update MR attributes
Add pipeline listing filters
Add missing project attributes
Implement runner jobs listing
Runners can be created (registered)
Implement runner token validation
Update the settings attributes
Add support for the gitlab CI lint API
Add support for group badges
Fix the IssueManager path to avoid redirections
time_stats(): use an existing attribute if available
Make ProjectCommitStatus.create work with CLI
Tests: default to python 3
ProjectPipelineJob was defined twice
Silence logs/warnings in unittests
Add support for MR approval configuration (EE)
Change post_data default value to None
Add geo nodes API support (EE)
Add support for issue links (EE)
Add support for LDAP groups (EE)
Add support for board creation/deletion (EE)
Add support for Project.pull_mirror (EE)
Add project push rules configuration (EE)
Add support for the EE license API
Add support for the LDAP groups API (EE)
Add support for epics API (EE)
Fix the non-verbose output of ProjectCommitComment
v1.4.0 (2018-05-19)#
Require requests>=2.4.2
ProjectKeys can be updated
Add support for unsharing projects (v3/v4)
cli: fix listing for json and yaml output
Fix typos in documentation
Introduce RefreshMixin
docs: Fix the time tracking examples
docs: Commits: add an example of binary file creation
cli: Allow to read args from files
Add support for recursive tree listing
cli: Restore the –help option behavior
Add basic unit tests for v4 CLI
cli: Fix listing of strings
Support downloading a single artifact file
Update docs copyright years
Implement attribute types to handle special cases
docs: fix GitLab reference for notes
Expose additional properties for Gitlab objects
Fix the impersonation token deletion example
feat: obey the rate limit
Fix URL encoding on branch methods
docs: add a code example for listing commits of a MR
docs: update service.available() example for API v4
tests: fix functional tests for python3
api-usage: bit more detail for listing with
all
More efficient .get() for group members
Add docs for the
files
arg in http_*Deprecate GetFromListMixin
v1.3.0 (2018-02-18)#
Add support for pipeline schedules and schedule variables
Clarify information about supported python version
Add manager for jobs within a pipeline
Fix wrong tag example
Update the groups documentation
Add support for MR participants API
Add support for getting list of user projects
Add Gitlab and User events support
Make trigger_pipeline return the pipeline
Config: support api_version in the global section
Gitlab can be used as context manager
Default to API v4
Add a simplified example for streamed artifacts
Add documentation about labels update
v1.2.0 (2018-01-01)#
Add mattermost service support
Add users custom attributes support
doc: Fix project.triggers.create example with v4 API
Oauth token support
Remove deprecated objects/methods
Rework authentication args handling
Add support for oauth and anonymous auth in config/CLI
Add support for impersonation tokens API
Add support for user activities
Update user docs with gitlab URLs
docs: Bad arguments in projects file documentation
Add support for user_agent_detail (issues)
Add a SetMixin
Add support for project housekeeping
Expected HTTP response for subscribe is 201
Update pagination docs for ProjectCommit
Add doc to get issue from iid
Make todo() raise GitlabTodoError on error
Add support for award emojis
Update project services docs for v4
Avoid sending empty update data to issue.save
docstrings: Explicitly document pagination arguments
docs: Add a note about password auth being removed from GitLab
Submanagers: allow having undefined parameters
ProjectFile.create(): don’t modify the input data
Update testing tools for /session removal
Update groups tests
Allow per_page to be used with generators
Add groups listing attributes
Add support for subgroups listing
Add supported python versions in setup.py
Add support for pagesdomains
Add support for features flags
Add support for project and group custom variables
Add support for user/group/project filter by custom attribute
Respect content of REQUESTS_CA_BUNDLE and *_proxy envvars
v1.1.0 (2017-11-03)#
Fix trigger variables in v4 API
Make the delete() method handle / in ids
docs: update the file upload samples
Tags release description: support / in tag names
docs: improve the labels usage documentation
Add support for listing project users
ProjectFileManager.create: handle / in file paths
Change ProjectUser and GroupProject base class
docs: document
get_create_attrs
in the API tutorialDocument the Gitlab session parameter
ProjectFileManager: custom update() method
Project: add support for printing_merge_request_link_enabled attr
Update the ssl_verify docstring
Add support for group milestones
Add support for GPG keys
Add support for wiki pages
Update the repository_blob documentation
Fix the CLI for objects without ID (API v4)
Add a contributed Dockerfile
Pagination generators: expose more information
Module’s base objects serialization
doc: Add sample code for client-side certificates
v1.0.2 (2017-09-29)#
docs: remove example usage of submanagers
Properly handle the labels attribute in ProjectMergeRequest
ProjectFile: handle / in path for delete() and save()
v1.0.1 (2017-09-21)#
Tags can be retrieved by ID
Add the server response in GitlabError exceptions
Add support for project file upload
Minor typo fix in “Switching to v4” documentation
Fix password authentication for v4
Fix the labels attrs on MR and issues
Exceptions: use a proper error message
Fix http_get method in get artifacts and job trace
CommitStatus:
sha
is parent attributeFix a couple listing calls to allow proper pagination
Add missing doc file
v1.0.0 (2017-09-08)#
Support for API v4. See http://python-gitlab.readthedocs.io/en/master/switching-to-v4.html
Support SSL verification via internal CA bundle
Docs: Add link to gitlab docs on obtaining a token
Added dependency injection support for Session
Fixed repository_compare examples
Fix changelog and release notes inclusion in sdist
Missing expires_at in GroupMembers update
Add lower-level methods for Gitlab()
v0.21.2 (2017-06-11)#
Install doc: use sudo for system commands
v4: Make MR work properly
Remove extra_attrs argument from
_raw_list
v4: Make project issues work properly
Fix urlencode() usage (python 2/3) (#268)
Fixed spelling mistake (#269)
Add new event types to ProjectHook
v0.21.1 (2017-05-25)#
Fix the manager name for jobs in the Project class
Fix the docs
v0.21 (2017-05-24)#
Add time_stats to ProjectMergeRequest
Update User options for creation and update (#246)
Add milestone.merge_requests() API
Fix docs typo (s/correspnding/corresponding/)
Support milestone start date (#251)
Add support for priority attribute in labels (#256)
Add support for nested groups (#257)
Make GroupProjectManager a subclass of ProjectManager (#255)
Available services: return a list instead of JSON (#258)
MR: add support for time tracking features (#248)
Fixed repository_tree and repository_blob path encoding (#265)
Add ‘search’ attribute to projects.list()
Initial gitlab API v4 support
Reorganise the code to handle v3 and v4 objects
Allow 202 as delete return code
Deprecate parameter related methods in gitlab.Gitlab
v0.20 (2017-03-25)#
Add time tracking support (#222)
Improve changelog (#229, #230)
Make sure that manager objects are never overwritten (#209)
Include chanlog and release notes in docs
Add DeployKey{,Manager} classes (#212)
Add support for merge request notes deletion (#227)
Properly handle extra args when listing with all=True (#233)
Implement pipeline creation API (#237)
Fix spent_time methods
Add ‘delete source branch’ option when creating MR (#241)
Provide API wrapper for cherry picking commits (#236)
Stop listing if recursion limit is hit (#234)
v0.19 (2017-02-21)#
Update project.archive() docs
Support the scope attribute in runners.list()
Add support for project runners
Add support for commit creation
Fix install doc
Add builds-email and pipelines-email services
Deploy keys: rework enable/disable
Document the dynamic aspect of objects
Add pipeline_events to ProjectHook attrs
Add due_date attribute to ProjectIssue
Handle settings.domain_whitelist, partly
{Project,Group}Member: support expires_at attribute
v0.18 (2016-12-27)#
Fix JIRA service editing for GitLab 8.14+
Add jira_issue_transition_id to the JIRA service optional fields
Added support for Snippets (new API in Gitlab 8.15)
docs: update pagination section
docs: artifacts example: open file in wb mode
CLI: ignore empty arguments
CLI: Fix wrong use of arguments
docs: Add doc for snippets
Fix duplicated data in API docs
Update known attributes for projects
sudo: always use strings
v0.17 (2016-12-02)#
README: add badges for pypi and RTD
Fix ProjectBuild.play (raised error on success)
Pass kwargs to the object factory
Add .tox to ignore to respect default tox settings
Convert response list to single data source for iid requests
Add support for boards API
Add support for Gitlab.version()
Add support for broadcast messages API
Add support for the notification settings API
Don’t overwrite attributes returned by the server
Fix bug when retrieving changes for merge request
Feature: enable / disable the deploy key in a project
Docs: add a note for python 3.5 for file content update
ProjectHook: support the token attribute
Rework the API documentation
Fix docstring for http_{username,password}
Build managers on demand on GitlabObject’s
API docs: add managers doc in GitlabObject’s
Sphinx ext: factorize the build methods
Implement
__repr__
for gitlab objectsAdd a ‘report a bug’ link on doc
Remove deprecated methods
Implement merge requests diff support
Make the manager objects creation more dynamic
Add support for templates API
Add attr ‘created_at’ to ProjectIssueNote
Add attr ‘updated_at’ to ProjectIssue
CLI: add support for project all –all
Add support for triggering a new build
Rework requests arguments (support latest requests release)
Fix
should_remove_source_branch
v0.16 (2016-10-16)#
Add the ability to fork to a specific namespace
JIRA service - add api_url to optional attributes
Fix bug: Missing coma concatenates array values
docs: branch protection notes
Create a project in a group
Add only_allow_merge_if_build_succeeds option to project objects
Add support for –all in CLI
Fix examples for file modification
Use the plural merge_requests URL everywhere
Rework travis and tox setup
Workaround gitlab setup failure in tests
Add ProjectBuild.erase()
Implement ProjectBuild.play()
v0.15.1 (2016-10-16)#
docs: improve the pagination section
Fix and test pagination
‘path’ is an existing gitlab attr, don’t use it as method argument
v0.15 (2016-08-28)#
Add a basic HTTP debug method
Run more tests in travis
Fix fork creation documentation
Add more API examples in docs
Update the ApplicationSettings attributes
Implement the todo API
Add sidekiq metrics support
Move the constants at the gitlab root level
Remove methods marked as deprecated 7 months ago
Refactor the Gitlab class
Remove _get_list_or_object() and its tests
Fix canGet attribute (typo)
Remove unused ProjectTagReleaseManager class
Add support for project services API
Add support for project pipelines
Add support for access requests
Add support for project deployments
v0.14 (2016-08-07)#
Remove ‘next_url’ from kwargs before passing it to the cls constructor.
List projects under group
Add support for subscribe and unsubscribe in issues
Project issue: doc and CLI for (un)subscribe
Added support for HTTP basic authentication
Add support for build artifacts and trace
–title is a required argument for ProjectMilestone
Commit status: add optional context url
Commit status: optional get attrs
Add support for commit comments
Issues: add optional listing parameters
Issues: add missing optional listing parameters
Project issue: proper update attributes
Add support for project-issue move
Update ProjectLabel attributes
Milestone: optional listing attrs
Add support for namespaces
Add support for label (un)subscribe
MR: add (un)subscribe support
Add
note_events
to project hooks attributesAdd code examples for a bunch of resources
Implement user emails support
Project: add VISIBILITY_* constants
Fix the Project.archive call
Implement archive/unarchive for a projet
Update ProjectSnippet attributes
Fix ProjectMember update
Implement sharing project with a group
Implement CLI for project archive/unarchive/share
Implement runners global API
Gitlab: add managers for build-related resources
Implement ProjectBuild.keep_artifacts
Allow to stream the downloads when appropriate
Groups can be updated
Replace Snippet.Content() with a new content() method
CLI: refactor _die()
Improve commit statuses and comments
Add support from listing group issues
Added a new project attribute to enable the container registry.
Add a contributing section in README
Add support for global deploy key listing
Add support for project environments
MR: get list of changes and commits
Fix the listing of some resources
MR: fix updates
Handle empty messages from server in exceptions
MR (un)subscribe: don’t fail if state doesn’t change
MR merge(): update the object
v0.13 (2016-05-16)#
Add support for MergeRequest validation
MR: add support for cancel_merge_when_build_succeeds
MR: add support for closes_issues
Add “external” parameter for users
Add deletion support for issues and MR
Add missing group creation parameters
Add a Session instance for all HTTP requests
Enable updates on ProjectIssueNotes
Add support for Project raw_blob
Implement project compare
Implement project contributors
Drop the next_url attribute when listing
Remove unnecessary canUpdate property from ProjectIssuesNote
Add new optional attributes for projects
Enable deprecation warnings for gitlab only
Rework merge requests update
Rework the Gitlab.delete method
ProjectFile: file_path is required for deletion
Rename some methods to better match the API URLs
Deprecate the file_* methods in favor of the files manager
Implement star/unstar for projects
Implement list/get licenses
Manage optional parameters for list() and get()
v0.12.2 (2016-03-19)#
Add new
ProjectHook
attributesAdd support for user block/unblock
Fix GitlabObject creation in _custom_list
Add support for more CLI subcommands
Add some unit tests for CLI
Add a coverage tox env
Define
GitlabObject.as_dict()
to dump object as a dictDefine
GitlabObject.__eq__()
and__ne__()
equivalence methodsDefine UserManager.search() to search for users
Define UserManager.get_by_username() to get a user by username
Implement “user search” CLI
Improve the doc for UserManager
CLI: implement user get-by-username
Re-implement _custom_list in the Gitlab class
Fix the ‘invalid syntax’ error on Python 3.2
Gitlab.update(): use the proper attributes if defined
v0.12.1 (2016-02-03)#
Fix a broken upload to pypi
v0.12 (2016-02-03)#
Improve documentation
Improve unit tests
Improve test scripts
Skip BaseManager attributes when encoding to JSON
Fix the json() method for python 3
Add Travis CI support
Add a decode method for ProjectFile
Make connection exceptions more explicit
Fix ProjectLabel get and delete
Implement ProjectMilestone.issues()
ProjectTag supports deletion
Implement setting release info on a tag
Implement project triggers support
Implement project variables support
Add support for application settings
Fix the ‘password’ requirement for User creation
Add sudo support
Fix project update
Fix Project.tree()
Add support for project builds
v0.11.1 (2016-01-17)#
Fix discovery of parents object attrs for managers
Support setting commit status
Support deletion without getting the object first
Improve the documentation
v0.11 (2016-01-09)#
functional_tests.sh: support python 2 and 3
Add a get method for GitlabObject
CLI: Add the -g short option for –gitlab
Provide a create method for GitlabObject’s
Rename the
_created
attribute_from_api
More unit tests
CLI: fix error when arguments are missing (python 3)
Remove deprecated methods
Implement managers to get access to resources
Documentation improvements
Add fork project support
Deprecate the “old” Gitlab methods
Add support for groups search
v0.10 (2015-12-29)#
Implement pagination for list() (#63)
Fix url when fetching a single MergeRequest
Add support to update MergeRequestNotes
API: Provide a Gitlab.from_config method
setup.py: require requests>=1 (#69)
Fix deletion of object not using ‘id’ as ID (#68)
Fix GET/POST for project files
Make ‘confirm’ an optional attribute for user creation
Python 3 compatibility fixes
Add support for group members update (#73)
v0.9.2 (2015-07-11)#
CLI: fix the update and delete subcommands (#62)
v0.9.1 (2015-05-15)#
Fix the setup.py script
v0.9 (2015-05-15)#
Implement argparse library for parsing argument on CLI
Provide unit tests and (a few) functional tests
Provide PEP8 tests
Use tox to run the tests
CLI: provide a –config-file option
Turn the gitlab module into a proper package
Allow projects to be updated
Use more pythonic names for some methods
Deprecate some Gitlab object methods:
raw*
methods should never have been exposed; replace them with_raw_*
methodssetCredentials and setToken are replaced with set_credentials and set_token
Sphinx: don’t hardcode the version in
conf.py
v0.8 (2014-10-26)#
Better python 2.6 and python 3 support
Timeout support in HTTP requests
Gitlab.get() raised GitlabListError instead of GitlabGetError
Support api-objects which don’t have id in api response
Add ProjectLabel and ProjectFile classes
Moved url attributes to separate list
Added list for delete attributes
v0.7 (2014-08-21)#
Fix license classifier in
setup.py
Fix encoding error when printing to redirected output
Fix encoding error when updating with redirected output
Add support for UserKey listing and deletion
Add support for branches creation and deletion
Support state_event in ProjectMilestone (#30)
Support namespace/name for project id (#28)
Fix handling of boolean values (#22)
v0.6 (2014-01-16)#
IDs can be unicode (#15)
ProjectMember: constructor should not create a User object
Add support for extra parameters when listing all projects (#12)
Projects listing: explicitly define arguments for pagination
v0.5 (2013-12-26)#
Add SSH key for user
Fix comments
Add support for project events
Support creation of projects for users
Project: add methods for create/update/delete files
Support projects listing: search, all, owned
System hooks can’t be updated
Project.archive(): download tarball of the project
Define new optional attributes for user creation
Provide constants for access permissions in groups
v0.4 (2013-09-26)#
Fix strings encoding (Closes #6)
Allow to get a project commit (GitLab 6.1)
ProjectMergeRequest: fix Note() method
Gitlab 6.1 methods: diff, blob (commit), tree, blob (project)
Add support for Gitlab 6.1 group members
v0.3 (2013-08-27)#
Use PRIVATE-TOKEN header for passing the auth token
provide an AUTHORS file
cli: support ssl_verify config option
Add ssl_verify option to Gitlab object. Defaults to True
Correct url for merge requests API.
v0.2 (2013-08-08)#
provide a pip requirements.txt
drop some debug statements
v0.1 (2013-07-08)#
Initial release