gitlab-projects-settings 6.1.1__tar.gz → 6.2.0__tar.gz

{gitlab_projects_settings-6.1.1 → gitlab_projects_settings-6.2.0}/.gitlab-ci.yml

@@ -1,5 +1,5 @@
 include:
-  - component: gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commits@4.0.0
+  - component: gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commits@4.1.0
     inputs:
       stage: prepare
 

{gitlab_projects_settings-6.1.1 → gitlab_projects_settings-6.2.0}/CHANGELOG.md

@@ -1,7 +1,28 @@
 # Changelog
 
+<a name="6.2.0"></a>
+## [6.2.0](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/compare/6.1.1...6.2.0) (2025-05-31)
+
+### ✨ Features
+
+- **entrypoint, gitlab:** detect legacy missing 'squash_option' attribute ([260c433](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/260c4332a3ddf006ed8806e8b74f74d45edfc51c))
+
+### 🐛 Bug Fixes
+
+- **gitlab:** avoid exceptions upon group last owner member removal ([fed6ef0](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/fed6ef00a2cf22a38cf58de70579c7b7fec739a0))
+- **main:** exclusive '--run-housekeeping' and '--prune-unreachable-objects' ([4a0a170](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/4a0a1707816a4404fdf14e58e370f960f961a7e8))
+
+### 📚 Documentation
+
+- **license, mkdocs:** raise copyright year to '2025' ([671d6e8](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/671d6e80a70cc519cdd302c704cbb01cb307f6b2))
+
+### 🚀 CI
+
+- **gitlab-ci:** migrate to 'pre-commit-crocodile/commits@4.1.0' ([63ebbc5](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/63ebbc536f8252ecb5c0066a2deca5518c58487b))
+
+
 <a name="6.1.1"></a>
-## [6.1.1](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/compare/6.1.0...6.1.1) (2025-02-11)
+## [6.1.1](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/compare/6.1.0...6.1.1) (2025-02-28)
 
 ### ✨ Features
 

