___ ____ ____ / _ | ___ ___ / __/__________ / / /__ / __ |/ _ \/ _ \ _\ \/ __/ __/ _ \/ / (_-< /_/ |_/ .__/ .__/ /___/\__/_/ \___/_/_/___/ /_/ /_/
An example application that was built by the App Scrolls is at https://github.com/drnic/mydemoapp. The generated README shows all the scrolls that were included.
scrolls new mynewapp -s twitter_bootstrap cd mynewapp rails s
Installation is simple:
gem install appscrolls
The primary usage of the
appscrolls gem is to utilize its interactive terminal command to build a new Rails application. To get started, you can simply run the command thusly:
appscrolls new APP_NAME scrolls new APP_NAME
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.
To transform an existing Rails app, you ... wait, that's not implemented yet. But since the "apply template" feature of
rails new APP_NAME -m template.rb is implemented in Thor, I mean, how hard could it be?*
The current available scrolls grouped by category:
If you wish to skip the interactive scroll selector, you may provide instead a list of scrolls with the
scrolls new APP_NAME -s twitter_bootstrap mysql resque scrolls 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:
Or print out a list of scrolls for a specific category:
scrolls list persistence
Web applications are boring if they aren't running proudly on the internet. The App Scrolls make this automatic for your favourite providers!
scrolls new mydemoapp -s twitter_bootstrap unicorn postgresql resque github eycloud
The created application above will be automatically stored in a git private/public repository on GitHub and then deployed to Engine Yard Cloud.
When deploying to Engine Yard Cloud you will need to choose:
passengerfor your app server
postgresqlfor your SQL DB
When choosing from the following scrolls, your Engine Yard Cloud environment will be automatically upgraded/configured with Chef recipes.
resque- add utility instances called resque for workers [see readme for more information]
redis- add a utility called redis to have a dedicated redis DB; else it is run on your DB master or Solo instance
delayed_job- add utility instances called delayed_job or dj for workers [see readme for more information]
The App Scrolls needs a Heroku Master to support Heroku for the App Scrolls.
The App Scrolls needs a CloudFoundry Master to support CloudFoundry for the App 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 App Scrolls could properly parse and understand your scroll file.
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.
App Scrolls and its scrolls are distributed under the MIT License. See MIT_LICENSE for the actual words.
Hosted on GitHub Pages — Theme by orderedlist