cod8a 0.1.0__tar.gz → 0.2.1__tar.gz

{cod8a-0.1.0 → cod8a-0.2.1}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: cod8a
-Version: 0.1.0
+Version: 0.2.1
 Summary: cod8a is a code documentation and visualization tool for Python and .NET projects
 License-Expression: MIT
 License-File: LICENSE
 Keywords: visualization,uml,docs,flowchart,class,sequence,diagram
-Author: Akumbom
+Author: Marietta Akumbom
 Author-email: akumbom5ma@gmail.com
 Maintainer: Marietta Akumbom
 Requires-Python: >=3.13
@@ -14,6 +14,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: click (>=8.3.3,<9.0.0)
 Requires-Dist: pydantic (>=2.13.3,<3.0.0)
+Project-URL: Repository, https://github.com/marietta-a/cod8a
 Description-Content-Type: text/markdown
 
 # cod8a
@@ -27,61 +28,17 @@ cod8a pronounced codetta, is a code documentation and visualization tool for **P
 - **[Python 3.9+](https://www.python.org/downloads/)**
 - **[.NET 10.0 Runtime or SDK](https://dotnet.microsoft.com/download/dotnet/10.0)** (Required **only** for C#/.NET analysis)
 
-### From PyPI (Recommended for Users)
+### From PyPI
 
-Once published, you can install `cod8a` directly using pip:
+Install `cod8a` directly using pip:
 
 ```bash
 pip install cod8a
 ```
 
-## Development & Contribution
-
-If you want to contribute to the project or run it from source:
-
-### Setup
-
-1. **Fork** the repository on GitHub.
-2. **Clone** your fork:
-
-```bash
-git clone https://github.com/yourusername/cod8a.git
-cd cod8a
-```
-
-### Development Options
-
-#### 1. Local Setup
-3. **Install** Python dependencies using **[Poetry](https://python-poetry.org/docs/#installation)**:
-
-```bash
-poetry install
-```
-
-4. **Optional**: Ensure .NET 10.0 is installed (if documenting C#)
-
-```bash
-dotnet --version
-```
-
-#### 2. VS Code Dev Container (Recommended)
-If you use VS Code, you can skip the local setup by using the provided **Dev Container**. It comes pre-configured with Python 3.13, .NET 10.0, and Poetry.
-- Simply open the project in VS Code and click **"Reopen in Container"** when prompted.
-
-#### 3. Docker
-You can also run `cod8a` as a standalone container without installing any dependencies locally:
-
-```bash
-# Build the image
-docker build -t cod8a .
-
-# Run the tool
-docker run -v $(pwd):/app/data cod8a uml -p /app/data/src
-```
-
 ## Usage
 
-The tool uses a CLI interface to analyze code and generate visualizations.
+The tool uses a CLI interface to analyze code and generate mermaid diagrams.
 
 ### UML Diagrams
 
@@ -92,13 +49,19 @@ Generate Mermaid-compatible diagrams (Class, Sequence, Flowchart):
 cod8a uml -p <path_to_source> -d <diagram_type>
 
 # Generate a class diagram (default)
-cod8a uml -p src/my_project
+cod8a uml -p <path_to_source>
 
 # Generate a sequence diagram
-cod8a uml -p src/my_file.py -d sequence
+cod8a uml -p <path_to_source> -d sequence
 
 # Generate a flowchart
-cod8a uml -p src/my_logic -d flow
+cod8a uml -p <path_to_source> -d flow
+
+# Summarize a large project (omit fields/methods)
+cod8a uml -p <path_to_source> --summarize
+
+# Force full diagram details for a large file
+cod8a uml -p <path_to_source> --no-summarize
 ```
 
 #### Diagram Type Options:
@@ -106,11 +69,19 @@ cod8a uml -p src/my_logic -d flow
 - **Sequence:** `sequence`, `seq`, `s`
 - **Flowchart:** `flowchart`, `flow`, `f`
 
+### Samples
+Below are detailed example Mermaid diagrams generated by `cod8a` based on its own `src/cod8a/models/models.py` file:
+
+- [Class Diagram Example](examples/class_diagram.mmd)
+- [Flowchart Example](examples/flowchart.mmd)
+- [Sequence Diagram Example](examples/sequence_diagram.mmd)
+
 ### CLI Options
 
 - `-p, --path`: Path to the file or directory to analyze.
 - `-d, --diagram`: Type of diagram to generate (default: `class`).
 - `-o, --output`: Output file path (saves as `.mmd`).
+- `-s, --summarize / --no-summarize`: Enable or disable diagram summarization. When enabled, details like fields and methods are omitted (useful for large files). Defaults to auto-summarize for large files.
 
 ### Documentation (In development)
 
@@ -132,3 +103,48 @@ cod8a doc -p path/to/source
 - **Markdown Documentation (TODO):** Detailed markdown generation for code documentation is currently in development.
 
 
+<!-- ## Development & Contribution -->
+<!-- If you want to contribute to the project or run it from source: -->
+## Development
+
+### Setup
+
+1. **Fork** the repository on GitHub.
+2. **Clone** your fork:
+
+```bash
+git clone https://github.com/yourusername/cod8a.git
+cd cod8a
+```
+
+### Development Options
+
+#### 1. Local Setup
+3. **Install** Python dependencies:
+
+Using **[Poetry](https://python-poetry.org/docs/#installation)** (recommended):
+```bash
+poetry install
+```
+
+4. **Optional**: Ensure .NET 10.0 is installed (if documenting C#)
+
+```bash
+dotnet --version
+```
+
+#### 2. VS Code Dev Container (Recommended)
+If you use VS Code, you can skip the local setup by using the provided **Dev Container**. It comes pre-configured with Python 3.13, .NET 10.0, and Poetry.
+- Simply open the project in VS Code and click **"Reopen in Container"** when prompted.
+
+#### 3. Docker
+You can also run `cod8a` as a standalone container without installing any dependencies locally:
+
+```bash
+# Build the image
+docker build -t cod8a .
+
+# Run the tool
+docker run -v $(pwd):/app/data cod8a uml -p /app/data/src
+```
+

{cod8a-0.1.0 → cod8a-0.2.1}/README.md

@@ -9,61 +9,17 @@ cod8a pronounced codetta, is a code documentation and visualization tool for **P
 - **[Python 3.9+](https://www.python.org/downloads/)**
 - **[.NET 10.0 Runtime or SDK](https://dotnet.microsoft.com/download/dotnet/10.0)** (Required **only** for C#/.NET analysis)
 
-### From PyPI (Recommended for Users)
+### From PyPI
 
-Once published, you can install `cod8a` directly using pip:
+Install `cod8a` directly using pip:
 
 ```bash
 pip install cod8a
 ```
 
-## Development & Contribution
-
-If you want to contribute to the project or run it from source:
-
-### Setup
-
-1. **Fork** the repository on GitHub.
-2. **Clone** your fork:
-
-```bash
-git clone https://github.com/yourusername/cod8a.git
-cd cod8a
-```
-
-### Development Options
-
-#### 1. Local Setup
-3. **Install** Python dependencies using **[Poetry](https://python-poetry.org/docs/#installation)**:
-
-```bash
-poetry install
-```
-
-4. **Optional**: Ensure .NET 10.0 is installed (if documenting C#)
-
-```bash
-dotnet --version
-```
-
-#### 2. VS Code Dev Container (Recommended)
-If you use VS Code, you can skip the local setup by using the provided **Dev Container**. It comes pre-configured with Python 3.13, .NET 10.0, and Poetry.
-- Simply open the project in VS Code and click **"Reopen in Container"** when prompted.
-
-#### 3. Docker
-You can also run `cod8a` as a standalone container without installing any dependencies locally:
-
-```bash
-# Build the image
-docker build -t cod8a .
-
-# Run the tool
-docker run -v $(pwd):/app/data cod8a uml -p /app/data/src
-```
-
 ## Usage
 
-The tool uses a CLI interface to analyze code and generate visualizations.
+The tool uses a CLI interface to analyze code and generate mermaid diagrams.
 
 ### UML Diagrams
 
@@ -74,13 +30,19 @@ Generate Mermaid-compatible diagrams (Class, Sequence, Flowchart):
 cod8a uml -p <path_to_source> -d <diagram_type>
 
 # Generate a class diagram (default)
-cod8a uml -p src/my_project
+cod8a uml -p <path_to_source>
 
 # Generate a sequence diagram
-cod8a uml -p src/my_file.py -d sequence
+cod8a uml -p <path_to_source> -d sequence
 
 # Generate a flowchart
-cod8a uml -p src/my_logic -d flow
+cod8a uml -p <path_to_source> -d flow
+
+# Summarize a large project (omit fields/methods)
+cod8a uml -p <path_to_source> --summarize
+
+# Force full diagram details for a large file
+cod8a uml -p <path_to_source> --no-summarize
 ```
 
 #### Diagram Type Options:
@@ -88,11 +50,19 @@ cod8a uml -p src/my_logic -d flow
 - **Sequence:** `sequence`, `seq`, `s`
 - **Flowchart:** `flowchart`, `flow`, `f`
 
+### Samples
+Below are detailed example Mermaid diagrams generated by `cod8a` based on its own `src/cod8a/models/models.py` file:
+
+- [Class Diagram Example](examples/class_diagram.mmd)
+- [Flowchart Example](examples/flowchart.mmd)
+- [Sequence Diagram Example](examples/sequence_diagram.mmd)
+
 ### CLI Options
 
 - `-p, --path`: Path to the file or directory to analyze.
 - `-d, --diagram`: Type of diagram to generate (default: `class`).
 - `-o, --output`: Output file path (saves as `.mmd`).
+- `-s, --summarize / --no-summarize`: Enable or disable diagram summarization. When enabled, details like fields and methods are omitted (useful for large files). Defaults to auto-summarize for large files.
 
 ### Documentation (In development)
 
@@ -113,3 +83,48 @@ cod8a doc -p path/to/source
 - **Python Support:** Uses AST-based parsing for Python files.
 - **Markdown Documentation (TODO):** Detailed markdown generation for code documentation is currently in development.
 
+
+<!-- ## Development & Contribution -->
+<!-- If you want to contribute to the project or run it from source: -->
+## Development
+
+### Setup
+
+1. **Fork** the repository on GitHub.
+2. **Clone** your fork:
+
+```bash
+git clone https://github.com/yourusername/cod8a.git
+cd cod8a
+```
+
+### Development Options
+
+#### 1. Local Setup
+3. **Install** Python dependencies:
+
+Using **[Poetry](https://python-poetry.org/docs/#installation)** (recommended):
+```bash
+poetry install
+```
+
+4. **Optional**: Ensure .NET 10.0 is installed (if documenting C#)
+
+```bash
+dotnet --version
+```
+
+#### 2. VS Code Dev Container (Recommended)
+If you use VS Code, you can skip the local setup by using the provided **Dev Container**. It comes pre-configured with Python 3.13, .NET 10.0, and Poetry.
+- Simply open the project in VS Code and click **"Reopen in Container"** when prompted.
+
+#### 3. Docker
+You can also run `cod8a` as a standalone container without installing any dependencies locally:
+
+```bash
+# Build the image
+docker build -t cod8a .
+
+# Run the tool
+docker run -v $(pwd):/app/data cod8a uml -p /app/data/src
+```

{cod8a-0.1.0 → cod8a-0.2.1}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "cod8a"
-version = "0.1.0"
+version = "0.2.1"
 description = "cod8a is a code documentation and visualization tool for Python and .NET projects"
 authors = [
-    { name = "Akumbom",email = "akumbom5ma@gmail.com"}
+    { name = "Marietta Akumbom",email = "akumbom5ma@gmail.com"}
 ]
 maintainers = [ 
     { name = "Marietta Akumbom" }
@@ -17,14 +17,17 @@ dependencies = [
     "pydantic (>=2.13.3,<3.0.0)"
 ]
 
+[project.urls]
+Repository = "https://github.com/marietta-a/cod8a"
+
 [tool.poetry]
 packages = [{include = "cod8a", from = "src"}]
 include = [
-    { path = "src/cod8a/dotnet/CodeAnalysis/bin/Release/net10.0/*.dll", format = ["wheel"] },
-    { path = "src/cod8a/dotnet/CodeAnalysis/bin/Release/net10.0/*.json", format = ["wheel"] }
+    { path = "src/cod8a/dotnet/CodeAnalyzer/bin/Release/net10.0/*.dll", format = ["wheel"] },
+    { path = "src/cod8a/dotnet/CodeAnalyzer/bin/Release/net10.0/*.json", format = ["wheel"] }
 ]
 
-[tool.poetry.scripts]
+[project.scripts]
 cod8a = "cod8a.cli:main"
 cde8a = "cod8a.cli:doc_main"
 

{cod8a-0.1.0 → cod8a-0.2.1}/src/cod8a/cli.py

@@ -43,7 +43,9 @@ def cli():
               help='The type of diagram to generate (default: class).')
 @click.option('-o', '--output', 
               help='Optional output file path. If not provided, you will be prompted to save to the Downloads folder.')
-def uml(path, diagram_type, output):
+@click.option('-s', '--summarize', is_flag=True, 
+              help='Summarize the diagram by omitting details like fields and methods (recommended for large files).')
+def uml(path, diagram_type, output, summarize):
     """Generate UML diagram (Mermaid format)."""
     struct = extract_structure(path)
     base_name = os.path.basename(path or os.getcwd())
@@ -53,15 +55,30 @@ def uml(path, diagram_type, output):
         click.echo("Error: Could not extract structure.")
         return
 
+    # Auto-summarize if not explicitly requested
+    if not summarize:
+        classes = []
+        if hasattr(struct, 'files'):
+            classes = [c for f in struct.files for c in f.classes]
+        elif hasattr(struct, 'classes'):
+            classes = struct.classes
+        elif isinstance(struct, list):
+            classes = [c for f in struct for c in f.classes]
+        
+        total_members = sum(len(c.fields) + len(c.methods) for c in classes)
+        if len(classes) > 50 or total_members > 250:
+            click.echo("Note: Large file/project detected. Auto-summarizing diagram for better visualization.")
+            summarize = True
+
     canon_type = "class"
     if DiagramType.FLOWCHART.value.startswith(diagram_type):
-        diagram = generate_flowchart_diagram(struct, base_name)
+        diagram = generate_flowchart_diagram(struct, base_name, summarize)
         canon_type = "flowchart"
     elif DiagramType.SEQUENCE.value.startswith(diagram_type):
-        diagram = generate_sequence_diagram(struct)
+        diagram = generate_sequence_diagram(struct, summarize)
         canon_type = "sequence"
     else:
-        diagram = generate_class_diagram(struct)
+        diagram = generate_class_diagram(struct, summarize)
         canon_type = "class"
         
     print(diagram)
@@ -70,24 +87,24 @@ def uml(path, diagram_type, output):
     save_diagram(struct, canon_type, diagram, output, path)
 
 
-# TODO Generating code documentation 
-@click.command(help="[TODO] Generate documentation (Markdown format) from code structure.")
-@click.option('-p', '--path', help='Specific path of file(s) to analyze')
-@click.option('--json', 'output_json', is_flag=True, help='Output in JSON format')
-def doc_cli(path, output_json):
-    """Generate documentation (Markdown format)."""
-    target = path or os.getcwd()
-    struct = extract_structure(target)
+# # TODO Generating code documentation 
+# @click.command(help="[TODO] Generate documentation (Markdown format) from code structure.")
+# @click.option('-p', '--path', help='Specific path of file(s) to analyze')
+# @click.option('--json', 'output_json', is_flag=True, help='Output in JSON format')
+# def doc_cli(path, output_json):
+#     """Generate documentation (Markdown format)."""
+#     target = path or os.getcwd()
+#     struct = extract_structure(target)
 
 
 # Main entry point for cod8a
 def main():
-    cli.add_command(doc_cli, name="doc")
+    # cli.add_command(doc_cli, name="doc")
     cli()
 
 # Separate entry point for code8a
-def doc_main():
-    doc_cli()
+# def doc_main():
+    # doc_cli()
 
 if __name__ == "__main__":
     main()

{cod8a-0.1.0/src/cod8a/dotnet/CodeAnalysis → cod8a-0.2.1/src/cod8a/dotnet/CodeAnalyzer}/Parsers/FileParser.cs

@@ -19,12 +19,13 @@ namespace CodeAnalyzer.Parsers
     public sealed partial class FileParser<T> : BaseParser<T> where T : FileStructure
     {
 
-        public override string Name { get; init; }
+        public override required string Name { get; init; }
 
         /// <summary>
         /// Gets the code associated with this instance.
         /// </summary>
-        public string FilePath { get; init; }
+        public required string FilePath { get; init; }
+        public int Id { get; init; } = 1;
         public override T Parse()
         {
             try
@@ -37,8 +38,7 @@ namespace CodeAnalyzer.Parsers
                 CompilationUnitSyntax root = tree.GetCompilationUnitRoot();
 
 
-                var directory = Directory.GetCurrentDirectory();
-                var fileName = Path.GetFileName(directory);
+                var fileName = Name ?? Path.GetFileName(FilePath);
                 var id = 0;
                 var usings = root.Usings.Select(b =>
                 {
@@ -47,7 +47,7 @@ namespace CodeAnalyzer.Parsers
                 });
                 var fileStructure = new FileStructure
                 {
-                    Id = 1,
+                    Id = Id,
                     Name = fileName,
                     UsingDirectives = usings.ToList(),
                 };
@@ -57,7 +57,7 @@ namespace CodeAnalyzer.Parsers
 
                 return (T)fileStructure;
             }
-            catch (Exception ex)
+            catch 
             {
                 throw;
             }
@@ -76,7 +76,7 @@ namespace CodeAnalyzer.Parsers
                     _ => string.Empty
                 };
             }
-            catch( Exception ex )
+            catch
             {
                 throw;
             }
@@ -98,7 +98,10 @@ namespace CodeAnalyzer.Parsers
                     var relationships = new List<RelationShip>();
 
                     var baseTypes = classDeclaration.BaseList?.Types;
-                    int id = 0;
+                    int relId = 0;
+                    int fieldId = 0;
+                    int methodId = 0;
+                    int classId = 0;
 
                     if(baseTypes is not null)
                     {
@@ -112,19 +115,19 @@ namespace CodeAnalyzer.Parsers
                                     _ => b.Type.ToString().Split('<')[0]
                                 };
                                 var type = parent.StartsWith("I") && parent.Length > 1 && char.IsUpper(parent[1]) ? "Interface" : "Class";
-                                return new RelationShip (++id, type, parent);
+                                return new RelationShip (++relId, type, parent);
                             })
                         );
                     }
 
                     // Extract standard fields and properties
-                    fieldStructures.AddRange(classDeclaration.DescendantNodes().OfType<FieldDeclarationSyntax>().Select(f => new FieldStructure(default, f.Declaration.Variables.First().Identifier.Text, f.Modifiers.ToFullString().Trim(), f.Declaration.Type.ToString(), f.GetLeadingTrivia().ToString().Trim())));
-                    fieldStructures.AddRange(classDeclaration.DescendantNodes().OfType<PropertyDeclarationSyntax>().Select(f => new FieldStructure(default, f.Identifier.Text, f.Modifiers.ToFullString().Trim(), f.Type.ToString(), f.GetLeadingTrivia().ToString().Trim())));
+                    fieldStructures.AddRange(classDeclaration.DescendantNodes().OfType<FieldDeclarationSyntax>().Select(f => new FieldStructure(++fieldId, f.Declaration.Variables.First().Identifier.Text, f.Modifiers.ToFullString().Trim(), f.Declaration.Type.ToString(), f.GetLeadingTrivia().ToString().Trim())));
+                    fieldStructures.AddRange(classDeclaration.DescendantNodes().OfType<PropertyDeclarationSyntax>().Select(f => new FieldStructure(++fieldId, f.Identifier.Text, f.Modifiers.ToFullString().Trim(), f.Type.ToString(), f.GetLeadingTrivia().ToString().Trim())));
                     
                     // Extract record positional parameters as properties
                     if (classDeclaration is RecordDeclarationSyntax recordDecl && recordDecl.ParameterList != null)
                     {
-                        fieldStructures.AddRange(recordDecl.ParameterList.Parameters.Select(p => new FieldStructure(default, p.Identifier.Text, "public", p.Type?.ToString() ?? "", p.GetLeadingTrivia().ToString().Trim())));
+                        fieldStructures.AddRange(recordDecl.ParameterList.Parameters.Select(p => new FieldStructure(++fieldId, p.Identifier.Text, "public", p.Type?.ToString() ?? "", p.GetLeadingTrivia().ToString().Trim())));
                     }
 
                     foreach (var method in classDeclaration.Members.OfType<MethodDeclarationSyntax>())
@@ -132,14 +135,34 @@ namespace CodeAnalyzer.Parsers
                         var parameters = method.ParameterList.Parameters.Select(p => new ParameterStructure(p.Identifier.Text, p.Modifiers.ToFullString().Trim(), p.Type?.ToString() ?? "", p.GetLeadingTrivia().ToString().Trim())).ToList();
                         parameterStructures.AddRange(parameters);
 
-                        methodStructures.Add(new MethodStructure(default, method.Identifier.Text, method.Modifiers.ToFullString().Trim(), method.ReturnType.ToString(), parameters, method.GetLeadingTrivia().ToString().Trim()));
+                        methodStructures.Add(new MethodStructure(++methodId, method.Identifier.Text, method.Modifiers.ToFullString().Trim(), method.ReturnType.ToString(), parameters, method.GetLeadingTrivia().ToString().Trim()));
                     }