{gitlab_projects_settings-6.1.1 → gitlab_projects_settings-6.2.0}/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2024 Adrian DC
+   Copyright 2024-2025 Adrian DC
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{gitlab_projects_settings-6.1.1/gitlab_projects_settings.egg-info → gitlab_projects_settings-6.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: gitlab-projects-settings
-Version: 6.1.1
+Version: 6.2.0
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings
 Author: Adrian DC
@@ -41,6 +41,7 @@ Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: keywords
 Dynamic: license
+Dynamic: license-file
 Dynamic: project-url
 Dynamic: requires-dist
 Dynamic: requires-python
@@ -122,7 +123,7 @@ usage: gitlab-projects-settings [-h] [--version] [--no-color] [--update-check] [
                                 [--disable-features FEATURES] [--enable-features FEATURES] [--reset-members]
                                 [--set-avatar FILE] [--set-description TEXT] [--update-descriptions]
                                 [--set-roles-create-projects [ROLE]] [--set-roles-create-subgroups [ROLE]]
-                                [--run-housekeeping] [--prune-unreachable-objects]
+                                [--run-housekeeping | --prune-unreachable-objects]
                                 [--archive-projects | --unarchive-projects] [--delete-groups] [--delete-projects]
                                 [--protect-branches] [--protect-tags [LEVEL]] [--set-merge-method [METHOD]]
                                 [--set-merge-squash [SQUASH]] [--set-merge-pipelines [CHECK]]

{gitlab_projects_settings-6.1.1 → gitlab_projects_settings-6.2.0}/README.md

@@ -74,7 +74,7 @@ usage: gitlab-projects-settings [-h] [--version] [--no-color] [--update-check] [
                                 [--disable-features FEATURES] [--enable-features FEATURES] [--reset-members]
                                 [--set-avatar FILE] [--set-description TEXT] [--update-descriptions]
                                 [--set-roles-create-projects [ROLE]] [--set-roles-create-subgroups [ROLE]]
-                                [--run-housekeeping] [--prune-unreachable-objects]
+                                [--run-housekeeping | --prune-unreachable-objects]
                                 [--archive-projects | --unarchive-projects] [--delete-groups] [--delete-projects]
                                 [--protect-branches] [--protect-tags [LEVEL]] [--set-merge-method [METHOD]]
                                 [--set-merge-squash [SQUASH]] [--set-merge-pipelines [CHECK]]

{gitlab_projects_settings-6.1.1 → gitlab_projects_settings-6.2.0/gitlab_projects_settings.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: gitlab-projects-settings
-Version: 6.1.1
+Version: 6.2.0
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings
 Author: Adrian DC
@@ -41,6 +41,7 @@ Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: keywords
 Dynamic: license
+Dynamic: license-file
 Dynamic: project-url
 Dynamic: requires-dist
 Dynamic: requires-python
@@ -122,7 +123,7 @@ usage: gitlab-projects-settings [-h] [--version] [--no-color] [--update-check] [
                                 [--disable-features FEATURES] [--enable-features FEATURES] [--reset-members]
                                 [--set-avatar FILE] [--set-description TEXT] [--update-descriptions]
                                 [--set-roles-create-projects [ROLE]] [--set-roles-create-subgroups [ROLE]]
-                                [--run-housekeeping] [--prune-unreachable-objects]
+                                [--run-housekeeping | --prune-unreachable-objects]
                                 [--archive-projects | --unarchive-projects] [--delete-groups] [--delete-projects]
                                 [--protect-branches] [--protect-tags [LEVEL]] [--set-merge-method [METHOD]]
                                 [--set-merge-squash [SQUASH]] [--set-merge-pipelines [CHECK]]

{gitlab_projects_settings-6.1.1 → gitlab_projects_settings-6.2.0}/mkdocs.yml

@@ -19,7 +19,7 @@ site_name: gitlab-projects-settings
 site_url: https://radiandevcore.gitlab.io/tools/gitlab-projects-settings
 
 # Project copyright
-copyright: Copyright &copy; 2024 - <a href="https://gitlab.com/AdrianDC">Adrian DC</a>
+copyright: Copyright &copy; 2024-2025 - <a href="https://gitlab.com/AdrianDC">Adrian DC</a>
 
 # Excluded sources
 exclude_docs: |

{gitlab_projects_settings-6.1.1 → gitlab_projects_settings-6.2.0}/src/cli/entrypoint.py

@@ -467,7 +467,7 @@ class Entrypoint:
     ) -> Result:
 
         # Variables
-        changed: bool
+        changed: Optional[bool]
 
         # Acquire project
         project = gitlab.project(criteria)
@@ -690,9 +690,15 @@ class Entrypoint:
                 MergeRequestsMethod.ATTRIBUTE,
                 MergeRequestsMethod.VALUES[options.set_merge_method],
             )
-            print(f'{Colors.BOLD}   - Set merge method: '
-                  f'{Colors.CYAN if changed else Colors.GREEN}{options.set_merge_method}'
-                  f'{Colors.RESET}')
+            if changed is None:
+                print(f'{Colors.BOLD}   - Set merge method: '
+                      f'{Colors.RED}Unknown feature'
+                      f'{Colors.RESET}')
+            else:
+                print(f'{Colors.BOLD}   - Set merge method: '
+                      f'{Colors.CYAN if changed else Colors.GREEN}'
+                      f'{options.set_merge_method}'
+                      f'{Colors.RESET}')
             Platform.flush()
 
         # Set project merge squash
@@ -702,9 +708,15 @@ class Entrypoint:
                 MergeRequestsSquash.ATTRIBUTE,
                 MergeRequestsSquash.VALUES[options.set_merge_squash],
             )
-            print(f'{Colors.BOLD}   - Set merge squash: '
-                  f'{Colors.CYAN if changed else Colors.GREEN}{options.set_merge_squash}'
-                  f'{Colors.RESET}')
+            if changed is None:
+                print(f'{Colors.BOLD}   - Set merge squash: '
+                      f'{Colors.RED}Unknown feature'
+                      f'{Colors.RESET}')
+            else:
+                print(f'{Colors.BOLD}   - Set merge squash: '
+                      f'{Colors.CYAN if changed else Colors.GREEN}'
+                      f'{options.set_merge_squash}'
+                      f'{Colors.RESET}')
             Platform.flush()
 
         # Set project merge pipelines
@@ -714,10 +726,15 @@ class Entrypoint:
                 MergeRequestsPipelines.ATTRIBUTE,
                 options.set_merge_pipelines,
             )
-            print(f'{Colors.BOLD}   - Set merge pipelines: '
-                  f'{Colors.CYAN if changed else Colors.GREEN}'
-                  f'{str(options.set_merge_pipelines).lower()}'
-                  f'{Colors.RESET}')
+            if changed is None:
+                print(f'{Colors.BOLD}   - Set merge pipelines: '
+                      f'{Colors.RED}Unknown feature'
+                      f'{Colors.RESET}')
+            else:
+                print(f'{Colors.BOLD}   - Set merge pipelines: '
+                      f'{Colors.CYAN if changed else Colors.GREEN}'
+                      f'{str(options.set_merge_pipelines).lower()}'
+                      f'{Colors.RESET}')
             Platform.flush()
 
         # Set project merge skipped
@@ -727,10 +744,15 @@ class Entrypoint:
                 MergeRequestsSkipped.ATTRIBUTE,
                 options.set_merge_skipped,
             )
