gitlab-projects-settings 2.0.2__tar.gz → 3.0.0__tar.gz

{gitlab_projects_settings-2.0.2 → gitlab_projects_settings-3.0.0}/.gitlab-ci.yml

@@ -53,43 +53,6 @@ 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
 
@@ -192,6 +155,43 @@ install:
   rules:
     - if: $CI_LOCAL
 
+readme:
+  stage: build
+  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: deploy
 

{gitlab_projects_settings-2.0.2 → gitlab_projects_settings-3.0.0}/CHANGELOG.md

@@ -1,4 +1,47 @@
 
+<a name="3.0.0"></a>
+## [3.0.0](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/2.1.0...3.0.0) (2024-05-06)
+
+### Bug Fixes
+
+* **entrypoint:** resolve support for private user namespaces
+* **entrypoint:** detect if GitLab actions can continue
+* **entrypoint:** enforce against missing '.description' values
+* **gitlab:** enforce 'group_delete' usage in '--dry-run' mode
+* **gitlab:** delay groups deletion by 10s and projects by 5s
+* **gitlab:** get all branches and tags upon 'list()' calls
+* **gitlab:** get all members in 'project_reset_members'
+
+### Ci
+
+* **gitlab-ci:** move 'readme' job after 'build' and local 'install'
+
+### Cleanups
+
+* **gitlab:** minor comments changes in 'project_reset_features'
+
+### Features
+
+* **entrypoint:** preserve main group description if exists
+* **entrypoint:** always flush progress output logs
+* **gitlab:** detect multiple branches to keep 'Merge requests'
+* **gitlab:** detect 'Token Access' usage for 'CI/CD' features
+* **namespaces:** migrate 'Helper' class to 'Namespaces' class
+
+
+<a name="2.1.0"></a>
+## [2.1.0](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/2.0.2...2.1.0) (2024-04-28)
+
+### Bug Fixes
+
+* **entrypoint:** fix project '--update-description' logs output
+
+### Features
+
+* **entrypoint:** sort groups and projects recursively
+* **entrypoint:** keep description if already contains group
+
+
 <a name="2.0.2"></a>
 ## [2.0.2](https://gitlab.com/AdrianDC/gitlab-projects-settings/compare/2.0.1...2.0.2) (2024-04-28)
 

