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

{gitlab_projects_settings-5.4.0 → gitlab_projects_settings-6.0.0}/.gitignore

@@ -14,6 +14,7 @@ coverage-reports/
 dist/
 
 # Documentation intermediates
+/docs/.pages
 /docs/.serve.pid
 /docs/about
 /docs/assets/stylesheets/variables.scss

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

@@ -1,5 +1,5 @@
 include:
-  - component: gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commits@3.0.0
+  - component: gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commits@4.0.0
     inputs:
       stage: prepare
 
@@ -19,6 +19,7 @@ variables:
 
 .local:
   engine: docker,auto
+  no_regex: true
   real_paths: true
   sockets: true
   version: 11.0
@@ -66,7 +67,7 @@ changelog:
       sed -i "s#raw/[^/]*/docs#raw/${tag}/docs#g" ./README.md
       git add -v ./CHANGELOG.md ./README.md
       echo ' '
-      git commit -m "docs(changelog): regenerate release tag changes history" -s
+      git commit -m "docs(changelog): release version ${tag} and refresh changes history" -s
       echo ' '
     # Create release tag
     - git tag -f -m "${tag}" "${tag}"
@@ -851,12 +852,32 @@ pages:
   variables:
     CI_LOCAL_NETWORK: 'host'
     MKDOCS_EXPORTER_PDF_ENABLED: 'true'
+    MKDOCS_EXPORTER_PDF_OUTPUT: 'gitlab-projects-settings'
   script:
     # Fetch all tags
     - |
       if [ -z "${CI_LOCAL:-}" ]; then
         git fetch --tags --unshallow || true
       fi
+    # Set PDF output version
+    - export MKDOCS_EXPORTER_PDF_OUTPUT="${MKDOCS_EXPORTER_PDF_OUTPUT%.pdf}-$(git describe --abbrev=7 --always --tags).pdf"
+    # Run locally without PDF
+    - |
+      if [ ! -z "${CI_LOCAL:-}" ] && [ ! "${CI_JOB_NAME:-}" = 'pdf' ]; then
+        export MKDOCS_EXPORTER_PDF_ENABLED='false'
+      fi
+    # Validate network interfaces
+    - |
+      if [ ! -z "${CI_LOCAL:-}" ] && hostname -I | tr ' ' '\n' | grep '.' | wc -l | grep -q '^0$\|^1$'; then
+        set +x
+        echo ' '
+        echo -n ' [INFO] Network addresses: '
+        hostname -I
+        echo ' '
+        echo ' [ERROR] Incompatible local CI version detected or missing host network interfaces...'
+        echo ' '
+        exit 1
+      fi
     # Prepare documentation
     - |
       if [ ! -z "${CI_LOCAL:-}" ]; then
@@ -890,6 +911,7 @@ pages:
       changes: !reference [.pages, rules, changes]
     - if: $CI_COMMIT_BRANCH && $CI_COMMIT_REF_PROTECTED
       changes: !reference [.pages, rules, changes]
+      allow_failure: true
       when: manual
 
 pdf:
@@ -899,7 +921,7 @@ pdf:
   artifacts:
     expire_in: 1 hour
     paths:
-      - public/documentation.pdf
+      - public/$MKDOCS_EXPORTER_PDF_OUTPUT*.pdf
   rules:
     - if: $CI_COMMIT_TAG
     - if: $CI_COMMIT_BRANCH

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

@@ -1,5 +1,54 @@
 # Changelog
 
