PyPI - gitlab-projects-settings - Versions diffs - 1.1.0__tar.gz → 2.0.1__tar.gz - Mend

gitlab-projects-settings 1.1.0tar.gz → 2.0.1tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (42) hide show

{gitlab_projects_settings-1.1.0 → gitlab_projects_settings-2.0.1}/.gitlab-ci.yml RENAMED Viewed

@@ -53,6 +53,43 @@ changelog:
   rules:
     - if: $CI_LOCAL
+readme:
+  stage: development
+  image: local:silent
+  script:
+    - |
+      export COLUMNS=120
+      mkdir -p ./.tmp/
+      PACKAGE_NAME=$(grep '^PROJECT_NAME =' ./setup.py | cut -d"'" -f2)
+      {
+        echo ''
+        echo '```yaml'
+        alignments='[ ]\{2,\}'
+        argument='[[:alnum:]][[:alnum:]_-]\{0,\}'
+        letter='[[:alnum:]_]\{1\}'
+        parameter='[-]\{1,2\}[[:alnum:]][[:alnum:]_-]\{0,\}'
+        word='[[:alnum:]_-]\{1,\}'
+        "${PACKAGE_NAME}" --help \
+          | sed '1d; $d' \
+          | sed "s/^\(  ${parameter} ${word}${alignments}\)/\1# /g" \
+          | sed "s/^\(  ${parameter}${alignments}\)/\1# /g" \
+          | sed "s/^\(  ${parameter}, ${parameter}${alignments}\)/\1# /g" \
+          | sed "s/^\(  ${argument}${alignments}\)/\1# /g"
+        echo '```'
+        echo ''
+      } >./.tmp/README.help.tmp
+    - |
+      lead='^<!-- readme-help-start -->$'
+      tail='^<!-- readme-help-stop -->$'
+      sed -i "/${lead}/,/${tail}/{ /${lead}/{ p; r ./.tmp/README.help.tmp
+        }; /${tail}/p; d }"  ./README.md | head -n 100
+    - rm -f ./.tmp/README.help.tmp
+    - |
+      git -c color.diff=always --no-pager diff ./README.md | grep --color=never '.' && echo ''
+      echo  ' > README: Updated successfully'
+  rules:
+    - if: $CI_LOCAL
 # =============================================================================
 # Stage: prepare
@@ -60,17 +97,17 @@ codestyle:
   stage: prepare
   image: registry.gitlab.com/adriandc/gitlabci-local/gitlabci-local:codestyle
   script:
-    - yapf -i ./gitlab_projects_settings/*.py ./gitlab_projects_settings/*/*.py ./setup.py
-    - unify -i --quote "'" ./gitlab_projects_settings/*.py ./gitlab_projects_settings/*/*.py ./setup.py
+    - yapf -i ./src/*.py ./src/*/*.py ./setup.py
+    - unify -i --quote "'" ./src/*.py ./src/*/*.py ./setup.py
     - echo '' && git diff --name-status
     - git diff --quiet
   rules:
     - if: $CI_COMMIT_REF_NAME == "develop"
       changes:
         - 'CHANGELOG.md'
-        - 'gitlab_projects_settings/**/*'
         - 'requirements/**/*'
         - 'setup.py'
+        - 'src/**/*'
     - if: $CI_COMMIT_TAG || $CI_PIPELINE_SOURCE == "trigger" || $CI_PIPELINE_SOURCE == "web" || $CI_COMMIT_REF_NAME != "develop"
       when: on_success
   allow_failure: true
@@ -83,15 +120,15 @@ lint:
   before_script:
     - pip3 install -q -r ./requirements/runtime.txt --upgrade
   script:
-    - pylint --errors-only ./gitlab_projects_settings/ ./setup.py
-    - pylint --disable=missing-docstring --load-plugins=pylint.extensions.no_self_use ./gitlab_projects_settings/ ./setup.py
+    - pylint --errors-only ./src/ ./setup.py
+    - pylint --disable=missing-docstring --load-plugins=pylint.extensions.no_self_use ./src/ ./setup.py
   rules:
     - if: $CI_COMMIT_REF_NAME == "develop"
       changes:
         - 'CHANGELOG.md'
