feat: port code from library-analyzer (#16)

### Summary of Changes

* Moved API and docstring parser functionality from Library-Analyzer to
this project.
* Removed astroid and added mypy for file parsing and adjusted the AST
walker & visitor.
* Adjusted docstring parsers to work with mypy.
* Added snapshot testing for pytest.

---------

Co-authored-by: Lars Reimann <[email protected]>
Co-authored-by: megalinter-bot <[email protected]>

.github/linters/.mypy.ini

@@ -2,3 +2,4 @@
 disallow_incomplete_defs = true
 disallow_untyped_defs = true
 ignore_missing_imports = true
+exclude = ["tests/data"]

.github/linters/.ruff.toml

@@ -89,6 +89,8 @@ ignore = [
     "TRY003",
 ]
 
+extend-exclude = ["tests/data"]
+
 [per-file-ignores]
 "*test*.py" = [
     # Undocumented declarations

.gitignore

@@ -27,6 +27,7 @@ __pycache__/
 venv/
 
 # Pytest outputs
+.mypy_cache/
 .pytest_cache/
 htmlcov/
 .coverage

.mega-linter.yml

@@ -3,7 +3,7 @@
 EXTENDS: https://raw.githubusercontent.com/lars-reimann/.github/main/.mega-linter.yml
 
 # Config
-FILTER_REGEX_EXCLUDE: (\.github/workflows/|mkdocs.yml)
+FILTER_REGEX_EXCLUDE: (\.github/workflows/|mkdocs.yml|tests/data)
 
 # Workaround to also run prettier on other supported file types. We deactivate it for Markdown compared to the extended
 # configuration since it breaks admonitions of Material for MkDocs.

pyproject.toml

@@ -18,10 +18,13 @@ generate-safeds-stubs = "safeds_stubgen.main:main"
 [tool.poetry.dependencies]
 python = "^3.11"
 mypy = "^1.5.1"
+docstring-parser = "^0.15"
+syrupy = "^4.5.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^7.4.2"
 pytest-cov = "^4.0.0"
+setuptools = "^68.0.0"
 
 [tool.poetry.group.docs.dependencies]
 mkdocs = "^1.5.3"
@@ -34,3 +37,4 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.black]
 line-length = 120
+

src/safeds_stubgen/__init__.py

@@ -0,0 +1,2 @@
+"""Safe-DS stubs generator."""
+from __future__ import annotations

src/safeds_stubgen/api_analyzer/__init__.py

@@ -0,0 +1,49 @@
+"""API-Analyzer for the Safe-DS stubs generator."""
+from __future__ import annotations
+
+from ._api import API, Attribute, Class, Function, Parameter, ParameterAssignment
+from ._get_api import get_api
+from ._mypy_helpers import get_classdef_definitions, get_funcdef_definitions, get_mypyfile_definitions
+from ._package_metadata import distribution, distribution_version, package_root
+from ._types import (
+    AbstractType,
+    BoundaryType,
+    DictType,
+    EnumType,
+    FinalType,
+    ListType,
+    LiteralType,
+    NamedType,
+    OptionalType,
+    SetType,
+    TupleType,
+    UnionType,
+)
+
+__all__ = [
+    "AbstractType",
+    "API",
+    "Attribute",
+    "BoundaryType",
+    "Class",
+    "DictType",
+    "distribution",
+    "distribution_version",
+    "EnumType",
+    "FinalType",
+    "Function",
+    "get_api",
+    "get_classdef_definitions",
+    "get_funcdef_definitions",
+    "get_mypyfile_definitions",
+    "ListType",
+    "LiteralType",
+    "NamedType",
+    "OptionalType",
+    "package_root",
+    "Parameter",
+    "ParameterAssignment",
+    "SetType",
+    "TupleType",
+    "UnionType",
+]