{gitlab_projects_settings-2.0.2 → gitlab_projects_settings-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: gitlab-projects-settings
-Version: 2.0.2
+Version: 3.0.0
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/AdrianDC/gitlab-projects-settings
 Author: Adrian DC
@@ -64,8 +64,9 @@ The following step is required before using the tool:
 ```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]
-                                [--protect-tags LEVEL]
+                                [--set-description TEXT] [--update-description] [--run-housekeeping]
+                                [--archive-project | --unarchive-project] [--delete-group] [--delete-project]
+                                [--protect-branches] [--protect-tags LEVEL]
                                 [gitlab] [path]
 
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
@@ -90,13 +91,20 @@ general settings arguments:
   --set-description TEXT  # Set description of GitLab projects and groups
   --update-description    # Update description of GitLab projects and groups automatically
 
+advanced settings arguments:
+  --run-housekeeping      # Run housekeeping of project or projects GitLab in groups
+  --archive-project       # Archive project or projects in GitLab groups
+  --unarchive-project     # Unarchive project or projects in GitLab groups
+  --delete-group          # Delete group or groups in GitLab groups
+  --delete-project        # 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]
 
 positional arguments:
   gitlab                  # GitLab URL (default: https://gitlab.com)
-  path                    # GitLab group or project path
+  path                    # GitLab group, user namespace or project path
 ```
 
 <!-- readme-help-stop -->

{gitlab_projects_settings-2.0.2 → gitlab_projects_settings-3.0.0}/README.md

@@ -30,8 +30,9 @@ The following step is required before using the tool:
 ```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]
-                                [--protect-tags LEVEL]
+                                [--set-description TEXT] [--update-description] [--run-housekeeping]
+                                [--archive-project | --unarchive-project] [--delete-group] [--delete-project]
+                                [--protect-branches] [--protect-tags LEVEL]
                                 [gitlab] [path]
 
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
@@ -56,13 +57,20 @@ general settings arguments:
   --set-description TEXT  # Set description of GitLab projects and groups
   --update-description    # Update description of GitLab projects and groups automatically
 
+advanced settings arguments:
+  --run-housekeeping      # Run housekeeping of project or projects GitLab in groups
+  --archive-project       # Archive project or projects in GitLab groups
+  --unarchive-project     # Unarchive project or projects in GitLab groups
+  --delete-group          # Delete group or groups in GitLab groups
+  --delete-project        # 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]
 
 positional arguments:
   gitlab                  # GitLab URL (default: https://gitlab.com)
-  path                    # GitLab group or project path
+  path                    # GitLab group, user namespace or project path
 ```
 
 <!-- readme-help-stop -->

{gitlab_projects_settings-2.0.2 → gitlab_projects_settings-3.0.0}/gitlab_projects_settings.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: gitlab-projects-settings
-Version: 2.0.2
+Version: 3.0.0
 Summary: Configure GitLab groups and projects settings automatically
 Home-page: https://gitlab.com/AdrianDC/gitlab-projects-settings
 Author: Adrian DC
@@ -64,8 +64,9 @@ The following step is required before using the tool:
 ```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]
-                                [--protect-tags LEVEL]
+                                [--set-description TEXT] [--update-description] [--run-housekeeping]
+                                [--archive-project | --unarchive-project] [--delete-group] [--delete-project]
+                                [--protect-branches] [--protect-tags LEVEL]
                                 [gitlab] [path]
 
 gitlab-projects-settings: Configure GitLab groups and projects settings automatically
@@ -90,13 +91,20 @@ general settings arguments:
   --set-description TEXT  # Set description of GitLab projects and groups
   --update-description    # Update description of GitLab projects and groups automatically
 
+advanced settings arguments:
+  --run-housekeeping      # Run housekeeping of project or projects GitLab in groups
+  --archive-project       # Archive project or projects in GitLab groups
+  --unarchive-project     # Unarchive project or projects in GitLab groups
+  --delete-group          # Delete group or groups in GitLab groups
+  --delete-project        # 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]
 
 positional arguments:
   gitlab                  # GitLab URL (default: https://gitlab.com)
-  path                    # GitLab group or project path
+  path                    # GitLab group, user namespace or project path
 ```
 
 <!-- readme-help-stop -->

{gitlab_projects_settings-2.0.2 → gitlab_projects_settings-3.0.0}/gitlab_projects_settings.egg-info/SOURCES.txt

@@ -35,4 +35,6 @@ src/package/version.py
 src/prints/__init__.py
 src/prints/colors.py
 src/system/__init__.py
-src/system/platform.py
+src/system/platform.py
+src/types/__init__.py
+src/types/namespaces.py

gitlab_projects_settings-3.0.0/src/cli/entrypoint.py

@@ -0,0 +1,401 @@
+#!/usr/bin/env python3
+
+# Standard libraries
+from argparse import Namespace
+
+# Modules libraries
+from gitlab.exceptions import GitlabGetError
+from gitlab.v4.objects import Group as GitLabGroup, Project as GitLabProject, User as GitLabUser
+
+# Components
+from ..features.gitlab import GitLabFeature
+from ..prints.colors import Colors
+from ..system.platform import Platform
+from ..types.namespaces import Namespaces
+
+# Entrypoint class, pylint: disable=too-few-public-methods
+class Entrypoint:
+
+    # CLI, pylint: disable=too-many-branches
+    @staticmethod
+    def cli(options: Namespace) -> bool:
+
+        # Variables
+        group: GitLabGroup = None
+        project: GitLabProject = None
+        user: GitLabUser = None
+
+        # Header
+        print(' ')
+
+        # GitLab client
+        gitlab = GitLabFeature(
+            options.gitlab,
+            options.token,
+            options.dry_run,
+        )
+        print(f'{Colors.BOLD} - GitLab host: '
+              f'{Colors.GREEN}{gitlab.url}'
+              f'{Colors.RESET}')
+        Platform.flush()
+
+        # GitLab path
+        try:
+            group = gitlab.group(options.path)
+            print(f'{Colors.BOLD} - GitLab group: '
+                  f'{Colors.GREEN}{group.full_path}'
+                  f'{Colors.CYAN} ({group.description})'
+                  f'{Colors.RESET}')
+            print(' ')
+            Platform.flush()
+        except GitlabGetError as exception:
+            try:
+                if '/' in options.path:
+                    raise TypeError from exception
+                user = gitlab.user(options.path)
+                namespace = gitlab.namespace(user.namespace_id)
+                print(f'{Colors.BOLD} - GitLab user namespace: '
+                      f'{Colors.GREEN}{namespace.full_path}'
+                      f'{Colors.CYAN} ({namespace.name})'
+                      f'{Colors.RESET}')
+                print(' ')
+                Platform.flush()
+            except (GitlabGetError, TypeError):
+                project = gitlab.project(options.path)
+                print(f'{Colors.BOLD} - GitLab project: '
+                      f'{Colors.GREEN}{project.path_with_namespace}'
+                      f'{Colors.CYAN} ({project.description})'
+                      f'{Colors.RESET}')
+                print(' ')
+                Platform.flush()
+
+        # Handle single project
+        if project:
+            Entrypoint.project(
+                options,
+                gitlab,
+                project.id,
+            )
+
+        # Handle group recursively
+        elif group:
+
+            # Handle group
+            if not options.exclude_group:
+                if not Entrypoint.group(
+                        options,
+                        gitlab,
+                        group.id,
+                ):
+                    return False
+
+            # Iterate through subgroups
+            if not options.exclude_subgroups:
+                for group_subgroup in sorted(
+                        group.descendant_groups.list(
+                            get_all=True,
+                            include_subgroups=True,
+                            order_by='path',
+                            sort='asc',
+                        ),
+                        key=lambda item: item.full_path,
+                ):
+                    if not Entrypoint.group(
+                            options,
+                            gitlab,
+                            group_subgroup.id,
+                            True,
+                    ):
+                        return False
+
+            # Iterate through projects
+            if not options.exclude_projects:
+                for group_project in sorted(
+                        group.projects.list(
+                            get_all=True,
+                            include_subgroups=not options.exclude_subgroups,
+                            order_by='path',
+                            sort='asc',
+                        ),
+                        key=lambda item: item.path_with_namespace,
+                ):
+                    if not Entrypoint.project(
+                            options,
+                            gitlab,
+                            group_project.id,
+                    ):
+                        return False
+
+        # Handle user recursively
+        elif user:
+
+            # Iterate through projects
+            if not options.exclude_projects:
+                for user_project in sorted(
+                        user.projects.list(
+                            get_all=True,
+                            order_by='path',
+                            sort='asc',
+                        ),
+                        key=lambda item: item.path_with_namespace,
+                ):
+                    if not Entrypoint.project(
+                            options,
+                            gitlab,
+                            user_project.id,
+                    ):
+                        return False
+
+        # Result
+        return True
+
+    # Group
+    @staticmethod
+    def group(
+        options: Namespace,
+        gitlab: GitLabFeature,
+        criteria: str,
+        subgroup: bool = False,
+    ) -> bool:
+
+        # Acquire group
+        group = gitlab.group(criteria)
+
+        # Acquire parent group
+        parent_group: GitLabGroup = 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}: '
+              f'{Colors.YELLOW_LIGHT}{group.full_path} '
+              f'{Colors.CYAN}({group.description})'
+              f'{Colors.RESET}')
+        Platform.flush()
+
+        # Delete group
+        if options.delete_group:
+            gitlab.group_delete(criteria)
+            print(f'{Colors.BOLD}   - Delete {group_type}: '
+                  f'{Colors.GREEN}Success'
+                  f'{Colors.RESET}')
+            print(' ')
+            Platform.flush()
+            return subgroup
+
+        # Set group description
+        if options.set_description:
+            gitlab.group_set_description(criteria, options.set_description)
+            print(f'{Colors.BOLD}   - Set description: '
+                  f'{Colors.CYAN}{options.set_description}'
+                  f'{Colors.RESET}')
+            Platform.flush()
+
+        # Update group description
+        elif options.update_description:
+            parent_description_text: str = ''
+            if parent_name:
+                parent_description_text = ' - ' + Namespaces.describe(
+                    name=parent_name,
+                    description=parent_description,
+                )
+            if not group.description or subgroup and ( \
+                        not parent_description_text or \
+                        not group.description.endswith(f'{parent_description_text}') \
+                    ):
+                description = f'{Namespaces.describe(name=group.name)}' \
+                              f'{parent_description_text}'
+                gitlab.group_set_description(criteria, description)
+                print(f'{Colors.BOLD}   - Updated description: '
+                      f'{Colors.CYAN}{description}'
+                      f'{Colors.RESET}')
+                Platform.flush()
+            else:
+                print(f'{Colors.BOLD}   - Kept description: '
+                      f'{Colors.GREEN}{group.description}'
+                      f'{Colors.RESET}')
+                Platform.flush()
+
+        # Reset group members
+        if options.reset_members:
+            gitlab.group_reset_members(criteria)
+            print(f'{Colors.BOLD}   - Reset members: '
+                  f'{Colors.GREEN}Success'
+                  f'{Colors.RESET}')
+            Platform.flush()
+
+        # Set group avatar
+        if 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}')
+            Platform.flush()
+
+        # Footer
+        print(' ')
+        Platform.flush()
+
+        # Result
+        return True
+
+    # Project, pylint: disable=too-many-branches,too-many-statements
+    @staticmethod
+    def project(
+        options: Namespace,
+        gitlab: GitLabFeature,
+        criteria: str,
+    ) -> bool:
+
+        # Acquire project
+        project = gitlab.project(criteria)
+
+        # Show project details
+        print(f'{Colors.BOLD} - GitLab project: '
+              f'{Colors.YELLOW_LIGHT}{project.path_with_namespace} '
+              f'{Colors.CYAN}({project.description})'
+              f'{Colors.RESET}')
+        Platform.flush()
+
+        # Delete project
+        if options.delete_project:
+            gitlab.project_delete(criteria)
+            print(f'{Colors.BOLD}   - Delete project: '
+                  f'{Colors.GREEN}Success'
+                  f'{Colors.RESET}')
+            print(' ')
+            Platform.flush()
+            return True
+
+        # Set project description
+        if options.set_description:
+            gitlab.project_set_description(criteria, options.set_description)
+            print(f'{Colors.BOLD}   - Set description: '
+                  f'{Colors.CYAN}{options.set_description}'
+                  f'{Colors.RESET}')
+            Platform.flush()
+
+        # Update project description
+        elif options.update_description:
+            namespace_description: str
+            if project.namespace['kind'] == 'user':
+                namespace = gitlab.namespace(project.namespace['id'])
+                namespace_description = namespace.name
+            else:
+                group = gitlab.group(project.namespace['id'])
+                namespace_description = Namespaces.describe(
+                    name=group.name,
+                    description=group.description,
+                )
+            if not project.description or \
+                    not project.description.endswith(f' - {namespace_description}'):
+                description = f'{Namespaces.describe(name=project.name)}' \
+                              f' - {namespace_description}'
+                gitlab.project_set_description(criteria, description)
+                print(f'{Colors.BOLD}   - Updated description: '
+                      f'{Colors.CYAN}{description}'
+                      f'{Colors.RESET}')
+                Platform.flush()
+            else:
+                print(f'{Colors.BOLD}   - Kept description: '
+                      f'{Colors.GREEN}{project.description}'
+                      f'{Colors.RESET}')
+                Platform.flush()
+
+        # Reset project features
+        if options.reset_features:
+            features = ', '.join(gitlab.project_reset_features(criteria))
+            if features:
+                print(f'{Colors.BOLD}   - Reset features: '
+                      f'{Colors.CYAN}{features}'
+                      f'{Colors.RESET}')
+                Platform.flush()
+            else:
+                print(f'{Colors.BOLD}   - Reset features: '
+                      f'{Colors.GREEN}Already done'
+                      f'{Colors.RESET}')
+                Platform.flush()
+
+        # Reset project members
+        if options.reset_members:
+            gitlab.project_reset_members(criteria)
+            print(f'{Colors.BOLD}   - Reset members: '
+                  f'{Colors.GREEN}Success'
+                  f'{Colors.RESET}')
+            Platform.flush()
+
+        # Set project avatar
+        if 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}')
+            Platform.flush()
+
+        # Run project housekeeping
+        if options.run_housekeeping:
+            gitlab.project_run_housekeeping(criteria)
+            print(f'{Colors.BOLD}   - Ran housekeeping: '
+                  f'{Colors.GREEN}Success'
+                  f'{Colors.RESET}')
+            Platform.flush()
+
+        # Archive project
+        if options.archive_project:
+            gitlab.project_set_archive(criteria, True)
+            print(f'{Colors.BOLD}   - Archive project: '
+                  f'{Colors.GREEN}Success'
+                  f'{Colors.RESET}')
+            Platform.flush()
+
+        # Unarchive project
+        elif options.unarchive_project:
+            gitlab.project_set_archive(criteria, False)
+            print(f'{Colors.BOLD}   - Unarchive project: '
+                  f'{Colors.GREEN}Success'
+                  f'{Colors.RESET}')
+            Platform.flush()
+
+        # Protect project branches
+        if options.protect_branches:
+            branches = ', '.join(gitlab.project_protect_branches(criteria))
+            if branches:
+                print(f'{Colors.BOLD}   - Protecting branches: '
+                      f'{Colors.CYAN}{branches}'
+                      f'{Colors.RESET}')
+                Platform.flush()
+            else:
+                print(f'{Colors.BOLD}   - Protecting branches: '
+                      f'{Colors.GREEN}Already done'
+                      f'{Colors.RESET}')
+                Platform.flush()
+
+        # Protect project tags
+        if options.protect_tags:
+            tags = ', '.join(gitlab.project_protect_tags(criteria, options.protect_tags))
+            if tags:
+                print(f'{Colors.BOLD}   - Protecting tags: '
+                      f'{Colors.CYAN}{tags}'
+                      f'{Colors.GREEN} (level: {options.protect_tags})'
+                      f'{Colors.RESET}')
+                Platform.flush()
+            else:
+                print(f'{Colors.BOLD}   - Protecting tags: '
+                      f'{Colors.GREEN}Already done'
+                      f'{Colors.RESET}')
+                Platform.flush()
+
+        # Footer
+        print(' ')
+        Platform.flush()
+
+        # Result
+        return True