tgwrap 0.10.0__py3-none-any.whl → 0.10.2__py3-none-any.whl

tgwrap/cli.py

@@ -750,6 +750,11 @@ def check_deployments(manifest_file, verbose, working_dir, out):
     help='Whether or not external dependencies must be ignored',
     show_default=True
     )
+@click.option('--analyze', '-a',
+    is_flag=True, default=False,
+    help='Show analysis of the graph',
+    show_default=True
+    )
 @click.option('--include-dir', '-I',
     multiple=True, default=[],
     help=r'A glob of a directory that needs to be included, this option can be used multiple times. For example: -I "integrations/\*/\*"',
@@ -765,7 +770,7 @@ def check_deployments(manifest_file, verbose, working_dir, out):
     )
 @click.argument('terragrunt-args', nargs=-1, type=click.UNPROCESSED)
 @click.version_option(version=__version__)
-def show_graph(verbose, backwards, exclude_external_dependencies, working_dir, include_dir, exclude_dir, terragrunt_args):
+def show_graph(verbose, backwards, exclude_external_dependencies, analyze, working_dir, include_dir, exclude_dir, terragrunt_args):
     """ Shows the dependencies of a project """
 
     check_latest_version(verbose)
@@ -774,6 +779,7 @@ def show_graph(verbose, backwards, exclude_external_dependencies, working_dir, i
     tgwrap.show_graph(
         backwards=backwards,
         exclude_external_dependencies=exclude_external_dependencies,
+        analyze=analyze,
         working_dir=working_dir,
         include_dirs=include_dir,
         exclude_dirs=exclude_dir,

tgwrap/inspector-resources-template.yml

@@ -43,6 +43,11 @@ databricks_workspace:
   properties:
     properties.provisioningState: Succeeded
     location: "{{location_code}}"
+machine_learning_workspace:
+  url: https://management.azure.com/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.MachineLearningServices/workspaces/{name}?api-version=2023-04-01
+  properties:
+    properties.provisioningState: Succeeded
+    location: "{{location_code}}"
 data_factory:
   url: https://management.azure.com/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.DataFactory/factories/{name}?api-version=2018-06-01
   properties:

tgwrap/main.py

@@ -1764,15 +1764,88 @@ Note:
             except Exception:
                 pass
 
-    def show_graph(self, backwards, exclude_external_dependencies, working_dir, include_dirs, exclude_dirs, terragrunt_args):
+    def show_graph(self, backwards, exclude_external_dependencies, analyze, working_dir, include_dirs, exclude_dirs, terragrunt_args):
         """ Shows the dependencies of a project """
 
+        def set_json_dumps_default(obj):
+            if isinstance(obj, set):
+                return list(obj)
+            raise TypeError
+
+        def calculate_dependencies(graph):
+            dependencies = {}
+            for node in graph.nodes:
+                out_degree = graph.out_degree(node)
+                in_degree = graph.in_degree(node)
+                total_degree = out_degree + in_degree
+                dependencies[node] = {
+                    'dependencies': out_degree,
+                    'dependent_on_it': in_degree,
+                    'total': total_degree,
+                }
+
+            return dependencies
+
+        def calculate_graph_metrics(graph):
+
+            metrics = {}
+
+            # Degree centrality
+            metric = {
+                'values': dict(sorted(nx.degree_centrality(graph).items(), key=lambda item: item[1], reverse=True)),
+                'description': 'Shows the degree of each node relative to the number of nodes in the graph',
+            }
+            sorted_dependencies = sorted(dependencies.items(), key=lambda x: x[1]['total'], reverse=True)
+            metrics['degree_centrality'] = metric
+            
+            # Betweenness centrality
+            metric = {
+                'values': dict(sorted(nx.betweenness_centrality(graph).items(), key=lambda item: item[1], reverse=True)),
+                'description': 'Indicates nodes that frequently lie on shortest paths between other nodes',
+            }
+            metrics['betweenness_centrality'] = metric
+            
+            # Closeness centrality
+            metric = {
+                'values': dict(sorted(nx.closeness_centrality(graph).items(), key=lambda item: item[1], reverse=True)),
+                'description': 'Reflects how quickly a node can reach other nodes in the graph',
+            }
+            metrics['closeness_centrality'] = metric
+            
+            # Strongly Connected Components (SCC)
+            metric = {
+                'values': list(nx.strongly_connected_components(graph)),
+                'description': 'Lists sets of nodes that are mutually reachable',
+            }
+            metrics['strongly_connected_components'] = metric
+            
+            # Weakly Connected Components (WCC)
+            metric = {
+                'values': list(nx.weakly_connected_components(graph)),
+                'description': 'Lists sets of nodes that are connected disregarding edge directions',
+            }
+            metrics['weakly_connected_components'] = metric
+            
+            # Average Path Length (only if the graph is connected)
+            if nx.is_strongly_connected(graph):
+                metric = {
+                    'values': nx.average_shortest_path_length(graph),
+                    'description': 'Shows the average shortest path length, indicating the graph\'s efficiency',
+                }
+                metrics['average_path_length'] = metric
+            
+            return metrics
+
         self.printer.verbose(f"Attempting to show dependencies")
         if terragrunt_args:
             self.printer.verbose(f"- with additional parameters: {' '.join(terragrunt_args)}")
 
         "Runs the desired command in the directories as defined in the directed graph"
         graph = self._get_di_graph(backwards=backwards, working_dir=working_dir)
+        try:
+            graph.remove_node(r'\n')
+        except nx.exception.NetworkXError:
+            pass
 
         # first go through the groups and clean up where needed
         groups = self._prepare_groups(
@@ -1792,6 +1865,27 @@ Note:
                 for directory in group:
                     self.printer.normal(f"- {directory}")
 
+        if analyze:
+            self.printer.header("Graph analysis", print_line_before=True)
+
+            self.printer.bold("Dependencies counts:", print_line_before=True)
+            dependencies = calculate_dependencies(graph)
+            sorted_dependencies = sorted(dependencies.items(), key=lambda x: x[1]['total'], reverse=True)
+            for node, counts in sorted_dependencies:
+                msg = f"""
+{node} ->
+\ttotal:        {counts['total']}
+\tdependent on: {counts['dependent_on_it']}
+\tdependencies: {counts['dependencies']}
+"""
+                self.printer.normal(msg)
+
+            metrics = calculate_graph_metrics(graph)
+            for metric, item in metrics.items():
+                self.printer.bold(f'Metric: {metric}')
+                self.printer.normal(f'Description: {item["description"]}')
+                self.printer.normal(json.dumps(item['values'], indent=2, default=set_json_dumps_default))
+
     def clean(self, working_dir):
         """ Clean the temporary files of a terragrunt/terraform project """
 
@@ -1922,9 +2016,12 @@ Note:
             exit_code = 0
             self.printer.header('Inspection status:', print_line_before=True)
             for k,v in results.items():
-                msg = f"{v['type']}: {k}\n\t-> Resource:\t{v.get('inspect_status_code', 'NC')} ({v.get('inspect_message', 'not found')})"
+                msg = f"""{v['type']}: {k}
+        -> Resource:  {v.get('inspect_status_code', 'NC')} ({v.get('inspect_message', 'not found')})""" # only since python 3.12 you can use things like \t and \n in an f-string
                 if 'rbac_assignment_status_code' in v:
-                    msg = msg + f'\n\t-> RBAC:\t{v['rbac_assignment_status_code']} ({v.get('rbac_assignment_message')})'
+                    msg = msg + f"""
+        -> RBAC: {v['rbac_assignment_status_code']} ({v.get('rbac_assignment_message')})"
+""" # only since python 3.12 you can use things like \t and \n in an f-string
                 if v['inspect_status_code'] != 'OK' or v.get('rbac_assignment_status_code', 'OK') == 'NOK':
                     self.printer.error(msg=msg)
                     exit_code += 1

{tgwrap-0.10.0.dist-info → tgwrap-0.10.2.dist-info}/METADATA

@@ -1,17 +1,15 @@
 Metadata-Version: 2.1
 Name: tgwrap
-Version: 0.10.0
+Version: 0.10.2
 Summary: A (terragrunt) wrapper around a (terraform) wrapper around ....
 Home-page: https://gitlab.com/lunadata/tgwrap
 License: MIT
 Keywords: terraform,terragrunt,terrasafe,python
 Author: Gerco Grandia
 Author-email: gerco.grandia@4synergy.nl
-Requires-Python: >=3.10,<4.0
+Requires-Python: >=3.12,<4.0
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: azure-core (>=1.30.2,<2.0.0)
 Requires-Dist: azure-identity (>=1.17.1,<2.0.0)

tgwrap-0.10.2.dist-info/RECORD

@@ -0,0 +1,13 @@
+tgwrap/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tgwrap/analyze.py,sha256=TJvAKVIbWl8-8oxpTwXVBWU72q_XQKzUTlyMZ25cV2M,8728
+tgwrap/cli.py,sha256=0SFzLJA-deut81Mpt6Giq77WK26vTDcajyFnPIHXR5c,31649
+tgwrap/deploy.py,sha256=-fSk-Ix_HqrXY7KQX_L27TnFzIuhBHYv4xYJW6zRDN4,10243
+tgwrap/inspector-resources-template.yml,sha256=Mos8NDzzZ3VxdXgeiVL9cmQfRcIXIHMLf79_KLwdXu8,3297
+tgwrap/inspector.py,sha256=5pW7Ex1lkKRoXY6hZGbCNmSD2iRzgMSfqi9w7gb-AcY,16990
+tgwrap/main.py,sha256=WKxlREE4QmdZKTHivhWa3K5yI40amGlmjBs4y7oCTqw,88748
+tgwrap/printer.py,sha256=frn1PARd8A28mkRCYR6ybN2x0NBULhNOutn4l2U7REY,2754
+tgwrap-0.10.2.dist-info/LICENSE,sha256=VT-AVxIXt3EQTC-7Hy1uPGnrDNJLqfcgLgJD78fiyx4,1065
+tgwrap-0.10.2.dist-info/METADATA,sha256=TMYitOkytrAQdGcEIeCOeiyKLg5yAFtgnmiupyLiJjo,17476
+tgwrap-0.10.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+tgwrap-0.10.2.dist-info/entry_points.txt,sha256=H8X0PMPmd4aW7Y9iyChZ0Ug6RWGXqhRUvHH-6f6Mxz0,42
+tgwrap-0.10.2.dist-info/RECORD,,

tgwrap-0.10.0.dist-info/RECORD

@@ -1,13 +0,0 @@
-tgwrap/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tgwrap/analyze.py,sha256=TJvAKVIbWl8-8oxpTwXVBWU72q_XQKzUTlyMZ25cV2M,8728
-tgwrap/cli.py,sha256=UokTSBp84HZ9IAwn0MlGMUjpjL76SILWm1GNlVHAqr0,31482
-tgwrap/deploy.py,sha256=-fSk-Ix_HqrXY7KQX_L27TnFzIuhBHYv4xYJW6zRDN4,10243
-tgwrap/inspector-resources-template.yml,sha256=goQaqyaTb_o1fAuCBHl-6xc1Rul63Byqau5RQ4qJvTo,2992
-tgwrap/inspector.py,sha256=5pW7Ex1lkKRoXY6hZGbCNmSD2iRzgMSfqi9w7gb-AcY,16990
-tgwrap/main.py,sha256=zKddIfI7-KHd1lX9xXh_tqgnIUa8uOxqDSxsVNW-klg,84544
-tgwrap/printer.py,sha256=frn1PARd8A28mkRCYR6ybN2x0NBULhNOutn4l2U7REY,2754
-tgwrap-0.10.0.dist-info/LICENSE,sha256=VT-AVxIXt3EQTC-7Hy1uPGnrDNJLqfcgLgJD78fiyx4,1065
-tgwrap-0.10.0.dist-info/METADATA,sha256=kH2A2ZYjEQPKQ0iGbJKiachqmV1yELC3j1k5g7ZWVyM,17578
-tgwrap-0.10.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-tgwrap-0.10.0.dist-info/entry_points.txt,sha256=H8X0PMPmd4aW7Y9iyChZ0Ug6RWGXqhRUvHH-6f6Mxz0,42
-tgwrap-0.10.0.dist-info/RECORD,,