Skip to content

Latest commit

 

History

History
91 lines (69 loc) · 3.24 KB

README.md

File metadata and controls

91 lines (69 loc) · 3.24 KB
Raw

FBuilder

It's a light tool written in Haxe that uses SWHX and that helps to work on multiple targets with several build scripts.

It displays buttons for the targets defined in your xml project file and when clicked, it runs the defined script, written in hscript.

Screenshot 1

Project xml file

A project file looks like that :

<!--<fbuilder always-on-top="false" taskbar="true" stick-edge="50">-->
<fbuilder>
	<target name="hss" color="#FFFF00"><![CDATA[
		execute( "hss.exe", [ "-output", "www/css/", "src/hss/default.hss" ] );
	]]></target>
	<target name="templo" color="#00FF00"><![CDATA[
		var err	= "";
		var out	= "";
		for( i in [ "login", "shell", "news", "media", "album", "picture", "live" ] ){
			var p	= new sys.io.Process( "temploc2.exe", [ i + ".mtt", "-cp", "src/mtt", "-output", "www/tpl", "-macros", "macro.mtt" ] );
			out	+= p.stdout.readAll().toString();
			err	+= p.stderr.readAll().toString();
		}
		{ out : out, err : err }
	]]></target>
	<target name="neko" color="#FF0000"><![CDATA[
		execute( "haxe", [ "neko.hxml" ] );
	]]></target>
	<target name="js" color="#0000FF"><![CDATA[
		execute( "haxe", [ "js.hxml" ] );
	]]></target>
	<target name="notepad" color="#FF00FF"><![CDATA[
		command( "c:/Windows/notepad.exe", [] );
	]]></target>
	<target name="test" color="#FFFFFF"><![CDATA[
		"The last line in the script is the console output ! :)";
	]]></target>
	<target name="test2" color="#999999"><![CDATA[
		var rd	= sys.FileSystem.readDirectory( "." );
		var a	= [];
		for( i in rd ){
			if( StringTools.endsWith( i, ".log" ) ){
				sys.io.File.copy( i, "_old_" + i );
				a.push( i );
			}
		}
		a;
	]]></target>
</fbuilder>

Scripting

Inside the CData node, you write your hscript that will be executed once the button clicked.

These things are available in the hscript context :

  • StringTools
  • Sys
  • sys.FileSystem
  • sys.io.File
  • sys.io.Process

And 3 shortcut functions :

  • process( cmd : String, args : Array ) : { out : String, err : String }
  • execute( cmd : String, args : Array ) : { out : String, err : String }
  • command( cmd : String, args : Array, keepPrompt = false ) : Void

The process and execute functions are the same. They run a background process and display stdout & stderr.

The command function launches a program in a separated Thread with or without the prompt. It was not done for that at the begining but it can help anyway.

How to use it

Yu must specify a project file as argument so the program must be called from command line like that :

FBuilder project.fbxml

Windows installation

Edit install-file-extension.reg and modify the location of the binary. Then Launch the .reg to register .fbxml as FBuilder project file. So you'll be able to open and build your .fbxml project from Windows' explorer.

Building from sources

You'll need these modified libs in order to build from sources Haxe 3 compatibles :