Bug Fixes
- **cli**: Add _from_parent_attrs to user-project manager
([2558](https://github.com/python-gitlab/python-gitlab/pull/2558),
[`016d90c`](https://github.com/python-gitlab/python-gitlab/commit/016d90c3c22bfe6fc4e866d120d2c849764ef9d2))
- **cli**: Fix action display in --help when there are few actions
([`b22d662`](https://github.com/python-gitlab/python-gitlab/commit/b22d662a4fd8fb8a9726760b645d4da6197bfa9a))
fixes 2656
- **cli**: Remove deprecated `--all` option in favor of `--get-all`
([`e9d48cf`](https://github.com/python-gitlab/python-gitlab/commit/e9d48cf69e0dbe93f917e6f593d31327cd99f917))
BREAKING CHANGE: The `--all` option is no longer available in the CLI. Use `--get-all` instead.
- **client**: Support empty 204 responses in http_patch
([`e15349c`](https://github.com/python-gitlab/python-gitlab/commit/e15349c9a796f2d82f72efbca289740016c47716))
- **snippets**: Allow passing list of files
([`31c3c5e`](https://github.com/python-gitlab/python-gitlab/commit/31c3c5ea7cbafb4479825ec40bc34e3b8cb427fd))
Chores
- Add package pipelines API link
([`2a2404f`](https://github.com/python-gitlab/python-gitlab/commit/2a2404fecdff3483a68f538c8cd6ba4d4fc6538c))
- Change `_update_uses` to `_update_method` and use an Enum
([`7073a2d`](https://github.com/python-gitlab/python-gitlab/commit/7073a2dfa3a4485d2d3a073d40122adbeff42b5c))
Change the name of the `_update_uses` attribute to `_update_method` and store an Enum in the
attribute to indicate which type of HTTP method to use. At the moment it supports `POST` and
`PUT`. But can in the future support `PATCH`.
- Fix test names
([`f1654b8`](https://github.com/python-gitlab/python-gitlab/commit/f1654b8065a7c8349777780e673aeb45696fccd0))
- Make linters happy
([`3b83d5d`](https://github.com/python-gitlab/python-gitlab/commit/3b83d5d13d136f9a45225929a0c2031dc28cdbed))
- Switch to docker-compose v2
([`713b5ca`](https://github.com/python-gitlab/python-gitlab/commit/713b5ca272f56b0fd7340ca36746e9649a416aa2))
Closes: 2625
- Update PyYAML to 6.0.1
([`3b8939d`](https://github.com/python-gitlab/python-gitlab/commit/3b8939d7669f391a5a7e36d623f8ad6303ba7712))
Fixes issue with CI having error: `AttributeError: cython_sources`
Closes: 2624
- **ci**: Adapt release workflow and config for v8
([`827fefe`](https://github.com/python-gitlab/python-gitlab/commit/827fefeeb7bf00e5d8fa142d7686ead97ca4b763))
- **ci**: Fix pre-commit deps and python version
([`1e7f257`](https://github.com/python-gitlab/python-gitlab/commit/1e7f257e79a7adf1e6f2bc9222fd5031340d26c3))
- **ci**: Follow upstream config for release build_command
([`3e20a76`](https://github.com/python-gitlab/python-gitlab/commit/3e20a76fdfc078a03190939bda303577b2ef8614))
- **ci**: Remove Python 3.13 dev job
([`e8c50f2`](https://github.com/python-gitlab/python-gitlab/commit/e8c50f28da7e3879f0dc198533041348a14ddc68))
- **ci**: Update release build for python-semantic-release v8
([2692](https://github.com/python-gitlab/python-gitlab/pull/2692),
[`bf050d1`](https://github.com/python-gitlab/python-gitlab/commit/bf050d19508978cbaf3e89d49f42162273ac2241))
- **deps**: Bring furo up to date with sphinx
([`a15c927`](https://github.com/python-gitlab/python-gitlab/commit/a15c92736f0cf78daf78f77fb318acc6c19036a0))
- **deps**: Bring myst-parser up to date with sphinx 7
([`da03e9c`](https://github.com/python-gitlab/python-gitlab/commit/da03e9c7dc1c51978e51fedfc693f0bce61ddaf1))
- **deps**: Pin pytest-console-scripts for 3.7
([`6d06630`](https://github.com/python-gitlab/python-gitlab/commit/6d06630cac1a601bc9a17704f55dcdc228285e88))
- **deps**: Update actions/checkout action to v3
([`e2af1e8`](https://github.com/python-gitlab/python-gitlab/commit/e2af1e8a964fe8603dddef90a6df62155f25510d))
- **deps**: Update actions/checkout action to v4
([`af13914`](https://github.com/python-gitlab/python-gitlab/commit/af13914e41f60cc2c4ef167afb8f1a10095e8a00))
- **deps**: Update actions/setup-python action to v4
([`e0d6783`](https://github.com/python-gitlab/python-gitlab/commit/e0d6783026784bf1e6590136da3b35051e7edbb3))
- **deps**: Update actions/upload-artifact action to v3
([`b78d6bf`](https://github.com/python-gitlab/python-gitlab/commit/b78d6bfd18630fa038f5f5bd8e473ec980495b10))
- **deps**: Update all non-major dependencies
([`1348a04`](https://github.com/python-gitlab/python-gitlab/commit/1348a040207fc30149c664ac0776e698ceebe7bc))
- **deps**: Update all non-major dependencies
([`ff45124`](https://github.com/python-gitlab/python-gitlab/commit/ff45124e657c4ac4ec843a13be534153a8b10a20))
- **deps**: Update all non-major dependencies
([`0d49164`](https://github.com/python-gitlab/python-gitlab/commit/0d491648d16f52f5091b23d0e3e5be2794461ade))
- **deps**: Update all non-major dependencies
([`6093dbc`](https://github.com/python-gitlab/python-gitlab/commit/6093dbcf07b9edf35379142ea58a190050cf7fe7))
- **deps**: Update all non-major dependencies
([`bb728b1`](https://github.com/python-gitlab/python-gitlab/commit/bb728b1c259dba5699467c9ec7a51b298a9e112e))
- **deps**: Update all non-major dependencies
([`9083787`](https://github.com/python-gitlab/python-gitlab/commit/9083787f0855d94803c633b0491db70f39a9867a))
- **deps**: Update all non-major dependencies
([`b6a3db1`](https://github.com/python-gitlab/python-gitlab/commit/b6a3db1a2b465a34842d1a544a5da7eee6430708))
- **deps**: Update all non-major dependencies
([`16f2d34`](https://github.com/python-gitlab/python-gitlab/commit/16f2d3428e673742a035856b1fb741502287cc1d))
- **deps**: Update all non-major dependencies
([`5b33ade`](https://github.com/python-gitlab/python-gitlab/commit/5b33ade92152e8ccb9db3eb369b003a688447cd6))
- **deps**: Update all non-major dependencies
([`3732841`](https://github.com/python-gitlab/python-gitlab/commit/37328416d87f50f64c9bdbdcb49e9b9a96d2d0ef))
- **deps**: Update all non-major dependencies
([`511f45c`](https://github.com/python-gitlab/python-gitlab/commit/511f45cda08d457263f1011b0d2e013e9f83babc))
- **deps**: Update all non-major dependencies
([`d4a7410`](https://github.com/python-gitlab/python-gitlab/commit/d4a7410e55c6a98a15f4d7315cc3d4fde0190bce))
- **deps**: Update all non-major dependencies
([`12846cf`](https://github.com/python-gitlab/python-gitlab/commit/12846cfe4a0763996297bb0a43aa958fe060f029))
- **deps**: Update all non-major dependencies
([`33d2aa2`](https://github.com/python-gitlab/python-gitlab/commit/33d2aa21035515711738ac192d8be51fd6106863))
- **deps**: Update all non-major dependencies
([`5ff56d8`](https://github.com/python-gitlab/python-gitlab/commit/5ff56d866c6fdac524507628cf8baf2c498347af))
- **deps**: Update all non-major dependencies
([`7586a5c`](https://github.com/python-gitlab/python-gitlab/commit/7586a5c80847caf19b16282feb25be470815729b))
- **deps**: Update all non-major dependencies to v23.9.1
([`a16b732`](https://github.com/python-gitlab/python-gitlab/commit/a16b73297a3372ce4f3ada3b4ea99680dbd511f6))
- **deps**: Update dependency build to v1
([`2e856f2`](https://github.com/python-gitlab/python-gitlab/commit/2e856f24567784ddc35ca6895d11bcca78b58ca4))
- **deps**: Update dependency commitizen to v3.10.0
([`becd8e2`](https://github.com/python-gitlab/python-gitlab/commit/becd8e20eb66ce4e606f22c15abf734a712c20c3))
- **deps**: Update dependency pylint to v3
([`491350c`](https://github.com/python-gitlab/python-gitlab/commit/491350c40a74bbb4945dfb9f2618bcc5420a4603))
- **deps**: Update dependency pytest-docker to v2
([`b87bb0d`](https://github.com/python-gitlab/python-gitlab/commit/b87bb0db1441d1345048664b15bd8122e6b95be4))
- **deps**: Update dependency setuptools to v68
([`0f06082`](https://github.com/python-gitlab/python-gitlab/commit/0f06082272f7dbcfd79f895de014cafed3205ff6))
- **deps**: Update dependency sphinx to v7
([`2918dfd`](https://github.com/python-gitlab/python-gitlab/commit/2918dfd78f562e956c5c53b79f437a381e51ebb7))
- **deps**: Update dependency types-setuptools to v68
([`bdd4eb6`](https://github.com/python-gitlab/python-gitlab/commit/bdd4eb694f8b56d15d33956cb982a71277ca907f))
- **deps**: Update dependency ubuntu to v22
([`8865552`](https://github.com/python-gitlab/python-gitlab/commit/88655524ac2053f5b7016457f8c9d06a4b888660))
- **deps**: Update pre-commit hook commitizen-tools/commitizen to v3.10.0
([`626c2f8`](https://github.com/python-gitlab/python-gitlab/commit/626c2f8879691e5dd4ce43118668e6a88bf6f7ad))
- **deps**: Update pre-commit hook maxbrunet/pre-commit-renovate to v36
([`db58cca`](https://github.com/python-gitlab/python-gitlab/commit/db58cca2e2b7d739b069904cb03f42c9bc1d3810))
- **deps**: Update pre-commit hook maxbrunet/pre-commit-renovate to v37
([`b4951cd`](https://github.com/python-gitlab/python-gitlab/commit/b4951cd273d599e6d93b251654808c6eded2a960))
- **deps**: Update pre-commit hook pycqa/pylint to v3
([`0f4a346`](https://github.com/python-gitlab/python-gitlab/commit/0f4a34606f4df643a5dbae1900903bcf1d47b740))
- **deps**: Update relekang/python-semantic-release action to v8
([`c57c85d`](https://github.com/python-gitlab/python-gitlab/commit/c57c85d0fc6543ab5a2322fc58ec1854afc4f54f))
- **helpers**: Fix previously undetected flake8 issue
([`bf8bd73`](https://github.com/python-gitlab/python-gitlab/commit/bf8bd73e847603e8ac5d70606f9393008eee1683))
- **rtd**: Fix docs build on readthedocs.io
([2654](https://github.com/python-gitlab/python-gitlab/pull/2654),
[`3d7139b`](https://github.com/python-gitlab/python-gitlab/commit/3d7139b64853cb0da46d0ef6a4bccc0175f616c2))
- **rtd**: Use readthedocs v2 syntax
([`6ce2149`](https://github.com/python-gitlab/python-gitlab/commit/6ce214965685a3e73c02e9b93446ad8d9a29262e))
Documentation
- Correct error with back-ticks ([2653](https://github.com/python-gitlab/python-gitlab/pull/2653),
[`0b98dd3`](https://github.com/python-gitlab/python-gitlab/commit/0b98dd3e92179652806a7ae8ccc7ec5cddd2b260))
New linting package update detected the issue.
- **access_token**: Adopt token docs to 16.1
([`fe7a971`](https://github.com/python-gitlab/python-gitlab/commit/fe7a971ad3ea1e66ffc778936296e53825c69f8f))
expires_at is now required Upstream MR: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/124964
- **advanced**: Document new netrc behavior
([`45b8930`](https://github.com/python-gitlab/python-gitlab/commit/45b89304d9745be1b87449805bf53d45bf740e90))
BREAKING CHANGE: python-gitlab now explicitly passes auth to requests, meaning it will only read
netrc credentials if no token is provided, fixing a bug where netrc credentials took precedence
over OAuth tokens. This also affects the CLI, where all environment variables now take precedence
over netrc files.
- **files**: Fix minor typo in variable declaration
([`118ce42`](https://github.com/python-gitlab/python-gitlab/commit/118ce4282abc4397c4e9370407b1ab6866de9f97))
Features
- Added iteration to issue and group filters
([`8d2d297`](https://github.com/python-gitlab/python-gitlab/commit/8d2d2971c3909fb5461a9f7b2d07508866cd456c))
- Officially support Python 3.12
([`2a69c0e`](https://github.com/python-gitlab/python-gitlab/commit/2a69c0ee0a86315a3ed4750f59bd6ab3e4199b8e))
- Remove support for Python 3.7, require 3.8 or higher
([`058d5a5`](https://github.com/python-gitlab/python-gitlab/commit/058d5a56c284c771f1fb5fad67d4ef2eeb4d1916))
Python 3.8 is End-of-Life (EOL) as of 2023-06-27 as stated in https://devguide.python.org/versions/
and https://peps.python.org/pep-0537/
By dropping support for Python 3.7 and requiring Python 3.8 or higher it allows python-gitlab to
take advantage of new features in Python 3.8, which are documented at:
https://docs.python.org/3/whatsnew/3.8.html
BREAKING CHANGE: As of python-gitlab 4.0.0, Python 3.7 is no longer supported. Python 3.8 or higher
is required.
- Use requests AuthBase classes
([`5f46cfd`](https://github.com/python-gitlab/python-gitlab/commit/5f46cfd235dbbcf80678e45ad39a2c3b32ca2e39))
- **api**: Add optional GET attrs for /projects/:id/ci/lint
([`40a102d`](https://github.com/python-gitlab/python-gitlab/commit/40a102d4f5c8ff89fae56cd9b7c8030c5070112c))
- **api**: Add ProjectPackagePipeline
([`5b4addd`](https://github.com/python-gitlab/python-gitlab/commit/5b4addda59597a5f363974e59e5ea8463a0806ae))
Add ProjectPackagePipeline, which is scheduled to be included in GitLab 16.0
- **api**: Add support for job token scope settings
([`59d6a88`](https://github.com/python-gitlab/python-gitlab/commit/59d6a880aacd7cf6f443227071bb8288efb958c4))
- **api**: Add support for new runner creation API
([2635](https://github.com/python-gitlab/python-gitlab/pull/2635),
[`4abcd17`](https://github.com/python-gitlab/python-gitlab/commit/4abcd1719066edf9ecc249f2da4a16c809d7b181))
Co-authored-by: Nejc Habjan <hab.nejcgmail.com>
- **api**: Support project remote mirror deletion
([`d900910`](https://github.com/python-gitlab/python-gitlab/commit/d9009100ec762c307b46372243d93f9bc2de7a2b))
- **client**: Mask tokens by default when logging
([`1611d78`](https://github.com/python-gitlab/python-gitlab/commit/1611d78263284508326347843f634d2ca8b41215))
- **packages**: Allow uploading bytes and files
([`61e0fae`](https://github.com/python-gitlab/python-gitlab/commit/61e0faec2014919e0a2e79106089f6838be8ad0e))
This commit adds a keyword argument to GenericPackageManager.upload() to allow uploading bytes and
file-like objects to the generic package registry. That necessitates changing file path to be a
keyword argument as well, which then cascades into a whole slew of checks to not allow passing
both and to not allow uploading file-like objects as JSON data.
Closes https://github.com/python-gitlab/python-gitlab/issues/1815
- **releases**: Add support for direct_asset_path
([`d054917`](https://github.com/python-gitlab/python-gitlab/commit/d054917ccb3bbcc9973914409b9e34ba9301663a))
This commit adds support for the “new” alias for `filepath`: `direct_asset_path` (added in 15.10) in
release links API.
Refactoring
- **artifacts**: Remove deprecated `artifact()`in favor of `artifacts.raw()`
([`90134c9`](https://github.com/python-gitlab/python-gitlab/commit/90134c949b38c905f9cacf3b4202c25dec0282f3))
BREAKING CHANGE: The deprecated `project.artifact()` method is no longer available. Use
`project.artifacts.raw()` instead.
- **artifacts**: Remove deprecated `artifacts()`in favor of `artifacts.download()`
([`42639f3`](https://github.com/python-gitlab/python-gitlab/commit/42639f3ec88f3a3be32e36b97af55240e98c1d9a))
BREAKING CHANGE: The deprecated `project.artifacts()` method is no longer available. Use
`project.artifacts.download()` instead.
- **build**: Build project using PEP 621
([`71fca8c`](https://github.com/python-gitlab/python-gitlab/commit/71fca8c8f5c7f3d6ab06dd4e6c0d91003705be09))
BREAKING CHANGE: python-gitlab now stores metadata in pyproject.toml as per PEP 621, with setup.py
removed. pip version v21.1 or higher is required if you want to perform an editable install.
- **const**: Remove deprecated global constant import
([`e4a1f6e`](https://github.com/python-gitlab/python-gitlab/commit/e4a1f6e2d1c4e505f38f9fd948d0fea9520aa909))
BREAKING CHANGE: Constants defined in `gitlab.const` can no longer be imported globally from
`gitlab`. Import them from `gitlab.const` instead.
- **groups**: Remove deprecated LDAP group link add/delete methods
([`5c8b7c1`](https://github.com/python-gitlab/python-gitlab/commit/5c8b7c1369a28d75261002e7cb6d804f7d5658c6))
BREAKING CHANGE: The deprecated `group.add_ldap_group_link()` and `group.delete_ldap_group_link()`
methods are no longer available. Use `group.ldap_group_links.create()` and
`group.ldap_group_links.delete()` instead.
- **lint**: Remove deprecated `lint()`in favor of `ci_lint.create()`
([`0b17a2d`](https://github.com/python-gitlab/python-gitlab/commit/0b17a2d24a3f9463dfbcab6b4fddfba2aced350b))
BREAKING CHANGE: The deprecated `lint()` method is no longer available. Use `ci_lint.create()`
instead.
- **list**: `as_list` support is removed.
([`9b6d89e`](https://github.com/python-gitlab/python-gitlab/commit/9b6d89edad07979518a399229c6f55bffeb9af08))
In `list()` calls support for the `as_list` argument has been removed. `as_list` was previously
deprecated and now the use of `iterator` will be required if wanting to have same functionality as
using `as_list`
BREAKING CHANGE: Support for the deprecated `as_list` argument in `list()` calls has been removed.
Use `iterator` instead.
- **projects**: Remove deprecated `project.transfer_project()` in favor of `project.transfer()`
([`27ed490`](https://github.com/python-gitlab/python-gitlab/commit/27ed490c22008eef383e1a346ad0c721cdcc6198))
BREAKING CHANGE: The deprecated `project.transfer_project()` method is no longer available. Use
`project.transfer()` instead.
Testing
- Add tests for token masking
([`163bfcf`](https://github.com/python-gitlab/python-gitlab/commit/163bfcf6c2c1ccc4710c91e6f75b51e630dfb719))
- Correct calls to `script_runner.run()`
([`cd04315`](https://github.com/python-gitlab/python-gitlab/commit/cd04315de86aca2bb471865b2754bb66e96f0119))
Warnings were being raised. Resolve those warnings.
- Fix failing tests that use 204 (No Content) plus content
([`3074f52`](https://github.com/python-gitlab/python-gitlab/commit/3074f522551b016451aa968f22a3dc5715db281b))
urllib3>=2 now checks for expected content length. Also codes 204 and 304 are set to expect a
content length of 0 [1]
So in the unit tests stop setting content to return in these situations.
[1]
https://github.com/urllib3/urllib3/blob/88a707290b655394aade060a8b7eaee83152dc8b/src/urllib3/response.py#L691-L693
- **cli**: Add test for user-project list
([`a788cff`](https://github.com/python-gitlab/python-gitlab/commit/a788cff7c1c651c512f15a9a1045c1e4d449d854))
BREAKING CHANGES
- **advanced**: Python-gitlab now explicitly passes auth to requests, meaning it will only read
netrc credentials if no token is provided, fixing a bug where netrc credentials took precedence
over OAuth tokens. This also affects the CLI, where all environment variables now take precedence
over netrc files.
- **build**: Python-gitlab now stores metadata in pyproject.toml as per PEP 621, with setup.py
removed. pip version v21.1 or higher is required if you want to perform an editable install.