cifter-cli 0.1.0__tar.gz

cifter_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 t-kenji
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cifter_cli-0.1.0/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: cifter-cli
+Version: 0.1.0
+Summary: C/C++ の関数実装を抽出する軽量 CLI
+Keywords: c,c++,cpp,cli,tree-sitter,source-extraction,static-analysis
+Author: t-kenji
+Author-email: t-kenji <protect.2501@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: C
+Classifier: Programming Language :: C++
+Classifier: Topic :: Software Development
+Requires-Dist: pcpp>=1.30
+Requires-Dist: tree-sitter>=0.25.2
+Requires-Dist: tree-sitter-c>=0.24.1
+Requires-Dist: tree-sitter-cpp>=0.23.4
+Requires-Dist: typer>=0.24.1
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/t-kenji/cifter
+Project-URL: Repository, https://github.com/t-kenji/cifter
+Project-URL: Issues, https://github.com/t-kenji/cifter/issues
+Project-URL: Changelog, https://github.com/t-kenji/cifter/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# cifter
+
+`cifter` は、C/C++ の関数実装を機械的かつ高速に抽出する CLI です。
+`tree-sitter` で構文を捉え、行番号付き text として返します。重い意味解析や LLM 連携は行いません。
+
+## 概要
+
+- 単一の `--source` ファイルから抽出します
+- 公開サブコマンドは `function` / `flow` / `path` の 3 つです
+- 出力は元ソースと対応付け可能な行番号付き text です
+- `-D NAME[=VALUE]` により条件分岐前処理を評価できます
+
+## Why cifter
+
+- 関数全体をそのまま抜き出したい
+- 分岐の骨格だけを見たい
+- 特定の route だけを細く追いたい
+- 元の行番号を失わずにレビューや調査へ貼りたい
+
+## Installation
+
+PyPI から install:
+
+```sh
+python -m pip install cifter-cli
+```
+
+最小確認:
+
+```sh
+cift --help
+python -m cifter --help
+```
+
+GitHub Release の `wheel` / `sdist` から install することもできます。
+
+```sh
+python -m pip install ./cifter_cli-0.1.0-py3-none-any.whl
+```
+
+開発用:
+
+```sh
+uv sync
+uv run cift --help
+```
+
+## Quick Start
+
+サンプルソース:
+
+```c
+int FooFunction(int x)
+{
+    if (x > 0) {
+        return 1;
+    }
+
+    return 0;
+}
+```
+
+関数全体を抽出:
+
+```sh
+cift function --name FooFunction --source foo.c
+```
+
+出力:
+
+```text
+1: int FooFunction(int x)
+2: {
+3:     if (x > 0) {
+4:         return 1;
+5:     }
+6:
+7:     return 0;
+8: }
+```
+
+## Commands
+
+`function`:
+指定した関数の実装全体をそのまま抽出します。レビュー対象の最小切り出しに向きます。
+
+```sh
+cift function --name FooFunction --source examples/demo.c
+```
+
+`flow`:
+制御構造の骨格だけを残します。`--track` を付けると、完全一致したアクセスパスを含む文を追加保持します。
+
+```sh
+cift flow --function FooFunction --source examples/demo.c --track state
+cift flow --function FooFunction --source examples/demo.c --track 'ctx->state'
+```
+
+`path`:
+指定した route だけを細く抽出します。親構造は残し、route 終端に達したコンテナでは後続の通常文も残します。
+
+```sh
+cift path --function FooFunction --source examples/demo.c --route 'case CMD_HOGE > if ret == OK'
+cift path --function FooFunction --source examples/demo.c --route 'case CMD_HOGE > else if errno == EINT'
+cift path --function ElseRoute --source examples/demo.c --route 'else'
+```
+
+## Preprocessor / Track / Route
+
+`-D`:
+条件分岐前処理の評価に使うマクロを追加します。
+
+```sh
+cift function --name FooFunction --source examples/demo.c -D DEF_FOO -D ENABLE_BAR=1
+```
+
+`--track`:
+`flow` で保持したいアクセスパスです。構文上の完全一致だけを扱います。
+
+- `state`
+- `ctx->state`
+- `a->b.c`
+
+`--route`:
+`path` で辿る最小 DSL です。
+
+- `case CMD_HOGE`
+- `case CMD_HOGE > if ret == OK`
+- `case CMD_HOGE > else if errno == EINT`
+- `default`
+- `else`
+
+## Limitations
+
+- 対象は C/C++ のみです
+- 入力は単一ファイルのみです
+- 出力形式は text のみです
+- 入力文字コードは UTF-8 前提です
+- `.h` は現状 C 扱いです
+- `--route` は `case` / `default` / `if` / `else` / `else if` のみ対応です
+- `--track` は名前解決やスコープ解析を行いません
+- ループ経路、`goto` 横断、意味解析、CFG 構築、JSON 出力は対象外です
+
+## Examples
+
+リポジトリには `examples/demo.c` を含めています。
+
+```sh
+cift function --name FooFunction --source examples/demo.c
+cift flow --function FooFunction --source examples/demo.c --track 'ctx->state'
+cift path --function FooFunction --source examples/demo.c --route 'case CMD_LOOP > if ret == OK'
+```
+
+## Development
+
+開発者向け文書は `docs/` にまとめています。
+
+- [docs/overview.md](/home/tkenji/Repos/cifter/docs/overview.md)
+- [docs/cli.md](/home/tkenji/Repos/cifter/docs/cli.md)
+- [docs/output-format.md](/home/tkenji/Repos/cifter/docs/output-format.md)
+- [docs/pipeline.md](/home/tkenji/Repos/cifter/docs/pipeline.md)
+- [docs/data-model.md](/home/tkenji/Repos/cifter/docs/data-model.md)
+- [docs/architecture.md](/home/tkenji/Repos/cifter/docs/architecture.md)
+- [docs/release.md](/home/tkenji/Repos/cifter/docs/release.md)
+
+仕様の正本は `docs/specs/` にあります。
+
+## License
+
+MIT License で配布します。詳細は `LICENSE` を参照してください。

