Flaxe

An AS3 to Haxe conversion script.

AS3Haxe is an excellent tool that does more than this program does. However, it also can introduce subtle bugs in the code that cannot be detected until run-time. When this program was designed, the intent was to do most of the boilerplate conversion of AS3 sources to Haxe sources, and leave logic conversions to humans instead. While this project doesn't do as much, it only does things that cannot introduce errors. (At least that's the hope!)

For the most part, this program is a simple pattern replacement tool. Things like :Number => :Float, and Vector.<Int> => Vector<Int>;. For certain things, it will introduce a new import statement. You can find and extend the patterns in the Patterns.java file. If you create some useful new patterns, please submit a pull request or open an issue.

How to contact the maintainer:

• Bugs or other issues: https://github.com/EricBishton/Flaxe/Issues
• Releases: https://github.com/EricBishton/Flaxe/Releases
• Source code: https://github.com/EricBishton/Flaxe

Usage

Pre-requisites:

This tool is implemented in Java. Therefore, you must have Java 8 or later installed.

Running the program:

Usage: flaxe.jar <action> <as3-source-folder> <haxe-destination-folder>

Where:

• <action> is one of rename, convert:
  • rename means to only rename .as file extensions to .hx
  • convert means to rename file extensions, and convert file contents by replacing recognized patterns with Haxe replacements.
• <as3-source-folder> is the root directory containing actionscript 3 files to convert.
  All .as source files inside of this directory and sub-directories will be processed.
• <haxe-destination-folder> is the target directory where the conversion results should be placed.

The program will refuse to run if the <haxe-destination-folder> exists prior to start. There is currently no functionality to merge directories or detect file collisions.

Doing a conversion run:

The general command line will be similar to this:

java -jar flaxe.jar convert D:\Development\FlashProject\Sources\ D:\Development\HaxeProject\Sources\

Building:

This project is built using gradle. If you have gradle installed, you may build using the gradlew assemble. The output jar will be under your project directory in the build\libs\flaxe.jar file.