gdare2 0.1.0__tar.gz

gdare2-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,82 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Test Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.3.3
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+      - name: Install dependencies
+        run: uv sync --group dev
+      - name: Run tests
+        run: uv run pytest
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.13"
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.3.3
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+      - name: Install dependencies
+        run: uv sync --group dev
+      - name: Check style
+        run: uv run ruff check .
+
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.13"
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.3.3
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+      - name: Build sdist and wheel
+        run: uv build
+      - name: Validate package metadata
+        run: uv run --with twine twine check dist/*

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

@@ -0,0 +1,130 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      target:
+        description: Index to publish to
+        required: true
+        default: testpypi
+        type: choice
+        options:
+          - testpypi
+          - pypi
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test before release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.13"
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.3.3
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+      - name: Install dependencies
+        run: uv sync --group dev
+      - name: Run tests
+        run: uv run pytest
+      - name: Check style
+        run: uv run ruff check .
+
+  build:
+    name: Build distributions
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.13"
+      - name: Check that the tag matches the package version
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          python - <<'PY'
+          import os
+          import pathlib
+          import re
+          import sys
+
+          tag = os.environ["GITHUB_REF_NAME"].removeprefix("v")
+          text = pathlib.Path("src/gdare2/__init__.py").read_text(encoding="utf-8")
+          match = re.search(r'^__version__ = "([^"]+)"', text, re.MULTILINE)
+          version = match.group(1) if match else "<missing>"
+          if tag != version:
+              sys.exit(f"tag {tag!r} does not match package version {version!r}")
+          PY
+      - name: Install build frontend and validator
+        run: python -m pip install --upgrade build twine
+      - name: Build sdist and wheel
+        run: python -m build
+      - name: Validate package metadata
+        run: python -m twine check dist/*
+      - name: Store distribution packages
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish-to-testpypi:
+    name: Publish to TestPyPI
+    if: >-
+      github.event_name == 'workflow_dispatch' &&
+      inputs.target == 'testpypi'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/gdare2
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    if: >-
+      github.event_name == 'release' ||
+      (github.event_name == 'workflow_dispatch' && inputs.target == 'pypi')
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/gdare2
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

gdare2-0.1.0/.gitignore

@@ -0,0 +1,19 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.venv/
+dist/
+build/
+.coverage
+htmlcov/
+site/
+.pypirc
+*.whl
+*.tar.gz
+*.log
+*.gpr
+*.rep/
+# Local-only design and development notes; never commit or publish.
+docs/

gdare2-0.1.0/CHANGELOG.md

@@ -0,0 +1,102 @@
+# Changelog
+
+All notable changes to gdare2 are documented here.  The format follows
+[Keep a Changelog](https://keepachangelog.com/) and the project uses
+[Semantic Versioning](https://semver.org/).
+
+## [0.1.0] - 2026-11-14
+
+First public release.
+
+v2 compatibility batches A–C (G1–G18) and the first batch-D item (G19).
+
+v3 batch A: command-language layer (`?` expression family, `@` temporary
+modifiers, macros, `.cmd`/`.!cmd` interpretation, repeat-prefix output
+accumulation) and the parity environment repair (radare2 6.2.6 + rebuilt
+goldens).
+
+v3 batch B: output/input format families (`pc` code-generation family,
+compare variants `c2/c4/c8/cJ/cv`, yank variants `yj/y*/yp/yq/ys/yw/yz`,
+flag subcommands `fc/fm/fo/fd`, `fs` flag spaces, seek gaps `sa/sC/sd`).
+
+v3 batch C: search and graph completion (`/b` backward hex search, `agC`
+call graph with DOT rendering, `axg` reference graph, explicit
+not-supported decisions for the remaining `/` and `ax` variants).
+
+v3 batch D: configuration and ecosystem (new keys `asm.offset`,
+`scr.utf8`, `bin.demangle`, `cfg.sandbox`, `search.maxhits`; explicit
+errors for unsupported r2 keys like `asm.emu`/`anal.*`; `--pipe-listen`
+r2pipe-compatible TCP command channel; CLI option audit).
+
+### Added
+
+- Expanded radare2 command compatibility: `p6`/`p=`/`pj`/`pr`/`ph`/`pwd`,
+  `pdq`/`pdC`/`pdJ`/`pd,`, `s:`/`s=`, `fn`/`fN`/`fx`, `e*`/`e-`/`e!`/`env`/
+  `es`/`et`/`ev`, `bj`/`bf`/`bm`, `iD`/`iC`/`iV`/`iv`/`iT`/`iee`/`ies`,
+  `Ch`/`Cs`/`Cm`/`Cf`/`Ct`/`CL`, and `tn`/`to`/`tk`/`tl`/`tx`.
+- Search variants `/i`, `/d`, `/z`, `/m`, `/c` and `/R`; `/m` and `/c` share a
+  deterministic built-in magic/crypto signature scanner.
+- Write commands `wt`/`wv`/`wr`/`ws`/`ww`, including width and float variants
+  for `wv`.
+- Project snapshots now preserve hidden ranges, string/magic metadata, type
+  comments, source lines, type links, no-return marks and notes; `Pc` emits
+  replay commands for all of them.
+- PyPI-ready packaging: PEP 639 license metadata, a required
+  `pyghidra>=3.2.0` runtime dependency, a `dev` dependency group, self-hosted
+  README badges, packaging regression tests, and TestPyPI/PyPI Trusted
+  Publishing workflows.
+- `pip install gdare2` is now the documented installation path.
+- `--assembler=ghidra|rasm2|auto` now configures `asm.assembler`; explicit
+  values override rc files, and `-e asm.assembler=...` wins on the same
+  command line.
+- `pdi` emits r2-style `address  flag:` lines for client-side flags without
+  duplicating the current instruction symbol.
+- `iSS` reads ELF program headers from the input file; `ih`/`iH`/`il`/`ir`
+  expose the ELF header, `DT_NEEDED` libraries and relocations.
+- Replayable command variants: `f*`, `C*`/`CC*`/`C*.`, `CCu base64:`,
+  `t*`, `s*`, `b*`, `iS*` and `ax*`/`axlj`/`axlq`/`axlc`.
+- `pf`/`pfj`/`pfs`/`pf.<name>` formatting with scalars, arrays, offset
+  controls, unions and named formats.
+- `~` filter v2: multi-column/negative/range selectors, column sorting and
+  `~{}` JSON pretty-printing.
+- `p` family read commands: `pdb`, `pC`, `pA`, `pxd`/`pxu`/`pxj`, the `ps`
+  variants, `p8` projections and `pvu`/`pvd`/`pvp`.
+- Tab completion for flags/functions and `$` variables; rc hierarchy with
+  `rc.d/*`, project ancestor files and `GDARE2_RCFILE`.
+- Backtick command substitution and `px` layout aligned with r2
+  (`hex.pairs`/`hex.offset`/`hex.ascii`).
+- GitHub Actions CI, configuration/format test suites and a PyPI publish
+  workflow.
+
+### Changed
+
+- The README is now English-only. The `docs/` tree is maintained locally and
+  excluded from Git and release artifacts.
+- `pd`/`pdi` render instruction bytes as contiguous hexpairs (r2 shape);
+  instructions longer than eight bytes are elided with `..`.
+- `@@f`/`@@F` skip external, thunk and non-executable function entries.
+- `pd -j` JSON and `-j` command resolution follow the r2 line-oriented
+  filter model.
+
+### Fixed
+
+- First-import analysis no longer cuts off at 180 seconds. The daemon-side
+  cap defaulted to a hard 180 s, which truncated slow-arch imports (measured:
+  i386 684 s, mipsel 665 s, big-endian MIPS 483 s) and silently cached a
+  broken one-function database that later runs reused. The default is now
+  unlimited; a cap can be set explicitly with the new client option
+  `--analysis-timeout <sec>` (0 disables it).
+- Entry-point detection prefers an executable `_start` and ignores
+  non-executable DWARF symbols named `entry` (seen in the Tenda `httpd`
+  firmware sample).
+- `tp`/`tpv` no longer crash on built-in integer types; `tc <name>` only emits
+  the requested declaration.
+- JSON output participates in `~`/`|` line by line.
+- `~` filters keep backslash escapes such as `~\.text`.
+- Pagination via `--list-offset`/`e list.offset`, with explicit metadata.
+
+## [0.1.0] - 2026-11-07
+
+Initial import: two-process daemon/client architecture, read-only core,
+analysis, disassembly, decompilation, types, writes, search, flags, scripts,
+parity golden files and the 22-configuration architecture matrix.

gdare2-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fire3
+
+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.