gitlab-projects-settings 4.0.0__tar.gz → 4.1.0__tar.gz

{gitlab_projects_settings-4.0.0 → gitlab_projects_settings-4.1.0}/CHANGELOG.md

@@ -1,4 +1,14 @@
 
+<a name="4.1.0"></a>
+## [4.1.0](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/4.0.0...4.1.0) (2024-05-17)
+
+### Features
+
+* **entrypoint:** implement prompt confirmation upon deletions
+* **gitlab:** isolate 'ProtectionLevels' enumeration
+* **requirements:** prepare 'questionary' library integration
+
+
 <a name="4.0.0"></a>
 ## [4.0.0](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/3.0.0...4.0.0) (2024-05-15)
 

{gitlab_projects_settings-4.0.0/gitlab_projects_settings.egg-info → gitlab_projects_settings-4.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: gitlab-projects-settings
-Version: 4.0.0
+Version: 4.1.0
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/AdrianDC/gitlab-projects-settings
 Author: Adrian DC
@@ -30,6 +30,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: colored>=1.4.2
 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
 
@@ -69,7 +70,7 @@ usage: gitlab-projects-settings [-h] [--version] [--update-check] [--settings] [
                                 [--disable-features FEATURES] [--enable-features FEATURES] [--reset-members]
                                 [--set-avatar FILE] [--set-description TEXT] [--update-description]
                                 [--run-housekeeping] [--archive-project | --unarchive-project] [--delete-group]
-                                [--delete-project] [--protect-branches] [--protect-tags LEVEL] [--]
+                                [--delete-project] [--protect-branches] [--protect-tags [LEVEL]] [--]
                                 [gitlab] [path]
 
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
@@ -111,7 +112,7 @@ advanced settings arguments:
 
 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-tags [LEVEL]            # Protect tags at level [no-one,admins,maintainers,developers] (default: no-one)
 
 positional arguments:
   --                                # Positional arguments separator (recommended)
@@ -138,10 +139,20 @@ gitlab-projects-settings --settings
 
 ---
 
+## Environment available configurations
+
+`gitlab-projects-settings` uses `colored` for colors outputs and `questionary` for interactive menus.
+
+If colors of both outputs types do not match the terminal's theme,  
+an environment variable `NO_COLOR=1` can be defined to disable colors.
+
+---
+
 ## Dependencies
 
 - [colored](https://pypi.org/project/colored/): Terminal colors and styles
 - [python-gitlab](https://pypi.org/project/python-gitlab/): A python wrapper for the GitLab API
+- [questionary](https://pypi.org/project/questionary/): Interactive terminal user interfaces
 - [setuptools](https://pypi.org/project/setuptools/): Build and manage Python packages
 - [update-checker](https://pypi.org/project/update-checker/): Check for package updates on PyPI
 

{gitlab_projects_settings-4.0.0 → gitlab_projects_settings-4.1.0}/README.md

@@ -34,7 +34,7 @@ usage: gitlab-projects-settings [-h] [--version] [--update-check] [--settings] [
                                 [--disable-features FEATURES] [--enable-features FEATURES] [--reset-members]
                                 [--set-avatar FILE] [--set-description TEXT] [--update-description]
                                 [--run-housekeeping] [--archive-project | --unarchive-project] [--delete-group]
-                                [--delete-project] [--protect-branches] [--protect-tags LEVEL] [--]
+                                [--delete-project] [--protect-branches] [--protect-tags [LEVEL]] [--]
                                 [gitlab] [path]
 
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
@@ -76,7 +76,7 @@ advanced settings arguments:
 
 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-tags [LEVEL]            # Protect tags at level [no-one,admins,maintainers,developers] (default: no-one)
 
 positional arguments:
   --                                # Positional arguments separator (recommended)
@@ -103,10 +103,20 @@ gitlab-projects-settings --settings
 
 ---
 
+## Environment available configurations
+
+`gitlab-projects-settings` uses `colored` for colors outputs and `questionary` for interactive menus.
+
+If colors of both outputs types do not match the terminal's theme,  
+an environment variable `NO_COLOR=1` can be defined to disable colors.
+
+---
+
 ## Dependencies
 
 - [colored](https://pypi.org/project/colored/): Terminal colors and styles
 - [python-gitlab](https://pypi.org/project/python-gitlab/): A python wrapper for the GitLab API
+- [questionary](https://pypi.org/project/questionary/): Interactive terminal user interfaces
 - [setuptools](https://pypi.org/project/setuptools/): Build and manage Python packages
 - [update-checker](https://pypi.org/project/update-checker/): Check for package updates on PyPI
 

{gitlab_projects_settings-4.0.0 → gitlab_projects_settings-4.1.0/gitlab_projects_settings.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: gitlab-projects-settings
-Version: 4.0.0
+Version: 4.1.0
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/AdrianDC/gitlab-projects-settings
 Author: Adrian DC
@@ -30,6 +30,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: colored>=1.4.2
 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
 
@@ -69,7 +70,7 @@ usage: gitlab-projects-settings [-h] [--version] [--update-check] [--settings] [
                                 [--disable-features FEATURES] [--enable-features FEATURES] [--reset-members]
                                 [--set-avatar FILE] [--set-description TEXT] [--update-description]
                                 [--run-housekeeping] [--archive-project | --unarchive-project] [--delete-group]
-                                [--delete-project] [--protect-branches] [--protect-tags LEVEL] [--]
+                                [--delete-project] [--protect-branches] [--protect-tags [LEVEL]] [--]
                                 [gitlab] [path]
 
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
@@ -111,7 +112,7 @@ advanced settings arguments:
 
 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-tags [LEVEL]            # Protect tags at level [no-one,admins,maintainers,developers] (default: no-one)
 
 positional arguments:
   --                                # Positional arguments separator (recommended)
@@ -138,10 +139,20 @@ gitlab-projects-settings --settings
 
 ---
 
+## Environment available configurations
+
+`gitlab-projects-settings` uses `colored` for colors outputs and `questionary` for interactive menus.
+
+If colors of both outputs types do not match the terminal's theme,  
+an environment variable `NO_COLOR=1` can be defined to disable colors.
+
+---
+
 ## Dependencies
 
 - [colored](https://pypi.org/project/colored/): Terminal colors and styles
 - [python-gitlab](https://pypi.org/project/python-gitlab/): A python wrapper for the GitLab API
+- [questionary](https://pypi.org/project/questionary/): Interactive terminal user interfaces
 - [setuptools](https://pypi.org/project/setuptools/): Build and manage Python packages
 - [update-checker](https://pypi.org/project/update-checker/): Check for package updates on PyPI
 

{gitlab_projects_settings-4.0.0 → gitlab_projects_settings-4.1.0}/gitlab_projects_settings.egg-info/SOURCES.txt

@@ -37,6 +37,7 @@ src/package/version.py
 src/prints/__init__.py
 src/prints/boxes.py
 src/prints/colors.py
+src/prints/themes.py
 src/system/__init__.py
 src/system/platform.py
 src/types/__init__.py

{gitlab_projects_settings-4.0.0 → gitlab_projects_settings-4.1.0}/gitlab_projects_settings.egg-info/requires.txt

@@ -1,4 +1,5 @@
 colored>=1.4.2
 python-gitlab>=4.4.0
+questionary>=2.0.1
 setuptools>=45.1.0
 update_checker>=0.18.0

{gitlab_projects_settings-4.0.0 → gitlab_projects_settings-4.1.0}/requirements/runtime.txt

@@ -1,4 +1,5 @@
 colored>=1.4.2
 python-gitlab>=4.4.0
+questionary>=2.0.1
 setuptools>=45.1.0
 update_checker>=0.18.0

{gitlab_projects_settings-4.0.0 → gitlab_projects_settings-4.1.0}/src/cli/entrypoint.py

@@ -12,10 +12,12 @@ from gitlab.v4.objects import (
     Project as GitLabProject,
     User as GitLabUser,
 )
+import questionary
 
 # Components
 from ..features.gitlab import GitLabFeature
 from ..prints.colors import Colors
+from ..prints.themes import Themes
 from ..system.platform import Platform
 from ..types.namespaces import Namespaces
 
@@ -173,6 +175,30 @@ class Entrypoint:
         # Result
         return Entrypoint.Result.SUCCESS
 
+    # Confirm
+    @staticmethod
+    def confirm(description: str, text: str = '') -> bool:
+
+        # Header
+        print(
+            f'{Colors.BOLD}   - Delete {description}: Confirm "'
+            f'{Colors.RED}{text}'
+            f'{Colors.BOLD}" deletion:'
+            f'{Colors.RESET}', end='')
+        Platform.flush()
+
+        # Get user configuration
+        answer: bool = questionary.confirm(
+            message='',
+            default=False,
+            qmark='',
+            style=Themes.confirmation_style(),
+            auto_enter=True,
+        ).ask()
+
+        # Result
+        return answer
+
     # Group
     @staticmethod
     def group(
@@ -205,8 +231,15 @@ class Entrypoint:
               f'{Colors.RESET}')
         Platform.flush()
 
-        # Delete group
+        # Delete group after validation
         if options.delete_group:
+            if not Entrypoint.confirm(
+                    group_type,
+                    group.full_path,
+            ):
+                return Entrypoint.Result.SUCCESS
+
+            # Delete group
             gitlab.group_delete(criteria)
             print(f'{Colors.BOLD}   - Delete {group_type}: '
                   f'{Colors.GREEN}Success'
@@ -289,8 +322,15 @@ class Entrypoint:
               f'{Colors.RESET}')
         Platform.flush()
 
-        # Delete project
+        # Delete project after validation
         if options.delete_project:
+            if not Entrypoint.confirm(
+                    'project',
+                    project.path_with_namespace,
+            ):
+                return Entrypoint.Result.SUCCESS
+
+            # Delete project
             gitlab.project_delete(criteria)
             print(f'{Colors.BOLD}   - Delete project: '
                   f'{Colors.GREEN}Success'

{gitlab_projects_settings-4.0.0 → gitlab_projects_settings-4.1.0}/src/cli/main.py

@@ -14,6 +14,7 @@ from ..package.updates import Updates
 from ..package.version import Version
 from ..prints.colors import Colors
 from ..system.platform import Platform
+from ..types.gitlab import ProtectionLevels
 from .entrypoint import Entrypoint
 
 # Main, pylint: disable=too-many-statements
@@ -216,7 +217,10 @@ def main() -> None:
         dest='protect_tags',
         action='store',
         metavar='LEVEL',
-        help='Protect tags at level [no-one,admins,maintainers,developers]',
+        nargs='?',
+        const=ProtectionLevels.default(),
+        help=f'Protect tags at level [{",".join(ProtectionLevels.names())}]'
+        ' (default: %(const)s)',
     )
 
     # Arguments positional definitions
@@ -232,7 +236,7 @@ def main() -> None:
         action='store',
         nargs='?',
         default='https://gitlab.com',
-        help='GitLab URL (default: https://gitlab.com)',
+        help='GitLab URL (default: %(default)s)',
     )
     group.add_argument(
         dest='path',

{gitlab_projects_settings-4.0.0 → gitlab_projects_settings-4.1.0}/src/features/gitlab.py

@@ -10,7 +10,7 @@ from gitlab.exceptions import GitlabDeleteError, GitlabGetError, GitlabListError
 from gitlab.v4.objects import Group, Namespace, Project, User
 
 # Components
-from ..types.gitlab import AccessLevels, ProjectFeatures
+from ..types.gitlab import AccessLevels, ProjectFeatures, ProtectionLevels
 
 # GitLabFeature class, pylint: disable=too-many-public-methods
 class GitLabFeature:
@@ -349,13 +349,13 @@ class GitLabFeature:
 
         # Prepare access level
         access_level: int
-        if protect_level == 'no-one':
+        if protect_level == ProtectionLevels.NO_ONE:
             access_level = 0
-        elif protect_level == 'admins':
+        elif protect_level == ProtectionLevels.ADMINS:
             access_level = 60
-        elif protect_level == 'maintainers':
+        elif protect_level == ProtectionLevels.MAINTAINERS:
             access_level = 40
-        elif protect_level == 'developers':
+        elif protect_level == ProtectionLevels.DEVELOPERS:
             access_level = 30
         else:
             raise SyntaxError(f'Unknown protection level: {access_level}')

gitlab_projects_settings-4.1.0/src/prints/themes.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+
+# Modules libraries
+try:
+    from prompt_toolkit.styles.style import Style as prompt_toolkit_styles_Style
+except ModuleNotFoundError: # pragma: no cover
+    from typing import Any as prompt_toolkit_styles_Style # type: ignore[assignment]
+
+# Components
+from .colors import Colors
+
+# Themes class, pylint: disable=too-few-public-methods
+class Themes:
+
+    # Flags
+    __prepared = False
+
+    # Members
+    __bold: str = ''
+    __red: str = ''
+    __selected: str = ''
+
+    # Prepare
+    @staticmethod
+    def __prepare() -> None:
+
+        # Colors enabled
+        if Colors.enabled():
+            Themes.__bold = 'bold'
+            Themes.__red = '#FF0000 bold'
+            Themes.__selected = 'bold noreverse'
+
+        # Colors disabled
+        else:
+            Themes.__bold = 'noinherit bold'
+            Themes.__red = 'noinherit bold'
+            Themes.__selected = 'noinherit bold noreverse'
+
+        # Raise flag
+        Themes.__prepared = True
+
+    # Confirmation
+    @staticmethod
+    def confirmation_style() -> prompt_toolkit_styles_Style:
+
+        # Prepare
+        if not Themes.__prepared:
+            Themes.__prepare()
+
+        # Result
+        return prompt_toolkit_styles_Style([
+            ('answer', Themes.__red),
+            ('instruction', Themes.__red),
+            ('highlighted', Themes.__bold),
+            ('pointer', Themes.__bold),
+            ('qmark', Themes.__bold),
+            ('question', Themes.__bold),
+            ('selected', Themes.__selected),
+            ('separator', Themes.__bold),
+        ])

{gitlab_projects_settings-4.0.0 → gitlab_projects_settings-4.1.0}/src/types/gitlab.py

@@ -14,6 +14,28 @@ class AccessLevels:
     PRIVATE: str = 'private'
     ENABLED: str = 'enabled'
 
+# ProtectionLevels class
+class ProtectionLevels:
+    NO_ONE: str = 'no-one'
+    ADMINS: str = 'admins'
+    MAINTAINERS: str = 'maintainers'
+    DEVELOPERS: str = 'developers'
+
+    # Default
+    @staticmethod
+    def default() -> str:
+        return ProtectionLevels.NO_ONE
+
+    # Names
+    @staticmethod
+    def names() -> List[str]:
+        return [
+            ProtectionLevels.NO_ONE,
+            ProtectionLevels.ADMINS,
+            ProtectionLevels.MAINTAINERS,
+            ProtectionLevels.DEVELOPERS,
+        ]
+
 # Visibility class, pylint: disable=too-few-public-methods
 class Visibility:
     PRIVATE: str = 'private'