-        - 'gitlab_projects_settings/**/*'
         - 'requirements/**/*'
         - 'setup.py'
+        - 'src/**/*'
     - if: $CI_COMMIT_TAG || $CI_PIPELINE_SOURCE == "trigger" || $CI_PIPELINE_SOURCE == "web" || $CI_COMMIT_REF_NAME != "develop"
       when: on_success
   allow_failure: true
@@ -106,17 +143,17 @@ typings:
     - set +x
     - |
       if [ $(git rev-list --count HEAD) -gt 1 ]; then
-        mypy --follow-imports silent --pretty $(git diff --name-only $(git diff --exit-code >/dev/null && echo 'HEAD^' || echo 'HEAD') ./gitlab_projects_settings/ ./setup.py) 2>/dev/null || true
+        mypy --follow-imports silent --pretty $(git diff --name-only $(git diff --exit-code >/dev/null && echo 'HEAD^' || echo 'HEAD') ./src/ ./setup.py) 2>/dev/null || true
       fi
     - sleep 1
-    - mypy --follow-imports silent --pretty ./gitlab_projects_settings/ ./setup.py
+    - mypy --follow-imports silent --pretty ./src/ ./setup.py
   rules:
     - if: $CI_COMMIT_REF_NAME == "develop"
       changes:
         - 'CHANGELOG.md'
-        - 'gitlab_projects_settings/**/*'
         - 'requirements/**/*'
         - 'setup.py'
+        - 'src/**/*'
     - if: $CI_COMMIT_TAG || $CI_PIPELINE_SOURCE == "trigger" || $CI_PIPELINE_SOURCE == "web" || $CI_COMMIT_REF_NAME != "develop"
       when: on_success
   allow_failure: true
@@ -137,8 +174,8 @@ build:
     - if: $CI_COMMIT_REF_NAME == "develop"
       changes:
         - 'CHANGELOG.md'
-        - 'gitlab_projects_settings/**/*'
         - 'requirements/**/*'
+        - 'src/**/*'
     - if: $CI_COMMIT_TAG || $CI_PIPELINE_SOURCE == "trigger" || $CI_PIPELINE_SOURCE == "web" || $CI_COMMIT_REF_NAME != "develop"
       when: on_success
   artifacts:

gitlab_projects_settings-2.0.1/CHANGELOG.md ADDED Viewed

@@ -0,0 +1,71 @@
+<a name="2.0.1"></a>
+## [2.0.1](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/2.0.0...2.0.1) (2024-04-28)
+### Bug Fixes
+* **entrypoint:** fix description updates faulty descriptions
+<a name="2.0.0"></a>
+## [2.0.0](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/1.1.0...2.0.0) (2024-04-27)
+### Bug Fixes
+* **gitlab:** enforce '--dry-run' usage and improve Python codestyle
+* **settings:** apply 'subgroup' feature to subgroup groups
+### Ci
+* **gitlab-ci:** implement 'readme' local job to update README details
+### Cleanups
+* **gitlab:** minor Python codestyle improvements
+* **settings:** minor Python codestyle improvements
+* **src:** ignore 'import-error' over '__init__' and '__main__'
+### Code Refactoring
+* **entrypoint:** minor Python codestyle improvements
+* **src:** isolate all sources under 'src/'
+### Documentation
+* **readme:** regenerate '--help' details in 'README.md'
+### Features
+* **cli:** isolate 'features/settings.py' to 'cli/entrypoint.py'
+* **main:** align 'RawTextHelpFormatter' to 30 chars columns
+* **main:** change '--set-description' metavar to 'TEXT'
+* **settings:** change project/group descriptions color
+<a name="1.1.0"></a>
+## [1.1.0](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/1.0.1...1.1.0) (2024-04-25)
+### Code Refactoring
+* **settings:** minor functions codestyle improvement
+### Features
+* **main:** rename '--avoid-*' parameters to '--exclude-*'
+<a name="1.0.1"></a>
+## [1.0.1](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/1.0.0...1.0.1) (2024-04-24)
+### Documentation
+* **setup:** fix PyPI 'gitlab-projects-settings' documentation
+<a name="1.0.0"></a>
+## 1.0.0 (2024-04-24)
+### Features
+* **gitlab-projects-settings:** initial sources implementation