+<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)
+
+### ✨ Features
+
+- **cli:** implement '--{get,set}-project-issues-boards' features ([0a88810](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/0a88810784efeb97f4f3cd1bdd22741bfb482288))
+- **cli, gitlab:** implement '--set-roles-create-{projects,subgroups}' ([56f7aba](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/56f7aba1a74ac1fde1c1d5c96ecc733683a94762))
+- **entrypoint:** show projects description after '# ...' ([fbd6678](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/fbd6678ce14808d0b5a7b000e9f503ccf6829d44))
+- **entrypoint:** allow empty description and custom indent in 'confirm' ([03fb17c](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/03fb17c49957a5377edc572ef161a45e5df2cad1))
+- **entrypoint:** use '...' quotes in 'confirm' function ([6e77117](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/6e77117320ea2949c56308039fba0682f80d56b9))
+
+### 🐛 Bug Fixes
+
+- **cli:** use package name for 'Updates' checks ([06d795e](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/06d795e0e870d2992cf20f4761c230267d4978bf))
+- **entrypoint:** show '# /' if no description is set ([fbf2a28](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/fbf2a2807fdd49f957da676ba16030a733be8505))
+- **gitlab:** support GitLab Premium delayed project/group deletions ([0ebc2c1](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/0ebc2c1117a119366515399b95cc7c1bcde78d02))
+
+### 📚 Documentation
+
+- **mkdocs:** minor '(prefers-color-scheme...)' syntax improvements ([3964c8f](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/3964c8f53df20d048e848634da08c7498fd0c1d2))
+- **mkdocs:** remove 'preview.py' and 'template.svg' files exclusions ([8caccf0](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/8caccf0ca0ce828343c2c433df4eeeb2b3142553))
+- **mkdocs, pages:** use 'MKDOCS_EXPORTER_PDF_OUTPUT' for PDF file ([e05833d](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/e05833d94647f9827b66eebea1c3eceacdf7b124))
+- **pages:** rename PDF link title to 'Export as PDF' ([f0b2b58](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/f0b2b5804debdc4c0289dffb717d8ac8dd313c21))
+- **pdf:** avoid header / footer lines on front / back pages ([84ed713](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/84ed713b6b690c4d2900634f4e97a376b04b65a4))
+- **pdf:** minor stylesheets codestyle improvements ([7373bd6](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/7373bd62de55a70375bcf9f4a6d812c82bbc7280))
+- **pdf:** reverse PDF front / back cover pages colors for printers ([7505256](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/7505256812186297b3f85f98a496f10730771b88))
+- **prepare:** use 'mkdocs.yml' to get project name value ([837d15b](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/837d15b1f345249da3620ed7debc1ce916e634b7))
+- **readme:** add missing '--' separator after '--reset-features' ([bd038df](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/bd038df4d21894a844489f5462ebd5e282566d96))
+- **stylesheets:** resolve lines and arrows visibility in dark mode ([89b16f6](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/89b16f6dec671af4be1f15f749f45b283088f53c))
+- **templates:** add 'Author' and 'Description' to PDF front page ([eff3014](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/eff3014e2fd7f229fcd548ddaebd180951a101ed))
+- **templates:** add 'Date' detail on PDF front page ([f1042d9](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/f1042d9463ee3cc1389608ce7a2016d1e5c1eb89))
+- **templates:** use Git commit SHA1 as version if no Git tag found ([37e1080](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/37e108093449c531bb579b4c057708079c4cff19))
+
+### 🧪 Test
+
+- **test:** fix daily updates coverage test syntax ([0eac0ac](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/0eac0acdab4b14add861e507c214cf9178a2bca4))
+
+### 🚀 CI
+
+- **gitlab-ci:** avoid PDF slow generation locally outside 'pdf' job ([77fc8e8](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/77fc8e88c8090133f10c27974037e99b075ee74e))
+- **gitlab-ci:** validate host network interfaces support ([d706e44](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/d706e44166c72cbae17fb8ca989bd5a0bc93e9f5))
+- **gitlab-ci:** enable '.local: no_regex' feature ([9235ece](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/9235ece9a5d326e4faa45715f79cea75a478cbd6))
+- **gitlab-ci:** append Git version to PDF output file name ([6e8cd69](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/6e8cd693ec6fefe56da07e3793f839d3e1bccb00))
+- **gitlab-ci:** rename PDF to 'gitlab-projects-settings' ([63344bd](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/63344bd3bf582ed9a893602e68e7f581dde46f4e))
+- **gitlab-ci:** migrate to 'pre-commit-crocodile/commits@4.0.0' ([708acf7](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/708acf7a548f54790f7e4e1e83016019811b74d9))
+- **gitlab-ci:** ensure 'pages' job does not block pipeline if manual ([077e41f](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/077e41f1c25e8c609df86104e2b1a1339e9f9b4e))
+- **gitlab-ci:** change release title to include tag version ([51b8089](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/commit/51b80895a57f7bc7c1429dfd27ac44c0a210633f))
+
+
 <a name="5.4.0"></a>
 ## [5.4.0](https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings/compare/5.3.1...5.4.0) (2024-10-28)
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: gitlab-projects-settings
-Version: 5.4.0
+Version: 6.0.0
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/RadianDevCore/tools/gitlab-projects-settings
 Author: Adrian DC
