code-explore 0.1.0__tar.gz

code_explore-0.1.0/.editorconfig

@@ -0,0 +1,104 @@
+# EditorConfig for EnterpriseApp
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{cs,csx}]
+indent_size = 4
+
+# C# Code Style
+[*.cs]
+# Organize usings
+dotnet_sort_system_directives_first = true
+dotnet_separate_import_directive_groups = false
+
+# this. preferences
+dotnet_style_qualification_for_field = false:suggestion
+dotnet_style_qualification_for_property = false:suggestion
+dotnet_style_qualification_for_method = false:suggestion
+dotnet_style_qualification_for_event = false:suggestion
+
+# Language keywords vs BCL types preferences
+dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
+dotnet_style_predefined_type_for_member_access = true:suggestion
+
+# var preferences
+csharp_style_var_for_built_in_types = true:suggestion
+csharp_style_var_when_type_is_apparent = true:suggestion
+csharp_style_var_elsewhere = true:suggestion
+
+# Expression-bodied members
+csharp_style_expression_bodied_methods = when_on_single_line:suggestion
+csharp_style_expression_bodied_constructors = false:suggestion
+csharp_style_expression_bodied_operators = when_on_single_line:suggestion
+csharp_style_expression_bodied_properties = true:suggestion
+csharp_style_expression_bodied_indexers = true:suggestion
+csharp_style_expression_bodied_accessors = true:suggestion
+csharp_style_expression_bodied_lambdas = true:suggestion
+csharp_style_expression_bodied_local_functions = when_on_single_line:suggestion
+
+# Pattern matching preferences
+csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
+csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
+
+# Null checking preferences
+csharp_style_throw_expression = true:suggestion
+csharp_style_conditional_delegate_call = true:suggestion
+
+# Code-block preferences
+csharp_prefer_braces = true:suggestion
+csharp_prefer_simple_using_statement = true:suggestion
+
+# Using directive preferences
+csharp_using_directive_placement = outside_namespace:suggestion
+
+# Namespace preferences
+csharp_style_namespace_declarations = file_scoped:suggestion
+
+# Primary constructor preferences
+csharp_style_prefer_primary_constructors = true:suggestion
+
+# Naming conventions
+dotnet_naming_rule.interface_should_be_begins_with_i.severity = suggestion
+dotnet_naming_rule.interface_should_be_begins_with_i.symbols = interface
+dotnet_naming_rule.interface_should_be_begins_with_i.style = begins_with_i
+
+dotnet_naming_symbols.interface.applicable_kinds = interface
+dotnet_naming_symbols.interface.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
+
+dotnet_naming_style.begins_with_i.required_prefix = I
+dotnet_naming_style.begins_with_i.capitalization = pascal_case
+
+dotnet_naming_rule.types_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.types_should_be_pascal_case.symbols = types
+dotnet_naming_rule.types_should_be_pascal_case.style = pascal_case
+
+dotnet_naming_symbols.types.applicable_kinds = class, struct, interface, enum
+dotnet_naming_symbols.types.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
+
+dotnet_naming_style.pascal_case.capitalization = pascal_case
+
+dotnet_naming_rule.private_fields_should_be_camel_case.severity = suggestion
+dotnet_naming_rule.private_fields_should_be_camel_case.symbols = private_fields
+dotnet_naming_rule.private_fields_should_be_camel_case.style = camel_case_with_underscore
+
+dotnet_naming_symbols.private_fields.applicable_kinds = field
+dotnet_naming_symbols.private_fields.applicable_accessibilities = private
+
+dotnet_naming_style.camel_case_with_underscore.required_prefix = _
+dotnet_naming_style.camel_case_with_underscore.capitalization = camel_case
+
+[*.{json,yml,yaml}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.razor]
+indent_size = 4

code_explore-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tools
+        run: pip install build
+      - name: Build package
+        run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

code_explore-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+*.whl
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Claude / AI tools (local runtime state)
+.claude/
+.claude-flow/
+.swarm/
+
+# Generated output
+output/
+specs/
+
+# Logs
+logs/
+*.log
+
+# Database (local user data)
+*.db
+*.db-journal

