______ __ ____ ____
/ __/ /__/ /__ _____ / __/__________ / / /__
/ _// / _ / _ `/ __/ _\ \/ __/ __/ _ \/ / (_-<
/___/_/\_,_/\_,_/_/ /___/\__/_/ \___/_/_/___/
The Eldar Scrolls is a magical tool to generate new Rails and modify existing Rails applications (coming) to include your favourite, powerful magic. Authentication, testing, persistence, javascript, css, deployment, and templating - there's a magical scroll for you.
- Follow on twitter @eldarscrolls
Installation is simple:
gem install eldarscrolls
The primary usage of the eldarscrolls
gem is to utilize its interactive terminal command to build a new Rails application. To get started, you can simply run the command thusly:
eldar new APP_NAME
eldarscrolls new APP_NAME
Where APP_NAME
is the directory in which you wish to create the app (it mirrors the Rails creation syntax). You will then be guided through the scroll selection process and subsequently the Rails app generator will automatically run with the template and all appropriate command line options included.
If you wish to skip the interactive scroll selector, you may provide instead a list of scrolls with the -s
or --scrolls
option:
eldar new APP_NAME -s twitter_bootstrap mysql resque
eldar new APP_NAME --scrolls postgresql github eycloud
This will automatically generate a Rails template with the provided scrolls and begin the app generator.
You can also print out a simple list of scrolls:
eldar list
Or print out a list of scrolls for a specific category:
eldar list persistence
Web applications are boring if they aren't running proudly on the internet. The Eldar Scrolls make this automatic for your favourite providers!
Scroll: eycloud
If you choose the eycloud
scroll, your application will be automatically deployed to Engine Yard Cloud. Your code will also be automatically stored on a private/public GitHub repository.
The eycloud
scroll magically transforms many other scrolls to work specifically for Engine Yard Cloud. For example:
postgresql
- the environment will have PostgreSQL selected instead of MySQLresque
- the environment will have Resque and Redis
The Eldar Scrolls needs a Heroku Master to support Heroku for the Eldar Scrolls.
There is some initial work in the current scrolls and the archived/unsupported scrolls
The Eldar Scrolls needs a CloudFoundry Master to support CloudFoundry for the Eldar Scrolls.
Create new scrolls using:
rake new NAME=scroll-name
Submitting a scroll is actually a very straightforward process. Scrolls are made of up template code and YAML back-matter stored in a ruby file. The __END__
parsing convention is used so that each scroll is actually a valid, parseable Ruby file. The structure of a scroll looks something like this:
gem 'supergem'
after_bundler do
generate "supergem:install"
end
__END__
category: templating
name: SuperGem
description: Installs SuperGem which is useful for things
author: mbleigh
It's really that simple. The gem has RSpec tests that automatically validate each scroll in the repository, so you should run rake spec
as a basic sanity check before submitting a pull request. Note that these don't verify that your scroll code itself works, just that Eldar Scrolls could properly parse and understand your scroll file.
This project is an old fashioned fork of Michael Bleigh's Rails Wizard. A new name, new project, and new purpose.
This project wouldn't exist without Michael having created Rails Wizard during Rails Rumble and maintaining and upgrading it for a long time. Sadly support dropped off, several recipes did not work with Rails 3.1+,
Dr Nic originally worked on Rails Wizard to provide Engine Yard Cloud support, his employer and his favourite hosting platform. He also merged in a lot of recipes from other forks, and added new recipes for modern projects.
Support for Engine Yard Cloud meant integration with Chef Recipes. This meant confusing language - Rails Wizard Recipes and Chef Recipes. He decided that wizards don't use recipes - they use scrolls. Alchemists use recipes. And screw alchemists and their dinky potions. Recipes became Scrolls.
"Eldar Scrolls" is a deliberate misspelling of the popular Elder Scrolls computer game. Ok, it was accidental but "eldarscrolls" and "eldarscrolls" should now be much easier to search for on Twitter and Google; and @eldarscrolls eldarscrolls.org were available
- Automatically setup Continuous Integration for new applications - branches "jenkins"
- Interactive mode is a wizard by categories "pick A, B, C or none"
- Apply scrolls to existing Rails applications - branch "apply_scrolls"
- Scrolls work or fail fast on Heroku
- Scrolls work or fail fast on CloudFoundry
- Scrolls generate their own README - branch "readmes"
- 3rd party services/add-ons enabled within deployment platform or directly with service
Missing scrolls
- MongoDB - branch "mongodb"
- OmniAuth - branch "omniauth"
- Sidekiq - branch "sidekiq"
ASCII banner - http://www.network-science.de/ascii/ using 'smslant' font.
Eldar Scrolls and its scrolls are distributed under the MIT License. See MIT_LICENSE for the actual words.