WPILib 2027 Migrator

A tool for automatically migrating 2026 WPILib Java projects to WPILib 2027 Alpha 6.

⚠️ This tool modifies your source code directly. Commit or back up your project before running it.

⚠️ This tool is not perfect and may make mistakes. It does not include all changes from 2026 to 2027 Alpha, please feel free to make a PR to add one.

Usage

The easiest way to use the migrator is to download the JAR from the Releases page.

1. Download wpilib-migrator-1.0.0.jar.
2. Place it in your robot project's root directory.
3. Run the following command from your project directory:

java -jar wpilib-migrator-1.0.0.jar src/main

The final argument is the path to the project/source directory you want to migrate. It can be any valid relative or absolute path.

Effectiveness

Version 1.0.0 was tested across three 2026 codebases.

Codebase	Errors after initial import	Errors after migration
3476	366	15
Codebase A	392	103
Codebase B	374	107

Development

To build the migrator from source, clone the repository:

git clone https://github.com/FRC3476/2027-Migrator.git
cd 2027-Migrator

Then build the executable JAR:

./gradlew shadowJar

The resulting JAR will be located in:

build/libs/wpilib-migrator-1.0.0.jar

Adding a Migration

Migrations are located in:

src/main/java/migrator/migrations/

To add a new migration:

1. Create a migration class.
2. Implement or extend the appropriate migration abstraction.
3. Add the migration to the list of migrations in Main.java.
4. Test and verify.