Skip to content

Latest commit

 

History

History
190 lines (133 loc) · 4.31 KB

README.md

File metadata and controls

190 lines (133 loc) · 4.31 KB
Raw

rmk

rmk is a software construction tool with a mix of features of make, rake maven, Scons and gradle. Unlike these tools rmk follows the idea that translation rules are not configured but implemented like normal code. Make targets become simple method calls. All configuration parameters are passed explicitly.

Features

  • Fast incremental builds
  • Build scripts are written in Ruby
  • Support for Java projects
  • Support for C++ projects
  • Automatic dependency management for C and C++
  • Support for maven dependencies
  • Advanced project dependencies using normal Ruby method calls
  • Support for parallel builds
  • Extremely fast (Delta build with 10000 files without changes in less than 1 second)
  • Share built files in a cache
  • Cross-platform builds on Linux, Mac OS X and Windows

Installation

sudo gem install rmk

C++ Example

plugin 'gnu' # Load gnu Toolchain

def compile_cpp()
  cc(glob("*.cpp"),[]) # Compile all cpp files in the current directory
end

You can run this build script with

rmk compile_cpp

Java Example

plugin 'java' # Load java support

def compile_java()
  # compile all files in src/main/java/**/*.java and include them in one jar file named test
  jar("test",javac(glob("src/main/java/**/*.java"),[]))
end

You can run this build script with

rmk compile_java

Maven support

plugin 'java'  # Load java support
plugin 'maven' # Load maven support

Maven.repository = "http://repo1.maven.org/maven2" # Configure maven repository

def compile_java()
  # compile all files in src/main/java/**/*.java with tapestry support
  javac(glob("src/main/java/**/*.java"),mvn("org.apache.tapestry","tapestry-core","5.3.6"))
end

Dependency management

You can refer to build results from other directories by loading the project and calling the corresponding method.

plugin 'java'

def compile_java()
  # compile all files in src/main/java/**/*.java. Use result from directory ../lib as additional library
  javac(glob("src/main/java/**/*.java"),project("../lib").compile_java)
end

Remote repositories

It's possible to clone remote git repositories. All repositories are cloned and updated to $HOME/.rmk/. You can specify a branch by using a fragment in the URI. During every run, the repository is updated. You can either use the command line

rmk -C https://github.com/wonderix/rmk

or the project method inside a build file to do this

plugin 'java'

def compile_java()
  # compile all files in src/main/java/**/*.java. Use result from directory ../lib as additional library
  javac(glob("src/main/java/**/*.java"),project("https://github.com/wonderix/rmk").compile_java)
end

Caching

Start cache server

rmksrv &

== Sinatra/1.4.3 has taken the stage on 4567 for development with backup from Thin
>> Thin web server (v1.5.1 codename Straight Razor)
>> Maximum connections set to 1024
>> Listening on localhost:4567, CTRL+C to stop

Run build

rmk -c http://localhost:4567

Writing plugins

  • Put a new file in the plugin directory. The filename should be lower case
  • Put a module in this file. The name of the module must match the capitalized filename
  • Require your plugin in your build.rmk
  • All methods from your plugin are available in your build file

The following script shows a simple example

# file abc.rb
module Abc
  def hello()
    puts "Hello"
  end
end

Writing jobs

  • Every build step must be encapsulated in a work item
  • All dependency checks are based on work items
  • All dependencies must be passed as argument to job

The following method extracts all strings from a given file

#include support for system command
include Tools

def strings(jobs)
  # create new work item and pass all dependencies
  # when this item needs to be rebuild the given block is called
  job("strings",jobs) do
    result = []
    # iterate of all items
    jobs.each do | item |
      txt = item.result + ".txt"
      system("strings #{item.result} > #{txt}")
      result << txt
    end
    # return result from block
    result
  end.to_a
end

Normally this kind of methods should be part of a plugin. You can also put this code in your build.rmk.

UI

Rmk supports a simple UI. You can run

rmk -u

And navigate to http://localhost:8081

CI-CD