code_explore-0.1.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: code-explore
+Version: 0.1.0
+Summary: Developer knowledge base CLI — scan, index, and search your programming projects
+Project-URL: Homepage, https://github.com/aipioneers/code-explore
+Project-URL: Repository, https://github.com/aipioneers/code-explore
+Project-URL: Issues, https://github.com/aipioneers/code-explore/issues
+Author-email: Tobias Oberrauch <tobias.oberrauch@gmail.com>
+License-Expression: MIT
+Keywords: cli,code-search,developer-tools,knowledge-base,project-indexer
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: lancedb>=0.4.0
+Requires-Dist: pyarrow>=14.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: api
+Requires-Dist: fastapi>=0.100.0; extra == 'api'
+Requires-Dist: uvicorn>=0.23.0; extra == 'api'
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# code-explore
+
+Developer knowledge base CLI — scan, index, and search your programming projects.
+
+## Install
+
+```bash
+pip install code-explore
+```
+
+## Usage
+
+```bash
+# Short alias (3 chars):
+cex scan ~/Projects
+cex index
+cex search "YouTube API alle Videos"
+cex show data-youtube
+cex stats
+
+# Full command also works:
+code-explore scan ~/Projects
+```
+
+## Features
+
+- Scan local project directories and extract metadata (languages, dependencies, patterns)
+- Generate AI summaries using local Ollama models
+- Create vector embeddings for semantic search (multilingual)
+- Hybrid search combining fulltext + semantic ranking
+- Incremental indexing with change detection

code_explore-0.1.0/README.md

@@ -0,0 +1,31 @@
+# code-explore
+
+Developer knowledge base CLI — scan, index, and search your programming projects.
+
+## Install
+
+```bash
+pip install code-explore
+```
+
+## Usage
+
+```bash
+# Short alias (3 chars):
+cex scan ~/Projects
+cex index
+cex search "YouTube API alle Videos"
+cex show data-youtube
+cex stats
+
+# Full command also works:
+code-explore scan ~/Projects
+```
+
+## Features
+
+- Scan local project directories and extract metadata (languages, dependencies, patterns)
+- Generate AI summaries using local Ollama models
+- Create vector embeddings for semantic search (multilingual)
+- Hybrid search combining fulltext + semantic ranking
+- Incremental indexing with change detection

code_explore-0.1.0/code_explore/__init__.py

@@ -0,0 +1,3 @@
+"""Code Explore - Personal developer knowledge base."""
+
+__version__ = "0.1.0"

code_explore-0.1.0/code_explore/analyzer/__init__.py

@@ -0,0 +1,13 @@
+"""Code analysis - languages, metrics, dependencies, patterns."""
+
+from code_explore.analyzer.dependencies import detect_dependencies
+from code_explore.analyzer.language import detect_languages
+from code_explore.analyzer.metrics import calculate_metrics
+from code_explore.analyzer.patterns import detect_patterns
+
+__all__ = [
+    "detect_dependencies",
+    "detect_languages",
+    "calculate_metrics",
+    "detect_patterns",
+]

code_explore-0.1.0/code_explore/analyzer/dependencies.py