{gitlab_projects_settings-1.1.0 → gitlab_projects_settings-2.0.1}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: gitlab-projects-settings
-Version: 1.1.0
+Version: 2.0.1
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/AdrianDC/gitlab-projects-settings
 Author: Adrian DC
@@ -55,47 +55,47 @@ for example protecting tags and branches, or setting a new avatar recursively.
 ## Usage
 <!-- prettier-ignore-start -->
+<!-- readme-help-start -->
 ```yaml
-usage: gitlab-projects-settings [-h] [--version] [-t TOKEN] [--dry-run] [--exclude-group]
-                                [--exclude-subgroups] [--exclude-projects] [--reset-features]
-                                [--reset-members] [--set-avatar FILE] [--set-description TEXT]
-                                [--update-description] [--protect-branches]
+usage: gitlab-projects-settings [-h] [--version] [-t TOKEN] [--dry-run] [--exclude-group] [--exclude-subgroups]
+                                [--exclude-projects] [--reset-features] [--reset-members] [--set-avatar FILE]
+                                [--set-description TEXT] [--update-description] [--protect-branches]
                                 [--protect-tags LEVEL]
                                 [gitlab] [path]
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
 internal arguments:
-  -h, --help            # Show this help message
-  --version             # Show the current version
+  -h, --help              # Show this help message
+  --version               # Show the current version
 credentials arguments:
-  -t TOKEN              # GitLab API token (default: GITLAB_TOKEN environment)
+  -t TOKEN                # GitLab API token (default: GITLAB_TOKEN environment)
 common settings arguments:
-  --dry-run             # Enable dry run mode to check without saving
-  --exclude-group       # Exclude parent group settings
-  --exclude-subgroups   # Exclude children subgroups settings
-  --exclude-projects    # Exclude children projects settings
+  --dry-run               # Enable dry run mode to check without saving
+  --exclude-group         # Exclude parent group settings
+  --exclude-subgroups     # Exclude children subgroups settings
+  --exclude-projects      # Exclude children projects settings
 general settings arguments:
-  --reset-features      # Reset features of GitLab projects based on usage
-  --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-description  # Update description of GitLab projects and groups automatically
+  --reset-features        # Reset features of GitLab projects based on usage
+  --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-description    # Update description of GitLab projects and groups automatically
 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]
+  --protect-branches      # Protect branches with default master/main, develop and staging
+  --protect-tags LEVEL    # Protect tags at level [no-one,admins,maintainers,developers]
 positional arguments:
-  gitlab                # GitLab URL (default: https://gitlab.com)
-  path                  # GitLab group or project path
+  gitlab                  # GitLab URL (default: https://gitlab.com)
+  path                    # GitLab group or project path
 ```
+<!-- readme-help-stop -->
 <!-- prettier-ignore-end -->
 ---

{gitlab_projects_settings-1.1.0 → gitlab_projects_settings-2.0.1}/README.md RENAMED Viewed

@@ -21,47 +21,47 @@ for example protecting tags and branches, or setting a new avatar recursively.
 ## Usage
 <!-- prettier-ignore-start -->
