kconfig-preprocessor-parser 0.1.0__tar.gz → 0.1.1__tar.gz

{kconfig_preprocessor_parser-0.1.0 → kconfig_preprocessor_parser-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kconfig-preprocessor-parser
-Version: 0.1.0
+Version: 0.1.1
 Summary: Extract C preprocessor conditionals and resolve each branch to its effective CONFIG_* condition
 Keywords: c,preprocessor,tree-sitter,kconfig,linux-kernel,ifdef
 Author: s4nsec
@@ -31,8 +31,8 @@ Description-Content-Type: text/markdown
 
 Extract C preprocessor conditional blocks (`#ifdef` / `#if` / `#elif` / `#else`)
 from source files using [tree-sitter](https://tree-sitter.github.io/), and
-resolve each branch to the **effective condition** that must hold for its lines
-to compile.
+resolve each branch to the effective condition that must hold for its lines to
+compile.
 
 Built for Linux kernel configuration analysis, where knowing *which* `CONFIG_*`
 symbols guard a given line matters. Scope is deliberately narrow: only
@@ -44,6 +44,17 @@ symbols guard a given line matters. Scope is deliberately narrow: only
 uv add kconfig-preprocessor-parser
 ```
 
+```bash
+pip install kconfig-preprocessor-parser
+```
+
+To try it without adding it to a project, run a throwaway interpreter with the
+package available:
+
+```bash
+uv run --with kconfig-preprocessor-parser --no-project python
+```
+
 Requires Python 3.10+.
 
 ## Quick start
@@ -86,7 +97,7 @@ Note `raw_expression` for the `#elif` and `#else` branches: the parser carries
 the negation of every earlier branch in the chain, so the expression is the
 complete guard for those lines, not just the local directive.
 
-Nested blocks compose the same way — a `#ifdef CONFIG_B` inside a
+Nested blocks compose the same way. A `#ifdef CONFIG_B` inside a
 `#ifdef CONFIG_A` yields `CONFIG_A and CONFIG_B`.
 
 Boolean operators are supported: `defined(A) && defined(B)` resolves to
@@ -118,38 +129,11 @@ Unresolved conditions are never silently dropped. They come back with
 **Conditions are read syntactically from one file.** Macros are not expanded and
 `#include` is not followed, so `#define MY_FLAG CONFIG_A` followed by
 `#ifdef MY_FLAG` reports `MY_FLAG`, not `CONFIG_A`. Symbols are reported as
-guards regardless of whether they are actually defined — resolve them against a
-real config with `parse_enabled_configs`.
+guards regardless of whether they are actually defined. Resolve them against
+a real config with `parse_enabled_configs`.
 
 **C only.** Backed by `tree-sitter-c`; C++ is not supported.
 
-## Coverage reports
-
-`get_all_lines_in_preproc` and
-`get_all_parseable_preproc_lines_in_covered_functions` read syzkaller coverage
-JSON. Reports record absolute paths from the machine the kernel was built on,
-which rarely match the tree you are analyzing, so paths are mapped onto
-`kernel_src` by longest matching suffix:
-
-```python
-get_all_parseable_preproc_lines_in_covered_functions(
-    coverage_file=Path("coverage.json"),
-    kernel_src=Path("/src/linux"),
-)
-```
-
-Pass `strip_prefix` to map them explicitly instead:
-
-```python
-get_all_parseable_preproc_lines_in_covered_functions(
-    coverage_file=Path("coverage.json"),
-    kernel_src=Path("/src/linux"),
-    strip_prefix="/build/ci/kernel-6.1",
-)
-```
-
-Files that cannot be mapped onto `kernel_src` are skipped, not fatal.
-
 ## License
 
 MIT

{kconfig_preprocessor_parser-0.1.0 → kconfig_preprocessor_parser-0.1.1}/README.md

@@ -2,8 +2,8 @@
 
 Extract C preprocessor conditional blocks (`#ifdef` / `#if` / `#elif` / `#else`)
 from source files using [tree-sitter](https://tree-sitter.github.io/), and
-resolve each branch to the **effective condition** that must hold for its lines
-to compile.
+resolve each branch to the effective condition that must hold for its lines to
+compile.
 
 Built for Linux kernel configuration analysis, where knowing *which* `CONFIG_*`
 symbols guard a given line matters. Scope is deliberately narrow: only
@@ -15,6 +15,17 @@ symbols guard a given line matters. Scope is deliberately narrow: only
 uv add kconfig-preprocessor-parser
 ```
 
+```bash
+pip install kconfig-preprocessor-parser
+```
+
+To try it without adding it to a project, run a throwaway interpreter with the
+package available:
+
+```bash
+uv run --with kconfig-preprocessor-parser --no-project python
+```
+
 Requires Python 3.10+.
 
 ## Quick start
@@ -57,7 +68,7 @@ Note `raw_expression` for the `#elif` and `#else` branches: the parser carries
 the negation of every earlier branch in the chain, so the expression is the
 complete guard for those lines, not just the local directive.
 
-Nested blocks compose the same way — a `#ifdef CONFIG_B` inside a
+Nested blocks compose the same way. A `#ifdef CONFIG_B` inside a
 `#ifdef CONFIG_A` yields `CONFIG_A and CONFIG_B`.
 
 Boolean operators are supported: `defined(A) && defined(B)` resolves to
@@ -89,38 +100,11 @@ Unresolved conditions are never silently dropped. They come back with
 **Conditions are read syntactically from one file.** Macros are not expanded and
 `#include` is not followed, so `#define MY_FLAG CONFIG_A` followed by
 `#ifdef MY_FLAG` reports `MY_FLAG`, not `CONFIG_A`. Symbols are reported as
-guards regardless of whether they are actually defined — resolve them against a
-real config with `parse_enabled_configs`.
+guards regardless of whether they are actually defined. Resolve them against
+a real config with `parse_enabled_configs`.
 
 **C only.** Backed by `tree-sitter-c`; C++ is not supported.
 
-## Coverage reports
-
-`get_all_lines_in_preproc` and
-`get_all_parseable_preproc_lines_in_covered_functions` read syzkaller coverage
-JSON. Reports record absolute paths from the machine the kernel was built on,
-which rarely match the tree you are analyzing, so paths are mapped onto
-`kernel_src` by longest matching suffix:
-
-```python
-get_all_parseable_preproc_lines_in_covered_functions(
-    coverage_file=Path("coverage.json"),
-    kernel_src=Path("/src/linux"),
-)
-```
-
-Pass `strip_prefix` to map them explicitly instead:
-
-```python
-get_all_parseable_preproc_lines_in_covered_functions(
-    coverage_file=Path("coverage.json"),
-    kernel_src=Path("/src/linux"),
-    strip_prefix="/build/ci/kernel-6.1",
-)
-```
-
-Files that cannot be mapped onto `kernel_src` are skipped, not fatal.
-
 ## License
 
 MIT

{kconfig_preprocessor_parser-0.1.0 → kconfig_preprocessor_parser-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kconfig-preprocessor-parser"
-version = "0.1.0"
+version = "0.1.1"
 description = "Extract C preprocessor conditionals and resolve each branch to its effective CONFIG_* condition"
 readme = "README.md"
 license = "MIT"

{kconfig_preprocessor_parser-0.1.0 → kconfig_preprocessor_parser-0.1.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "kconfig-preprocessor-parser"
-version = "0.1.0"
+version = "0.1.1"
 description = "Extract C preprocessor conditionals and resolve each branch to its effective CONFIG_* condition"
 readme = "README.md"
 license = "MIT"