@@ -0,0 +1,328 @@
+"""Parse dependency files to extract project dependencies."""
+
+import json
+import re
+from pathlib import Path
+
+from code_explore.models import DependencyInfo
+
+
+def _read_file(path: Path) -> str:
+    try:
+        return path.read_text(encoding="utf-8", errors="replace")
+    except OSError:
+        return ""
+
+
+def _parse_package_json(path: Path) -> list[DependencyInfo]:
+    content = _read_file(path)
+    if not content:
+        return []
+    try:
+        data = json.loads(content)
+    except (json.JSONDecodeError, ValueError):
+        return []
+
+    deps: list[DependencyInfo] = []
+    for name, version in (data.get("dependencies") or {}).items():
+        deps.append(DependencyInfo(name=name, version=version, dev=False, source="package.json"))
+    for name, version in (data.get("devDependencies") or {}).items():
+        deps.append(DependencyInfo(name=name, version=version, dev=True, source="package.json"))
+    return deps
+
+
+def _parse_requirements_txt(path: Path) -> list[DependencyInfo]:
+    content = _read_file(path)
+    if not content:
+        return []
+
+    deps: list[DependencyInfo] = []
+    for line in content.splitlines():
+        line = line.strip()
+        if not line or line.startswith("#") or line.startswith("-"):
+            continue
+        match = re.match(r"^([A-Za-z0-9_][A-Za-z0-9._-]*)\s*(?:([><=!~]+.*))?", line)
+        if match:
+            name = match.group(1)
+            version = match.group(2)
+            if version:
+                version = version.strip()
+            deps.append(DependencyInfo(
+                name=name, version=version or None, dev=False, source=path.name,
+            ))
+    return deps
+
+
+def _parse_pyproject_toml(path: Path) -> list[DependencyInfo]:
+    content = _read_file(path)
+    if not content:
+        return []
+
+    deps: list[DependencyInfo] = []
+
+    in_deps = False
+    in_dev_deps = False
+    for line in content.splitlines():
+        stripped = line.strip()
+
+        if stripped.startswith("["):
+            in_deps = stripped in (
+                "[project]",
+                "[tool.poetry.dependencies]",
+            )
+            in_dev_deps = stripped in (
+                "[tool.poetry.dev-dependencies]",
+                "[tool.poetry.group.dev.dependencies]",
+            )
+            if stripped == "[project]":
+                in_deps = False
+            continue
+
+        if stripped == "dependencies = [":
+            in_deps = True
+            continue
+
+        if in_deps and stripped.startswith("]"):
+            in_deps = False
+            continue
+
+        if in_deps:
+            match = re.match(r'"([A-Za-z0-9_][A-Za-z0-9._-]*)\s*(?:([><=!~]+[^"]*))?"', stripped)
+            if match:
+                deps.append(DependencyInfo(
+                    name=match.group(1),
+                    version=match.group(2) or None,
+                    dev=False,
+                    source="pyproject.toml",
+                ))
+                continue
+
+            toml_match = re.match(
+                r'([A-Za-z0-9_][A-Za-z0-9._-]*)\s*=\s*["\{]([^"}\n]*)', stripped,
+            )
+            if toml_match:
+                name = toml_match.group(1)
+                if name == "python":
+                    continue
+                version_str = toml_match.group(2).strip().rstrip('"')
+                deps.append(DependencyInfo(
+                    name=name,
+                    version=version_str or None,
+                    dev=in_dev_deps,
+                    source="pyproject.toml",
+                ))
+
+        if in_dev_deps:
+            toml_match = re.match(
+                r'([A-Za-z0-9_][A-Za-z0-9._-]*)\s*=\s*["\{]([^"}\n]*)', stripped,
+            )
+            if toml_match:
+                name = toml_match.group(1)
+                if name == "python":
+                    continue
+                version_str = toml_match.group(2).strip().rstrip('"')
+                deps.append(DependencyInfo(
+                    name=name,
+                    version=version_str or None,
+                    dev=True,
+                    source="pyproject.toml",
+                ))
+
+    return deps
+
+
+def _parse_setup_py(path: Path) -> list[DependencyInfo]:
+    content = _read_file(path)
+    if not content:
+        return []
+
+    deps: list[DependencyInfo] = []
+    for match in re.finditer(r"install_requires\s*=\s*\[(.*?)]", content, re.DOTALL):
+        block = match.group(1)
+        for pkg in re.findall(r"['\"]([A-Za-z0-9_][A-Za-z0-9._-]*(?:\s*[><=!~]+[^'\"]*)?)['\"]", block):
+            parts = re.match(r"([A-Za-z0-9_][A-Za-z0-9._-]*)\s*(.*)", pkg)
+            if parts:
+                deps.append(DependencyInfo(
+                    name=parts.group(1),
+                    version=parts.group(2).strip() or None,
+                    dev=False,
+                    source="setup.py",
+                ))
+    return deps
+
+
+def _parse_cargo_toml(path: Path) -> list[DependencyInfo]:
+    content = _read_file(path)
+    if not content:
+        return []
+
+    deps: list[DependencyInfo] = []
+    in_deps = False
+    in_dev_deps = False
+
+    for line in content.splitlines():
+        stripped = line.strip()
+        if stripped.startswith("["):
+            in_deps = stripped == "[dependencies]"
+            in_dev_deps = stripped in ("[dev-dependencies]", "[build-dependencies]")
+            continue
+
+        if in_deps or in_dev_deps:
+            match = re.match(r'([A-Za-z0-9_][A-Za-z0-9_-]*)\s*=\s*"([^"]*)"', stripped)
+            if match:
+                deps.append(DependencyInfo(
+                    name=match.group(1),
+                    version=match.group(2),
+                    dev=in_dev_deps,
+                    source="Cargo.toml",
+                ))
+                continue
+            match = re.match(r'([A-Za-z0-9_][A-Za-z0-9_-]*)\s*=\s*\{.*?version\s*=\s*"([^"]*)"', stripped)
+            if match:
+                deps.append(DependencyInfo(
+                    name=match.group(1),
+                    version=match.group(2),
+                    dev=in_dev_deps,
+                    source="Cargo.toml",
+                ))
+
+    return deps
+
+
+def _parse_go_mod(path: Path) -> list[DependencyInfo]:
+    content = _read_file(path)
+    if not content:
+        return []
+
+    deps: list[DependencyInfo] = []
+    in_require = False
+
+    for line in content.splitlines():
+        stripped = line.strip()
+        if stripped.startswith("require ("):
+            in_require = True
+            continue
+        if stripped == ")":
+            in_require = False
+            continue
+        if stripped.startswith("require "):
+            parts = stripped[len("require "):].strip().split()
+            if len(parts) >= 2:
+                deps.append(DependencyInfo(
+                    name=parts[0], version=parts[1], dev=False, source="go.mod",
+                ))
+            continue
+        if in_require:
+            parts = stripped.split()
+            if len(parts) >= 2 and not parts[0].startswith("//"):
+                deps.append(DependencyInfo(
+                    name=parts[0], version=parts[1], dev=False, source="go.mod",
+                ))
+
+    return deps
+
+
+def _parse_pom_xml(path: Path) -> list[DependencyInfo]:
+    content = _read_file(path)
+    if not content:
+        return []
+
+    deps: list[DependencyInfo] = []
+    for match in re.finditer(
+        r"<dependency>\s*"
+        r"<groupId>([^<]+)</groupId>\s*"
+        r"<artifactId>([^<]+)</artifactId>\s*"
+        r"(?:<version>([^<]+)</version>)?",
+        content,
+    ):
+        group_id = match.group(1).strip()
+        artifact_id = match.group(2).strip()
+        version = match.group(3).strip() if match.group(3) else None
+        scope_match = re.search(r"<scope>([^<]+)</scope>", content[match.start():match.start() + 500])
+        is_dev = scope_match and scope_match.group(1).strip() in ("test", "provided")
+        deps.append(DependencyInfo(
+            name=f"{group_id}:{artifact_id}",
+            version=version,
+            dev=bool(is_dev),
+            source="pom.xml",
+        ))
+
+    return deps
+
+
+def _parse_gemfile(path: Path) -> list[DependencyInfo]:
+    content = _read_file(path)
+    if not content:
+        return []
+
+    deps: list[DependencyInfo] = []
+    in_dev_group = False
+
+    for line in content.splitlines():
+        stripped = line.strip()
+        if stripped.startswith("group :development") or stripped.startswith("group :test"):
+            in_dev_group = True
+            continue
+        if stripped == "end" and in_dev_group:
+            in_dev_group = False
+            continue
+
+        match = re.match(r"gem\s+['\"]([^'\"]+)['\"](?:\s*,\s*['\"]([^'\"]*)['\"])?", stripped)
+        if match:
+            deps.append(DependencyInfo(
+                name=match.group(1),
+                version=match.group(2) or None,
+                dev=in_dev_group,
+                source="Gemfile",
+            ))
+
+    return deps
+
+
+def _parse_composer_json(path: Path) -> list[DependencyInfo]:
+    content = _read_file(path)
+    if not content:
+        return []
+    try:
+        data = json.loads(content)
+    except (json.JSONDecodeError, ValueError):
+        return []
+
+    deps: list[DependencyInfo] = []
+    for name, version in (data.get("require") or {}).items():
+        if name == "php" or name.startswith("ext-"):
+            continue
+        deps.append(DependencyInfo(name=name, version=version, dev=False, source="composer.json"))
+    for name, version in (data.get("require-dev") or {}).items():
+        deps.append(DependencyInfo(name=name, version=version, dev=True, source="composer.json"))
+    return deps
+
+
+_PARSERS: dict[str, callable] = {
+    "package.json": _parse_package_json,
+    "requirements.txt": _parse_requirements_txt,
+    "requirements-dev.txt": _parse_requirements_txt,
+    "requirements_dev.txt": _parse_requirements_txt,
+    "pyproject.toml": _parse_pyproject_toml,
+    "setup.py": _parse_setup_py,
+    "Cargo.toml": _parse_cargo_toml,
+    "go.mod": _parse_go_mod,
+    "pom.xml": _parse_pom_xml,
+    "Gemfile": _parse_gemfile,
+    "composer.json": _parse_composer_json,
+}
+
+
+def detect_dependencies(project_path: str | Path) -> list[DependencyInfo]:
+    root = Path(project_path)
+    if not root.is_dir():
+        return []
+
+    all_deps: list[DependencyInfo] = []
+
+    for filename, parser in _PARSERS.items():
+        dep_file = root / filename
+        if dep_file.is_file():
+            all_deps.extend(parser(dep_file))
+
+    return all_deps