Turbobuilder NPM

TurboBuilder

Command line tool with a massive amount of features to help with daily development tasks: build projects, run unit tests, generate docs, upload to ftp, compress images, detect duplicate code, force copyright headers, and many more features

Main features

Runs via node command line
Totally configurable with a single turbobuilder.json setup file
Build projects with several languages: JavaScript, Typescript, Php, Css, Java
Covers the whole project development cycle: Build, deploy, validate, test and generate a production release

Build features

Improved node cmd projects building process
Compiles source code for several modern languages
Compile turbosite projects to create fully featured websites or webservices
Compile php libraries as a single phar file
Compile java libraries as a single jar file
Compile js libraries as a single .js file (generate the ES4, ES5 and ES6 versions at the same time)
Compile typescript libraries with output to typescript, ES5, ES6, etc...
Improved building process for Angular applications (typescript)
Improved building process for Angular libraries (typescript)
Automatic version number generation
Generates a 'target' folder containing all the results of the build

Deploy features

The following deploy operations can be enabled and customized via the turbobuilder.json setup file:

Automatically upload the compiled project files into a remote ftp location
Automatically copy the compiled project files into a local folder location

Validate features

The following validations can be customized via the turbobuilder.json setup file:

Automatic project structure and conventions validation
Prevent the existence of tabulation characters on the project files
Detect copy pasted code on the project and launch build warnings or build errors if necessary
Verify that all project source code files have all the same copyright header based on a template
Perform extra validation rules to css style sheets as part of the build process
Namespace validation for the languages that support it (Make sure all the declared namespaces follow the same rules)
Force use strict on all javascript files
Several custom extra validations for angular applications

Test features

Run unit tests as part of the build process (for supported languages)
Execute php unit tests with the PhpUnit library
Execute javascript unit tests with the jasmine library
Execute javascript unit tests with the Qunit library

Release features

Automatic merging of all the project javascript or typescript files to a single .js
Php phar generation
Java jar generation
Typescript transpilation to one or more javascript language versions at the same time
Js, css, html and php minification
Generate git changelog as part of the production release compilation
Automatic images compression and optimitzation for jpg and png files
Generate project documentation automatically for several languages: Php, Typescript, ...

How to use it

Install the cmd tool

TurboBuilder is based on nodejs but you only need basic terminal command line execution knowledge to run it. To install the turbobuilder cmd executable, follow these steps:

Install the latest NodeJs version on your computer
Open a terminal and run npm install -g turbobuilder to get the latest version

Generate a new empty project

TODO

Turbobuilder expected project structure

For the turbobuilder application to work, it expects to be run on a project that matches the following structure:

MyProjectFolder
│   turbobuilder.json
│
├───extras
│   ├───help
│   └───todo
├───src
│   ├───main
│   └───test

Configure the turbobuilder.json file on for the project

TODO

Validate the project

TODO

Build the project

TODO

Test the project

TODO

Generate a release production version of the project

TODO

Support

TurboBuilder is 100% free and open source, but we will be really pleased to receive any help, support, comments or donations to improve it. If you find any bug on your enviroment or OS, please tell us so we can improve the tool.