Amp

What is Amp:

Amp aims to change the way we approach VCS.

Amp is:

• Mercurial in Ruby. 100% compatible with hg.
• Uniquely customizable
• Superbly documented with YARD
• Free and Open-Source (GPLv2)
• Performance Focused
• Dependency-free (you just need Ruby!)

Big Plans for Amp:

Amp has bigger dreams. Here’s what we want to do:

• git, bazaar, svn, cvs, darcs In Ruby. 100% Compatible.
• Common API to all repository formats.
• Command system independent of repository format
• Workflows matching each major VCS system
• Run on Windows
• Demonstrate Ruby performance
• A GUI application on top of all these features

Why Amp?

Amp is unlike any other VCS software to date. Amp's novel command system gives you the flexibility to customize and personalize the way you develop software. Create in your own workspace with full Mercurial compatibility, and no external dependencies.

The following adds a new command to amp. Usage: amp echo Hello World. Once this is in your ampfile, it’s usable in amp.

 command "echo" do |c|
   c.opt :noline, "Don't append newline", :short => "-n"
   c.on_run do |opts, args|
     print args.join(" ")
     print "\n" unless opts[:noline]
   end
 end

Don’t like how a command works out-of-the-box? Change the default settings. It’s almost not even code.

 command "status" do |c|
   c.default :"no-color", true
 end

This one's from our own ampfile. Run tests before every push. If your tests fail, no push.

 command :push do |c|
   c.before { system "rake test" }
 end

Developing Amp:

There's a lot we want to do, and amp needs developers. Want to help? Here's how amp rolls:

 hg clone http://bitbucket.org/carbonica/amp/

• Make your changes

 hg diff > your.patch

• Create ticket on Lighthouse, attach your patch
• Land one patch, you get commit rights

Requirements

• Ruby

Installation

gem install amp --no-wrappers