+<!-- readme-help-start -->
 ```yaml
-usage: gitlab-projects-settings [-h] [--version] [-t TOKEN] [--dry-run] [--exclude-group]
-                                [--exclude-subgroups] [--exclude-projects] [--reset-features]
-                                [--reset-members] [--set-avatar FILE] [--set-description TEXT]
-                                [--update-description] [--protect-branches]
+usage: gitlab-projects-settings [-h] [--version] [-t TOKEN] [--dry-run] [--exclude-group] [--exclude-subgroups]
+                                [--exclude-projects] [--reset-features] [--reset-members] [--set-avatar FILE]
+                                [--set-description TEXT] [--update-description] [--protect-branches]
                                 [--protect-tags LEVEL]
                                 [gitlab] [path]
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
 internal arguments:
-  -h, --help            # Show this help message
-  --version             # Show the current version
+  -h, --help              # Show this help message
+  --version               # Show the current version
 credentials arguments:
-  -t TOKEN              # GitLab API token (default: GITLAB_TOKEN environment)
+  -t TOKEN                # GitLab API token (default: GITLAB_TOKEN environment)
 common settings arguments:
-  --dry-run             # Enable dry run mode to check without saving
-  --exclude-group       # Exclude parent group settings
-  --exclude-subgroups   # Exclude children subgroups settings
-  --exclude-projects    # Exclude children projects settings
+  --dry-run               # Enable dry run mode to check without saving
+  --exclude-group         # Exclude parent group settings
+  --exclude-subgroups     # Exclude children subgroups settings
+  --exclude-projects      # Exclude children projects settings
 general settings arguments:
-  --reset-features      # Reset features of GitLab projects based on usage
-  --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-description  # Update description of GitLab projects and groups automatically
+  --reset-features        # Reset features of GitLab projects based on usage
+  --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-description    # Update description of GitLab projects and groups automatically
 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]
+  --protect-branches      # Protect branches with default master/main, develop and staging
+  --protect-tags LEVEL    # Protect tags at level [no-one,admins,maintainers,developers]
 positional arguments:
-  gitlab                # GitLab URL (default: https://gitlab.com)
-  path                  # GitLab group or project path
+  gitlab                  # GitLab URL (default: https://gitlab.com)
+  path                    # GitLab group or project path
 ```
+<!-- readme-help-stop -->
 <!-- prettier-ignore-end -->
 ---

{gitlab_projects_settings-1.1.0 → gitlab_projects_settings-2.0.1}/gitlab_projects_settings.egg-info/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: gitlab-projects-settings
-Version: 1.1.0
+Version: 2.0.1
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/AdrianDC/gitlab-projects-settings
 Author: Adrian DC
@@ -55,47 +55,47 @@ for example protecting tags and branches, or setting a new avatar recursively.
 ## Usage
 <!-- prettier-ignore-start -->
+<!-- readme-help-start -->
 ```yaml
-usage: gitlab-projects-settings [-h] [--version] [-t TOKEN] [--dry-run] [--exclude-group]
-                                [--exclude-subgroups] [--exclude-projects] [--reset-features]
-                                [--reset-members] [--set-avatar FILE] [--set-description TEXT]
-                                [--update-description] [--protect-branches]
+usage: gitlab-projects-settings [-h] [--version] [-t TOKEN] [--dry-run] [--exclude-group] [--exclude-subgroups]
+                                [--exclude-projects] [--reset-features] [--reset-members] [--set-avatar FILE]
+                                [--set-description TEXT] [--update-description] [--protect-branches]
                                 [--protect-tags LEVEL]
                                 [gitlab] [path]
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
 internal arguments:
-  -h, --help            # Show this help message
-  --version             # Show the current version
+  -h, --help              # Show this help message
+  --version               # Show the current version
 credentials arguments:
-  -t TOKEN              # GitLab API token (default: GITLAB_TOKEN environment)
+  -t TOKEN                # GitLab API token (default: GITLAB_TOKEN environment)
 common settings arguments:
-  --dry-run             # Enable dry run mode to check without saving
-  --exclude-group       # Exclude parent group settings
-  --exclude-subgroups   # Exclude children subgroups settings
-  --exclude-projects    # Exclude children projects settings
+  --dry-run               # Enable dry run mode to check without saving
+  --exclude-group         # Exclude parent group settings
+  --exclude-subgroups     # Exclude children subgroups settings
+  --exclude-projects      # Exclude children projects settings
 general settings arguments:
-  --reset-features      # Reset features of GitLab projects based on usage
-  --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-description  # Update description of GitLab projects and groups automatically
+  --reset-features        # Reset features of GitLab projects based on usage
+  --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-description    # Update description of GitLab projects and groups automatically
 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]
+  --protect-branches      # Protect branches with default master/main, develop and staging
+  --protect-tags LEVEL    # Protect tags at level [no-one,admins,maintainers,developers]
 positional arguments:
-  gitlab                # GitLab URL (default: https://gitlab.com)
-  path                  # GitLab group or project path
+  gitlab                  # GitLab URL (default: https://gitlab.com)
+  path                    # GitLab group or project path
 ```
