uncoded 2.1.0__tar.gz → 2.1.1__tar.gz

{uncoded-2.1.0 → uncoded-2.1.1}/.github/workflows/ci.yml

@@ -31,3 +31,5 @@ jobs:
       - run: uv python install ${{ matrix.python-version }}
       - run: uv sync --extra dev
       - run: uv run pytest -v -m "integration or not integration"
+        env:
+          PYTHONWARNDEFAULTENCODING: "1"

{uncoded-2.1.0 → uncoded-2.1.1}/.pre-commit-config.yaml

@@ -13,18 +13,23 @@ repos:
       - id: check-toml
       - id: check-added-large-files
 
-  - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.10
-    hooks:
-      - id: ruff
-        args: [--fix]
-      - id: ruff-format
-
   - repo: local
     hooks:
+      - id: ruff-check
+        name: ruff check
+        entry: uv run ruff check --fix --exit-non-zero-on-fix --show-fixes
+        language: system
+        types_or: [python, pyi]
+        pass_filenames: false
+      - id: ruff-format
+        name: ruff format
+        entry: uv run ruff format
+        language: system
+        types_or: [python, pyi]
+        pass_filenames: false
       - id: ty
         name: ty
-        entry: uvx ty check src tests
+        entry: uv run ty check src tests
         language: system
         pass_filenames: false
       # Runs before uncoded so the generated skill files are built from

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/docs.yaml

@@ -19,14 +19,18 @@ README.md:
     Find references to a symbol:
     How agents use it:
     Coherence review:
-    Dev setup:
-      Note for Windows contributors:
     Upgrading from v1:
-    Releasing:
+    Contributing:
 AGENTS.md:
   uncoded:
     Problem:
     Approach:
     Commands:
+    Dev setup:
+      Windows:
+    Linting and formatting:
     Docstrings:
+    Testing:
+    Conventions:
+    Releasing:
     Before you start:

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/namespace.yaml

@@ -18,8 +18,11 @@ src/:
       resolve_body:
       _extract_body:
     cli.py:
+      _validate_root:
       _sync_code_artefacts:
+      _sync_doc_artefacts:
       _sync:
+      _report_lookup_error:
       _body:
       _refs:
       main:
@@ -35,6 +38,7 @@ src/:
       read_config:
     docs_map.py:
       DOCS_HEADER:
+      _parse_atx_heading:
       extract_headings:
       _unique_key:
       _collapse_empty:
@@ -51,6 +55,7 @@ src/:
         constants:
         classes:
         functions:
+      _extract_class_members:
       extract_module:
       iter_source_files:
       extract_modules:
@@ -90,8 +95,8 @@ src/:
         tail:
         parse:
         __str__:
-      SymbolNotFound:
-      UnsupportedNamePath:
+      SymbolNotFoundError:
+      UnsupportedNamePathError:
       resolve_ast_node:
       resolve_name_position:
       resolve_ast_node_from_source:
@@ -146,8 +151,12 @@ src/:
       _render_function:
       _format_assignment_body:
       _render_assignment:
+      _render_class:
       render_stub:
       _generate_stubs:
+      _resolve_stubs_root:
+      _remove_orphan_stubs:
+      _prune_empty_stub_dirs:
       _write_stubs:
       remove_all_stubs:
       build_stubs:
@@ -184,7 +193,7 @@ tests/:
       test_shadowed_class_member_found_in_last_definition:
       test_shadowed_class_member_not_found_in_last_definition:
       test_not_found_in_class:
-    TestUnsupportedNamePath:
+    TestUnsupportedNamePathError:
       SUPPORTED_SHAPES:
       _assert_raises:
       test_three_segment_path:
@@ -292,7 +301,7 @@ tests/:
       test_finds_in_parent_of_start:
       test_returns_none_if_not_found:
     TestReadConfig:
