refactor: rename package io.github.dfa1.zstdffm -> io.github.dfa1.zstd

dfa1 · claude · dfa1 · commit 1ddd4741310d · 2026-06-25T22:55:52.000+02:00
Drop the ffm suffix from the Java package. Moves all main/test sources and the
benchmark module's bench package; updates CLAUDE.md and docs/compatibility.md.
Maven coordinate (zstd-java) and the native resource path are unaffected.

76 tests green.

Co-Authored-By: Claude Opus 4.8 &lt;noreply@anthropic.com&gt;
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -12,7 +12,7 @@ already off-heap (e.g. an mmap slice in, an arena buffer out).
 Multi-module Maven build (`io.github.dfa1:zstd-java`):
 
 - `zstd/` — the library module, artifactId `zstd-java`, pure-Java FFM bindings
-  (package `io.github.dfa1.zstdffm`). The only module with Java sources.
+  (package `io.github.dfa1.zstd`). The only module with Java sources.
 - `native/<classifier>/` — one module per platform; each packages a
   `libzstd.{dylib,so,dll}` built from the `third_party/zstd` submodule. No Java.
   Classifiers: `osx-aarch64`, `osx-x86_64`, `linux-x86_64`, `linux-aarch64`,
diff --git a/benchmark/src/main/java/io/github/dfa1/zstd/bench/BenchData.java b/benchmark/src/main/java/io/github/dfa1/zstd/bench/BenchData.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm.bench;
+package io.github.dfa1.zstd.bench;
 
 import java.util.Random;
 
diff --git a/benchmark/src/main/java/io/github/dfa1/zstd/bench/CompressBenchmark.java b/benchmark/src/main/java/io/github/dfa1/zstd/bench/CompressBenchmark.java
@@ -1,10 +1,10 @@
-package io.github.dfa1.zstdffm.bench;
+package io.github.dfa1.zstd.bench;
 
 import static java.lang.foreign.ValueLayout.JAVA_BYTE;
 
 import io.airlift.compress.v3.zstd.ZstdJavaCompressor;
-import io.github.dfa1.zstdffm.Zstd;
-import io.github.dfa1.zstdffm.ZstdCompressCtx;
+import io.github.dfa1.zstd.Zstd;
+import io.github.dfa1.zstd.ZstdCompressCtx;
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
 import java.util.concurrent.TimeUnit;
diff --git a/benchmark/src/main/java/io/github/dfa1/zstd/bench/DecompressBenchmark.java b/benchmark/src/main/java/io/github/dfa1/zstd/bench/DecompressBenchmark.java
@@ -1,10 +1,10 @@
-package io.github.dfa1.zstdffm.bench;
+package io.github.dfa1.zstd.bench;
 
 import static java.lang.foreign.ValueLayout.JAVA_BYTE;
 
 import io.airlift.compress.v3.zstd.ZstdJavaDecompressor;
-import io.github.dfa1.zstdffm.Zstd;
-import io.github.dfa1.zstdffm.ZstdDecompressCtx;
+import io.github.dfa1.zstd.Zstd;
+import io.github.dfa1.zstd.ZstdDecompressCtx;
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
 import java.util.concurrent.TimeUnit;
diff --git a/docs/compatibility.md b/docs/compatibility.md
@@ -1,6 +1,6 @@
 # Symbol compatibility
 