cifter_cli-0.1.0/README.md

@@ -0,0 +1,170 @@
+# cifter
+
+`cifter` は、C/C++ の関数実装を機械的かつ高速に抽出する CLI です。
+`tree-sitter` で構文を捉え、行番号付き text として返します。重い意味解析や LLM 連携は行いません。
+
+## 概要
+
+- 単一の `--source` ファイルから抽出します
+- 公開サブコマンドは `function` / `flow` / `path` の 3 つです
+- 出力は元ソースと対応付け可能な行番号付き text です
+- `-D NAME[=VALUE]` により条件分岐前処理を評価できます
+
+## Why cifter
+
+- 関数全体をそのまま抜き出したい
+- 分岐の骨格だけを見たい
+- 特定の route だけを細く追いたい
+- 元の行番号を失わずにレビューや調査へ貼りたい
+
+## Installation
+
+PyPI から install:
+
+```sh
+python -m pip install cifter-cli
+```
+
+最小確認:
+
+```sh
+cift --help
+python -m cifter --help
+```
+
+GitHub Release の `wheel` / `sdist` から install することもできます。
+
+```sh
+python -m pip install ./cifter_cli-0.1.0-py3-none-any.whl
+```
+
+開発用:
+
+```sh
+uv sync
+uv run cift --help
+```
+
+## Quick Start
+
+サンプルソース:
+
+```c
+int FooFunction(int x)
+{
+    if (x > 0) {
+        return 1;
+    }
+
+    return 0;
+}
+```
+
+関数全体を抽出:
+
+```sh
+cift function --name FooFunction --source foo.c
+```
+
+出力:
+
+```text
+1: int FooFunction(int x)
+2: {
+3:     if (x > 0) {
+4:         return 1;
+5:     }
+6:
+7:     return 0;
+8: }
+```
+
+## Commands
+
+`function`:
+指定した関数の実装全体をそのまま抽出します。レビュー対象の最小切り出しに向きます。
+
+```sh
+cift function --name FooFunction --source examples/demo.c
+```
+
+`flow`:
+制御構造の骨格だけを残します。`--track` を付けると、完全一致したアクセスパスを含む文を追加保持します。
+
+```sh
+cift flow --function FooFunction --source examples/demo.c --track state
+cift flow --function FooFunction --source examples/demo.c --track 'ctx->state'
+```
+
+`path`:
+指定した route だけを細く抽出します。親構造は残し、route 終端に達したコンテナでは後続の通常文も残します。
+
+```sh
+cift path --function FooFunction --source examples/demo.c --route 'case CMD_HOGE > if ret == OK'
+cift path --function FooFunction --source examples/demo.c --route 'case CMD_HOGE > else if errno == EINT'
+cift path --function ElseRoute --source examples/demo.c --route 'else'
+```
+
+## Preprocessor / Track / Route
+
+`-D`:
+条件分岐前処理の評価に使うマクロを追加します。
+
+```sh
+cift function --name FooFunction --source examples/demo.c -D DEF_FOO -D ENABLE_BAR=1
+```
+
+`--track`:
+`flow` で保持したいアクセスパスです。構文上の完全一致だけを扱います。
+
+- `state`
+- `ctx->state`
+- `a->b.c`
+
+`--route`:
+`path` で辿る最小 DSL です。
+
+- `case CMD_HOGE`
+- `case CMD_HOGE > if ret == OK`
+- `case CMD_HOGE > else if errno == EINT`
+- `default`
+- `else`
+
+## Limitations
+
+- 対象は C/C++ のみです
+- 入力は単一ファイルのみです
+- 出力形式は text のみです
+- 入力文字コードは UTF-8 前提です
+- `.h` は現状 C 扱いです
+- `--route` は `case` / `default` / `if` / `else` / `else if` のみ対応です
+- `--track` は名前解決やスコープ解析を行いません
+- ループ経路、`goto` 横断、意味解析、CFG 構築、JSON 出力は対象外です
+
+## Examples
+
+リポジトリには `examples/demo.c` を含めています。
+
+```sh
+cift function --name FooFunction --source examples/demo.c
+cift flow --function FooFunction --source examples/demo.c --track 'ctx->state'
+cift path --function FooFunction --source examples/demo.c --route 'case CMD_LOOP > if ret == OK'
+```
+
+## Development
+
+開発者向け文書は `docs/` にまとめています。
+
+- [docs/overview.md](/home/tkenji/Repos/cifter/docs/overview.md)
+- [docs/cli.md](/home/tkenji/Repos/cifter/docs/cli.md)
+- [docs/output-format.md](/home/tkenji/Repos/cifter/docs/output-format.md)
+- [docs/pipeline.md](/home/tkenji/Repos/cifter/docs/pipeline.md)
+- [docs/data-model.md](/home/tkenji/Repos/cifter/docs/data-model.md)
+- [docs/architecture.md](/home/tkenji/Repos/cifter/docs/architecture.md)
+- [docs/release.md](/home/tkenji/Repos/cifter/docs/release.md)
+
+仕様の正本は `docs/specs/` にあります。
+
+## License
+
+MIT License で配布します。詳細は `LICENSE` を参照してください。