-      test_returns_none_when_no_config_file:
+      test_raises_when_no_config_file:
       test_source_roots_read_from_pyproject:
       test_doc_roots_read_from_pyproject:
       test_both_roots_empty_when_section_absent:
@@ -342,6 +351,7 @@ tests/:
       test_rel_path_is_relative_to_project_root:
       test_skips_non_utf8_file_with_warning:
       test_single_file_root_unreadable_yields_nothing:
+      test_bom_prefixed_file_heading_appears:
     TestBuildDocsMap:
       test_empty_files:
       test_headingless_file_maps_to_null:
@@ -359,6 +369,8 @@ tests/:
       test_header_present:
       test_yaml_parseable:
       test_null_renders_clean:
+  test_encoding_gate.py:
+    test_encoding_warning_gate:
   test_extract.py:
     TestExtractModuleFromSource:
       test_classes_and_functions:
@@ -389,6 +401,12 @@ tests/:
       test_preserves_source_order:
       test_module_with_only_constants_is_kept:
       test_skips_files_with_no_symbols:
+  test_markers.py:
+    TestMarkerCompleteness:
+      test_namespace_map_carries_marker:
+      test_docs_map_carries_marker:
+      test_stub_carries_marker:
+      test_skill_carries_marker:
   test_namespace_map.py:
     TestBuildMap:
       test_single_file:
@@ -548,6 +566,7 @@ tests/:
       test_check_mode_reports_without_removing:
       test_check_mode_noop_when_absent:
       test_returns_count_of_pyi_files:
+      test_stray_non_pyi_file_not_removed:
     _setup:
     _build:
   test_sync.py:

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/__init__.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/__init__.py
 
 from importlib.metadata import version

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/ast_helpers.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/ast_helpers.py
 
 import ast

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/body.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/body.py
 
 import ast

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/cli.pyi

@@ -1,25 +1,36 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/cli.py
 
 import argparse
 import sys
 from pathlib import Path
+from typing import Literal
 from uncoded.body import resolve_body
 from uncoded.config import ConfigError, read_config
 from uncoded.docs_map import build_docs_map, iter_doc_files, render_docs_map
 from uncoded.extract import extract_modules, iter_source_files
 from uncoded.namespace_map import build_map, render_map
 from uncoded.refs import find_refs
-from uncoded.resolver import NamePath, SymbolNotFound, UnsupportedNamePath
+from uncoded.resolver import NamePath, SymbolNotFoundError, UnsupportedNamePathError
 from uncoded.skill import sync_skills
 from uncoded.stubs import build_stubs, remove_all_stubs
 from uncoded.sync import remove_file, sync_file
 
+def _validate_root(configured: Path, *, kind: Literal['source', 'doc'], project_root: Path, resolved_project_root: Path, accepts_md_file: bool) -> Path:
+    ...
+
 def _sync_code_artefacts(*, build: bool, configured_source_roots: list[Path], project_root: Path, resolved_project_root: Path, check: bool) -> int:
     ...
 
+def _sync_doc_artefacts(*, build: bool, configured_doc_roots: list[Path], project_root: Path, resolved_project_root: Path, check: bool) -> int:
+    ...
+
 def _sync(*, start: Path | None, check: bool) -> int:
     ...
 
+def _report_lookup_error(exc: Exception, *, name_path: str, in_path: str) -> int:
+    ...
+
 def _body(*, name_path: str, in_path: str) -> int:
     ...
 

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/config.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/config.py
 
 import tomllib
@@ -13,7 +14,7 @@ def _has_uncoded_section(*, pyproject_path: Path) -> bool:
 def _find_config_file(*, start: Path) -> Path | None:
     ...
 
-def read_config(start: Path) -> Config | None:
+def read_config(start: Path) -> Config:
     ...
 
 class ConfigError(Exception):

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/docs_map.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/docs_map.py
 
 from collections.abc import Iterable, Iterator
