Merge branch 'release-0.3'

.github/workflows/build.yml

@@ -0,0 +1,14 @@
+name: build
+on: [push]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 21
+        uses: actions/setup-java@v1
+        with:
+          java-version: 21
+      - name: Build with Maven
+        run: mvn --batch-mode --update-snapshots verify

.gitignore

@@ -1,3 +1,8 @@
-*.class
-*.jar
+.classpath
+.project
+.settings
+.DS_Store
+bin
+build
+target
 *~

CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+This project adheres to [Semantic
+Versioning](https://semver.org/spec/v2.0.0.html).
+
+## Release 0.3 (2024-03-31)
+### Changed
+- Migrated to Maven for builds. This included setting up the test
+  suite via JUnit. [#10](https://github.com/paulhoadley/pal/issues/10)
+- Reduced reliance on `System.exit()` (outside of `main()`), largely
+  to facilitate
+  testing. [#11](https://github.com/paulhoadley/pal/issues/11)

README.markdown → README.md

@@ -1,3 +1,6 @@
+![](https://github.com/paulhoadley/pal/workflows/build/badge.svg)
+[![License](https://img.shields.io/badge/License-BSD-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+
 The PAL Abstract Machine—An implementation in Java
 ==================================================
 

pom.xml

@@ -0,0 +1,97 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>net.logicsquad</groupId>
+  <artifactId>pal</artifactId>
+  <version>0.3</version>
+  <packaging>jar</packaging>
+  <name>PAL</name>
+  <description>The PAL Abstract Machine—An implementation in Java.</description>
+  <inceptionYear>2002</inceptionYear>
+
+  <organization>
+    <name>Logic Squad</name>
+    <url>https://logicsquad.net/</url>
+  </organization>
+
+  <properties>
+    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <maven.compiler.source>21</maven.compiler.source>
+    <maven.compiler.target>21</maven.compiler.target>
+  </properties>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <configuration>
+          <archive>
+            <manifest>
+              <addClasspath>true</addClasspath>
+              <mainClass>net.logicsquad.pal.PAL</mainClass>
+            </manifest>
+          </archive>
+        </configuration>
+      </plugin>
+      <plugin>
+        <artifactId>maven-surefire-plugin</artifactId>
+        <version>3.2.5</version>
+        <configuration>
+          <forkCount>1</forkCount>
+          <reuseForks>false</reuseForks>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-javadoc-plugin</artifactId>
+        <version>3.6.3</version>
+        <configuration>
+          <additionalJOption>-Xdoclint:none</additionalJOption>
+          <detectLinks />
+          <show>private</show>
+        </configuration>
+        <executions>
+          <execution>
+            <id>build-javadocs</id>
+            <phase>package</phase>
+            <goals>
+              <goal>javadoc</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+      <plugin>
+        <artifactId>maven-project-info-reports-plugin</artifactId>
+        <version>3.5.0</version>
+      </plugin>
+    </plugins>    
+  </build>
+
+  <dependencyManagement>
+    <dependencies>
+      <dependency>
+        <groupId>org.junit</groupId>
+        <artifactId>junit-bom</artifactId>
+        <version>5.10.2</version>
+        <type>pom</type>
+        <scope>import</scope>
+      </dependency>
+    </dependencies>
+  </dependencyManagement>
+
+  <dependencies>
+    <dependency>
+      <groupId>org.apache.logging.log4j</groupId>
+      <artifactId>log4j-slf4j2-impl</artifactId>
+      <version>2.22.1</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter</artifactId>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>