# Changelog

<!--next-version-placeholder-->

## v2.10.1 (2021-08-28)
### Fix
* **mixins:** Improve deprecation warning ([`57e0187`](https://github.com/python-gitlab/python-gitlab/commit/57e018772492a8522b37d438d722c643594cf580))
* **deps:** Upgrade requests to 2.25.0 (see CVE-2021-33503) ([`ce995b2`](https://github.com/python-gitlab/python-gitlab/commit/ce995b256423a0c5619e2a6c0d88e917aad315ba))

### Documentation
* **mergequests:** Gl.mergequests.list documentation was missleading ([`5b5a7bc`](https://github.com/python-gitlab/python-gitlab/commit/5b5a7bcc70a4ddd621cbd59e134e7004ad2d9ab9))

## v2.10.0 (2021-07-28)
### Feature
* **api:** Add merge_ref for merge requests ([`1e24ab2`](https://github.com/python-gitlab/python-gitlab/commit/1e24ab247cc783ae240e94f6cb379fef1e743a52))
* **api:** Add `name_regex_keep` attribute in `delete_in_bulk()` ([`e49ff3f`](https://github.com/python-gitlab/python-gitlab/commit/e49ff3f868cbab7ff81115f458840b5f6d27d96c))

### Fix
* **api:** Do not require Release name for creation ([`98cd03b`](https://github.com/python-gitlab/python-gitlab/commit/98cd03b7a3085356b5f0f4fcdb7dc729b682f481))

### Documentation
* **readme:** Move contributing docs to CONTRIBUTING.rst ([`edf49a3`](https://github.com/python-gitlab/python-gitlab/commit/edf49a3d855b1ce4e2bd8a7038b7444ff0ab5fdc))
* Add example for mr.merge_ref ([`b30b8ac`](https://github.com/python-gitlab/python-gitlab/commit/b30b8ac27d98ed0a45a13775645d77b76e828f95))
* **project:** Add example on getting a single project using name with namespace ([`ef16a97`](https://github.com/python-gitlab/python-gitlab/commit/ef16a979031a77155907f4160e4f5e159d839737))

## v2.9.0 (2021-06-28)
### Feature
* **release:** Allow to update release ([`b4c4787`](https://github.com/python-gitlab/python-gitlab/commit/b4c4787af54d9db6c1f9e61154be5db9d46de3dd))
* **api:** Add group hooks ([`4a7e9b8`](https://github.com/python-gitlab/python-gitlab/commit/4a7e9b86aa348b72925bce3af1e5d988b8ce3439))
* **api:** Remove responsibility for API inconsistencies for MR reviewers ([`3d985ee`](https://github.com/python-gitlab/python-gitlab/commit/3d985ee8cdd5d27585678f8fbb3eb549818a78eb))
* **api:** Add MR pipeline manager and deprecate pipelines() method ([`954357c`](https://github.com/python-gitlab/python-gitlab/commit/954357c49963ef51945c81c41fd4345002f9fb98))
* **api:** Add support for creating/editing reviewers in project merge requests ([`676d1f6`](https://github.com/python-gitlab/python-gitlab/commit/676d1f6565617a28ee84eae20e945f23aaf3d86f))

### Documentation
* **tags:** Remove deprecated functions ([`1b1a827`](https://github.com/python-gitlab/python-gitlab/commit/1b1a827dd40b489fdacdf0a15b0e17a1a117df40))
* **release:** Add update example ([`6254a5f`](https://github.com/python-gitlab/python-gitlab/commit/6254a5ff6f43bd7d0a26dead304465adf1bd0886))
* Make Gitlab class usable for intersphinx ([`8753add`](https://github.com/python-gitlab/python-gitlab/commit/8753add72061ea01c508a42d16a27388b1d92677))

## v2.8.0 (2021-06-10)
### Feature
* Add keys endpoint ([`a81525a`](https://github.com/python-gitlab/python-gitlab/commit/a81525a2377aaed797af0706b00be7f5d8616d22))
* **objects:** Add support for Group wikis ([#1484](https://github.com/python-gitlab/python-gitlab/issues/1484)) ([`74f5e62`](https://github.com/python-gitlab/python-gitlab/commit/74f5e62ef5bfffc7ba21494d05dbead60b59ecf0))
* **objects:** Add support for generic packages API ([`79d88bd`](https://github.com/python-gitlab/python-gitlab/commit/79d88bde9e5e6c33029e4a9f26c97404e6a7a874))
* **api:** Add deployment mergerequests interface ([`fbbc0d4`](https://github.com/python-gitlab/python-gitlab/commit/fbbc0d400015d7366952a66e4401215adff709f0))
* **objects:** Support all issues statistics endpoints ([`f731707`](https://github.com/python-gitlab/python-gitlab/commit/f731707f076264ebea65afc814e4aca798970953))
* **objects:** Add support for descendant groups API ([`1b70580`](https://github.com/python-gitlab/python-gitlab/commit/1b70580020825adf2d1f8c37803bc4655a97be41))
* **objects:** Add pipeline test report support ([`ee9f96e`](https://github.com/python-gitlab/python-gitlab/commit/ee9f96e61ab5da0ecf469c21cccaafc89130a896))
* **objects:** Add support for billable members ([`fb0b083`](https://github.com/python-gitlab/python-gitlab/commit/fb0b083a0e536a6abab25c9ad377770cc4290fe9))
* Add feature to get inherited member for project/group ([`e444b39`](https://github.com/python-gitlab/python-gitlab/commit/e444b39f9423b4a4c85cdb199afbad987df026f1))
* Add code owner approval as attribute ([`fdc46ba`](https://github.com/python-gitlab/python-gitlab/commit/fdc46baca447e042d3b0a4542970f9758c62e7b7))
* Indicate that we are a typed package ([`e4421ca`](https://github.com/python-gitlab/python-gitlab/commit/e4421caafeeb0236df19fe7b9233300727e1933b))
* Add support for lists of integers to ListAttribute ([`115938b`](https://github.com/python-gitlab/python-gitlab/commit/115938b3e5adf9a2fb5ecbfb34d9c92bf788035e))

### Fix
* Catch invalid type used to initialize RESTObject ([`c7bcc25`](https://github.com/python-gitlab/python-gitlab/commit/c7bcc25a361f9df440f9c972672e5eec3b057625))
* Functional project service test ([#1500](https://github.com/python-gitlab/python-gitlab/issues/1500)) ([`093db9d`](https://github.com/python-gitlab/python-gitlab/commit/093db9d129e0a113995501755ab57a04e461c745))
* Ensure kwargs are passed appropriately for ObjectDeleteMixin ([`4e690c2`](https://github.com/python-gitlab/python-gitlab/commit/4e690c256fc091ddf1649e48dbbf0b40cc5e6b95))
* **cli:** Add missing list filter for jobs ([`b3d1c26`](https://github.com/python-gitlab/python-gitlab/commit/b3d1c267cbe6885ee41b3c688d82890bb2e27316))
* Change mr.merge() to use 'post_data' ([`cb6a3c6`](https://github.com/python-gitlab/python-gitlab/commit/cb6a3c672b9b162f7320c532410713576fbd1cdc))
* **cli:** Fix parsing CLI objects to classnames ([`4252070`](https://github.com/python-gitlab/python-gitlab/commit/42520705a97289ac895a6b110d34d6c115e45500))
* **objects:** Return server data in cancel/retry methods ([`9fed061`](https://github.com/python-gitlab/python-gitlab/commit/9fed06116bfe5df79e6ac5be86ae61017f9a2f57))
* **objects:** Add missing group attributes ([`d20ff4f`](https://github.com/python-gitlab/python-gitlab/commit/d20ff4ff7427519c8abccf53e3213e8929905441))
* **objects:** Allow lists for filters for in all objects ([`603a351`](https://github.com/python-gitlab/python-gitlab/commit/603a351c71196a7f516367fbf90519f9452f3c55))
* Iids not working as a list in projects.issues.list() ([`45f806c`](https://github.com/python-gitlab/python-gitlab/commit/45f806c7a7354592befe58a76b7e33a6d5d0fe6e))
* Add a check to ensure the MRO is correct ([`565d548`](https://github.com/python-gitlab/python-gitlab/commit/565d5488b779de19a720d7a904c6fc14c394a4b9))

### Documentation
* Fix typo in http_delete docstring ([`5226f09`](https://github.com/python-gitlab/python-gitlab/commit/5226f095c39985d04c34e7703d60814e74be96f8))
* **api:** Add behavior in local attributes when updating objects ([`38f65e8`](https://github.com/python-gitlab/python-gitlab/commit/38f65e8e9994f58bdc74fe2e0e9b971fc3edf723))
* Fail on  warnings during sphinx build ([`cbd4d52`](https://github.com/python-gitlab/python-gitlab/commit/cbd4d52b11150594ec29b1ce52348c1086a778c8))

## 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](https://github.com/python-gitlab/python-gitlab/commit/0078f8993c38df4f02da9aaa3f7616d1c8b97095), 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
* %d replaced by %s
* 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 tutorial
* Document 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 attribute
* Fix 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 objects
* Add 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 attributes
* Add 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` attributes
* Add 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 dict
* Define `GitlabObject.__eq__()` and `__ne__()` equivalence methods
* Define 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_*` methods
  * setCredentials 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