@@ -8,6 +9,9 @@ from uncoded.yaml_tree import render_yaml_tree
 
 DOCS_HEADER = ...
 
+def _parse_atx_heading(line: str) -> tuple[int, str] | None:
+    ...
+
 def extract_headings(text: str) -> list[tuple[int, str]]:
     ...
 

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/extract.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/extract.py
 
 import ast
@@ -8,6 +9,9 @@ from pathlib import Path
 from uncoded.ast_helpers import assign_target_name, property_kind
 from uncoded.read_helpers import read_source_text_or_warn
 
+def _extract_class_members(node: ast.ClassDef) -> ClassInfo:
+    ...
+
 def extract_module(source: str, rel_path: str) -> ModuleInfo:
     ...
 

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/markers.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/markers.py
 
 GENERATED_MARKER = 'Generated by uncoded — do not edit; regeneration overwrites.'

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/namespace_map.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/namespace_map.py
 
 from pathlib import Path

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/read_helpers.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/read_helpers.py
 
 import sys

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/refs.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/refs.py
 
 from __future__ import annotations
@@ -12,7 +13,7 @@ from uncoded.config import find_pyproject_toml
 from uncoded.read_helpers import read_source_text
 from uncoded.resolver import NamePath, resolve_name_position
 
-TY_VERSION = '0.0.37'
+TY_VERSION = '0.0.53'
 
 def find_refs(name_path: NamePath, in_path: Path) -> list[Reference]:
     ...

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/resolver.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/resolver.py
 
 import ast
@@ -28,8 +29,8 @@ class NamePath(NamedTuple):
     def __str__(self) -> str:
         ...
 
-class SymbolNotFound(Exception):
+class SymbolNotFoundError(Exception):
     ...
 
-class UnsupportedNamePath(Exception):
+class UnsupportedNamePathError(Exception):
     ...

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/skill.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/skill.py
 
 from dataclasses import dataclass

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/stubs.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/stubs.py
 
 import ast
@@ -5,6 +6,7 @@ from collections.abc import Iterable
 from dataclasses import dataclass, field
 from pathlib import Path
 from uncoded.ast_helpers import property_kind
+from uncoded.markers import GENERATED_MARKER
 from uncoded.sync import remove_file, sync_file
 
 VALUE_WIDTH_CAP = 80
@@ -42,12 +44,24 @@ def _format_assignment_body(a: StubAssignment) -> str:
 def _render_assignment(a: StubAssignment, indent: str) -> str:
     ...
 
+def _render_class(cls: StubClass) -> list[str]:
+    ...
+
 def render_stub(module: StubModule) -> str:
     ...
 
 def _generate_stubs(files: Iterable[tuple[str, str]]) -> dict[Path, str]:
     ...
 
+def _resolve_stubs_root(*, source_root: Path, output_dir: Path, project_root: Path) -> Path | None:
+    ...
+
+def _remove_orphan_stubs(*, expected: set[Path], abs_stubs_root: Path, project_root: Path, check: bool) -> int:
+    ...
+
+def _prune_empty_stub_dirs(*, abs_stubs_root: Path) -> None:
+    ...
+
 def _write_stubs(*, stubs: dict[Path, str], source_root: Path, output_dir: Path, project_root: Path, check: bool) -> int:
     ...
 

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/sync.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/sync.py
 
 from pathlib import Path

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/src/uncoded/yaml_tree.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # src/uncoded/yaml_tree.py
 
 import yaml
@@ -6,5 +7,5 @@ def render_yaml_tree(header: str, mapping: dict) -> str:
     ...
 
 class _CleanDumper(yaml.SafeDumper):
-    def increase_indent(self, flow, indentless):
+    def increase_indent(self, flow: bool, indentless: bool) -> None:
         ...

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_body.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_body.py
 
 import ast
@@ -5,7 +6,7 @@ import textwrap
 from unittest import mock
 import pytest
 from uncoded.body import resolve_body