+<!-- readme-help-stop -->
 <!-- prettier-ignore-end -->
 ---

gitlab_projects_settings-2.0.1/gitlab_projects_settings.egg-info/SOURCES.txt ADDED Viewed

@@ -0,0 +1,38 @@
+.gitignore
+.gitlab-ci.yml
+.markdownlint.json
+.style.yapf
+CHANGELOG.md
+LICENSE
+README.md
+mypy.ini
+setup.py
+.chglog/CHANGELOG.tpl.md
+.chglog/changelog.sh
+.chglog/config.yml
+.vscode/extensions.json
+.vscode/settings.json
+gitlab_projects_settings.egg-info/PKG-INFO
+gitlab_projects_settings.egg-info/SOURCES.txt
+gitlab_projects_settings.egg-info/dependency_links.txt
+gitlab_projects_settings.egg-info/entry_points.txt
+gitlab_projects_settings.egg-info/requires.txt
+gitlab_projects_settings.egg-info/top_level.txt
+requirements/build.txt
+requirements/deploy.txt
+requirements/quality.txt
+requirements/runtime.txt
+src/__init__.py
+src/__main__.py
+src/cli/__init__.py
+src/cli/entrypoint.py
+src/cli/main.py
+src/features/__init__.py
+src/features/gitlab.py
+src/package/__init__.py
+src/package/bundle.py
+src/package/version.py
+src/prints/__init__.py
+src/prints/colors.py
+src/system/__init__.py
+src/system/platform.py

{gitlab_projects_settings-1.1.0 → gitlab_projects_settings-2.0.1}/setup.py RENAMED Viewed

@@ -23,14 +23,14 @@ PROJECT_EMAIL = 'radian.dc@gmail.com'
 PROJECT_KEYWORDS = 'gitlab issues sync'
 PROJECT_NAME = 'gitlab-projects-settings'
 PROJECT_OWNER = 'AdrianDC'