-            print(f'{Colors.BOLD}   - Set merge skipped: '
-                  f'{Colors.CYAN if changed else Colors.GREEN}'
-                  f'{str(options.set_merge_skipped).lower()}'
-                  f'{Colors.RESET}')
+            if changed is None:
+                print(f'{Colors.BOLD}   - Set merge skipped: '
+                      f'{Colors.RED}Unknown feature'
+                      f'{Colors.RESET}')
+            else:
+                print(f'{Colors.BOLD}   - Set merge skipped: '
+                      f'{Colors.CYAN if changed else Colors.GREEN}'
+                      f'{str(options.set_merge_skipped).lower()}'
+                      f'{Colors.RESET}')
             Platform.flush()
 
         # Set project merge resolved
@@ -740,10 +762,15 @@ class Entrypoint:
                 MergeRequestsResolved.ATTRIBUTE,
                 options.set_merge_resolved,
             )
-            print(f'{Colors.BOLD}   - Set merge method: '
-                  f'{Colors.CYAN if changed else Colors.GREEN}'
-                  f'{str(options.set_merge_resolved).lower()}'
-                  f'{Colors.RESET}')
+            if changed is None:
+                print(f'{Colors.BOLD}   - Set merge method: '
+                      f'{Colors.RED}Unknown feature'
+                      f'{Colors.RESET}')
+            else:
+                print(f'{Colors.BOLD}   - Set merge method: '
+                      f'{Colors.CYAN if changed else Colors.GREEN}'
+                      f'{str(options.set_merge_resolved).lower()}'
+                      f'{Colors.RESET}')
             Platform.flush()
 
         # Add path to CI/CD job token allowlist

{gitlab_projects_settings-6.1.1 → gitlab_projects_settings-6.2.0}/src/cli/main.py

@@ -257,13 +257,14 @@ def main() -> None:
 
     # Arguments advanced settings definitions
     group = parser.add_argument_group('advanced settings arguments')
-    group.add_argument(
+    subgroup = group.add_mutually_exclusive_group()
+    subgroup.add_argument(
         '--run-housekeeping',
         dest='run_housekeeping',
         action='store_true',
         help='Run housekeeping of GitLab project or projects in groups',
     )
-    group.add_argument(
+    subgroup.add_argument(
         '--prune-unreachable-objects',
         dest='prune_unreachable_objects',
         action='store_true',

{gitlab_projects_settings-6.1.1 → gitlab_projects_settings-6.2.0}/src/features/gitlab.py

@@ -2,11 +2,12 @@
 
 # Standard libraries
 from time import sleep
-from typing import cast, Dict, List, Union
+from typing import cast, Dict, List, Optional, Union
 
 # Modules libraries
 from gitlab import Gitlab
 from gitlab.base import RESTObject, RESTObjectList
+from gitlab.const import AccessLevel as GitLabAccessLevel
 from gitlab.exceptions import (
     GitlabDeleteError,
     GitlabGetError,
@@ -139,9 +140,18 @@ class GitLabFeature:
 
         # Remove group members
         group = self.group(criteria)
-        for member in group.members.list(get_all=True):
+        for member in sorted(
+                group.members.list(get_all=True),
+                key=lambda item: item.access_level,
+        ):
             if not self.__dry_run:
-                group.members.delete(member.id)
+                try:
+                    group.members.delete(member.id)
+                except GitlabDeleteError as exception:
+                    if member.access_level == GitLabAccessLevel.OWNER \
+                            and len(group.members.list(get_all=True)) == 1:
+                        continue
+                    raise exception
 
         # Save group
         if not self.__dry_run:
@@ -792,13 +802,17 @@ class GitLabFeature:
         criteria: str,
         name: str,
         value: Union[bool, str],
-    ) -> bool:
+    ) -> Optional[bool]:
 
         # Variables
         changed: bool = False
 
-        # Set project attribute
+        # Check project attribute
         project = self.project(criteria)
+        if not self.__dry_run and not hasattr(project, name):
+            return None
+
+        # Set project attribute
         if not self.__dry_run and getattr(project, name) != value:
             setattr(project, name, value)
             changed = True