diff --git a/src/test/fixtures/README.md b/src/test/fixtures/README.md new file mode 100644 index 0000000..fcc5d5e --- /dev/null +++ b/src/test/fixtures/README.md @@ -0,0 +1,7 @@ +# Precompiled compatibility fixtures + +Sources below this directory document binary consumers compiled against the untouched `1.7.12` reference dev jar. They are not part of a Gradle source set and must not be recompiled against the current project during normal tests. + +`ReferenceScalaPartialOcclusion.scala` was compiled with Scala 2.11.5 against reference revision `f10595d062bfc1e6dd57a5320fb5b48c383a4f38` and dev jar SHA-256 `bc6e06a01ca8a50b7532aa7d173895c9e89bd2989e43ed977e9eddd3adba57a5`. Its class-file SHA-256 is `c29f2fe296d0a50352b1de1d12ab7a95ac75848a14352ddae06b7aa9640d404a`. + +The class is stored as `src/test/resources/compat/ReferenceScalaPartialOcclusion.class.b64` so the repository retains a fixed binary compiled against the reference API. The test decodes and defines that class directly; compiling the documented source against the port would invalidate the compatibility check. diff --git a/src/test/fixtures/scala/codechicken/multipart/compat/ReferenceScalaPartialOcclusion.scala b/src/test/fixtures/scala/codechicken/multipart/compat/ReferenceScalaPartialOcclusion.scala new file mode 100644 index 0000000..e5acd81 --- /dev/null +++ b/src/test/fixtures/scala/codechicken/multipart/compat/ReferenceScalaPartialOcclusion.scala @@ -0,0 +1,11 @@ +package codechicken.multipart.compat + +import java.util.Collections + +import codechicken.lib.vec.Cuboid6 +import codechicken.multipart.JPartialOcclusion + +final class ReferenceScalaPartialOcclusion extends JPartialOcclusion { + override def getPartialOcclusionBoxes: java.lang.Iterable[Cuboid6] = + Collections.emptyList[Cuboid6]() +} diff --git a/src/test/java/codechicken/multipart/JPartialOcclusionBinaryCompatibilityTest.java b/src/test/java/codechicken/multipart/JPartialOcclusionBinaryCompatibilityTest.java new file mode 100644 index 0000000..901f5c1 --- /dev/null +++ b/src/test/java/codechicken/multipart/JPartialOcclusionBinaryCompatibilityTest.java @@ -0,0 +1,47 @@ +package codechicken.multipart; + +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import java.util.Base64; +import java.util.Objects; +import java.util.Scanner; + +import org.junit.jupiter.api.Test; + +class JPartialOcclusionBinaryCompatibilityTest { + + @Test + void loadsScalaImplementorCompiledAgainstReferenceJar() throws Exception { + byte[] bytecode = loadFixture(); + Class fixtureClass = new FixtureClassLoader(JPartialOcclusion.class.getClassLoader()).define(bytecode); + Object fixture = fixtureClass.getDeclaredConstructor().newInstance(); + + assertTrue(fixture instanceof JPartialOcclusion); + JPartialOcclusion part = (JPartialOcclusion) fixture; + assertFalse(part.allowCompleteOcclusion()); + assertFalse(part.getPartialOcclusionBoxes().iterator().hasNext()); + } + + private static byte[] loadFixture() { + InputStream input = Objects.requireNonNull( + JPartialOcclusionBinaryCompatibilityTest.class + .getResourceAsStream("/compat/ReferenceScalaPartialOcclusion.class.b64")); + try (Scanner scanner = new Scanner(input, StandardCharsets.US_ASCII.name()).useDelimiter("\\A")) { + return Base64.getMimeDecoder().decode(scanner.next()); + } + } + + private static final class FixtureClassLoader extends ClassLoader { + + private FixtureClassLoader(ClassLoader parent) { + super(parent); + } + + private Class define(byte[] bytecode) { + return defineClass(null, bytecode, 0, bytecode.length); + } + } +} diff --git a/src/test/resources/compat/ReferenceScalaPartialOcclusion.class.b64 b/src/test/resources/compat/ReferenceScalaPartialOcclusion.class.b64 new file mode 100644 index 0000000..1b9fe06 --- /dev/null +++ b/src/test/resources/compat/ReferenceScalaPartialOcclusion.class.b64 @@ -0,0 +1 @@ +yv66vgAAADIALAEAO2NvZGVjaGlja2VuL211bHRpcGFydC9jb21wYXQvUmVmZXJlbmNlU2NhbGFQYXJ0aWFsT2NjbHVzaW9uBwABAQAQamF2YS9sYW5nL09iamVjdAcAAwEAJ2NvZGVjaGlja2VuL211bHRpcGFydC9KUGFydGlhbE9jY2x1c2lvbgcABQEAJFJlZmVyZW5jZVNjYWxhUGFydGlhbE9jY2x1c2lvbi5zY2FsYQEAHkxzY2FsYS9yZWZsZWN0L1NjYWxhU2lnbmF0dXJlOwEABWJ5dGVzAQFMBgExMkEhAQIDEwlxIisaNGZlFnQ3LVoqZEMyDAcrGTp1UwZkd2pZMm1rTkx3ThwGAwcRCWFhWThuYQYkKEJBAwcDJWlXDxw7amEGFEhPQwEIAy0Zdw5aM2RRJhw3Lho4BAFNGQFBAwkRBS1xUSIBBwsDNQlRYV0yYlkGTCFhBAcDDQVzF1BVM2chCQkiI0QBBRMJGUJBQQlLIQYUSC9bMW0fDhxHLl46al86RFEhBgEFAlkJYQFQNW9TUnREI0EMEQVhAVEiAQIJC2kBQRFJDgIxHSxHD1Uxc2kmDEduVDJkWVYcGG4cOENfYiw3L0YBHSENaSIFSgcCPSkRcQRJAQVZBnR3TUMBIgMRURdNXjEKBQ1yIgFDJXVLSgwnDVwzEQUVUlMiARQLBR1CE2EBPGZHKhERRkIBBFkmFBdCQRYnBR0ZVU9ZOGpJWgIBABZhbGxvd0NvbXBsZXRlT2NjbHVzaW9uAQADKClaAQAtY29kZWNoaWNrZW4vbXVsdGlwYXJ0L0pQYXJ0aWFsT2NjbHVzaW9uJGNsYXNzBwANAQAsKExjb2RlY2hpY2tlbi9tdWx0aXBhcnQvSlBhcnRpYWxPY2NsdXNpb247KVoMAAsADwoADgAQAQAEdGhpcwEAPUxjb2RlY2hpY2tlbi9tdWx0aXBhcnQvY29tcGF0L1JlZmVyZW5jZVNjYWxhUGFydGlhbE9jY2x1c2lvbjsBABhnZXRQYXJ0aWFsT2NjbHVzaW9uQm94ZXMBABYoKUxqYXZhL2xhbmcvSXRlcmFibGU7AQAVamF2YS91dGlsL0NvbGxlY3Rpb25zBwAWAQAJZW1wdHlMaXN0AQASKClMamF2YS91dGlsL0xpc3Q7DAAYABkKABcAGgEABjxpbml0PgEAAygpVgwAHAAdCgAEAB4BAAYkaW5pdCQBACwoTGNvZGVjaGlja2VuL211bHRpcGFydC9KUGFydGlhbE9jY2x1c2lvbjspVgwAIAAhCgAOACIBAARDb2RlAQASTG9jYWxWYXJpYWJsZVRhYmxlAQAPTGluZU51bWJlclRhYmxlAQAJU2lnbmF0dXJlAQA1KClMamF2YS9sYW5nL0l0ZXJhYmxlPExjb2RlY2hpY2tlbi9saWIvdmVjL0N1Ym9pZDY7PjsBAApTb3VyY2VGaWxlAQAZUnVudGltZVZpc2libGVBbm5vdGF0aW9ucwEACFNjYWxhU2lnADEAAgAEAAEABgAAAAMAAQALAAwAAQAkAAAALwABAAEAAAAFKrgAEawAAAACACUAAAAMAAEAAAAFABIAEwAAACYAAAAGAAEAAAAIAAEAFAAVAAIAJAAAAC4AAQABAAAABLgAG7AAAAACACUAAAAMAAEAAAAEABIAEwAAACYAAAAGAAEAAAAKACcAAAACACgAAQAcAB0AAQAkAAAAMwABAAEAAAAJKrcAHyq4ACOxAAAAAgAlAAAADAABAAAACQASABMAAAAmAAAABgABAAAACAADACkAAAACAAcAKgAAAAsAAQAIAAEACXMACgArAAAAAwUAAA==