-Coverage of the zstd C API by the `io.github.dfa1.zstdffm` bindings. Signatures
+Coverage of the zstd C API by the `io.github.dfa1.zstd` bindings. Signatures
 and semantics follow the [official manual](https://facebook.github.io/zstd/doc/api_manual_latest.html).
 
 - zstd version: **1.6.0** (vendored `third_party/zstd`)
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/Bindings.java b/zstd/src/main/java/io/github/dfa1/zstd/Bindings.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.lang.foreign.FunctionDescriptor;
 import java.lang.invoke.MethodHandle;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/NativeLibrary.java b/zstd/src/main/java/io/github/dfa1/zstd/NativeLibrary.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.io.IOException;
 import java.io.InputStream;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/NativeObject.java b/zstd/src/main/java/io/github/dfa1/zstd/NativeObject.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.lang.foreign.MemorySegment;
 import java.util.concurrent.atomic.AtomicReference;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/Zstd.java b/zstd/src/main/java/io/github/dfa1/zstd/Zstd.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdCompressCtx.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdCompressCtx.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdCompressDict.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdCompressDict.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdCompressParameter.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdCompressParameter.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 /// Advanced compression parameters settable on a [ZstdCompressCtx], mirroring
 /// `ZSTD_cParameter` from the
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdDecompressCtx.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdDecompressCtx.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdDecompressDict.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdDecompressDict.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdDictionary.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdDictionary.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdErrorCode.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdErrorCode.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 /// Categories of zstd error, exposed by [ZstdException#code()] so callers can
 /// branch on the kind of failure (e.g. distinguish [#CHECKSUM_WRONG] from
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdException.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdException.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 /// Thrown when a zstd native call reports an error.
 ///
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdFrame.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdFrame.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdFrameHeader.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdFrameHeader.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.util.OptionalLong;
 
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdFrameType.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdFrameType.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 /// The kind of a zstd frame, from `ZSTD_FrameType_e`.
 public enum ZstdFrameType {
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdInputStream.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdInputStream.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.io.IOException;
 import java.io.InputStream;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdOutputStream.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdOutputStream.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.io.IOException;
 import java.io.OutputStream;
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdSkippableContent.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdSkippableContent.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 /// The decoded payload of a skippable frame, returned by
 /// [ZstdFrame#readSkippableFrame(byte[])].
diff --git a/zstd/src/main/java/io/github/dfa1/zstd/ZstdStreamBuffer.java b/zstd/src/main/java/io/github/dfa1/zstd/ZstdStreamBuffer.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.lang.foreign.Arena;
 import java.lang.foreign.MemorySegment;
diff --git a/zstd/src/test/java/io/github/dfa1/zstd/RandomArrays.java b/zstd/src/test/java/io/github/dfa1/zstd/RandomArrays.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import java.util.Random;
 import java.util.stream.IntStream;
diff --git a/zstd/src/test/java/io/github/dfa1/zstd/ZstdDictionaryTest.java b/zstd/src/test/java/io/github/dfa1/zstd/ZstdDictionaryTest.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import org.junit.jupiter.api.BeforeAll;
 import org.junit.jupiter.api.Nested;
diff --git a/zstd/src/test/java/io/github/dfa1/zstd/ZstdErrorTest.java b/zstd/src/test/java/io/github/dfa1/zstd/ZstdErrorTest.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
diff --git a/zstd/src/test/java/io/github/dfa1/zstd/ZstdFrameTest.java b/zstd/src/test/java/io/github/dfa1/zstd/ZstdFrameTest.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
diff --git a/zstd/src/test/java/io/github/dfa1/zstd/ZstdParameterTest.java b/zstd/src/test/java/io/github/dfa1/zstd/ZstdParameterTest.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
diff --git a/zstd/src/test/java/io/github/dfa1/zstd/ZstdSegmentTest.java b/zstd/src/test/java/io/github/dfa1/zstd/ZstdSegmentTest.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
diff --git a/zstd/src/test/java/io/github/dfa1/zstd/ZstdStreamTest.java b/zstd/src/test/java/io/github/dfa1/zstd/ZstdStreamTest.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
diff --git a/zstd/src/test/java/io/github/dfa1/zstd/ZstdTest.java b/zstd/src/test/java/io/github/dfa1/zstd/ZstdTest.java
@@ -1,4 +1,4 @@
-package io.github.dfa1.zstdffm;
+package io.github.dfa1.zstd;
 
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
@@ -17,7 +17,7 @@ class ZstdTest {
     class RoundTrip {
 
         @ParameterizedTest
-        @MethodSource("io.github.dfa1.zstdffm.RandomArrays#bytes")
+        @MethodSource("io.github.dfa1.zstd.RandomArrays#bytes")
         void preservesArbitraryBytes(byte[] original) {
             // Given a payload and its compressed frame
             byte[] frame = Zstd.compress(original);
@@ -58,7 +58,7 @@ void shrinksCompressibleInput() {
     class Levels {
 
         @ParameterizedTest
-        @MethodSource("io.github.dfa1.zstdffm.RandomArrays#levels")
+        @MethodSource("io.github.dfa1.zstd.RandomArrays#levels")
         void roundTripAtEveryLevel(int level) {
             // Given a payload compressed at the given level
             byte[] original = "payload-data-".repeat(500).getBytes(StandardCharsets.UTF_8);

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-package io.github.dfa1.zstdffm.bench;`
	`1`	`+package io.github.dfa1.zstd.bench;`
`2`	`2`
`3`	`3`	`import java.util.Random;`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-package io.github.dfa1.zstdffm;`
	`1`	`+package io.github.dfa1.zstd;`
`2`	`2`
`3`	`3`	`import java.lang.foreign.FunctionDescriptor;`
`4`	`4`	`import java.lang.invoke.MethodHandle;`