Changelog¶
4.0.4¶
Bug Fixes¶
- reduce unnecessary commits when modifying files #892, closes #891 (Tim Knight (DWP))
- wildcard based branch protection config fails to apply #887 (KieranSt97)
Dependencies¶
- Update various dependencies to newer version.
Thanks to all the contributors of this release!
4.0.3¶
Performance¶
Documentation¶
- Fix Gitlab System hooks doc link #883 (Philippe Granet)
Dependencies¶
- Update various dependencies to newer version.
Thanks to all the contributors of this release!
4.0.2¶
Performance¶
Refactors¶
- Migrate branches processor to python-gitlab #876 (amimas)
- Migrate files processor to python-gitlab #874 (amimas)
Build Process¶
- Fix codecov notification 8e89932 (Tim Knight (DWP))
Dependencies¶
- Update various dependencies to newer version.
Thanks to all the contributors of this release!
4.0.1¶
Bug Fixes¶
- fix: project settings failing to apply because membership config is not processed #857, closes #765. (amimas)
4.0.0¶
BREAKING CHANGES¶
- Stop supporting Python older than 3.12 #789, closes #754. (Greg Dubicki)
Dependencies¶
- Update various dependencies reliant on dropping python3.8 support; to newer version.
Thanks to all the contributors of this release!
3.16.5¶
Dependencies¶
- Update various dependencies to newer version.
3.16.4¶
Bug Fixes¶
- fix: print out to info level - user being processed #864, closes #863 (Tim Knight (DWP))
Refactors¶
- refactor: migrate 'resource_groups' config to be managed by python-gitlab #854, closes #628 (amimas)
Dependencies¶
- Update various dependencies to newer version.
Thanks to all the contributors of this release!
3.16.3¶
Bug Fixes¶
- fix: only unprotect branch right before protecting again #830 (Chris Hill)
- fix: VariablesProcessor._print_diff() got an unexpected keyword argument 'diff_only_changed' #852, closes #851 (kriko)
Dependencies¶
- Update various dependencies to newer version.
Thanks to all the contributors of this release!
3.16.2¶
Bug Fixes¶
- fix: iterates through project list to check and add members #843. Resolves 836. (Sachin Kumar Singh)
Dependencies¶
- Update various dependencies to newer version.
3.16.1¶
Bug Fixes¶
- fix: Adding members who already exist in project #840. Resolves 836. (Tim Knight (DWP))
Documentation¶
- fix "Edit a project webhook" Gitlab link #839 (Philippe Granet)
3.16.0¶
Features¶
- Run gitlabform for a single group and all it's subgroups #828, closes 613. (Patrick Del Conte)
Bug Fixes¶
- return all members when listing for member processor #838 (Jack Hindley)
- fix error when --diff-only-changed is set, but no changes are present #833 (Arden Shackelford)
- remove 'enforce' key from the config so that it's not treated as a "variable" #831 (Philippe Granet)
Dependencies¶
- Update various dependencies to newer version.
Thanks to all the contributors of this release!
3.15.0¶
Features¶
- Add flag to only print settings that are being changed #815 (Arden Shackelford)
Bug Fixes¶
- Idempotent updating for SAML Group Links #824 (ItsJustMagic)
Refactors¶
- Moving members and members_processor to use python-gitlab #822 (Arden Shackelford)
Build Process¶
- Switch to Trusted Publishing to PyPi #805 (Greg Dubicki)
- Cleanup tests to avoid multiple issue tracking integrations being enabled #820 (Arden Shackelford)
Documentation¶
Dependencies¶
- Update various dependencies to newer version.
Thanks to all the contributors of this release!
3.14.1¶
Features¶
- Enhanced cron expressions for scheduled pipelines. PRs #800, 801, implements #455. (Mirko Friedenhagen)
- Show dry-run mode in the output header, if set. PR #798. (Sebastian Gumprich)
Build Process¶
- Remove grafana from test GitLab instance. (Tim Knight (DWP))
- Stop running setup.py directly, it's deprecated. (Greg Dubicki)
Dependencies¶
- Update various dependencies to newer version.
Thanks to all the contributors of this release!
3.14.0¶
(Not released because of a build issue, ugh.)
3.13.2¶
Bug fixes¶
- Fix custom roles for GitLab SaaS users. PR #787. (Tim Knight (DWP))
Dependencies¶
- Update packaging, cryptography, pytest, types-request, coverage and python-gitlab to newer versions.
3.13.1¶
Bug fixes¶
- Fix documentation to publish website
3.13.0¶
Features¶
- Add support for setting custom roles (Ultimate only) in project and group members. Creation of custom roles in gitlabform is NOT SUPPORTED. #673. PR 759, 775. (Tim Knight (DWP))
Documentation¶
- Add info about and link to pyenv PR #774, (Jimisola Laursen)
Build Process¶
- Improvements to codecov reports 43adfb9b. (Tim Knight (DWP))
- Fixes to PRs workflows to ensure tests/linters run on branch. 7cd1bfc3 & c373b54. (Tim Knight (DWP))
- Adds suite of Acceptance Tests using Ultimate License. d33b0928. (Tim Knight (DWP))
Dependencies¶
- Update certifi, coverage, requests, types-requests to newer versions.
Thanks to all the contributors of this release!
3.12.0¶
Features¶
- support for group SAML links, closes #549, PR #760 (mahadevan-karthi-dwp)
- support for CI/CD Job Token Scope #571, PR #758 (Tim Knight (DWP))
Dependencies¶
- Update py-test, python-gitlab, dependencies to newer version.
Thanks to all the contributors of this release!
3.11.1 (2024-05-16)¶
Bug Fixes¶
- release process and deploy container to GHCR (741ff75)
3.11.0 (2024-05-15)¶
Features¶
- add option to not fail if configured resource group does not exist (#650) (a362d8e), closes #649
- manage Project and Group Labels via gitlabform (#751) (f1be42b)
- use python lib for group settings (#746) (03ce3fa)
Documentation¶
3.10.0¶
Features¶
- Add support for Application Settings #120, PR #742 (Tim Knight (DWP))
Refactors¶
- Use new convenience methods for getting groups and projects in more places and document them in the contribution docs: PRs #734, #743 (Tim Knight (DWP))
Dependencies¶
- Update some dependencies to newer version.
Thanks to all the contributors of this release!
3.9.7¶
Fixes¶
- Processing group fails if it has more than 20 members #732, PR #735 (Sachin Kumar Singh )
Thanks to all the contributors of this release!
3.9.6¶
Fixes¶
- Process all schedules and not only the first 20 #731 (Andreas Wirooks)
Thanks to all the contributors of this release!
3.9.5¶
Fixes¶
- Error when running with
--noop
and--output-file
parameter and config contains project to be transferred #729 (long-wan-ep)
Refactors¶
- Migrate
schedules
(pipeline schedules) configuration to use python-gitlab library #706 (TimKnight-Opencast) - Migrate
group_members
configuration to use python-gitlab library #697 (TimKnight-DWP)
Thanks to all the contributors of this release!
3.9.4¶
Fixes¶
- Dry run failure when project transfer is configured along with other additional configs #726 (long-wan-ep)
Chores¶
Dependencies¶
- Update some dependencies to newer version.
Thanks to all the contributors of this release!
3.9.3¶
Fixes¶
Dependencies¶
- Update some dependencies to newer version.
Thanks to all the contributors of this release!
3.9.2¶
Fixes¶
- Transfer project not working when target is ALL or ALL_DEFINED or group or subgroup #714 (long-wan-ep)
Documentation¶
Dependencies¶
- Update some dependencies to newer version.
Thanks to all the contributors of this release!
3.9.1¶
Fixes¶
CI¶
Dependencies¶
- Update some dependencies to newer version.
Thanks to all the contributors of this release!
3.9.0¶
Features¶
- Ability to transfer projects between groups or namespaces #582 (amimas)
- Add support for Python 3.12 and update to alpine 3.18 #612 (gdubicki)
- Add
enforce
support for project hooks/webhooks configuration #664(TigreModerata)
Fixes¶
- JSON data with dates not serialized correctly #656 (HontoNoRoger)
Refactors¶
- Migrate
archive
configuration to use python-gitlab library #622 (amimas) - Migrate
hooks
configuration feature to use python-gitlab library #635 (TigreModerata) - Migrate
tags
configuration to use python-gitlab library #642 (lhokktyn)
Documentation¶
- Clarify gitlabform release procedure steps #600 (amimas)
- Add users' logs to the repo to fix problems with diplaying them commit (gdubicki)
- Fix broken links to references in homepage #653 (alamirault)
Dependencies¶
- Update many dependencies to newer version.
Styles¶
Thanks to all the contributors of this release!
3.8.0¶
- Add
allowed_to_create
support for tag protection. PR #551, implements #505. - Require Python version >= 3.8 (as 3.7 is EOL since June 2023) and update dependencies that have required it. PR #592, implements #576.
- Usernames in projects and groups should be case-insensitive. PR #556, implements #555.
- Update many dependencies to newer version.
- Various fixes to local dev, tests, and CI of gitlabform.
Thanks to the contributors of this release::
3.7.0¶
- Add
enforce
support to managing pipeline schedules. PR #561, implements #539. - Fix group membership failing to apply when using
keep_bots
attribute. PR #554, fixes #553.
Thanks to the contributors of this release:
3.6.1¶
- Fix acceptance tests after GitLab v16 started to require expiration date for all the tokens. PR #557 and d2b0c81.
- Dependencies update.
Thanks to amimas for his contribution!
3.6.0¶
- Enforcing project and group members while keeping the bot users is now easier. When using
enforce: true
add alsokeep_bots: true
at the same level. See the docs for more info. Implements #454, PR #544. - (For contributors) All acceptance tests have been rewritten to use python-gitlab as a first step towards moving the whole project to use it instead of own home-grown library for the GitLab API. PR #442.
BIG thanks the contributions of this release:
- Nejc Habjan for his enormous work on migrating the tests to python-gitlab,
- James Gauld for brilliantly implementing
keep_bots: true
, - Rajas Gujarathi for multiple improvements to the docs,
- Waldek Maleska for contribution to docs.
3.5.0¶
- Make running with
ALL
work fast when using gitlab.com or a self-hosted GitLab instance and a non-admin account. With a non-admin account the app will not try to get all the groups and projects, but only the ones where the used account has at least a Reporter role, which is the lowest level of permissions that allow to make a configuration change. Fixes #509, PR #518. - Improved contribution docs. PR #515.
Thanks to Mirko Friedenhagen for his contribution!
3.4.3¶
3.4.2¶
- Improve the reliability in some cases (PR #497):
- retrying the whole section for a given entity (f.e.
files
for a projectfoo/bar
) when it fails on a non-retryable individual HTTP request, - retrying individual HTTP requests on errors that may be returned by gitlab.com's CloudFlare CDN (520-531).
3.4.1¶
- Fix for old merge request syntax using inheritance when a sole
approvals_before_merge
setting is inherited/overwritten. PR #481.
3.4.0¶
- Add support for multiple merge request approval rules and for changing the name of the currently managed single approval rule. Implements #388 and #95, PR #435 and many more.
- A more user-friendly error message when a key is not found. PR #422
- Start to edit instead of remove+re-add users as project and group members when changing their access level or expiration time. This should give cleaner audit logs of membership changes and may resolve some issues. Related to issue #466, PR #469.
- Operate on simple dicts and lists instead of more complex ordereddict and CommentedSeq for easier to understand debug output and tests.
- Show the config before and after the internal transformation stage, with the debug output enabled.
- (For contributors) Big refactoring to make the code more logically groupped and contribution documentation updates for easier contributions. Please see the commit messages in the PR #431 for more information.
Thanks to the following contributors of this release:
- Waldek Maleska, amimas, Jimisola Laursen, Siythrun for consulting and testing of the multiple merge request approval rules feature,
- Rafael Zanella for the development.
3.4.0rc4¶
- Fix internal conversion of group names and usernames to ids in some cases for Merge Request approval rules. Reported by Siythrun in issue #388, PR #467.
- Operate on simple dicts and lists instead of more complex ordereddict and CommentedSeq for easier to understand debug output and tests.
- Show the config before and after the internal transformation stage, with the debug output enabled.
3.3.4¶
- Fix unnecessary reapply of branch protection when
*_access_levels
is set to0
. PR #474
Thanks to Ben Kuhar for his contribution!
3.4.0rc3¶
- Start to edit instead of remove+re-add users as project and group members when changing their access level or expiration time. This should give cleaner audit logs of membership changes and may resolve some issues. Related to issue #466, PR #469.
3.3.3¶
- Fix bug on the first run when both adding project members and the same users as merge request approvers. Fixes #461.
3.4.0rc2¶
- A more user-friendly error message when a key is not found. PR #422
- Fix for converting legacy merge request approval into the new setup. PR #456
Thanks to Rafael Zanella for his contribution!
3.3.2¶
3.3.1¶
- Fix for setting deploy key in some cases fail with HTTP 400:
{"fingerprint":["has already been taken"]}
. Fixes #19, PR #441.
3.4.0rc1¶
- Add support for multiple merge request approval rules and for changing the name of the currently managed single approval rule. Implements #388 and #95, PR #435. The syntax for this feature is shown here for now - it will be moved to the GitHub Pages docs before the final release of v3.4.0.
- (For contributors) Big refactoring to make the code more logically groupped and contribution documentation updates for easier contributions. Please see the commit messages in the PR #431 for more information.
3.3.0¶
- Add support for managing project Protected environments. PR #423 & PR #430
- Add support for Python 3.11 and switch to this version in the Docker image.
- (For contributors) Move all the GitLabForm tests that require GitLab Premium license into a separate module and introduce a new GitHub Actions flow to enable running them for PRs after the maintainer's approval.
Thanks to Rafael Zanella for his contributions!
3.2.0¶
- Add authoritative mode (
enforce: true
) support to group badges, group LDAP links, group variables, badges, deploy keys, variables. Implements #403, PR #419.
3.1.2¶
- Make setting project-level CI/CI variables with a non-default different
environment_scope
work again. Fixes #411, PR #414.
3.1.1¶
- Fixed error when passing the GitLab token in the config file with single or double quotes. Fixes #401, PR #412.
3.1.0¶
Thanks to @ep-linden from Elastic Path and to @L154x for their contribution!
3.0.0¶
This is a major new version with some backward incompatibility. Please follow the upgrade guide for a fast and safe upgrade.
New features/bugfixes:
- Subgroups now do inherit the settings from their groups. It should have worked like this already, but it did not because of a bug #372 fixed in PR #385. (Please use
inherit: false
to keep the old behavior. See the upgrade guide for more info.), - Shorter and easier to read errors (full stacktrace shown only when
--debug
is enabled),
Backward-incompatible maintenance changes:
- Require GitLab version >= 14.4 (released in Oct 2021) as it contains the required API rename,
- Require Python version >= 3.7 (as 3.6 is EOL since Dec 2021) and update many dependencies that have required it,
- Drop support for a lot of deprecated configuration syntax that the app has warned about:
- branch protection - no more
developers_can_push
,developers_can_merge
, usepush_access_level
,merge_access_level
etc. instead, - group members - no more
group_shared_with
,enforce_group_members
,group_access_level
, usegroup_members
,group_members.enforce
,group_access
instead, - services/integrations - no more
recreate
,
- branch protection - no more
- Rename some configuration sections following the renames made in GitLab:
services
->integrations
,secret_variables
->variables
,group_secret_variables
->group_variables
,
- Drop the Debian-based Docker image (it's practically unused - you can maintain your own, if you needed it),
- (For users of this app as a library) Rename some API methods, remove deprecated ones:
protect_branch()
is now the method using the new API, the method using the old one has been removed,branch_code_owner_approval_required()
->set_branch_code_owner_approval_required()
.delete_legacy_approvers()
has been removed,- all the methods with
service(s)
/secret_variable(s)
/group_secret_variable(s)
in their names have been renamed to containintegration(s)
/variable(s)
/group_variables(s)
.
Thanks to the contributors of this release: @ep-linden from Elastic Path.
2.12.0¶
- Update base Docker images:
- from Python 3.9 and Alpine 3.14 to Python 3.10 and Alpine 3.16,
- from Python 3.9 and Debian 10 (Buster) to Python 3.10 and Debian 11 (Bullseye).
- Fix Group CI/CD Variables not honoring
protected
andmasked
values set tofalse
. Fixes #384.
2.11.1post3¶
- Moved the project from
gitlabform/gitlabform
togitlabform/gitlabform
. Stopped publishing new images to the oldegnyte/gitlabform
Docker registry.
2.11.1¶
- Fix another case of GitLab's Schedules API change/bug. Fixes #364.
2.11.0¶
Imagine you have a configuration like this:
projects_and_groups:
my-group/*:
members:
enforce: true
groups:
regular-developers:
group_access: developer
my-group/special-private-project:
members:
inherit: false # <--- the new keyword
enforce: true
groups:
special-developers:
group_access: developer
users:
john:
access_level: maintainer
inherit: false
entry used here, the effective members for my-group/special-private-project
project are ONLY the special-developers
grup and john
user.
- Always expect pagination for GETs. Fixes #354. PR #358.
- Workaround for the GitLab's Schedules API change/bug. Fixes #361.
Big thanks to the Elastic Path team for their contribution of the above feature, especially @ep-linden for the whole implementation and @amimas for the initial proposal and cooperation on design!
(There were 4 pre-releases of this version, 2.11.0b1-b4. b1 contained "Allow breaking configuration inheritance", b2 also #358, b3 also a fix of a bug that caused breaking config inheritance to not work in some cases, b4 - #361).
2.10.1¶
2.10.0¶
- Deleting deploy keys is now possible. This partially implements #193. Also completely replace the implementation of deploy keys, secret variables and group secret variables with a new universal one. This possibly fixes #19.
- Up to 40% faster thanks to making less requests to GitLab. (For almost 1000 repositories the apply time has dropped from ~18 minutes to ~11 minutes.)
- With debug enabled a lot less duplication and a more readable output of dicts (shown as JSONs).
- For Contributors Introduce
SingleEntityProcessor
that generalizes editing things that are single per project, f.e. settings or push rules set. It does not edit entities if there are not changes to be applied. Using it implementing new features can be superfast! (See alsoMultipleEntitiesProcessor
added in v2.2.0). - For Contributors Faster tests and improved usage of fixtures.
(A pre-release of 2.9.2 RC1 contained some of the above changes. 2.10.0rc1 pre-release was the same as 2.10.0 final but with a slightly different changelog - the speed gains turned out to be higher than expected.)
2.9.1¶
- Fix version 2.9.0 not even starting. 🤦♂️ Add test to prevent this from happening again.
2.9.0¶
- Access level names (not only their numbers) are now accepted in the configuration.
- More strictness in parsing configuration YAML and better error messages thanks to a switch to different libraries. F.e. hash keys overwriting is not accepted anymore.
- Moved the project from
egnyte/gitlabform
togitlabform/gitlabform
and switch to GitHub Registry as the new main Docker registry.
2.8.1¶
- Don't show "Warning: Using group_shared_with: is deprecated" although the user is not really using this config syntax.
2.8.0¶
- Complete support for managing groups and projects members:
- Add enforcing (direct) project members - groups and users, including being able to remove all direct members and keep only the members inherited from the group. Implements #100.
- Unify the configuration syntax for group and project level membership.
✨ New ✨ config syntax example:
projects_and_groups:
foo/*:
# below key now includes what used to be under
# `group_shared_with` and `enforce_group_members` keys
group_members:
# there are only up to 3 direct keys below
groups:
another-group:
# below key's name been changed to the name used in projects `members`
# for groups (and the same as in the API to share group with group)
group_access: 30
users:
my-user:
access_level: 50 # owner
# this will enforce group-level users to be ONLY as defined above
enforce: true
# this will make the projects in `foo` group not contain any **direct** users or groups other
# (so it will make it contain only the ones inherited from the group `foo`)
members:
enforce: true
projects_and_groups:
foo/*:
group_shared_with:
groups:
another-group:
group_access_level: 30
group_members:
my-user:
access_level: 50 # owner
enforce_group_members: true
# !!! * - there was no enforce project members support before v2.8.0 !!!
2.7.1¶
- Speed up running for
ALL_DEFINED
, when the defined groups and projects for just a small part of all the GitLab instance's groups and projects. Additionally always show the number of omitted groups and projects for any reasons (no config, archived, skipped). Fixes #285.
2.7.0¶
- Allow processing only requested configuration sections using a new cli argument
-os / --only-sections
. - Minimize the number of unnecessary audit branch unprotect/protect events. Up to now every apply of the
files
section for protected branch resulted in unprotect and then (re)protect event for each protected branches and each file. Now this will only happen when the user running GitLabForm actually needs to do that, which should not happen often if you are using an admin account. Completely fixes #178.
2.6.0¶
- Complete support for Protected branches - access levels / users / groups allowed to push/merge/unprotect (GitLab Premium (paid) only). PR #289.
- Add option to allow push force in protected branches. Implements #227.
- Fix a bug causing the app to get HTTP 502 from GitLab when protecting branches in some cases.
- Fix getting members list to include usernames of all direct members not just the first page. PR #284.
Big thanks to the contributors of this release: @trissanen
2.5.0¶
- Make commit messages for file operations configurable. Implements #278.
Thanks to @aleung for his contribution!
2.4.0¶
Thanks to @chris-workingmouse for his contribution!
2.3.0¶
- Add Protected branches - users allowed to push/merge (GitLab Premium (paid) only), PR #273.
- For
ALL_DEFINED
also skip archived projects even if they are explicitly defined in the config, unless -a flag is added - for consistency. - For Contributors Add docs for running the test themselves in a Docker container and for running GitLab in Docker using a license file, for testing paid-only features.
Thanks to @florentio, @barryib and @Pigueiras for their contribution!
2.2.0¶
-
Add LDAP Group Links support (GitLab Premium (paid) only). Implements #140.
-
Add project and group badges support. Implements #59.
-
Allow 0 (no access) in Protected Tags. Fixes #172.
-
Exit on configuration missing
projects_and_groups
key. This will provide a helpful error message for typos made in this key. Fixes #242. - Make error messages more friendly when there is no network connection or when configuration is invalid (f.e. YAML parsing errors).
-
Make the output of some processors a bit more consistent.
-
Fix detecting an "empty effective config" and improve the UI related to processing groups and projects with such. Fixes #251.
-
Big refactoring that should make adding new features easier and faster. The main change is introducing a new way to implement "processors" - thanks to a generalized
MultipleEntitiesProcessor
class adding a new feature like Project Badges should is now as easy as implementing a class likeBadgesProcessor
and writing an acceptance test likeTestBadges
. Note that this new design may change in the near future and we are open to discussions and PRs to make it even better! We also plan to create a similar generalizedSingleEntityProcessor
class soon. -
Change the User Agent that the app uses when making requests to GitLab to a custom
GitLabForm/<gitlabform_version> (python-requests/<requests_version>)
.
2.1.2¶
- Managing project members is not incredibly slow anymore. Fixes #240
Thanks to @andrewjw (Ocado Technology) for his contribution!
2.1.1¶
- Fixed sharing group with a subgroup. Fixes #236
- Improved re-protecting branches after updating files in them. Fail fast if the config is invalid.
- Better Docker images:
- Updated Alpine from 3.12 to 3.14,
- Started to build images in ARM64 architecture (apart from x86-64),
- Started to add tags
, . . Note that Alpine-based image is the main one which gets these tags. For Debian-based images add "-buster" suffix. Implements #173
Thanks to @andrewjw (Ocado Technology) for his contribution!
2.1.0¶
- Added a feature to share groups with other groups, with optional enforcing. Implements #150
Thanks to @andrewjw (Ocado Technology) for this contribution!
2.0.6¶
- Fixed incorrect subgroups list when requesting to process ALL_DEFINED. Completes the fix for #221
2.0.5¶
- Really fixed issue with
unprotect_branch_new_api
. Fixes #219 - Fixed call to a Merge Requests Approvers API endpoint removed in GitLab 13.11.0. Fixes #220
- Fixed potential security issue by enabling autoescaping when loading Jinja templates. (Bandit security tool issue B701)
Thanks to @Pigueiras for his contribution!
2.0.4¶
- Fixed issue with Push Rules when the project name contains a dot. Fixes #224
- Fixed calling to process a single subgroup (like:
gitlabform 'group/subgroup'
). Fixes #221
2.0.3¶
- Fixed issue with dry-run for Project Push Rules when the current config is empty (
None
). Fixes #223
2.0.2¶
- Fixed issue with
unprotect_branch_new_api
. Fixes #219 (update: later it turned out that it was not really fixed in 2.0.2 but in 2.0.5 instead)
2.0.1¶
- Fixed issues with Jinja loader.
- Fixed calls to GitLab API that do not contain 'x-total-pages' header (gradually rolled out since GitLab MR #23931).
- Start showing deprecation warning when using the old branch protection API config syntax.
Thanks to @mkjmdski for his contribution!
(2.0.0post1-3 release is technically the same as 2.0.1 but was incorrectly versioned.)
2.0.0¶
(For a detailed info about changes in each RC of v2 please see the previous version of this changelog.)
-
Make deep merging of configuration actually work (breaking change). Fixes #197 (RC5)
-
Introduce config versioning (breaking change). ...or rather a change to avoid breakage. New major releases of GitLabForm starting with v2 will look for
config_version
key in the config file. If it doesn't exist, or the version does not match expected then the app will exit to avoid applying unexpected configuration and allowing the user to update the configuration. (RC1) -
New config syntax (breaking change). All 3 levels under a common key
projects_and_groups
. It should contain a dict, where common config is under a special"*"
key, group configs under keys likegroup/*
and project configs under keys likegroup/project
. This will allow introducing pattern matching in these keys and introducing support for multiple config files in the future releases. Partially implements #138. (RC1) -
Exit with code != 0 when any group/project processing was failed (breaking change). This will allow you to notice problems when running the app from CI. Note that you can restore the old behaviour by running the app with
(...) || true
. Also standardized exit codes. Exit with 1 in case of input error (f.e. config file does not exist), with 2 in case of processing error (f.e. GitLab returns HTTP 500).Fixes #153. (RC1) -
Allow any case in groups and projects names (breaking change). GitLab groups and projects names are case sensitive but you cannot create such entities that differ only in the case. There is also a distinction between a "name" and a "path" and they may differ in case... To make work with this easier GitLabForm now accepts any case for them in both config files as well as when provided as command line arguments. We also disallow such entities that differ only in case (f.e.
group/*
andGROUP/*
) to avoid ambiguity. Fixes #160. (RC2) -
Ignore archived projects by default (breaking change). This makes processing faster and output shorter. You can restore the previous behavior by adding
--include-archived-projects
/-a
command line switch. Note that you have to do it if you want to unarchive archived projects! Fixes #157 in (arguably) a more convenient way. (RC2) -
Color output! Implements #141. (RC1)
-
Add diffing feature for secret variables. (with values shown as hashes to protect the secrets from leaking). (RC6)
-
Added checking for invalid syntax in "members" section. Defining groups or users directly under this key instead of under sub-keys "users" and "groups" will now trigger an immediate error. (RC5)
-
Add support for Python 3.9 (RC8)
-
Added Windows support. Fixes #206 (RC5)
-
Start processing at any group using the new command line switch -
--start-from-group
/-sfg
. Similar to--start-from
/-sf
switch that can be used for projects. (RC1) -
Start releasing pre-releases as Docker images. They have tags with specific versions, but not "latest" tag as it is reserved for new final releases. Implements #201 (RC5)
-
Prevent multiple email notifications from being sent when adding members to project. Fixes #101 (RC6)
-
Prevent project's Audit Events being filled in with "Added protected branch". Fixes #178 (RC6)
-
Fixed using "expires_at" for users. Fixes #207 (RC6)
-
Remove the need to add the
gitlab.api_version
configuration key. (RC1) -
For Contributors Make writing tests easier and the tests more robust. Deduplicate a lot of the boilerplate code, allow putting configs into the test methods and use pytest fixtures for easier setup and cleanup. This should fix issues with tests reported in #190. Also stop storing any dockerized GitLab data permanently to avoid problems like #196 and probably other related to failed dockerized GitLab upgrades. (RC3)
-
For Contributors Rename "integration tests" to "acceptance tests". Because they ARE in fact acceptance tests. (RC3)
Thanks to @amimas, @weakcamel, @kowpatryk, @ss7548, @houres, @Pigueiras and @YuraBeznos for their contributions!
before 2.0.0¶
Please see GitHub pre-2.0 releases' descriptions.