-from uncoded.resolver import NamePath, SymbolNotFound, UnsupportedNamePath, resolve_ast_node, resolve_name_position
+from uncoded.resolver import NamePath, SymbolNotFoundError, UnsupportedNamePathError, resolve_ast_node, resolve_name_position
 
 class TestResolveBodyTopLevel:
     def test_function_without_decorators(self, tmp_path):
@@ -75,7 +76,7 @@ class TestResolveBodyClassMember:
     def test_not_found_in_class(self, tmp_path):
         ...
 
-class TestUnsupportedNamePath:
+class TestUnsupportedNamePathError:
     SUPPORTED_SHAPES = ("'name'", "'Class/member'")
 
     def _assert_raises(self, name_path):

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_cli.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_cli.py
 
 import sys

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_config.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_config.py
 
 from pathlib import Path
@@ -15,7 +16,7 @@ class TestFindPyprojectToml:
         ...
 
 class TestReadConfig:
-    def test_returns_none_when_no_config_file(self, tmp_path):
+    def test_raises_when_no_config_file(self, tmp_path):
         ...
 
     def test_source_roots_read_from_pyproject(self, tmp_path):

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_docs_map.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_docs_map.py
 
 from pathlib import Path
@@ -102,6 +103,9 @@ class TestIterDocFiles:
     def test_single_file_root_unreadable_yields_nothing(self, tmp_path, capsys):
         ...
 
+    def test_bom_prefixed_file_heading_appears(self, tmp_path):
+        ...
+
 class TestBuildDocsMap:
     def test_empty_files(self):
         ...

uncoded-2.1.1/.uncoded/stubs/tests/test_encoding_gate.pyi

@@ -0,0 +1,8 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
+# tests/test_encoding_gate.py
+
+from pathlib import Path
+import pytest
+
+def test_encoding_warning_gate(tmp_path: Path) -> None:
+    ...

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_extract.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_extract.py
 
 import textwrap

uncoded-2.1.1/.uncoded/stubs/tests/test_markers.pyi

@@ -0,0 +1,21 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
+# tests/test_markers.py
+
+from uncoded.docs_map import render_docs_map
+from uncoded.markers import GENERATED_MARKER
+from uncoded.namespace_map import render_map
+from uncoded.skill import SKILLS, _render_content
+from uncoded.stubs import StubModule, render_stub
+
+class TestMarkerCompleteness:
+    def test_namespace_map_carries_marker(self):
+        ...
+
+    def test_docs_map_carries_marker(self):
+        ...
+
+    def test_stub_carries_marker(self):
+        ...
+
+    def test_skill_carries_marker(self):
+        ...

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_namespace_map.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_namespace_map.py
 
 import yaml

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_refs.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_refs.py
 
 import io

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_skill.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_skill.py
 
 from importlib.resources import files

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_stubs.pyi

@@ -1,9 +1,11 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_stubs.py
 
 import textwrap
 from pathlib import Path
 import pytest
 from uncoded.extract import iter_source_files
+from uncoded.markers import GENERATED_MARKER
 from uncoded.stubs import StubAssignment, StubClass, StubFunction, StubModule, StubParam, _write_stubs, build_stubs, extract_stub, remove_all_stubs, render_stub
 
 def _setup(tmp_path):
@@ -230,3 +232,6 @@ class TestRemoveAllStubs:
 
     def test_returns_count_of_pyi_files(self, tmp_path):
         ...
+
+    def test_stray_non_pyi_file_not_removed(self, tmp_path):
+        ...

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_sync.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_sync.py
 
 from pathlib import Path

{uncoded-2.1.0 → uncoded-2.1.1}/.uncoded/stubs/tests/test_uncoded.pyi

@@ -1,3 +1,4 @@
+# Generated by uncoded — do not edit; regeneration overwrites.
 # tests/test_uncoded.py
 
 import uncoded