cifter_cli-0.1.0/pyproject.toml

@@ -0,0 +1,86 @@
+[project]
+name = "cifter-cli"
+version = "0.1.0"
+description = "C/C++ の関数実装を抽出する軽量 CLI"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "t-kenji", email = "protect.2501@gmail.com" }
+]
+requires-python = ">=3.12"
+keywords = [
+    "c",
+    "c++",
+    "cpp",
+    "cli",
+    "tree-sitter",
+    "source-extraction",
+    "static-analysis",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: C",
+    "Programming Language :: C++",
+    "Topic :: Software Development",
+]
+dependencies = [
+    "pcpp>=1.30",
+    "tree-sitter>=0.25.2",
+    "tree-sitter-c>=0.24.1",
+    "tree-sitter-cpp>=0.23.4",
+    "typer>=0.24.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/t-kenji/cifter"
+Repository = "https://github.com/t-kenji/cifter"
+Issues = "https://github.com/t-kenji/cifter/issues"
+Changelog = "https://github.com/t-kenji/cifter/blob/main/CHANGELOG.md"
+
+[project.scripts]
+cift = "cifter:main"
+
+[build-system]
+requires = ["uv_build>=0.10.10,<0.11.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "cifter"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+    "ruff>=0.15.6",
+    "ty>=0.0.23",
+]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+exclude = ["examples/*"]
+
+[tool.ruff.lint]
+extend-select = [
+    "B",
+    "I",
+    "RUF",
+    "SIM",
+    "UP"
+]
+
+[tool.ty.rules]
+possibly-unresolved-reference = "warn"
+
+[tool.ty.environment]
+python-version = "3.12"
+root = ["./src"]
+
+[tool.ty.src]
+exclude = ["examples/*"]

cifter_cli-0.1.0/src/cifter/__init__.py

@@ -0,0 +1,3 @@
+from cifter.cli import main
+
+__all__ = ["main"]

cifter_cli-0.1.0/src/cifter/__main__.py

@@ -0,0 +1,4 @@
+from cifter.cli import main
+
+if __name__ == "__main__":
+    main()

cifter_cli-0.1.0/src/cifter/cli.py

@@ -0,0 +1,90 @@
+from __future__ import annotations
+
+from collections.abc import Callable
+from pathlib import Path
+from typing import Annotated
+
+import typer
+
+from cifter.errors import CiftError
+from cifter.extract_flow import extract_flow
+from cifter.extract_function import extract_function
+from cifter.extract_path import extract_path
+from cifter.model import TrackPath
+from cifter.parser import parse_source
+from cifter.render import render_result
+
+app = typer.Typer(no_args_is_help=True, help="C/C++ の関数実装を抽出する CLI")
+
+
+def main() -> None:
+    app()
+
+
+SourceOption = Annotated[
+    Path,
+    typer.Option(
+        "--source",
+        exists=True,
+        file_okay=True,
+        dir_okay=False,
+        readable=True,
+        resolve_path=True,
+        help="解析するソースファイル",
+    ),
+]
+
+
+@app.command("function")
+def function_command(
+    name: Annotated[str, typer.Option("--name", help="抽出する関数名")],
+    source: SourceOption,
+    defines: Annotated[
+        list[str] | None,
+        typer.Option("--define", "-D", help="条件分岐評価に使うマクロ定義"),
+    ] = None,
+) -> None:
+    _run(lambda: render_result(extract_function(parse_source(source, defines or []), name)))
+
+
+@app.command("flow")
+def flow_command(
+    function_name: Annotated[str, typer.Option("--function", help="対象関数名")],
+    source: SourceOption,
+    track: Annotated[list[str], typer.Option("--track", help="保持するアクセスパス")] | None = None,
+    defines: Annotated[
+        list[str] | None,
+        typer.Option("--define", "-D", help="条件分岐評価に使うマクロ定義"),
+    ] = None,
+) -> None:
+    def task() -> str:
+        parsed = parse_source(source, defines or [])
+        tracks = tuple(TrackPath.parse(value) for value in (track or []))
+        return render_result(extract_flow(parsed, function_name, tracks))
+
+    _run(task)
+
+
+@app.command("path")
+def path_command(
+    function_name: Annotated[str, typer.Option("--function", help="対象関数名")],
+    source: SourceOption,
+    route: Annotated[str, typer.Option("--route", help="抽出する経路 DSL")],
+    defines: Annotated[
+        list[str] | None,
+        typer.Option("--define", "-D", help="条件分岐評価に使うマクロ定義"),
+    ] = None,
+) -> None:
+    def task() -> str:
+        parsed = parse_source(source, defines or [])
+        return render_result(extract_path(parsed, function_name, route))
+
+    _run(task)
+
+
+def _run(task: Callable[[], str]) -> None:
+    try:
+        typer.echo(task())
+    except CiftError as error:
+        typer.echo(error.message, err=True)
+        raise typer.Exit(code=1) from error

cifter_cli-0.1.0/src/cifter/errors.py

@@ -0,0 +1,4 @@
+class CiftError(Exception):
+    def __init__(self, message: str) -> None:
+        super().__init__(message)
+        self.message = message