Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Mine beautiful RubyGems from Ore
Ruby HTML

README.md

Ore

Description

Ore is a fully configurable and customisable Ruby gem generator. With Ore, you spend less time editing files and more time writing code.

Features

SCMs

Ore supports generating Git, Mercurial and using SubVersion repositories:

$ mine my-project [--git | --hg]

Licenses

Ore supports generating MIT (default), BSD, Apache 2.0, GPLv3 or LGPLv3 licenses:

$ mine my-project [--mit | --bsd | --apache | --gpl | --lgpl]

Testing

Ore supports generating RSpec, Minitest or Test::Unit tests:

$ mine my-project [--test-unit | --minitest | --rspec]

TravisCI

Ore also supports generating a .travis.yml file and README badge:

$ mine my-project --travis

Documentation

Ore supports generating projects with RDoc or YARD documentation:

$ mine my-project [--rdoc | --yard]

Ore also supports RDoc, Markdown and Textile markup:

$ mine my-project --yard [--rdoc | --markdown | --textile]

Bundler

Ore also supports Bundler:

$ mine my-project --bundler

Gem Tasks

Ore supports generating Rakefiles using rubygems/tasks, bundler/gem_tasks and even Gem::PackageTask:

$ mine my-project [--rubygems-tasks | --bundler-tasks  | --gem-package-task]

Gemspecs

Ore generates a pure-Ruby gemspec by default:

$ mine my-project

Ore can also generate a gemspec.yml file:

$ mine my-project --gemspec-yml

The gemspecs support listing files from Git, Hg and SubVersion. If the project uses Git submodules, the gemspecs will automatically include files from the submodules.

Custom Templates

Additional templates can also be installed from Git:

$ ore install git://github.com/ruby-ore/rbenv.git
$ mine my-project --rbenv

Requirements

Install

$ gem install ore

Synopsis

Generate a new project:

$ mine my_project

Generate a new customized project:

$ mine my_project --bundler --rspec --yard

Generate a new project using previously installed templates:

$ mine my_project --bundler --rspec --yard --templates rbenv

Set your github username, so mine can generate GitHub project URLs:

$ git config github.user foobar
$ mine my_project

Install a custom template:

$ ore install git://github.com/ruby-ore/rbenv.git

List installed templates:

$ ore list

Remove a previously installed template:

$ ore remove rbenv

Add default generator options to ~/.ore/options.yml:

gemspec_yml:    true
rubygems_tasks: true
rspec:          true
yard:           true
markdown:       true
authors:
  - Alice
email: alice@example.com

License

Copyright (c) 2010-2015 Hal Brodigan

See {file:LICENSE.txt} for license information.

Something went wrong with that request. Please try again.