pycallgraph-visualizer 1.0.1__py3-none-any.whl

pycallgraph_visualizer/cli.py

@@ -0,0 +1,181 @@
+"""
+Command-line interface for pycallgraph-visualizer
+"""
+
+import argparse
+import os
+import sys
+import webbrowser
+from pathlib import Path
+from .analyzer import analyze_directory, generate_html_graph
+
+
+def main():
+    """Main entry point for the CLI"""
+    parser = argparse.ArgumentParser(
+        prog='pycallgraph',
+        description='Visualize Python code dependencies with interactive call graphs',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Analyze current directory
+  pycallgraph
+  
+  # Analyze specific directory
+  pycallgraph /path/to/project
+  
+  # Specify output file
+  pycallgraph -o my_graph.html
+  
+  # Don't open browser automatically
+  pycallgraph --no-browser
+  
+  # Increase complexity threshold
+  pycallgraph --complexity-threshold 15
+        """
+    )
+    
+    parser.add_argument(
+        'directory',
+        nargs='?',
+        default='.',
+        help='Directory to analyze (default: current directory)'
+    )
+    
+    parser.add_argument(
+        '-o', '--output',
+        default='call_graph.html',
+        help='Output HTML file name (default: call_graph.html)'
+    )
+    
+    parser.add_argument(
+        '--no-browser',
+        action='store_true',
+        help="Don't open the browser automatically"
+    )
+    
+    parser.add_argument(
+        '--complexity-threshold',
+        type=int,
+        default=10,
+        help='Complexity threshold for flagging functions (default: 10)'
+    )
+    
+    parser.add_argument(
+        '--include-tests',
+        action='store_true',
+        help='Include test files in analysis'
+    )
+    
+    parser.add_argument(
+        '-v', '--verbose',
+        action='store_true',
+        help='Verbose output'
+    )
+    
+    parser.add_argument(
+        '--version',
+        action='version',
+        version='%(prog)s 1.0.0'
+    )
+    
+    args = parser.parse_args()
+    
+    # Resolve directory path
+    directory = os.path.abspath(args.directory)
+    
+    if not os.path.exists(directory):
+        print(f"❌ Error: Directory not found: {directory}", file=sys.stderr)
+        sys.exit(1)
+    
+    if not os.path.isdir(directory):
+        print(f"❌ Error: Path is not a directory: {directory}", file=sys.stderr)
+        sys.exit(1)
+    
+    # Check if there are any Python files
+    has_python_files = any(
+        f.endswith('.py') 
+        for root, _, files in os.walk(directory) 
+        for f in files
+    )
+    
+    if not has_python_files:
+        print(f"❌ Error: No Python files found in: {directory}", file=sys.stderr)
+        sys.exit(1)
+    
+    print("🔍 PyCallGraph Visualizer")
+    print("=" * 60)
+    print(f"📁 Analyzing: {directory}")
+    print()
+    
+    try:
+        # Analyze the directory
+        analysis_result = analyze_directory(
+            directory
+        )
+        
+        if analysis_result["total_functions"] == 0:
+            print("⚠️  No Python functions found in the directory.")
+            print("   Make sure the directory contains .py files with function definitions.")
+            sys.exit(1)
+        
+        # Generate output file path
+        if os.path.isabs(args.output):
+            output_file = args.output
+        else:
+            output_file = os.path.join(directory, args.output)
+        
+        # Generate HTML graph
+        generate_html_graph(analysis_result, output_file, directory)
+        
+        # Print summary
+        print()
+        print("=" * 60)
+        print("📊 Analysis Complete!")
+        print("=" * 60)
+        print(f"📈 Total Functions: {analysis_result['total_functions']}")
+        print(f"📁 Total Files: {analysis_result['total_files']}")
+        print(f"🔗 Total Connections: {sum(len(v) for v in analysis_result['call_graph'].values())}")
+        print()
+        
+        if analysis_result['circular_dependencies']:
+            print(f"🔴 Circular Dependencies: {len(analysis_result['circular_dependencies'])}")
+        else:
+            print("✅ No circular dependencies found")
+        
+        if analysis_result['dead_functions']:
+            print(f"💀 Dead Functions: {len(analysis_result['dead_functions'])}")
+        else:
+            print("✅ No dead code found")
+        
+        if analysis_result['high_complexity_functions']:
+            print(f"📈 High Complexity Functions: {len(analysis_result['high_complexity_functions'])}")
+        else:
+            print("✅ All functions have reasonable complexity")
+
+        print(f"🚪 Entry Points: {len(analysis_result['entry_points'])}")
+        print()
+        print(f"📄 Output: {output_file}")
+        
+        # Open browser
+        if not args.no_browser:
+            print("🌐 Opening in browser...")
+            webbrowser.open('file://' + os.path.abspath(output_file))
+        
+        print()
+        print("💡 Tips:")
+        print("   - Use search to filter functions")
+        print("   - Click function names to focus on their dependencies")
+        print("   - Hover over nodes for detailed metrics")
+        print("   - Red = Circular deps, Gray = Dead code, Orange = Complex, Green = Entry points")
+        
+    except Exception as e:
+        print(f"❌ Error during analysis: {e}", file=sys.stderr)
+        if args.verbose:
+            import traceback
+            traceback.print_exc()
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()

pycallgraph_visualizer-1.0.1.dist-info/METADATA

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: pycallgraph-visualizer
+Version: 1.0.1
+Summary: Visualize Python code dependencies with interactive call graphs
+Home-page: https://github.com/Er-buddy/PyCallGraph-Visualizer/issues
+Author: Rankush Vishwakarma
+Author-email: er.rankush.vishwakarma.in@gmail.com
+Project-URL: Bug Reports, https://github.com/Er-buddy/PyCallGraph-Visualizer/issues
+Project-URL: Source, https://github.com/Er-buddy/PyCallGraph-Visualizer/issues
+Keywords: call-graph visualization code-analysis python ast circular-dependency
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Documentation
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyvis>=0.3.2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

pycallgraph_visualizer-1.0.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+pycallgraph_visualizer/__init__.py,sha256=E1N6uQci4ura-LJpSOehuIJPlO_en82G0tWpBhHmB_g,744
+pycallgraph_visualizer/analyzer.py,sha256=VGRmnmM7f3OiKZyt5zVvrqHAc9IPvkNpCasbTiiw0wk,67585
+pycallgraph_visualizer/cli.py,sha256=AwiGsdyawFDGFlH2VSRimeQWJeFtpNjUsXs_Wyw02kw,5545
+pycallgraph_visualizer-1.0.1.dist-info/licenses/LICENSE,sha256=q53YqEH5OACuJ8YmE3i9pND509hapVaOX42ix2AMkZ8,1085
+pycallgraph_visualizer-1.0.1.dist-info/METADATA,sha256=P74BvHSI6_YNcA0NQyE4qJrAmqe3lIECA6bB_KrzDCA,1474
+pycallgraph_visualizer-1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pycallgraph_visualizer-1.0.1.dist-info/entry_points.txt,sha256=k15hB0Vtyr-QaDE91k9QG8_QmBViA63cHV_J5sB3PyI,64
+pycallgraph_visualizer-1.0.1.dist-info/top_level.txt,sha256=KX4s7Fqg77k4263iuckooioPaJmg-h6BAa7f8fRKAOA,23
+pycallgraph_visualizer-1.0.1.dist-info/RECORD,,

pycallgraph_visualizer-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pycallgraph_visualizer-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pycallgraph = pycallgraph_visualizer.cli:main

pycallgraph_visualizer-1.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pycallgraph_visualizer-1.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+pycallgraph_visualizer