ext4-cli 0.0.1__tar.gz

ext4_cli-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,77 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - name: Run linting
+        run: make lint
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: taiki-e/install-action@nextest
+
+      - name: Generate fixtures
+        run: make fixtures
+
+      - name: Run tests
+        run: make test
+
+  coverage:
+    name: Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: taiki-e/install-action@cargo-tarpaulin
+
+      - name: Generate fixtures
+        run: make fixtures
+
+      - name: Generate coverage
+        run: cargo tarpaulin --out xml
+
+      - name: Upload to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          files: cobertura.xml
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  all-checks-passed:
+    name: All checks passed
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    if: always()
+    steps:
+      - name: Verify all checks passed
+        run: |
+          if [ "${{ contains(needs.*.result, 'failure') || contains(needs.*.result, 'cancelled') }}" == "true" ]; then
+            echo "Some checks failed or were cancelled"
+            exit 1
+          fi
+          echo "All checks passed"

ext4_cli-0.0.1/.github/workflows/release.yml

@@ -0,0 +1,286 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v[0-9]*.[0-9]*.[0-9]*'
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Dry run (skip publishing)'
+        required: false
+        default: true
+        type: boolean
+      skip_crates_io:
+        description: 'Skip crates.io publish (if already published)'
+        required: false
+        default: false
+        type: boolean
+      skip_pypi:
+        description: 'Skip PyPI publish (if already published)'
+        required: false
+        default: false
+        type: boolean
+      skip_github_release:
+        description: 'Skip GitHub release creation (if already exists)'
+        required: false
+        default: false
+        type: boolean
+
+permissions:
+  contents: write
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+  test:
+    name: Run tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: taiki-e/install-action@nextest
+
+      - name: Verify Cargo.lock is up to date
+        run: cargo check --locked
+
+      - name: Generate fixtures
+        run: make fixtures
+
+      - name: Run tests
+        run: make test
+
+  build:
+    name: Build ${{ matrix.target }}
+    needs: test
+    strategy:
+      matrix:
+        include:
+          - target: x86_64-unknown-linux-gnu
+            os: ubuntu-latest
+          - target: aarch64-unknown-linux-gnu
+            os: ubuntu-latest
+          - target: x86_64-apple-darwin
+            os: macos-latest
+          - target: aarch64-apple-darwin
+            os: macos-latest
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Install cross-compilation tools
+        if: matrix.target == 'aarch64-unknown-linux-gnu'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y gcc-aarch64-linux-gnu
+
+      - name: Install maturin and zig
+        run: pip install maturin ziglang
+
+      - name: Build wheel
+        shell: bash
+        run: |
+          case "${{ matrix.target }}" in
+            *-gnu)
+              maturin build --release --target ${{ matrix.target }} --zig
+              ;;
+            *)
+              maturin build --release --target ${{ matrix.target }}
+              ;;
+          esac
+
+      - name: Build binary
+        run: cargo build --release --target ${{ matrix.target }}
+        env:
+          CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER: aarch64-linux-gnu-gcc
+
+      - name: Package binary
+        shell: bash
+        run: |
+          ARCHIVE_NAME="ext4-${{ github.ref_name }}-${{ matrix.target }}"
+          mkdir -p "${ARCHIVE_NAME}"
+          cp "target/${{ matrix.target }}/release/ext4" "${ARCHIVE_NAME}/"
+          tar czf "${ARCHIVE_NAME}.tar.gz" "${ARCHIVE_NAME}"
+          if [[ "${{ runner.os }}" == "macOS" ]]; then
+            shasum -a 256 "${ARCHIVE_NAME}.tar.gz" > "${ARCHIVE_NAME}.tar.gz.sha256"
+          else
+            sha256sum "${ARCHIVE_NAME}.tar.gz" > "${ARCHIVE_NAME}.tar.gz.sha256"
+          fi
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: build-${{ matrix.target }}
+          path: |
+            ext4-*.tar.gz
+            ext4-*.tar.gz.sha256
+            target/wheels/*.whl
+
+  sdist:
+    name: Build source distribution
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install maturin
+        run: pip install maturin
+
+      - name: Build sdist
+        run: maturin sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: target/wheels/*.tar.gz
+
+  release:
+    name: Release
+    needs: [build, sdist]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: actions/download-artifact@v4
+        with:
+          path: /tmp/artifacts
+
+      - name: Publish to crates.io
+        if: ${{ !inputs.dry_run && !inputs.skip_crates_io }}
+        run: cargo publish --locked
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+
+      - name: Test crates.io publish (dry run)
+        if: ${{ inputs.dry_run == true && !inputs.skip_crates_io }}
+        run: cargo publish --dry-run --locked
+
+      - name: Skip crates.io publishing
+        if: ${{ inputs.skip_crates_io == true }}
+        run: echo "Skipping crates.io publishing as requested"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Publish to PyPI
+        if: ${{ !inputs.dry_run && !inputs.skip_pypi }}
+        run: uv publish /tmp/artifacts/build-*/*.whl /tmp/artifacts/sdist/*.tar.gz
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+
+      - name: Test PyPI publish (dry run)
+        if: ${{ inputs.dry_run == true && !inputs.skip_pypi }}
+        run: |
+          echo "DRY RUN: Would upload to PyPI:"
+          find /tmp/artifacts/build-* -name "*.whl" -type f | sort
+          find /tmp/artifacts/sdist -name "*.tar.gz" -type f | sort
+          uv tool run twine check /tmp/artifacts/build-*/*.whl /tmp/artifacts/sdist/*.tar.gz
+
+      - name: Skip PyPI publishing
+        if: ${{ inputs.skip_pypi == true }}
+        run: echo "Skipping PyPI publishing as requested"
+
+      - name: Create GitHub Release
+        if: ${{ !inputs.dry_run && !inputs.skip_github_release }}
+        run: |
+          gh release create ${{ github.ref_name }} \
+            --title "${{ github.ref_name }}" \
+            --generate-notes \
+            /tmp/artifacts/build-*/*.tar.gz \
+            /tmp/artifacts/build-*/*.sha256
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Dry Run Summary
+        if: ${{ inputs.dry_run == true }}
+        run: |
+          echo "Dry run complete. Artifacts built but nothing published."
+          find /tmp/artifacts -type f | sort
+
+  update-homebrew:
+    name: Update Homebrew formula
+    needs: release
+    if: ${{ !inputs.dry_run && !inputs.skip_github_release }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: /tmp/artifacts
+
+      - name: Compute SHA256 hashes
+        id: hashes
+        run: |
+          for target in x86_64-apple-darwin aarch64-apple-darwin x86_64-unknown-linux-gnu aarch64-unknown-linux-gnu; do
+            sha=$(cat /tmp/artifacts/build-${target}/ext4-${{ github.ref_name }}-${target}.tar.gz.sha256 | awk '{print $1}')
+            key=$(echo "${target}" | tr '-' '_')
+            echo "${key}=${sha}" >> "$GITHUB_OUTPUT"
+          done
+
+      - name: Update Homebrew formula
+        env:
+          GH_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        run: |
+          VERSION="${{ github.ref_name }}"
+          VERSION_NUM="${VERSION#v}"
+
+          cat > /tmp/ext4.rb << 'FORMULA'
+          class Ext4 < Formula
+            desc "Read ext4 filesystems from image files and block devices"
+            homepage "https://github.com/rvben/ext4-cli"
+            version "VERSION_NUM"
+            license "MIT"
+
+            on_macos do
+              if Hardware::CPU.arm?
+                url "https://github.com/rvben/ext4-cli/releases/download/VERSION/ext4-VERSION-aarch64-apple-darwin.tar.gz"
+                sha256 "SHA_AARCH64_APPLE_DARWIN"
+              else
+                url "https://github.com/rvben/ext4-cli/releases/download/VERSION/ext4-VERSION-x86_64-apple-darwin.tar.gz"
+                sha256 "SHA_X86_64_APPLE_DARWIN"
+              end
+            end
+
+            on_linux do
+              if Hardware::CPU.arm?
+                url "https://github.com/rvben/ext4-cli/releases/download/VERSION/ext4-VERSION-aarch64-unknown-linux-gnu.tar.gz"
+                sha256 "SHA_AARCH64_UNKNOWN_LINUX_GNU"
+              else
+                url "https://github.com/rvben/ext4-cli/releases/download/VERSION/ext4-VERSION-x86_64-unknown-linux-gnu.tar.gz"
+                sha256 "SHA_X86_64_UNKNOWN_LINUX_GNU"
+              end
+            end
+
+            def install
+              bin.install "ext4"
+            end
+
+            test do
+              system "#{bin}/ext4", "--version"
+            end
+          end
+          FORMULA
+
+          sed -i "s/VERSION_NUM/${VERSION_NUM}/g" /tmp/ext4.rb
+          sed -i "s/VERSION/${VERSION}/g" /tmp/ext4.rb
+          sed -i "s/SHA_AARCH64_APPLE_DARWIN/${{ steps.hashes.outputs.aarch64_apple_darwin }}/g" /tmp/ext4.rb
+          sed -i "s/SHA_X86_64_APPLE_DARWIN/${{ steps.hashes.outputs.x86_64_apple_darwin }}/g" /tmp/ext4.rb
+          sed -i "s/SHA_AARCH64_UNKNOWN_LINUX_GNU/${{ steps.hashes.outputs.aarch64_unknown_linux_gnu }}/g" /tmp/ext4.rb
+          sed -i "s/SHA_X86_64_UNKNOWN_LINUX_GNU/${{ steps.hashes.outputs.x86_64_unknown_linux_gnu }}/g" /tmp/ext4.rb
+
+          git clone https://x-access-token:${GH_TOKEN}@github.com/rvben/homebrew-tap.git /tmp/tap
+          mkdir -p /tmp/tap/Formula
+          cp /tmp/ext4.rb /tmp/tap/Formula/ext4.rb
+          cd /tmp/tap
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/ext4.rb
+          git diff --cached --quiet || git commit -m "Update ext4 to ${VERSION}"
+          git push

ext4_cli-0.0.1/.gitignore

@@ -0,0 +1 @@
+/target

ext4_cli-0.0.1/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/).
+
+## [0.0.1] - 2026-04-13
+
+### Added
+
+- **cp**: extract files and directories from ext4 filesystem ([6f1c1a0](https://github.com/rvben/ext4-cli/commit/6f1c1a0a0b77d4e573ce73323317912c6fa656fe))
+- **cat**: stream file contents to stdout ([7331180](https://github.com/rvben/ext4-cli/commit/7331180d30af9ab8039cb6d53fc02bb239cd5405))
+- **stat**: show inode metadata for files and directories ([544b10e](https://github.com/rvben/ext4-cli/commit/544b10e3c48e8872651d9601ae43f912cf84e602))
+- **ls**: list ext4 directory contents with JSON support ([9a65503](https://github.com/rvben/ext4-cli/commit/9a655032fe0963f3e54243b2ae4bedb5b920d3d4))
+- **info**: show filesystem info via superblock parsing ([b420404](https://github.com/rvben/ext4-cli/commit/b4204041844b7b690ad8310cdc5495a8b705df7b))
+- **output**: mode formatting and JSON printer ([33a2497](https://github.com/rvben/ext4-cli/commit/33a24979f7ccd4d849b6b2721904da1c60c8ff78))
+- **source**: open ext4 image files and block devices ([6913ee9](https://github.com/rvben/ext4-cli/commit/6913ee9586c93ef81c6221fe316be6bb70884b88))
+
+### Fixed
+
+- **tests**: remove redundant serde_json import ([e41fb6e](https://github.com/rvben/ext4-cli/commit/e41fb6e7166472d26b1694a5ee3204031c6341e6))
+- **main**: collapse nested if-let for permission denied check ([a89b255](https://github.com/rvben/ext4-cli/commit/a89b2556cf5cf508b68b2707c6d702fb4918ff0f))
+- **source**: use sector-aligned reads for raw block device compatibility ([7183d50](https://github.com/rvben/ext4-cli/commit/7183d50dc3f29a0f02d4db253cf68899fbff99c7))
+- **ls**: classify all FileType variants correctly, add --all flag tests ([607c742](https://github.com/rvben/ext4-cli/commit/607c7429801d4410e028300cf448bc5361274bad))
+- **info**: correct metadata_csum bitmask, add gdt_csum/dir_nlink/extra_isize, safe block_size shift ([4d3b73d](https://github.com/rvben/ext4-cli/commit/4d3b73d4deb69e6c236ebe0e05c2e5a2fb071291))
+- **fixtures**: clean up partial images on failure ([9375a46](https://github.com/rvben/ext4-cli/commit/9375a465d8b14669662c177af03594f0941eca85))