-                    classes.Add(new ClassStructure(default, classDeclaration.Identifier.Text, methodStructures, fieldStructures, classDeclaration.Keyword.ToFullString().Trim(), relationships, classDeclaration.GetLeadingTrivia().ToString().Trim()));
+
+                    var className = classDeclaration.Identifier.Text;
+                    if (string.IsNullOrEmpty(className) && classDeclaration.Keyword.Text == "extension")
+                    {
+                        var parameterList = classDeclaration.ChildNodes().OfType<ParameterListSyntax>().FirstOrDefault();
+                        if (parameterList != null && parameterList.Parameters.Any())
+                        {
+                            var extendedType = parameterList.Parameters[0].Type;
+                            if (extendedType != null)
+                            {
+                                className = $"{extendedType}ExtensionBlock";
+                                relationships.Add(new RelationShip(++relId, "Extension", extendedType.ToString()));
+                            }
+                        }
+                        else
+                        {
+                            className = "extension";
+                        }
+                    }
+
+                    classes.Add(new ClassStructure(++classId, className, methodStructures, fieldStructures, classDeclaration.Keyword.ToFullString().Trim(), relationships, classDeclaration.GetLeadingTrivia().ToString().Trim()));
                 }
 
                 return classes;
             }
-            catch (Exception ex)
+            catch
             {
                 throw;
             }

