WIP: feat: base parser

compile_flags/__about__.py

@@ -1,4 +1,5 @@
 # SPDX-FileCopyrightText: 2025-present Yiannis Charalambous <[email protected]>
 #
 # SPDX-License-Identifier: AGPL-3.0
+
 __version__ = "0.0.1"

compile_flags/__init__.py

@@ -1,3 +1,11 @@
 # SPDX-FileCopyrightText: 2025-present Yiannis Charalambous <[email protected]>
 #
 # SPDX-License-Identifier: AGPL-3.0
+
+from compile_flags.solution import Solution, SourceFile
+
+__all__ = [
+    "Solution",
+    "SourceFile",
+]
+

compile_flags/parsers/__init__.py

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2025-present Yiannis Charalambous <[email protected]>
+#
+# SPDX-License-Identifier: AGPL-3.0
+
+from .base_parser import BaseSolutionParser, CLikeParser
+
+__all__ = [
+    "BaseSolutionParser",
+    "CLikeParser",
+]

compile_flags/parsers/base_parser.py

@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: 2025-present Yiannis Charalambous <[email protected]>
+#
+# SPDX-License-Identifier: AGPL-3.0
+
+from pydantic import BaseModel, Field
+
+from compile_flags import Solution
+
+
+class BaseSolutionParser(BaseModel):
+    """Base parser class for analyzing a code base."""
+
+    solution: Solution = Field()
+
+
+class CLikeParser(BaseSolutionParser):
+    """C and C++ based parser."""

compile_flags/solution.py

@@ -0,0 +1,24 @@
+# SPDX-FileCopyrightText: 2025-present Yiannis Charalambous <[email protected]>
+#
+# SPDX-License-Identifier: AGPL-3.0
+
+from pydantic import BaseModel, Field, FilePath
+
+
+class SourceFile(BaseModel):
+    """Represents a generic source file."""
+
+    path: FilePath = Field(description="The file path of this source file.")
+
+    @property
+    def dependencies(self) -> list[FilePath]:
+        """Gets the deps of this source file. Needs to be overwritten."""
+        return []
+
+
+class Solution(BaseModel):
+    """Represents the codebase."""
+
+    source_files: dict[FilePath, SourceFile] = Field(
+        default_factory=dict, description="The list of source files."
+    )