feat: add decoder implementation

Author: Ariel Ben-Yehuda

.github/workflows/build-decoder.yml

@@ -0,0 +1,24 @@
+name: Build (decoder)
+on: [pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      RUST_BACKTRACE: 1
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: stable
+      - uses: Swatinem/rust-cache@v2
+        with:
+          cache-directories: decoder
+      - name: Build
+        working-directory: decoder
+        shell: bash
+        run: cargo build --all-features --verbose
+      - name: Run tests
+        working-directory: decoder
+        shell: bash
+        run: cargo test --all-features --verbose

.github/workflows/format.yml

@@ -15,6 +15,11 @@ jobs:
         id: cargoFmt
         shell: bash
         run: cargo fmt --all -- --check
+      - name: Run fmt check - decoder
+        id: cargoFmtDecoder
+        shell: bash
+        working-directory: decoder
+        run: cargo fmt --all -- --check
   clippy:
     name: Cargo clippy
     runs-on: ubuntu-latest
@@ -26,3 +31,17 @@ jobs:
         id: cargoClippy
         shell: bash
         run: cargo clippy --workspace --all-features -- -D warnings
+  clippyDecoder:
+    name: Cargo clippy (decoder)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+        with:
+          cache-directories: decoder
+      - name: Run clippy check - decoder
+        id: cargoClippyDecoder
+        shell: bash
+        working-directory: decoder
+        run: cargo clippy --workspace --all-features -- -D warnings

.gitignore

@@ -1 +1,2 @@
 /target
+/decoder/target

CONTRIBUTING.md

@@ -57,8 +57,6 @@ Then make a new PR for the release and get it approved.
 
 The automated release PR generation functionality is not used here.
 
-This requires a crates.io token in GitHub secrets for the repo. Currently the "token" is literally the string `secret` but I will put a more realistic token once the repo is public. 
-
 [conventional commits]: https://www.conventionalcommits.org/en/v1.0.0/
 
 ## Code of Conduct

Cargo.lock

@@ -84,6 +84,16 @@ emit `tokio.PollCatchV1` events this way:
     }
 ```
 
+## Decoder
+
+The `decoder` directory in the Git repository contains a decoder that can be used to view JFR files, especially with PollCatch information.
+
+The decoder is NOT intended right now to be used in production. In particular, it uses the [`jfrs`] crate for parsing `.jfr` files, and while that crate seems to be purely safe Rust, to my knowledge it has not been audited for security and probably contains at least denial-of-service issues if not worse.
+
+If you want to use the decoder for anything but debugging on trusted `.jfr` files, you bear full responsibility for the consequences.
+
+[`jfrs`]: https://docs.rs/jfrs
+
 ## Security
 
 See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.