@@ -91,7 +91,7 @@ gitlab-projects-settings --protect-tags -- 'https://gitlab.com/group'
 gitlab-projects-settings --set-avatar ./avatar.png --update-description 'https://gitlab.com/group'
 
 # Automatically detect and reset features of projects based on usage
-gitlab-projects-settings --reset-features 'https://gitlab.com/group/project'
+gitlab-projects-settings --reset-features -- 'https://gitlab.com/group/project'
 ```
 
 <!-- prettier-ignore-end -->
@@ -109,86 +109,98 @@ usage: gitlab-projects-settings [-h] [--version] [--no-color] [--update-check] [
                                 [--exclude-projects] [--available-features] [--reset-features [KEEP_FEATURES]]
                                 [--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]
                                 [--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]]
                                 [--set-merge-skipped [CHECK]] [--set-merge-resolved [CHECK]]
-                                [--erase-jobs-artifacts | --erase-jobs-contents]
-                                [--get-group-labels | --set-group-labels JSON]
+                                [--add-jobs-token-allowlist PATH] [--remove-jobs-token-allowlist PATH]
+                                [--erase-jobs-artifacts | --erase-jobs-contents] [--get-project-issues-boards]
+                                [--set-project-issues-boards JSON] [--get-group-labels | --set-group-labels JSON]
                                 [--get-project-labels | --set-project-labels JSON] [--]
                                 [url_path]
 
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
 
 internal arguments:
-  -h, --help                        # Show this help message
-  --version                         # Show the current version
-  --no-color                        # Disable colors outputs with 'NO_COLOR=1'
-                                    # (or default settings: [themes] > no_color)
-  --update-check                    # Check for newer package updates
-  --settings                        # Show the current settings path and contents
-  --set GROUP KEY VAL               # Set settings specific 'VAL' value to [GROUP] > KEY
-                                    # or unset by using 'UNSET' as 'VAL'
+  -h, --help                           # Show this help message
+  --version                            # Show the current version
+  --no-color                           # Disable colors outputs with 'NO_COLOR=1'
+                                       # (or default settings: [themes] > no_color)
+  --update-check                       # Check for newer package updates
+  --settings                           # Show the current settings path and contents
+  --set GROUP KEY VAL                  # Set settings specific 'VAL' value to [GROUP] > KEY
+                                       # or unset by using 'UNSET' as 'VAL'
 
 credentials arguments:
-  -c FILES, --config FILES          # Python GitLab configuration files (default: PYTHON_GITLAB_CFG environment)
+  -c FILES, --config FILES             # Python GitLab configuration files (default: PYTHON_GITLAB_CFG environment)
 
 common settings arguments:
-  --confirm                         # Automatically confirm all removal and contents warnings
-  --dry-run                         # Enable dry run mode to check without saving
-  --dump                            # Dump Python objects of groups and projects
-  --exclude-group                   # Exclude parent group settings
-  --exclude-subgroups               # Exclude children subgroups settings
-  --exclude-projects                # Exclude children projects settings
+  --confirm                            # Automatically confirm all removal and contents warnings
+  --dry-run                            # Enable dry run mode to check without saving
+  --dump                               # Dump Python objects of groups and projects
+  --exclude-group                      # Exclude parent group settings
+  --exclude-subgroups                  # Exclude children subgroups settings
+  --exclude-projects                   # Exclude children projects settings
 
 general settings arguments:
-  --available-features              # List the available GitLab project features known by the tool
-  --reset-features [KEEP_FEATURES]  # Reset features of GitLab projects based on usage
-                                    # (Optionally keep features separated by ",")
-  --disable-features FEATURES       # List of features to disable separated by ","
-  --enable-features FEATURES        # List of features to enable separated by ","
-  --reset-members                   # Reset members of GitLab projects and groups
-  --set-avatar FILE                 # Set avatar of GitLab projects and groups
-  --set-description TEXT            # Set description of GitLab projects and groups
-  --update-descriptions             # Update description of GitLab projects and groups automatically
+  --available-features                 # List the available GitLab project features known by the tool
+  --reset-features [KEEP_FEATURES]     # Reset features of GitLab projects based on usage
+                                       # (Optionally keep features separated by ",")
+  --disable-features FEATURES          # List of features to disable separated by ","
+  --enable-features FEATURES           # List of features to enable separated by ","
+  --reset-members                      # Reset members of GitLab projects and groups
+  --set-avatar FILE                    # Set avatar of GitLab projects and groups
+  --set-description TEXT               # Set description of GitLab projects and groups
+  --update-descriptions                # Update description of GitLab projects and groups automatically
+
+group settings arguments:
+  --set-roles-create-projects [ROLE]   # Set roles allowed to create projects [noone,owner,maintainer,developer,administrator] (default: developer)
+  --set-roles-create-subgroups [ROLE]  # Set roles allowed to create subgroups [owner,maintainer] (default: maintainer)
 
 advanced settings arguments:
-  --run-housekeeping                # Run housekeeping of GitLab project or projects in groups
-  --prune-unreachable-objects       # Prune unreachable objects of GitLab project or projects in groups
-  --archive-projects                # Archive project or projects in GitLab groups
-  --unarchive-projects              # Unarchive project or projects in GitLab groups
-  --delete-groups                   # Delete group or groups in GitLab groups
-  --delete-projects                 # Delete project or projects in GitLab groups
+  --run-housekeeping                   # Run housekeeping of GitLab project or projects in groups
+  --prune-unreachable-objects          # Prune unreachable objects of GitLab project or projects in groups
+  --archive-projects                   # Archive project or projects in GitLab groups
+  --unarchive-projects                 # Unarchive project or projects in GitLab groups
+  --delete-groups                      # Delete group or groups in GitLab groups
+  --delete-projects                    # Delete project or projects in GitLab groups
 
 repository settings arguments:
-  --protect-branches                # Protect branches with default master/main, develop and staging
-  --protect-tags [LEVEL]            # Protect tags at level [no-one,admins,maintainers,developers] (default: no-one)
+  --protect-branches                   # Protect branches with default master/main, develop and staging
+  --protect-tags [LEVEL]               # Protect tags at level [no-one,admins,maintainers,developers] (default: no-one)
 
 merge requests settings arguments:
-  --set-merge-method [METHOD]       # Set project merge requests method (Merge, Semi-linear, Fast-forward, default: Fast-forward)
-  --set-merge-squash [SQUASH]       # Set project merge requests squashing (Do not allow, Allow, Encourage, Require, default: Allow)
-  --set-merge-pipelines [CHECK]     # Set project merge requests check for successful pipelines (true, false, default: True)
-  --set-merge-skipped [CHECK]       # Set project merge requests check for skipped pipelines (true, false, default: True)
-  --set-merge-resolved [CHECK]      # Set project merge requests check for resolved threads (true, false, default: True)
+  --set-merge-method [METHOD]          # Set project merge requests method (Merge, Semi-linear, Fast-forward, default: Fast-forward)
+  --set-merge-squash [SQUASH]          # Set project merge requests squashing (Do not allow, Allow, Encourage, Require, default: Allow)
+  --set-merge-pipelines [CHECK]        # Set project merge requests check for successful pipelines (true, false, default: True)
+  --set-merge-skipped [CHECK]          # Set project merge requests check for skipped pipelines (true, false, default: True)
+  --set-merge-resolved [CHECK]         # Set project merge requests check for resolved threads (true, false, default: True)
 
 ci/cd settings arguments:
-  --erase-jobs-artifacts            # Erase all CI/CD jobs artifacts
-  --erase-jobs-contents             # Erase all CI/CD jobs artifacts and traces
+  --add-jobs-token-allowlist PATH      # Add a group or project to CI/CD job token allowlist
+  --remove-jobs-token-allowlist PATH   # Remove a group or project from CI/CD job token allowlist
+  --erase-jobs-artifacts               # Erase all CI/CD jobs artifacts
+  --erase-jobs-contents                # Erase all CI/CD jobs artifacts and traces
+
+issues arguments:
+  --get-project-issues-boards          # Get the GitLab project issues boards in JSON format
+  --set-project-issues-boards JSON     # Set the GitLab project issues boards from JSON format
 
 labels arguments:
-  --get-group-labels                # Get the GitLab group labels in JSON format
-  --set-group-labels JSON           # Set the GitLab group labels from JSON format
-  --get-project-labels              # Get the GitLab project labels in JSON format
-  --set-project-labels JSON         # Set the GitLab project labels from JSON format
+  --get-group-labels                   # Get the GitLab group labels in JSON format
+  --set-group-labels JSON              # Set the GitLab group labels from JSON format
+  --get-project-labels                 # Get the GitLab project labels in JSON format
+  --set-project-labels JSON            # Set the GitLab project labels from JSON format
 
 positional arguments:
-  --                                # Positional arguments separator (recommended)
-  url_path                          # GitLab group or project path URL
+  --                                   # Positional arguments separator (recommended)
+  url_path                             # GitLab group or project path URL
 
 environment variables:
-  GITLAB_TOKEN                      # GitLab API token environment variable
-  CI_JOB_TOKEN                      # GitLab CI job token environment variable (CI only)
+  GITLAB_TOKEN                         # GitLab API token environment variable
+  CI_JOB_TOKEN                         # GitLab CI job token environment variable (CI only)
 ```
 
 <!-- readme-help-stop -->

