gitlab-projects-settings 6.0.0__tar.gz → 6.1.0__tar.gz

{gitlab_projects_settings-6.0.0 → gitlab_projects_settings-6.1.0}/.gitlab-ci.yml

@@ -627,6 +627,7 @@ readme:
       changes:
         - 'CHANGELOG.md'
         - 'requirements/**/*'
+        - 'sonar-project.properties'
         - 'src/**/*'
         - 'tests/**/*'
     - if: $CI_COMMIT_TAG || $CI_PIPELINE_SOURCE == "trigger" || $CI_PIPELINE_SOURCE == "web" || $CI_COMMIT_REF_NAME != $CI_DEFAULT_BRANCH
@@ -728,6 +729,7 @@ sonarcloud:
       changes:
         - 'CHANGELOG.md'
         - 'requirements/**/*'
+        - 'sonar-project.properties'
         - 'src/**/*'
         - 'tests/**/*'
       when: always
@@ -881,7 +883,7 @@ pages:
     # Prepare documentation
     - |
       if [ ! -z "${CI_LOCAL:-}" ]; then
-        find ./config/* ./docs/* ./mkdocs.yml ./README.md -not -path ./docs/assets/stylesheets/variables.scss -type f | entr -n sh ./docs/prepare.sh &
+        find ./config/* ./docs/.* ./docs/* ./mkdocs.yml ./README.md -not -path ./docs/assets/stylesheets/variables.scss -type f | entr -n sh ./docs/prepare.sh &
         echo -n "${!}" >./docs/.serve.pid
         sleep 2
       else

{gitlab_projects_settings-6.0.0 → gitlab_projects_settings-6.1.0}/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+<a name="6.1.0"></a>
+## [6.1.0](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/compare/6.0.1...6.1.0) (2025-02-09)
+
+### ✨ Features
+
+- **entrypoint, gitlab:** show already valid settings in green ([ed29b3a](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/ed29b3a24a86e9fd37cc5857c7f3010b77bb34fa))
+- **entrypoint, gitlab:** show GitLab username upon authentication ([6beea96](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/6beea961771d3e3c58b0be3896d65d5353493adf))
+
+### 🐛 Bug Fixes
+
+- **entrypoint:** prevent acces to projects shared with groups ([c2308cd](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/c2308cd8f5aceb3ba8c7f7733ab7f95f91676fcf))
+
+### 📚 Documentation
+
+- **docs:** use '<span class=page-break>' instead of '<div>' ([fe38e5e](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/fe38e5ee4067f919191ce61b35c714a48ec927b3))
+- **prepare:** avoid 'TOC' injection if 'hide:  - toc' is used ([b05111b](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/b05111bc9f25a9dcf29db56fecfc8240a2cae575))
+
+### 🎨 Styling
+
+- **colors:** ignore 'Colored' import 'Incompatible import' warning ([56cb0df](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/56cb0df63be7cebd812204f30609bb6b04dec94b))
+
+### ⚙️ Cleanups
+
+- **sonar-project:** configure coverage checks in SonarCloud ([0a23f99](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/0a23f99271c9f3ef27b0d678ff2f7e635059a62d))
+
+### 🚀 CI
+
+- **gitlab-ci:** run coverage jobs if 'sonar-project.properties' changes ([b3efefc](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/b3efefc5e958093797e54ed69aac9d27f33f834c))
+- **gitlab-ci:** watch for 'docs/.*' changes in 'pages' jobs ([a4c1b0d](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/a4c1b0dbc07298e65815c62a3593bcc5039c1e10))
+
+
+<a name="6.0.1"></a>
+## [6.0.1](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/compare/6.0.0...6.0.1) (2025-01-01)
+
+### 🐛 Bug Fixes
+
+- **gitlab:** catch 'StopIteration' exceptions upon missing boards ([e200557](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/e200557e86edc81c556421adb613e7d4e81c56ed))
+
+
 <a name="6.0.0"></a>
 ## [6.0.0](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/compare/5.4.0...6.0.0) (2025-01-01)
 

{gitlab_projects_settings-6.0.0/gitlab_projects_settings.egg-info → gitlab_projects_settings-6.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: gitlab-projects-settings
-Version: 6.0.0
+Version: 6.1.0
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings
 Author: Adrian DC
@@ -33,6 +33,18 @@ Requires-Dist: python-gitlab>=4.4.0
 Requires-Dist: questionary>=2.0.1
 Requires-Dist: setuptools>=45.1.0
 Requires-Dist: update_checker>=0.18.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # gitlab-projects-settings
 

{gitlab_projects_settings-6.0.0 → gitlab_projects_settings-6.1.0}/docs/prepare.sh

@@ -62,7 +62,8 @@ sed -i \
 # Inject 'toc' section (PDF only)
 find "${docs_path}/" -name '*.md' \
   | while read -r file_path; do
-    if ! grep -q '\[TOC\]' "${file_path}" \
+    if ! grep -A1 '^hide:$' "${file_path}" | grep -q '^  - toc$' \
+      && ! grep -q '\[TOC\]' "${file_path}" \
       && ! grep -c '^## ' "${file_path}" | grep -q '^0$\|^1$' \
       && ! grep -q '^<!-- documentation no-toc -->$' "${file_path}" \
       && ! grep -q '^<!-- generated documentation section -->$' "${file_path}"; then
@@ -72,7 +73,7 @@ find "${docs_path}/" -name '*.md' \
 \
 [TOC]\
 \
-<div class="page-break"><\/div>/
+<span class="page-break"><\/span>/
         }
       ' "${file_path}"
     fi

{gitlab_projects_settings-6.0.0 → gitlab_projects_settings-6.1.0/gitlab_projects_settings.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: gitlab-projects-settings
-Version: 6.0.0
+Version: 6.1.0
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings
 Author: Adrian DC
@@ -33,6 +33,18 @@ Requires-Dist: python-gitlab>=4.4.0
 Requires-Dist: questionary>=2.0.1
 Requires-Dist: setuptools>=45.1.0
 Requires-Dist: update_checker>=0.18.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # gitlab-projects-settings
 

{gitlab_projects_settings-6.0.0 → gitlab_projects_settings-6.1.0}/sonar-project.properties

@@ -16,3 +16,6 @@ sonar.sources=src
 
 # Python versions
 sonar.python.version=3.8, 3.9, 3.10, 3.11, 3.12
+
+# Patterns used to exclude some files from coverage report.
+sonar.coverage.exclusions=setup.py

{gitlab_projects_settings-6.0.0 → gitlab_projects_settings-6.1.0}/src/cli/entrypoint.py

@@ -93,6 +93,7 @@ class Entrypoint:
         )
         print(f'{Colors.BOLD} - GitLab host: '
               f'{Colors.GREEN}{gitlab.url}'
+              f'{Colors.CYAN} ({gitlab.username})'
               f'{Colors.RESET}')
         Platform.flush()
 
@@ -189,6 +190,7 @@ class Entrypoint:
                 for group_project in sorted(
                         group.projects.list(
                             get_all=True,
+                            with_shared=False,
                             include_subgroups=not options.exclude_subgroups,
                             order_by='path',
                             sort='asc',
@@ -279,6 +281,9 @@ class Entrypoint:
         subgroup: bool = False,
     ) -> Result:
 
+        # Variables
+        changed: bool
+
         # Acquire group
         group = gitlab.group(criteria)
 
@@ -325,9 +330,12 @@ class Entrypoint:
 
         # Set group description
         if options.set_description:
-            gitlab.group_set_description(criteria, options.set_description)
+            changed = gitlab.group_set_description(
+                criteria,
+                options.set_description,
+            )
             print(f'{Colors.BOLD}   - Set description: '
-                  f'{Colors.CYAN}{options.set_description}'
+                  f'{Colors.CYAN if changed else Colors.GREEN}{options.set_description}'
                   f'{Colors.RESET}')
             Platform.flush()
 
@@ -345,9 +353,12 @@ class Entrypoint:
                     ):
                 description = f'{Namespaces.describe(name=group.name)}' \
                               f'{parent_description_text}'
-                gitlab.group_set_description(criteria, description)
+                changed = gitlab.group_set_description(
+                    criteria,
+                    description,
+                )
                 print(f'{Colors.BOLD}   - Updated description: '
-                      f'{Colors.CYAN}{description}'
+                      f'{Colors.CYAN if changed else Colors.GREEN}{description}'
                       f'{Colors.RESET}')
                 Platform.flush()
             else:
@@ -366,7 +377,10 @@ class Entrypoint:
 
         # Set group avatar
         if options.set_avatar:
-            gitlab.group_set_avatar(criteria, options.set_avatar)
+            gitlab.group_set_avatar(
+                criteria,
+                options.set_avatar,
+            )
             print(f'{Colors.BOLD}   - Set avatar: '
                   f'{Colors.CYAN}{options.set_avatar}'
                   f'{Colors.RESET}')
@@ -374,20 +388,26 @@ class Entrypoint:
 
         # Set group roles create projects
         if options.set_roles_create_projects:
-            gitlab.group_set_roles_create_projects(criteria,
-                                                   options.set_roles_create_projects)
-            print(f'{Colors.BOLD}   - Set roles allowed to create projects: '
-                  f'{Colors.CYAN}{options.set_roles_create_projects}'
-                  f'{Colors.RESET}')
+            changed = gitlab.group_set_roles_create_projects(
+                criteria,
+                options.set_roles_create_projects,
+            )
+            print(
+                f'{Colors.BOLD}   - Set roles allowed to create projects: '
+                f'{Colors.CYAN if changed else Colors.GREEN}{options.set_roles_create_projects}'
+                f'{Colors.RESET}')
             Platform.flush()
 
         # Set group roles create subgroups
         if options.set_roles_create_subgroups:
-            gitlab.group_set_roles_create_subgroups(criteria,
-                                                    options.set_roles_create_subgroups)
-            print(f'{Colors.BOLD}   - Set roles allowed to create subgroups: '
-                  f'{Colors.CYAN}{options.set_roles_create_subgroups}'
-                  f'{Colors.RESET}')
+            changed = gitlab.group_set_roles_create_subgroups(
+                criteria,
+                options.set_roles_create_subgroups,
+            )
+            print(
+                f'{Colors.BOLD}   - Set roles allowed to create subgroups: '
+                f'{Colors.CYAN if changed else Colors.GREEN}{options.set_roles_create_subgroups}'
+                f'{Colors.RESET}')
             Platform.flush()
 
         # Get group labels
@@ -446,6 +466,9 @@ class Entrypoint:
         criteria: str,
     ) -> Result:
 
+        # Variables
+        changed: bool
+
         # Acquire project
         project = gitlab.project(criteria)
 
@@ -479,9 +502,12 @@ class Entrypoint:
 
         # Set project description
         if options.set_description:
-            gitlab.project_set_description(criteria, options.set_description)
+            changed = gitlab.project_set_description(
+                criteria,
+                options.set_description,
+            )
             print(f'{Colors.BOLD}   - Set description: '
-                  f'{Colors.CYAN}{options.set_description}'
+                  f'{Colors.CYAN if changed else Colors.GREEN}{options.set_description}'
                   f'{Colors.RESET}')
             Platform.flush()
 
@@ -501,9 +527,12 @@ class Entrypoint:
                     not project.description.endswith(f' - {namespace_description}'):
                 description = f'{Namespaces.describe(name=project.name)}' \
                               f' - {namespace_description}'
-                gitlab.project_set_description(criteria, description)
+                changed = gitlab.project_set_description(
+                    criteria,
+                    description,
+                )
                 print(f'{Colors.BOLD}   - Updated description: '
-                      f'{Colors.CYAN}{description}'
+                      f'{Colors.CYAN if changed else Colors.GREEN}{description}'
                       f'{Colors.RESET}')
                 Platform.flush()
             else:
@@ -576,7 +605,10 @@ class Entrypoint:
 
         # Set project avatar
         if options.set_avatar:
-            gitlab.project_set_avatar(criteria, options.set_avatar)
+            gitlab.project_set_avatar(
+                criteria,
+                options.set_avatar,
+            )
             print(f'{Colors.BOLD}   - Set avatar: '
                   f'{Colors.CYAN}{options.set_avatar}'
                   f'{Colors.RESET}')
@@ -600,17 +632,25 @@ class Entrypoint:
 
         # Archive project
         if options.archive_project:
-            gitlab.project_set_archive(criteria, True)
+            changed = gitlab.project_set_archive(
+                criteria,
+                True,
+            )
             print(f'{Colors.BOLD}   - Archive project: '
-                  f'{Colors.GREEN}Success'
+                  f'{Colors.CYAN if changed else Colors.GREEN}'
+                  f'{"Success" if changed else "Already done"}'
                   f'{Colors.RESET}')
             Platform.flush()
 
         # Unarchive project
         elif options.unarchive_project:
-            gitlab.project_set_archive(criteria, False)
+            changed = gitlab.project_set_archive(
+                criteria,
+                False,
+            )
             print(f'{Colors.BOLD}   - Unarchive project: '
-                  f'{Colors.GREEN}Success'
+                  f'{Colors.CYAN if changed else Colors.GREEN}'
+                  f'{"Success" if changed else "Already done"}'
                   f'{Colors.RESET}')
             Platform.flush()
 
@@ -645,61 +685,64 @@ class Entrypoint:
 
         # Set project merge method
         if options.set_merge_method is not None:
-            gitlab.project_set_attribute(
+            changed = gitlab.project_set_attribute(
                 criteria,
                 MergeRequestsMethod.ATTRIBUTE,
                 MergeRequestsMethod.VALUES[options.set_merge_method],
             )
             print(f'{Colors.BOLD}   - Set merge method: '
-                  f'{Colors.CYAN}{options.set_merge_method}'
+                  f'{Colors.CYAN if changed else Colors.GREEN}{options.set_merge_method}'
                   f'{Colors.RESET}')
             Platform.flush()
 
         # Set project merge squash
         if options.set_merge_squash is not None:
-            gitlab.project_set_attribute(
+            changed = gitlab.project_set_attribute(
                 criteria,
                 MergeRequestsSquash.ATTRIBUTE,
                 MergeRequestsSquash.VALUES[options.set_merge_squash],
             )
             print(f'{Colors.BOLD}   - Set merge squash: '
-                  f'{Colors.CYAN}{options.set_merge_squash}'
+                  f'{Colors.CYAN if changed else Colors.GREEN}{options.set_merge_squash}'
                   f'{Colors.RESET}')
             Platform.flush()
 
         # Set project merge pipelines
         if options.set_merge_pipelines is not None:
-            gitlab.project_set_attribute(
+            changed = gitlab.project_set_attribute(
                 criteria,
                 MergeRequestsPipelines.ATTRIBUTE,
                 options.set_merge_pipelines,
             )
             print(f'{Colors.BOLD}   - Set merge pipelines: '
-                  f'{Colors.CYAN}{str(options.set_merge_pipelines).lower()}'
+                  f'{Colors.CYAN if changed else Colors.GREEN}'
+                  f'{str(options.set_merge_pipelines).lower()}'
                   f'{Colors.RESET}')
             Platform.flush()
 
         # Set project merge skipped
         if options.set_merge_skipped is not None:
-            gitlab.project_set_attribute(
+            changed = gitlab.project_set_attribute(
                 criteria,
                 MergeRequestsSkipped.ATTRIBUTE,
                 options.set_merge_skipped,
             )
             print(f'{Colors.BOLD}   - Set merge skipped: '
-                  f'{Colors.CYAN}{str(options.set_merge_skipped).lower()}'
+                  f'{Colors.CYAN if changed else Colors.GREEN}'
+                  f'{str(options.set_merge_skipped).lower()}'
                   f'{Colors.RESET}')
             Platform.flush()
 
         # Set project merge resolved
         if options.set_merge_resolved is not None:
-            gitlab.project_set_attribute(
+            changed = gitlab.project_set_attribute(
                 criteria,
                 MergeRequestsResolved.ATTRIBUTE,
                 options.set_merge_resolved,
             )
             print(f'{Colors.BOLD}   - Set merge method: '
-                  f'{Colors.CYAN}{str(options.set_merge_resolved).lower()}'
+                  f'{Colors.CYAN if changed else Colors.GREEN}'
+                  f'{str(options.set_merge_resolved).lower()}'
                   f'{Colors.RESET}')
             Platform.flush()
 

{gitlab_projects_settings-6.0.0 → gitlab_projects_settings-6.1.0}/src/features/gitlab.py

@@ -80,11 +80,17 @@ class GitLabFeature:
             self.__gitlab.auth()
 
     # Group
-    def group(self, criteria: str) -> Group:
+    def group(
+        self,
+        criteria: str,
+    ) -> Group:
         return self.__gitlab.groups.get(criteria)
 
     # Group delete
-    def group_delete(self, criteria: str) -> None:
+    def group_delete(
+        self,
+        criteria: str,
+    ) -> None:
 
         # Delete group
         group = self.group(criteria)
@@ -126,7 +132,10 @@ class GitLabFeature:
         return group.labels.list(get_all=True)
 
     # Group reset members
-    def group_reset_members(self, criteria: str) -> None:
+    def group_reset_members(
+        self,
+        criteria: str,
+    ) -> None:
 
         # Remove group members
         group = self.group(criteria)
@@ -139,7 +148,11 @@ class GitLabFeature:
             group.save()
 
     # Group set avatar
-    def group_set_avatar(self, criteria: str, file: str) -> None:
+    def group_set_avatar(
+        self,
+        criteria: str,
+        file: str,
+    ) -> None:
 
         # Set group avatar
         group = self.group(criteria)
@@ -151,16 +164,27 @@ class GitLabFeature:
                 group.save()
 
     # Group set description
-    def group_set_description(self, criteria: str, description: str) -> None:
+    def group_set_description(
+        self,
+        criteria: str,
+        description: str,
+    ) -> bool:
+
+        # Variables
+        changed: bool = False
 
         # Set group description
         group = self.group(criteria)
-        if not self.__dry_run:
+        if not self.__dry_run and group.description != description:
             group.description = description
+            changed = True
 
             # Save group
             group.save()
 
+        # Result
+        return changed
+
     # Group set label, pylint: disable=too-many-arguments,too-many-positional-arguments
     def group_set_label(
         self,
@@ -195,7 +219,14 @@ class GitLabFeature:
         return label
 
     # Group set roles create projects
-    def group_set_roles_create_projects(self, criteria: str, level: str) -> None:
+    def group_set_roles_create_projects(
+        self,
+        criteria: str,
+        level: str,
+    ) -> bool:
+
+        # Variables
+        changed: bool = False
 
         # Validate level
         if level not in RolesCreateProjects.names():
@@ -204,14 +235,25 @@ class GitLabFeature:
 
         # Set roles allowed to create projects
         group = self.group(criteria)
-        if not self.__dry_run:
+        if not self.__dry_run and group.project_creation_level != level:
             group.project_creation_level = level
+            changed = True
 
             # Save group
             group.save()
 
+        # Result
+        return changed
+
     # Group set roles create subgroups
-    def group_set_roles_create_subgroups(self, criteria: str, level: str) -> None:
+    def group_set_roles_create_subgroups(
+        self,
+        criteria: str,
+        level: str,
+    ) -> bool:
+
+        # Variables
+        changed: bool = False
 
         # Validate level
         if level not in RolesCreateSubgroups.names():
@@ -220,22 +262,35 @@ class GitLabFeature:
 
         # Set roles allowed to create subgroups
         group = self.group(criteria)
-        if not self.__dry_run:
+        if not self.__dry_run and group.subgroup_creation_level != level:
             group.subgroup_creation_level = level
+            changed = True
 
             # Save group
             group.save()
 
+        # Result
+        return changed
+
     # Namespace
-    def namespace(self, criteria: str) -> Namespace:
+    def namespace(
+        self,
+        criteria: str,
+    ) -> Namespace:
         return self.__gitlab.namespaces.get(criteria)
 
     # Project
-    def project(self, criteria: str) -> Project:
+    def project(
+        self,
+        criteria: str,
+    ) -> Project:
         return self.__gitlab.projects.get(criteria)
 
     # Project delete
-    def project_delete(self, criteria: str) -> None:
+    def project_delete(
+        self,
+        criteria: str,
+    ) -> None:
 
         # Delete project
         project = self.project(criteria)
@@ -267,7 +322,10 @@ class GitLabFeature:
         sleep(3)
 
     # Project erase jobs artifacts
-    def project_erase_jobs_artifacts(self, criteria: str) -> None:
+    def project_erase_jobs_artifacts(
+        self,
+        criteria: str,
+    ) -> None:
 
         # Erase project jobs artifacts
         project = self.project(criteria)
@@ -277,7 +335,10 @@ class GitLabFeature:
                     job.delete_artifacts()
 
     # Project erase jobs artifacts and traces
-    def project_erase_jobs_contents(self, criteria: str) -> None:
+    def project_erase_jobs_contents(
+        self,
+        criteria: str,
+    ) -> None:
 
         # Erase project jobs artifacts and traces
         project = self.project(criteria)
@@ -338,7 +399,10 @@ class GitLabFeature:
                 project.job_token_scope.get().groups_allowlist.delete(path_group.id)
 
     # Project protect branches
-    def project_protect_branches(self, criteria: str) -> List[str]:
+    def project_protect_branches(
+        self,
+        criteria: str,
+    ) -> List[str]:
 
         # Validate project feature
         result: List[str] = []
@@ -422,13 +486,14 @@ class GitLabFeature:
     ) -> List[str]:
 
         # Variables
+        changed: bool
         result: List[str] = []
         project = self.__gitlab.projects.get(criteria, statistics=True)
 
         # Iterate through features
         for key in features:
             if key in ProjectFeatures.keys():
-                changed: bool = False
+                changed = False
                 feature = ProjectFeatures.get(key)
 
                 # Disable 'access_level' feature
@@ -472,13 +537,14 @@ class GitLabFeature:
     ) -> List[str]:
 
         # Variables
+        changed: bool
         result: List[str] = []
         project = self.__gitlab.projects.get(criteria, statistics=True)
 
         # Iterate through features
         for key in features:
             if key in ProjectFeatures.keys():
-                changed: bool = False
+                changed = False
                 feature = ProjectFeatures.get(key)
 
                 # Enable 'access_level' feature
@@ -522,13 +588,14 @@ class GitLabFeature:
     ) -> List[str]:
 
         # Variables
+        changed: bool
         result: List[str] = []
         project = self.__gitlab.projects.get(criteria, statistics=True)
 
         # Iterate through features
         for key in ProjectFeatures.keys():
             if key not in keep_features:
-                changed: bool = False
+                changed = False
                 feature = ProjectFeatures.get(key)
 
                 # Disable 'access_level' feature
@@ -589,7 +656,11 @@ class GitLabFeature:
         ]
 
     # Project protect tags, pylint: disable=too-many-branches
-    def project_protect_tags(self, criteria: str, protect_level: str) -> List[str]:
+    def project_protect_tags(
+        self,
+        criteria: str,
+        protect_level: str,
+    ) -> List[str]:
 
         # Validate project feature
         result: List[str] = []
@@ -650,7 +721,10 @@ class GitLabFeature:
         return result
 
     # Project prune unreachable objects
-    def project_prune_unreachable_objects(self, criteria: str) -> None:
+    def project_prune_unreachable_objects(
+        self,
+        criteria: str,
+    ) -> None:
 
         # Prune project unreachable objects
         project = self.project(criteria)
@@ -658,7 +732,10 @@ class GitLabFeature:
             project.housekeeping(post_data={'task': 'prune'})
 
     # Project reset members
-    def project_reset_members(self, criteria: str) -> None:
+    def project_reset_members(
+        self,
+        criteria: str,
+    ) -> None:
 
         # Remove project members
         project = self.project(criteria)
@@ -673,7 +750,10 @@ class GitLabFeature:
             project.save()
 
     # Project run housekeeping
-    def project_run_housekeeping(self, criteria: str) -> None:
+    def project_run_housekeeping(
+        self,
+        criteria: str,
+    ) -> None:
 
         # Run project housekeeping
         project = self.project(criteria)
@@ -681,16 +761,30 @@ class GitLabFeature:
             project.housekeeping()
 
     # Project set archive
-    def project_set_archive(self, criteria: str, enabled: bool) -> None:
+    def project_set_archive(
+        self,
+        criteria: str,
+        enabled: bool,
+    ) -> bool:
+
+        # Variables
+        changed: bool = False
 
         # Archive project
         project = self.project(criteria)
         if not self.__dry_run and enabled:
-            project.archive()
+            if not project.archived:
+                project.archive()
+                changed = True
 
         # Unarchive project
         elif not self.__dry_run:
-            project.unarchive()
+            if project.archived:
+                project.unarchive()
+                changed = True
+
+        # Result
+        return changed
 
     # Project set attribute
     def project_set_attribute(
@@ -698,18 +792,29 @@ class GitLabFeature:
         criteria: str,
         name: str,
         value: Union[bool, str],
-    ) -> None:
+    ) -> bool:
+
+        # Variables
+        changed: bool = False
 
         # Set project attribute
         project = self.project(criteria)
-        if not self.__dry_run:
+        if not self.__dry_run and getattr(project, name) != value:
             setattr(project, name, value)
+            changed = True
 
             # Save project
             project.save()
 
+        # Result
+        return changed
+
     # Project set avatar
-    def project_set_avatar(self, criteria: str, file: str) -> None:
+    def project_set_avatar(
+        self,
+        criteria: str,
+        file: str,
+    ) -> None:
 
         # Set project avatar
         project = self.project(criteria)
@@ -721,16 +826,27 @@ class GitLabFeature:
                 project.save()
 
     # Project set description
-    def project_set_description(self, criteria: str, description: str) -> None:
+    def project_set_description(
+        self,
+        criteria: str,
+        description: str,
+    ) -> bool:
+
+        # Variables
+        changed: bool = False
 
         # Set project description
         project = self.project(criteria)
-        if not self.__dry_run:
+        if not self.__dry_run and project.description != description:
             project.description = description
+            changed = True
 
             # Save project
             project.save()
 
+        # Result
+        return changed
+
     # Project set issues_board, pylint: disable=too-many-arguments,too-many-positional-arguments
     def project_set_issues_board(
         self,
@@ -747,7 +863,7 @@ class GitLabFeature:
         try:
             issues_board = next(board for board in project.boards.list(get_all=True)
                                 if board.name == name and isinstance(board, ProjectBoard))
-        except GitlabGetError:
+        except (GitlabGetError, StopIteration):
             project.boards.create({
                 'name': name,
             })
@@ -769,7 +885,7 @@ class GitLabFeature:
                                   for board_list in issues_board.lists.list(get_all=True)
                                   if board_list.label['name'] == list_json['label']
                                   and isinstance(board_list, ProjectBoardList))
-            except (GitlabGetError, IndexError):
+            except (GitlabGetError, IndexError, StopIteration):
                 label = project.labels.get(list_json['label'],
                                            include_ancestor_groups=True)
                 issues_board.lists.create({
@@ -832,14 +948,24 @@ class GitLabFeature:
         # Result
         return label
 
+    # URL
+    @property
+    def url(self) -> str:
+        return str(self.__gitlab.api_url)
+
     # User
-    def user(self, criteria: str) -> User:
+    def user(
+        self,
+        criteria: str,
+    ) -> User:
         users = self.__gitlab.users.list(all=True, iterator=True, username=criteria)
         for user in users:
             return cast(User, user)
-        raise RuntimeError()
+        raise RuntimeError(f'Could not find user {criteria}')
 
-    # URL
+    # User name
     @property
-    def url(self) -> str:
-        return str(self.__gitlab.api_url)
+    def username(self) -> str:
+        if self.__gitlab.user:
+            return str(self.__gitlab.user.username)
+        return '/'

{gitlab_projects_settings-6.0.0 → gitlab_projects_settings-6.1.0}/src/prints/colors.py

@@ -8,7 +8,7 @@ try:
     try: # colored>=2.0.0
         from colored import Colored
     except ImportError: # colored<2.0.0 # pragma: no cover
-        from colored import colored as Colored
+        from colored import colored as Colored # type: ignore[assignment]
 except ModuleNotFoundError: # pragma: no cover
     pass