{cod8a-0.1.0/src/cod8a/dotnet/CodeAnalysis → cod8a-0.2.1/src/cod8a/dotnet/CodeAnalyzer}/Parsers/ProjectParser.cs

@@ -10,24 +10,30 @@ namespace CodeAnalyzer.Parsers
 {
     public sealed partial class ProjectParser<T> : BaseParser<T> where T : ProjectStructure
     {
-        public override string Name { get; init; }
+        public override required string Name { get; init; }
         
-        public string[] FilePaths { get; init; }
+        public required string[] FilePaths { get; init; }
 
         public override T Parse()
         {
             try
             {
+                var fileId = 1;
                 var projectStructure = new ProjectStructure
                 {
                     Id = 1,
                     Name = Name,
-                    Files = FilePaths.Select(b => new FileParser<FileStructure> { FilePath = b, Name = Path.GetFileName(b) }.Parse()).ToList(),
+                    Files = FilePaths.Select(b => new FileParser<FileStructure> 
+                    { 
+                        FilePath = b, 
+                        Name = Path.GetFileName(b),
+                        Id = fileId++ 
+                    }.Parse()).ToList(),
                 };
                 
                 return (T) projectStructure;
             }
-            catch (Exception ex)
+            catch
             {
                 throw;
             }

{cod8a-0.1.0/src/cod8a/dotnet/CodeAnalysis → cod8a-0.2.1/src/cod8a/dotnet/CodeAnalyzer}/Parsers/SolutionParser.cs

@@ -7,7 +7,7 @@ namespace CodeAnalyzer.Parsers
 {
     public sealed partial class SolutionParser<T> : BaseParser<T> where T : SolutionStructure
     {
-        public override string Name { get; init; }
+        public override required string Name { get; init; }
 
         public override T Parse()
         {

{cod8a-0.1.0/src/cod8a/dotnet/CodeAnalysis → cod8a-0.2.1/src/cod8a/dotnet/CodeAnalyzer}/Program.cs

@@ -9,35 +9,37 @@ class Program
 {
     static void Main(string[] args)
     {
-        Console.WriteLine("Starting code analysis...");
-        var fileName = args.Length > 0 ? args[0] : null;
-        //Check if path is directory
-        var fileAttr = File.GetAttributes(fileName!);
-        var isDirectory = fileAttr.HasFlag(FileAttributes.Directory);
+        var path = args.Length > 0 ? args[0] : null;
 
-
-        if(string.IsNullOrEmpty(fileName))
+        if(string.IsNullOrEmpty(path))
         {
             Console.Error.WriteLine(@"No file or project specified. Please provide a file/directory
                                      containing ...cs, .csproj, or .sln file.");
             return;
         }
 
-        if (!File.Exists(fileName) && !isDirectory){
-            Console.Error.WriteLine($"File not found: {fileName}");
+        //Check if path is directory
+        var fileAttr = File.GetAttributes(path!);
+        var isDirectory = fileAttr.HasFlag(FileAttributes.Directory);
+
+
+        if (!File.Exists(path) && !isDirectory){
+            Console.Error.WriteLine($"File not found: {path}");
             return;
         }
         
-        string json = "";
+        var json = "";
+        var fileName = Path.GetFileName(path);
 
-        if (isDirectory || fileName.EndsWith(".csproj") || fileName.EndsWith(".sln") || fileName.EndsWith(".slnx"))
+        if (isDirectory || path.EndsWith(".csproj") || path.EndsWith(".sln") || path.EndsWith(".slnx"))
         {
-            var csFiles = Directory.GetFiles(Path.GetDirectoryName(fileName)!, "*.cs", SearchOption.AllDirectories).Where(f => !f.Contains("obj", StringComparison.CurrentCultureIgnoreCase)).ToArray();
+            var directoryPath = isDirectory ? path : Path.GetDirectoryName(path)!;
+            var csFiles = Directory.GetFiles(directoryPath, "*.cs", SearchOption.TopDirectoryOnly).Where(f => !f.Contains("obj", StringComparison.CurrentCultureIgnoreCase)).ToArray();
 
             BaseParser<ProjectStructure> projectStructure = new ProjectParser<ProjectStructure>()
             {
                 FilePaths = csFiles,
-                Name = Path.GetFileName(fileName),
+                Name = fileName,
             };
 
             json = JsonSerializer.Serialize(projectStructure.Parse(), new JsonSerializerOptions { WriteIndented = false });
@@ -46,13 +48,14 @@ class Program
         {
             BaseParser<FileStructure> fileStructure = new FileParser<FileStructure>()
             {
-                FilePath = fileName,
-                Name = Path.GetFileName(fileName),
+                FilePath = path,
+                Name = fileName,
             };
 
             json = JsonSerializer.Serialize(fileStructure.Parse(), new JsonSerializerOptions { WriteIndented = false });
         }
 
         Console.WriteLine(json);
+
     }
 }

{cod8a-0.1.0/src/cod8a/dotnet/CodeAnalysis → cod8a-0.2.1/src/cod8a/dotnet/CodeAnalyzer}/models/FileStructure.cs

@@ -14,17 +14,17 @@ namespace CodeAnalyzer.Models
         /// <summary>
         /// <see langword="nameof"/>of the namespace, e.g., <c>MyNamespace</c>.
         /// </summary>
-        public string Name { get; set; }
+        public required string Name { get; set; }
 
         /// <summary>
         /// Gets or sets the collection of using directives associated with the current context.
         /// </summary>
-        public List<UsingDirective> UsingDirectives { get; set; }
+        public List<UsingDirective>? UsingDirectives { get; set; }
 
         /// <summary>
         /// Gets or sets the collection of classes associated with the current instance.
         /// </summary>
-        public List<ClassStructure> Classes { get; set; }
+        public List<ClassStructure>? Classes { get; set; }
 
     }
 

{cod8a-0.1.0/src/cod8a/dotnet/CodeAnalysis → cod8a-0.2.1/src/cod8a/dotnet/CodeAnalyzer}/models/ProjectStructure.cs

@@ -14,16 +14,16 @@ namespace CodeAnalyzer.Models
         /// <summary>
         /// Name of the Project
         /// </summary>
-        public string Name { get; set; }
+        public required string Name { get; set; }
 
         /// <summary>
         /// Project Description
         /// </summary>
-        public string Description { get; set; }
+        public string? Description { get; set; }
 
         /// <summary>
         /// Gets or sets the collection of files associated with the Project.
         /// </summary>
-        public List<FileStructure> Files { get; set; }
+        public required List<FileStructure> Files { get; set; }
     }
 }

{cod8a-0.1.0/src/cod8a/dotnet/CodeAnalysis → cod8a-0.2.1/src/cod8a/dotnet/CodeAnalyzer}/models/SolutionStructure.cs

@@ -13,16 +13,16 @@ namespace CodeAnalyzer.Models
         /// <summary>
         /// Gets or sets the name of the Solution
         /// </summary>
-        public string Name { get; set; }
+        public required string Name { get; set; }
 
         /// <summary>
         /// Gets or sets the description associated with the object.
         /// </summary>
-        public string Description { get; set; }
+        public string? Description { get; set; }
 
         /// <summary>
         /// Gets or sets the collection of projects within this solution
         /// </summary>
-        public List<ProjectStructure> Projects { get; set; }
+        public required List<ProjectStructure> Projects { get; set; }
     }
 }

{cod8a-0.1.0 → cod8a-0.2.1}/src/cod8a/dotnet/Test/CodeAnalyzerTest.csproj

@@ -19,7 +19,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <ProjectReference Include="..\CodeAnalysis\CodeAnalyzer.csproj" />
+    <ProjectReference Include="..\CodeAnalyzer\CodeAnalyzer.csproj" />
   </ItemGroup>
 
 </Project>

cod8a-0.2.1/src/cod8a/dotnet/Test/ExtensionTypeTest.cs

@@ -0,0 +1,64 @@
+using System;
+using System.IO;
+using System.Linq;
+using Xunit;
+using CodeAnalyzer.Parsers;
+using CodeAnalyzer.Models;
+
+namespace MermaidTests.Mermaid
+{
+    public class ExtensionTypeTest
+    {
+        [Fact]
+        public void Parse_ExtensionType_HandlesEmptyIdentifier()
+        {
+            // Arrange
+            var testCode = @"
+            namespace TestNamespace
+            {
+                extension(Color)
+                {
+                    public static Color GreenSmile()
+                    {
+                        return Color.FromArgb(83, 255, 26);
+                    }
+                }
+            }";
+
+            var filePath = Path.GetTempFileName() + ".cs";
+            File.WriteAllText(filePath, testCode);
+
+            try
+            {
+                var parser = new FileParser<FileStructure>
+                {
+                    FilePath = filePath,
+                    Name = Path.GetFileName(filePath)
+                };
+
+                // Act
+                var result = parser.Parse();
+
+                // Assert
+                Assert.NotNull(result);
+                Assert.Single(result.Classes);
+                var extensionClass = result.Classes.First();
+                
+                // This is what the user says is happening: it's empty.
+                // We want it to NOT be empty, or at least handle it gracefully.
+                Assert.Equal("extension(Color)", extensionClass.Name);
+
+                // Verify Relationship
+                Assert.NotNull(extensionClass.Relationships);
+                Assert.Single(extensionClass.Relationships);
+                var rel = extensionClass.Relationships.First();
+                Assert.Equal("Extension", rel.Type);
+                Assert.Equal("Color", rel.AssociatedItem);
+            }
+            finally
+            {
+                if (File.Exists(filePath)) File.Delete(filePath);
+            }
+        }
+    }
+}

{cod8a-0.1.0 → cod8a-0.2.1}/src/cod8a/generators/mermaid/class_diagram.py

@@ -9,7 +9,7 @@ class ClassDiagramGenerator:
     Generates a Mermaid class diagram from a JSON representation of code structure.
     """
 
-    def generate(self, data: Union[FileStructure, ProjectStructure, List[FileStructure]]) -> str:
+    def generate(self, data: Union[FileStructure, ProjectStructure, List[FileStructure]], summarize: bool = False) -> str:
         if not isinstance(data, FileStructure | ProjectStructure | list):
                 return "Error: Invalid data structure"
 
@@ -19,7 +19,7 @@ class ClassDiagramGenerator:
         mermaid_lines = ["classDiagram"]
         # 1. Generate Class Definitions
         for cls in all_classes:
-            mermaid_lines.extend(self._generate_class_block(cls))
+            mermaid_lines.extend(self._generate_class_block(cls, summarize))
         
         # 2. Generate Relationships
         mermaid_lines.extend(self._generate_relationships(all_classes))
@@ -58,7 +58,10 @@ class ClassDiagramGenerator:
         
         return classes
 
-    def _generate_class_block(self, cls: ClassStructure) -> List[str]:
+    def _generate_class_block(self, cls: ClassStructure, summarize: bool = False) -> List[str]:
+        if summarize:
+            return [f"    class {cls.name}", ""]
+            
         lines = [f"    class {cls.name} {{"]
         
         # Fields
@@ -129,6 +132,9 @@ class ClassDiagramGenerator:
                 label = "inherits"
                 if "interface" in relation.type.lower() or "implements" in relation.type.lower():
                    label = "implements"
+                elif "extension" in relation.type.lower():
+                    label = "extends"
+                    connector = "<.."
                 
                 rel_lines.append(f"    {relation.parent_name} {connector} {cls_name} : {label}")
             
@@ -153,10 +159,10 @@ class ClassDiagramGenerator:
                     
         return sorted(list(set(rel_lines)))
 
-def generate_class_diagram(data: FileStructure | ProjectStructure) -> str:
+def generate_class_diagram(data: FileStructure | ProjectStructure, summarize: bool = False) -> str:
     print("calling uml class generator ...")
     generator = ClassDiagramGenerator()
-    return generator.generate(data)
+    return generator.generate(data, summarize)
 
 if __name__ == "__main__":
     import sys

{cod8a-0.1.0 → cod8a-0.2.1}/src/cod8a/generators/mermaid/flowchart_diagram.py

@@ -8,9 +8,9 @@ class FlowchartDiagramGenerator:
     Generates a readable Mermaid flowchart from code structure.
     """
 
-    def generate(self, data: Union['FileStructure', 'ProjectStructure', List['FileStructure']], file_name: str) -> str:
+    def generate(self, data: Union['FileStructure', 'ProjectStructure', List['FileStructure']], file_name: str, summarize: bool = False) -> str:
         mermaid_lines = ["graph TD"]
-        
+
         # Track unique IDs to avoid conflicts in Mermaid
         self.counter = 0
 
@@ -21,31 +21,38 @@ class FlowchartDiagramGenerator:
         elif isinstance(data, list): files = data
 
         for file in files:
-            file_id = f"file_{self._get_id()}"
+            # file_id = f"file_{self._get_id()}"
+            file_id = f"file_{file.id}" if file.id else f"file_{self._get_id()}"
             mermaid_lines.append(f'    {file_id}["File: {file.name}"]')
-            
+
             for cls in file.classes:
-                cls_id = f"cls_{self._get_id()}"
+                # cls_id = f"cls_{self._get_id()}"
+                cls_id = f"cls_{cls.id}" if cls.id else f"cls_{self._get_id()}"
                 mermaid_lines.append(f'    {file_id} --> {cls_id}["Class: {cls.name}"]')
-                
+
+                if summarize:
+                    continue
+
                 # Exclude private Properties
                 fields = [f for f in cls.fields if f.modifier not in "private"]
                 # If too many fields, don't overwhelm the diagram truncate
                 fields = fields[:10] if len(fields) > 10 else fields
                 for field in fields:
-                    f_id = f"f_{self._get_id()}"
+                    # f_id = f"f_{self._get_id()}"
+                    f_id = f"f_{field.id}" if field.id else f"f_{self._get_id()}"
                     mermaid_lines.append(f'    {cls_id} --> {f_id}["{field.name} ({field.type})"]')
 
                 # Methods: Always helpful to see
                 for method in cls.methods:
-                    m_id = f"m_{self._get_id()}"
+                    # m_id = f"m_{self._get_id()}"
+                    m_id = f"m_{method.id}" if method.id else f"m_{self._get_id()}"
                     mermaid_lines.append(f'    {cls_id} --> {m_id}{{"{method.name}()"}}')
-            
+
         return "\n".join(mermaid_lines)
 
     def _get_id(self) -> int:
         self.counter += 1
         return self.counter
 
-def generate_flowchart_diagram(data, file_name) -> str:
-    return FlowchartDiagramGenerator().generate(data, file_name)
+def generate_flowchart_diagram(data, file_name, summarize: bool = False) -> str:
+    return FlowchartDiagramGenerator().generate(data, file_name, summarize)

{cod8a-0.1.0 → cod8a-0.2.1}/src/cod8a/generators/mermaid/sequence_diagram.py

@@ -9,7 +9,7 @@ class SequenceDiagramGenerator:
     def _sanitize(self, name: str) -> str:
         return re.sub(r'[^a-zA-Z0-9_ ]', '', name)
 
-    def generate(self, data: Union['FileStructure', 'ProjectStructure', list['FileStructure']]) -> str:
+    def generate(self, data: Union['FileStructure', 'ProjectStructure', list['FileStructure']], summarize: bool = False) -> str:
         classes = self._extract_classes(data)
         
         mermaid_lines = ["sequenceDiagram", "    autonumber"]
@@ -37,13 +37,15 @@ class SequenceDiagramGenerator:
                 # Exclude private properties
                 fields = [f for f in cls.fields if f.modifier != "private"]
                 mermaid_lines.append(f"    C->>{cls_alias}: Create {cls.name}")
-                for field in fields[:5]: # Limit to 5 fields to avoid huge diagrams
-                    if not field.name.startswith('_'):
-                        mermaid_lines.append(f"    {cls_alias}->>{cls_alias}: Set {self._sanitize(field.name)}")
+                
+                if not summarize:
+                    for field in cls.fields[:20]: # Limit to 20 fields to avoid huge diagrams
+                        if not field.name.startswith('_'):
+                            mermaid_lines.append(f"    {cls_alias}->>{cls_alias}: Set {self._sanitize(field.name)}")
             else:
                 # Exclude private methods
-                methods = [m for m in cls.methods if m.modifier != "private"]
-                for method in methods:
+                # methods = [m for m in cls.methods if m.modifier != "private"]
+                for method in cls.methods:
                     if method.name.lower() in["dispose", "tostring", "equals", "gethashcode", "gettype"]:
                         continue
                     
@@ -70,8 +72,8 @@ class SequenceDiagramGenerator:
         if not type_str: return ""
         return re.split(r'[<\[]', type_str)[0].replace('?', '').split('.')[-1].strip()
 
-def generate_sequence_diagram(data) -> str:
-    return SequenceDiagramGenerator().generate(data)
+def generate_sequence_diagram(data, summarize: bool = False) -> str:
+    return SequenceDiagramGenerator().generate(data, summarize)
 
 if __name__ == "__main__":
     import sys

{cod8a-0.1.0 → cod8a-0.2.1}/src/cod8a/helpers/cli_helper.py

@@ -9,10 +9,10 @@ from cod8a.parsers.python_parser import PythonParser
 from cod8a.models.models import FileStructure, ProjectStructure
 
 # Path to the C# analyzer project
-DOTNET_ANALYZER_PATH = os.path.join(os.path.dirname(__file__), "..", "dotnet", "CodeAnalysis", "CodeAnalyzer.csproj")
+DOTNET_ANALYZER_PATH = os.path.join(os.path.dirname(__file__), "..", "dotnet", "CodeAnalyzer", "CodeAnalyzer.csproj")
 
 def _get_parser(path: str):
-    print(f"Checking analyzer ...")
+    print(f"Analyzing File ...")
     isDotnetParser = any(path.endswith(ext) for ext in [".cs", ".csproj", ".sln"]) or os.path.isdir(path) and any(f.endswith(".cs") for _, _, files in os.walk(path) for f in files) 
     if isDotnetParser:
         return DotnetParser(DOTNET_ANALYZER_PATH)
@@ -25,7 +25,7 @@ def extract_structure(path) -> Union[FileStructure | ProjectStructure | list[Fil
     
     pathExists = os.path.exists(path)
     if not pathExists:
-        print("Not found")
+        print("Not found: Ensure path doesn't end with a separator and points to a valid file or directory.")
         return
     
     struct = parser.parse(path or os.getcwd())

{cod8a-0.1.0 → cod8a-0.2.1}/src/cod8a/parsers/dotnet_parser.py

@@ -3,6 +3,7 @@ import json
 import os
 import shutil
 from typing import Union, List
+from pathlib import Path
 from cod8a.models.models import (
     FileStructure, ProjectStructure, ClassStructure, 
     MethodStructure, FieldStructure, ParameterStructure, 
@@ -12,6 +13,7 @@ from cod8a.models.models import (
 class DotnetParser:
     def __init__(self, analyzer_path: str):
         self.analyzer_path = analyzer_path
+        self.file_name = ""
 
     def parse(self, path: str) -> Union[FileStructure, ProjectStructure]:
         if not shutil.which("dotnet"):
@@ -19,9 +21,14 @@ class DotnetParser:
 
         abs_path = os.path.abspath(path)
         cwd = os.path.dirname(self.analyzer_path)
+        self.file_name = Path(abs_path).stem
+
+        wdir = os.getcwd()
+        print(wdir)
+        
         
         # Look for a compiled DLL first (production/distribution mode)
-        # Expected path: src/cod8a/dotnet/CodeAnalysis/bin/Release/net10.0/CodeAnalyzer.dll
+        # Expected path: src/cod8a/dotnet/CodeAnalyzer/bin/Release/net10.0/CodeAnalyzer.dll
         dll_path = os.path.join(cwd, "bin", "Release", "net10.0", "CodeAnalyzer.dll")
         
         if os.path.exists(dll_path):
@@ -31,6 +38,7 @@ class DotnetParser:
             args = ["dotnet", "run", "--project", self.analyzer_path, "--", abs_path]
 
         result = subprocess.run(args, capture_output=True, text=True, cwd=cwd)
+        
         if result.returncode != 0:
             raise Exception(f"Dotnet analyzer failed: {result.stderr}")
 
@@ -50,7 +58,7 @@ class DotnetParser:
 
     def _map_project(self, data: dict) -> ProjectStructure:
         return ProjectStructure(
-            name=data.get("Name", ""),
+            name=self.file_name,
             files=[self._map_file(f) for f in data.get("Files", [])]
         )