dircat 0.1.0

High-performance Rust utility that concatenates and displays directory contents, similar to the C++ DirCat.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

name: Release

on:
  push:
    tags:
      - 'v*.*.*' # Trigger on tags like v0.1.0, v1.2.3

permissions:
  contents: write # Needed to create releases and upload assets

env:
  CARGO_TERM_COLOR: always
  BINARY_NAME: dircat
  STAGING_DIR: staging

jobs:
  build-release:
    name: Build Release Binaries (${{ matrix.target }})
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        include:
          # Linux (GNU) - tar.gz archive
          - os: ubuntu-latest
            target: x86_64-unknown-linux-gnu
            bin_suffix: ""
            archive_format: tar.gz
            archive_command: |

              tar czf "$ARCHIVE_NAME" -C "$STAGING_DIR" .
            archive_shell: bash # Keep for reference, but not used in shell: key

          # macOS (Intel x86_64) - tar.gz archive
          - os: macos-latest
            target: x86_64-apple-darwin
            bin_suffix: ""
            archive_format: tar.gz
            archive_command: |

              tar czf "$ARCHIVE_NAME" -C "$STAGING_DIR" .
            archive_shell: bash # Keep for reference, but not used in shell: key

          # macOS (Apple Silicon arm64) - tar.gz archive
          - os: macos-14
            target: aarch64-apple-darwin
            bin_suffix: ""
            archive_format: tar.gz
            archive_command: |

              tar czf "$ARCHIVE_NAME" -C "$STAGING_DIR" .
            archive_shell: bash # Keep for reference, but not used in shell: key

          # Windows (MSVC x86_64) - zip archive
          - os: windows-latest
            target: x86_64-pc-windows-msvc
            bin_suffix: ".exe"
            archive_format: zip
            archive_command: |

              Compress-Archive -Path "$($env:STAGING_DIR)\*" -DestinationPath "$env:ARCHIVE_NAME"
            archive_shell: pwsh # Keep for reference, but not used in shell: key

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Install Rust toolchain (stable)
        uses: actions-rust-lang/setup-rust-toolchain@v1
        with:
          toolchain: stable
          target: ${{ matrix.target }}
          cache: 'cargo'

      - name: Build release binary
        run: cargo build --release --target ${{ matrix.target }} --verbose

      - name: Prepare archive name
        id: prepare_archive_name # Step ID remains
        run: |

          # Calculate the filename
          archive_filename="${{ env.BINARY_NAME }}-${{ github.ref_name }}-${{ matrix.target }}.${{ matrix.archive_format }}"
          # Set environment variable for subsequent run steps (like packaging)
          echo "ARCHIVE_NAME=${archive_filename}" >> $GITHUB_ENV
          # Set step output using the new method for use in action inputs
          echo "archive_filename=${archive_filename}" >> $GITHUB_OUTPUT
        shell: bash

      - name: Create staging directory
        run: mkdir ${{ env.STAGING_DIR }}
        shell: bash

      - name: Copy binary to staging directory
        run: |

          set -e
          cp target/${{ matrix.target }}/release/${{ env.BINARY_NAME }}${{ matrix.bin_suffix }} ${{ env.STAGING_DIR }}/
        shell: bash

      - name: Copy documentation and license files to staging directory
        # Copy only LICENSE and README.md, not COMMIT.md
        run: |

          set -e
          cp LICENSE ${{ env.STAGING_DIR }}/
          cp README.md ${{ env.STAGING_DIR }}/
        shell: bash

      - name: List staging directory contents (for debugging)
        run: ls -R ${{ env.STAGING_DIR }}
        shell: bash

      - name: Package release artifacts from staging directory
        run: ${{ matrix.archive_command }}
        # No shell: key needed here

      - name: Upload release asset
        uses: actions/upload-artifact@v4
        with:
          # Use a unique name for each artifact based on the target
          name: release-asset-${{ matrix.target }}
          # Use the output from the 'prepare_archive_name' step
          path: ${{ steps.prepare_archive_name.outputs.archive_filename }}

  create-release:
    name: Create GitHub Release
    needs: build-release
    runs-on: ubuntu-latest

    steps:
      - name: Download all release assets
        uses: actions/download-artifact@v4
        with:
          # No 'name' specified, download all artifacts from the run
          path: release-assets # All downloaded artifacts will land here

      - name: List downloaded files (for debugging)
        run: ls -R release-assets

      - name: Create Release and Upload Assets
        uses: softprops/action-gh-release@v2
        with:
          tag_name: ${{ github.ref_name }}
          name: Release ${{ github.ref_name }}
          generate_release_notes: true
          files: release-assets/*/*
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}