{gitlab_projects_settings-5.4.0 → gitlab_projects_settings-6.0.0}/README.md

@@ -55,7 +55,7 @@ gitlab-projects-settings --protect-tags -- 'https://gitlab.com/group'
 gitlab-projects-settings --set-avatar ./avatar.png --update-description 'https://gitlab.com/group'
 
 # Automatically detect and reset features of projects based on usage
-gitlab-projects-settings --reset-features 'https://gitlab.com/group/project'
+gitlab-projects-settings --reset-features -- 'https://gitlab.com/group/project'
 ```
 
 <!-- prettier-ignore-end -->
@@ -73,86 +73,98 @@ usage: gitlab-projects-settings [-h] [--version] [--no-color] [--update-check] [
                                 [--exclude-projects] [--available-features] [--reset-features [KEEP_FEATURES]]
                                 [--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]
                                 [--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]]
                                 [--set-merge-skipped [CHECK]] [--set-merge-resolved [CHECK]]
-                                [--erase-jobs-artifacts | --erase-jobs-contents]
-                                [--get-group-labels | --set-group-labels JSON]
+                                [--add-jobs-token-allowlist PATH] [--remove-jobs-token-allowlist PATH]
+                                [--erase-jobs-artifacts | --erase-jobs-contents] [--get-project-issues-boards]
+                                [--set-project-issues-boards JSON] [--get-group-labels | --set-group-labels JSON]
                                 [--get-project-labels | --set-project-labels JSON] [--]
                                 [url_path]
 
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
 
 internal arguments:
-  -h, --help                        # Show this help message
-  --version                         # Show the current version
-  --no-color                        # Disable colors outputs with 'NO_COLOR=1'
-                                    # (or default settings: [themes] > no_color)
-  --update-check                    # Check for newer package updates
-  --settings                        # Show the current settings path and contents
-  --set GROUP KEY VAL               # Set settings specific 'VAL' value to [GROUP] > KEY
-                                    # or unset by using 'UNSET' as 'VAL'
+  -h, --help                           # Show this help message
+  --version                            # Show the current version
+  --no-color                           # Disable colors outputs with 'NO_COLOR=1'
+                                       # (or default settings: [themes] > no_color)
+  --update-check                       # Check for newer package updates
+  --settings                           # Show the current settings path and contents
+  --set GROUP KEY VAL                  # Set settings specific 'VAL' value to [GROUP] > KEY
+                                       # or unset by using 'UNSET' as 'VAL'
 
 credentials arguments:
-  -c FILES, --config FILES          # Python GitLab configuration files (default: PYTHON_GITLAB_CFG environment)
+  -c FILES, --config FILES             # Python GitLab configuration files (default: PYTHON_GITLAB_CFG environment)
 
 common settings arguments:
-  --confirm                         # Automatically confirm all removal and contents warnings
-  --dry-run                         # Enable dry run mode to check without saving
-  --dump                            # Dump Python objects of groups and projects
-  --exclude-group                   # Exclude parent group settings
-  --exclude-subgroups               # Exclude children subgroups settings
-  --exclude-projects                # Exclude children projects settings
+  --confirm                            # Automatically confirm all removal and contents warnings
+  --dry-run                            # Enable dry run mode to check without saving
+  --dump                               # Dump Python objects of groups and projects
+  --exclude-group                      # Exclude parent group settings
+  --exclude-subgroups                  # Exclude children subgroups settings
+  --exclude-projects                   # Exclude children projects settings
 
 general settings arguments:
-  --available-features              # List the available GitLab project features known by the tool
-  --reset-features [KEEP_FEATURES]  # Reset features of GitLab projects based on usage
-                                    # (Optionally keep features separated by ",")
-  --disable-features FEATURES       # List of features to disable separated by ","
-  --enable-features FEATURES        # List of features to enable separated by ","
-  --reset-members                   # Reset members of GitLab projects and groups
-  --set-avatar FILE                 # Set avatar of GitLab projects and groups
-  --set-description TEXT            # Set description of GitLab projects and groups
-  --update-descriptions             # Update description of GitLab projects and groups automatically
+  --available-features                 # List the available GitLab project features known by the tool
+  --reset-features [KEEP_FEATURES]     # Reset features of GitLab projects based on usage
+                                       # (Optionally keep features separated by ",")
+  --disable-features FEATURES          # List of features to disable separated by ","
+  --enable-features FEATURES           # List of features to enable separated by ","
+  --reset-members                      # Reset members of GitLab projects and groups
+  --set-avatar FILE                    # Set avatar of GitLab projects and groups
+  --set-description TEXT               # Set description of GitLab projects and groups
+  --update-descriptions                # Update description of GitLab projects and groups automatically
+
+group settings arguments:
+  --set-roles-create-projects [ROLE]   # Set roles allowed to create projects [noone,owner,maintainer,developer,administrator] (default: developer)
+  --set-roles-create-subgroups [ROLE]  # Set roles allowed to create subgroups [owner,maintainer] (default: maintainer)
 
 advanced settings arguments:
-  --run-housekeeping                # Run housekeeping of GitLab project or projects in groups
-  --prune-unreachable-objects       # Prune unreachable objects of GitLab project or projects in groups
-  --archive-projects                # Archive project or projects in GitLab groups
-  --unarchive-projects              # Unarchive project or projects in GitLab groups
-  --delete-groups                   # Delete group or groups in GitLab groups
-  --delete-projects                 # Delete project or projects in GitLab groups
+  --run-housekeeping                   # Run housekeeping of GitLab project or projects in groups
+  --prune-unreachable-objects          # Prune unreachable objects of GitLab project or projects in groups
+  --archive-projects                   # Archive project or projects in GitLab groups
+  --unarchive-projects                 # Unarchive project or projects in GitLab groups
+  --delete-groups                      # Delete group or groups in GitLab groups
+  --delete-projects                    # Delete project or projects in GitLab groups
 
 repository settings arguments:
-  --protect-branches                # Protect branches with default master/main, develop and staging
-  --protect-tags [LEVEL]            # Protect tags at level [no-one,admins,maintainers,developers] (default: no-one)
+  --protect-branches                   # Protect branches with default master/main, develop and staging
+  --protect-tags [LEVEL]               # Protect tags at level [no-one,admins,maintainers,developers] (default: no-one)
 
 merge requests settings arguments:
-  --set-merge-method [METHOD]       # Set project merge requests method (Merge, Semi-linear, Fast-forward, default: Fast-forward)
-  --set-merge-squash [SQUASH]       # Set project merge requests squashing (Do not allow, Allow, Encourage, Require, default: Allow)
-  --set-merge-pipelines [CHECK]     # Set project merge requests check for successful pipelines (true, false, default: True)
-  --set-merge-skipped [CHECK]       # Set project merge requests check for skipped pipelines (true, false, default: True)
-  --set-merge-resolved [CHECK]      # Set project merge requests check for resolved threads (true, false, default: True)
+  --set-merge-method [METHOD]          # Set project merge requests method (Merge, Semi-linear, Fast-forward, default: Fast-forward)
+  --set-merge-squash [SQUASH]          # Set project merge requests squashing (Do not allow, Allow, Encourage, Require, default: Allow)
+  --set-merge-pipelines [CHECK]        # Set project merge requests check for successful pipelines (true, false, default: True)
+  --set-merge-skipped [CHECK]          # Set project merge requests check for skipped pipelines (true, false, default: True)
+  --set-merge-resolved [CHECK]         # Set project merge requests check for resolved threads (true, false, default: True)
 
 ci/cd settings arguments:
-  --erase-jobs-artifacts            # Erase all CI/CD jobs artifacts
-  --erase-jobs-contents             # Erase all CI/CD jobs artifacts and traces
+  --add-jobs-token-allowlist PATH      # Add a group or project to CI/CD job token allowlist
+  --remove-jobs-token-allowlist PATH   # Remove a group or project from CI/CD job token allowlist
+  --erase-jobs-artifacts               # Erase all CI/CD jobs artifacts
+  --erase-jobs-contents                # Erase all CI/CD jobs artifacts and traces
+
+issues arguments:
+  --get-project-issues-boards          # Get the GitLab project issues boards in JSON format
+  --set-project-issues-boards JSON     # Set the GitLab project issues boards from JSON format
 
 labels arguments:
-  --get-group-labels                # Get the GitLab group labels in JSON format
-  --set-group-labels JSON           # Set the GitLab group labels from JSON format
-  --get-project-labels              # Get the GitLab project labels in JSON format
-  --set-project-labels JSON         # Set the GitLab project labels from JSON format
+  --get-group-labels                   # Get the GitLab group labels in JSON format
+  --set-group-labels JSON              # Set the GitLab group labels from JSON format
+  --get-project-labels                 # Get the GitLab project labels in JSON format
+  --set-project-labels JSON            # Set the GitLab project labels from JSON format
 
 positional arguments:
-  --                                # Positional arguments separator (recommended)
-  url_path                          # GitLab group or project path URL
+  --                                   # Positional arguments separator (recommended)
+  url_path                             # GitLab group or project path URL
 
 environment variables:
-  GITLAB_TOKEN                      # GitLab API token environment variable
-  CI_JOB_TOKEN                      # GitLab CI job token environment variable (CI only)
+  GITLAB_TOKEN                         # GitLab API token environment variable
+  CI_JOB_TOKEN                         # GitLab CI job token environment variable (CI only)
 ```
 
 <!-- readme-help-stop -->

gitlab_projects_settings-5.4.0/docs/.pages → gitlab_projects_settings-6.0.0/docs/.pages.in

@@ -4,6 +4,6 @@ nav:
       - ‣ Usage: index.md
   - About:
       - ‣ Changelog: about/changelog/
-      - ‣ Documentation: documentation.pdf
       - ‣ License: about/license/
       - ‣ Quality: about/quality/
+      - ‣ Export as PDF: %MKDOCS_EXPORTER_PDF_OUTPUT%

{gitlab_projects_settings-5.4.0 → gitlab_projects_settings-6.0.0}/docs/assets/stylesheets/custom.css

@@ -36,7 +36,7 @@
   --md-mermaid-custom-secondaryTextColor: #ffffff;
   --md-mermaid-custom-tertiaryColor: #e2f0ff;
   --md-mermaid-custom-tertiaryBordColor: #00000000;
-  --md-mermaid-custom-tertiaryTextColor: #222222;
+  --md-mermaid-custom-tertiaryTextColor: #004f77;
 
   --md-mermaid-edge-color: var(--md-mermaid-custom-tertiaryTextColor);
   --md-mermaid-node-bg-color: var(--md-mermaid-custom-primaryColor);