-PROJECT_PACKAGE = 'gitlab-projects-settings'
+PROJECT_PACKAGE = 'gitlab_projects_settings'
 PROJECT_SCRIPTS = [
     'gitlab-projects-settings = gitlab_projects_settings.cli.main:main',
 ]
 # Setup configurations
 setup(
-    name=PROJECT_PACKAGE,
+    name=PROJECT_NAME,
     use_scm_version=True,
     author=PROJECT_AUTHOR,
     author_email=PROJECT_EMAIL,
@@ -42,11 +42,21 @@ setup(
     project_urls={
         'Bug Reports': f'https://gitlab.com/{PROJECT_OWNER}/{PROJECT_NAME}/-/issues',
         'Changelog': f'https://gitlab.com/{PROJECT_OWNER}/{PROJECT_NAME}/blob/main/CHANGELOG.md',
-        'Documentation': f'https://gitlab.com/{PROJECT_OWNER}/{PROJECT_NAME}#{PROJECT_PACKAGE}',
+        'Documentation': f'https://gitlab.com/{PROJECT_OWNER}/{PROJECT_NAME}#{PROJECT_NAME}',
         'Source': f'https://gitlab.com/{PROJECT_OWNER}/{PROJECT_NAME}',
-        'Statistics': f'https://pypistats.org/packages/{PROJECT_PACKAGE}'
+        'Statistics': f'https://pypistats.org/packages/{PROJECT_NAME}'
+    },
+    packages=[
+        PROJECT_PACKAGE,
+    ] + [
+        f'{PROJECT_PACKAGE}.{module}' for module in find_packages(
+            where='src',
+            exclude=['tests'],
+        )
+    ],
+    package_dir={
+        PROJECT_PACKAGE: 'src',
     },
-    packages=find_packages(exclude=['tests']),
     setup_requires=['setuptools_scm'],
     install_requires=requirements,
     classifiers=[

{gitlab_projects_settings-1.1.0/gitlab_projects_settings → gitlab_projects_settings-2.0.1/src}/__init__.py RENAMED Viewed

@@ -1,4 +1,4 @@
-# Components
+# Components, pylint: disable=import-error
 from gitlab_projects_settings.package.version import Version
 # Version

{gitlab_projects_settings-1.1.0/gitlab_projects_settings → gitlab_projects_settings-2.0.1/src}/__main__.py RENAMED Viewed

@@ -1,4 +1,4 @@
-# Components
+# Components, pylint: disable=import-error
 from gitlab_projects_settings.cli.main import main
 # Entrypoint

gitlab_projects_settings-1.1.0/gitlab_projects_settings/features/settings.py → gitlab_projects_settings-2.0.1/src/cli/entrypoint.py RENAMED Viewed

@@ -12,12 +12,12 @@ from ..features.gitlab import GitLabFeature
 from ..prints.colors import Colors
 from ..system.platform import Platform
-# SettingsFeature class, pylint: disable=too-few-public-methods
-class SettingsFeature:
+# Entrypoint class, pylint: disable=too-few-public-methods
+class Entrypoint:
-    # Entrypoint
+    # CLI
     @staticmethod
-    def entrypoint(options: Namespace) -> bool:
+    def cli(options: Namespace) -> bool:
         # Variables
         group: Group = None
@@ -27,7 +27,11 @@ class SettingsFeature:
         print(' ')
         # GitLab client
-        gitlab = GitLabFeature(options.gitlab, options.token, options.dry_run)
+        gitlab = GitLabFeature(
+            options.gitlab,
+            options.token,
+            options.dry_run,
+        )
         print(f'{Colors.BOLD} - GitLab host: '
               f'{Colors.GREEN}{gitlab.url}'
               f'{Colors.RESET}')
@@ -37,28 +41,38 @@ class SettingsFeature:
         try:
             group = gitlab.group(options.path)
             print(f'{Colors.BOLD} - GitLab group: '
-                  f'{Colors.GREEN}{group.full_path} ({group.description})'
+                  f'{Colors.GREEN}{group.full_path}'
+                  f'{Colors.CYAN} ({group.description})'
                   f'{Colors.RESET}')
             print(' ')
             Platform.flush()
         except GitlabGetError:
             project = gitlab.project(options.path)
             print(f'{Colors.BOLD} - GitLab project: '
-                  f'{Colors.GREEN}{project.path_with_namespace} ({project.description})'
+                  f'{Colors.GREEN}{project.path_with_namespace}'
+                  f'{Colors.CYAN} ({project.description})'
                   f'{Colors.RESET}')
             print(' ')
             Platform.flush()
         # Handle single project
         if project:
-            SettingsFeature.project(options, gitlab, project.id)
+            Entrypoint.project(
+                options,
+                gitlab,
+                project.id,
+            )
         # Handle group recursively
         elif group:
             # Handle group
             if not options.exclude_group:
-                SettingsFeature.group(options, gitlab, group.id)
+                Entrypoint.group(
+                    options,
+                    gitlab,
+                    group.id,
+                )
             # Iterate through subgroups
             if not options.exclude_subgroups:
@@ -68,7 +82,12 @@ class SettingsFeature:
                         order_by='path',
                         sort='asc',
                 ):
-                    SettingsFeature.group(options, gitlab, group_subgroup.id)
+                    Entrypoint.group(
+                        options,
+                        gitlab,
+                        group_subgroup.id,
+                        True,
+                    )
             # Iterate through projects
             if not options.exclude_projects:
@@ -78,7 +97,11 @@ class SettingsFeature:
                         order_by='path',
                         sort='asc',
                 ):
-                    SettingsFeature.project(options, gitlab, group_project.id)
+                    Entrypoint.project(
+                        options,
+                        gitlab,
+                        group_project.id,
+                    )
         # Result
         return True
@@ -95,6 +118,18 @@ class SettingsFeature:
         # Acquire group
         group = gitlab.group(criteria)
+        # Acquire parent group
+        parent_group: Group = None
+        if group.parent_id:
+            parent_group = gitlab.group(group.parent_id)
+        # Get parent description
+        parent_description: str = ''
+        parent_name: str = ''
+        if parent_group:
+            parent_description = parent_group.description
+            parent_name = parent_group.name
         # Show group details
         group_type = 'subgroup' if subgroup else 'group'
         print(f'{Colors.BOLD} - GitLab {group_type}: '
@@ -111,8 +146,14 @@ class SettingsFeature:
         # Update group description
         elif options.update_description:
-            description = f'{group.name[:1].capitalize()}{group.name[1:]}' \
-                            f' - description'
+            parent_description_text: str = ''
+            if parent_name:
+                parent_description_text = ' - ' + GitLabFeature.Helper.describe(
+                    parent_description,
+                    parent_name,
+                )
+            description = f'{GitLabFeature.Helper.capitalize(group.name)}' \
+                          f'{parent_description_text}'
             gitlab.group_set_description(criteria, description)
             print(f'{Colors.BOLD}   - Updated description: '
                   f'{Colors.CYAN}{description}'
@@ -147,6 +188,9 @@ class SettingsFeature:
         # Acquire project
         project = gitlab.project(criteria)
+        # Acquire group
+        group = gitlab.group(project.namespace['id'])
         # Show project details
         print(f'{Colors.BOLD} - GitLab project: '
               f'{Colors.YELLOW_LIGHT}{project.path_with_namespace} '
@@ -162,11 +206,15 @@ class SettingsFeature:
         # Update project description
         elif options.update_description:
-            description = f'{project.name[:1].capitalize()}{project.name[1:]}' \
-                            f' - description'
+            group_description = GitLabFeature.Helper.describe(
+                group.description,
+                group.name,
+            )
+            description = f'{GitLabFeature.Helper.capitalize(project.name)}' \
+                          f' - {group_description}'
             gitlab.project_set_description(criteria, description)
             print(f'{Colors.BOLD}   - Updated description: '
-                  f'{Colors.CYAN}{description}'
+                  f'{Colors.CYAN}{group_description}'
                   f'{Colors.RESET}')
         # Reset project features

{gitlab_projects_settings-1.1.0/gitlab_projects_settings → gitlab_projects_settings-2.0.1/src}/cli/main.py RENAMED Viewed

@@ -6,11 +6,11 @@ from os import environ
 from sys import exit as sys_exit
 # Components
-from ..features.settings import SettingsFeature
 from ..package.bundle import Bundle
 from ..package.version import Version
 from ..prints.colors import Colors
 from ..system.platform import Platform
+from .entrypoint import Entrypoint
 # Main, pylint: disable=too-many-statements
 def main() -> None:
@@ -24,7 +24,10 @@ def main() -> None:
         prog=Bundle.NAME,
         description=f'{Bundle.NAME}: {Bundle.DESCRIPTION}',
         add_help=False,
-        formatter_class=RawTextHelpFormatter,
+        formatter_class=lambda prog: RawTextHelpFormatter(
+            prog,
+            max_help_position=30,
+        ),
     )
     # Arguments internal definitions
@@ -104,7 +107,7 @@ def main() -> None:
         '--set-description',
         dest='set_description',
         action='store',
-        metavar='DESCRIPTION',
+        metavar='TEXT',
         help='Set description of GitLab projects and groups',
     )
     group.add_argument(
@@ -180,8 +183,8 @@ def main() -> None:
     print(' ')
     Platform.flush()
-    # Configure GitLab projects
-    result = SettingsFeature.entrypoint(options)
+    # CLI entrypoint
+    result = Entrypoint.cli(options)
     # Footer
     print(' ')

{gitlab_projects_settings-1.1.0/gitlab_projects_settings → gitlab_projects_settings-2.0.1/src}/features/gitlab.py RENAMED Viewed

@@ -42,23 +42,23 @@ class GitLabFeature:
     def group_set_avatar(self, criteria: str, file: str) -> None:
         # Set group avatar
-        group = self.group(criteria)
-        with open(file, 'rb') as avatar:
-            group.avatar = avatar
+        if not self.__dry_run:
+            group = self.group(criteria)
+            with open(file, 'rb') as avatar:
+                group.avatar = avatar
-            # Save group
-            if not self.__dry_run:
+                # Save group
                 group.save()
     # Group set description
     def group_set_description(self, criteria: str, description: str) -> None:
         # Set group description
-        group = self.group(criteria)
-        group.description = description
-        # Save group
         if not self.__dry_run:
+            group = self.group(criteria)
+            group.description = description
+            # Save group
             group.save()
     # Project
@@ -282,33 +282,56 @@ class GitLabFeature:
     def project_reset_members(self, criteria: str) -> None:
         # Remove project members
-        project = self.project(criteria)
-        for member in project.members.list():
-            if not self.__dry_run:
+        if not self.__dry_run:
+            project = self.project(criteria)
+            for member in project.members.list():
                 project.members.delete(member.id)
-        # Save project
-        if not self.__dry_run:
+            # Save project
             project.save()
     # Project set avatar
     def project_set_avatar(self, criteria: str, file: str) -> None:
         # Set project avatar
-        project = self.project(criteria)
-        with open(file, 'rb') as avatar:
-            project.avatar = avatar
-            if not self.__dry_run:
+        if not self.__dry_run:
+            project = self.project(criteria)
+            with open(file, 'rb') as avatar:
+                project.avatar = avatar
+                # Save project
                 project.save()
     # Project set description
     def project_set_description(self, criteria: str, description: str) -> None:
-        project = self.project(criteria)
-        project.description = description
+        # Set project description
         if not self.__dry_run:
+            project = self.project(criteria)
+            project.description = description
+            # Save project
             project.save()
     # URL
     @property
     def url(self) -> str:
         return str(self.__gitlab.api_url)
+    # Helper class
+    class Helper:
+        # Capitalize
+        @staticmethod
+        def capitalize(text: str) -> str:
+            return f'{text[:1].capitalize()}{text[1:]}'
+        # Describe
+        @staticmethod
+        def describe(
+            description: str,
+            name: str,
+        ) -> str:
+            if description:
+                return description
+            return GitLabFeature.Helper.capitalize(name)

gitlab_projects_settings-1.1.0/CHANGELOG.md DELETED Viewed

@@ -1,28 +0,0 @@
-<a name="1.1.0"></a>
-## [1.1.0](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/1.0.1...1.1.0) (2024-04-25)
-### Code Refactoring
-* **settings:** minor functions codestyle improvement
-### Features
-* **main:** rename '--avoid-*' parameters to '--exclude-*'
-<a name="1.0.1"></a>
-## [1.0.1](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/1.0.0...1.0.1) (2024-04-24)
-### Documentation
-* **setup:** fix PyPI 'gitlab-projects-settings' documentation
-<a name="1.0.0"></a>
-## 1.0.0 (2024-04-24)
-### Features
-* **gitlab-projects-settings:** initial sources implementation

gitlab_projects_settings-1.1.0/gitlab_projects_settings.egg-info/SOURCES.txt DELETED Viewed

@@ -1,38 +0,0 @@
-.gitignore
-.gitlab-ci.yml
-.markdownlint.json
-.style.yapf
-CHANGELOG.md
-LICENSE
-README.md
-mypy.ini
-setup.py
-.chglog/CHANGELOG.tpl.md
-.chglog/changelog.sh
-.chglog/config.yml
-.vscode/extensions.json
-.vscode/settings.json
-gitlab_projects_settings/__init__.py
-gitlab_projects_settings/__main__.py
-gitlab_projects_settings.egg-info/PKG-INFO
-gitlab_projects_settings.egg-info/SOURCES.txt
-gitlab_projects_settings.egg-info/dependency_links.txt
-gitlab_projects_settings.egg-info/entry_points.txt
-gitlab_projects_settings.egg-info/requires.txt
-gitlab_projects_settings.egg-info/top_level.txt
-gitlab_projects_settings/cli/__init__.py
-gitlab_projects_settings/cli/main.py
-gitlab_projects_settings/features/__init__.py
-gitlab_projects_settings/features/gitlab.py
-gitlab_projects_settings/features/settings.py
-gitlab_projects_settings/package/__init__.py
-gitlab_projects_settings/package/bundle.py
-gitlab_projects_settings/package/version.py
-gitlab_projects_settings/prints/__init__.py
-gitlab_projects_settings/prints/colors.py
-gitlab_projects_settings/system/__init__.py
-gitlab_projects_settings/system/platform.py
-requirements/build.txt
-requirements/deploy.txt
-requirements/quality.txt
-requirements/runtime.txt