armadura 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 36b26941170980cabf20c58b602706e6d4c78f68
+  data.tar.gz: c54079e4c2e3c51d0bfb1fa4da0d4e6cb0ed7e9b
+SHA512:
+  metadata.gz: ddcb0b5185a19ac82b5f3cf60848f2d4f89d98b0d519fb10e664e65e01de781f158ce1e1ef15d2e91040ab0d70882e83544b719e7db4bbdd81e4f99009bcbafa
+  data.tar.gz: 9b6c5cf924ea45ba115b4c3ae0b4f8ab0eacbc63b3e343dc9266439ff8d1b935ac94eb08bc8c5b6dbaaf872ac5f6f75170f37454344645d9a90e01b1f68c2f25

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+*.swp
+Gemfile.lock
+/.bundle
+/tmp

data/.ruby-version

@@ -0,0 +1 @@
+2.3.1

data/.travis.yml

@@ -0,0 +1,11 @@
+language: ruby
+rvm: 2.3.1
+cache: bundler
+sudo: false
+before_install:
+  - "echo '--colour' > ~/.rspec"
+  - git config --global user.name 'Travis CI'
+  - git config --global user.email 'travis-ci@example.com'
+install: bundle install
+notifications:
+  email: false

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,19 @@
+The MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,218 @@
+# Armadura [![Build Status](https://secure.travis-ci.org/mcmire/armadura.svg?branch=master)](http://travis-ci.org/mcmire/armadura)
+
+Armadura is a gem that lets you generate a Rails application, preconfigured with
+sensible defaults.
+
+## Installation
+
+First install the armadura gem:
+
+    gem install armadura
+
+Then run:
+
+    armadura projectname
+
+This will create a Rails app in `projectname` using the latest version of Rails.
+
+### Associated services
+
+* Enable [Circle CI](https://circleci.com/) Continuous Integration
+* Enable [GitHub auto deploys to Heroku staging and review
+    apps](https://dashboard.heroku.com/apps/app-name-staging/deploy/github).
+
+## Gemfile
+
+To see the latest and greatest gems, look at Armadura's
+[Gemfile](templates/Gemfile.erb), which will be appended to the default
+generated projectname/Gemfile.
+
+It includes application gems like:
+
+* [Autoprefixer Rails](https://github.com/ai/autoprefixer-rails) for CSS vendor prefixes
+* [Bourbon](https://github.com/thoughtbot/bourbon) for Sass mixins
+* [Bitters](https://github.com/thoughtbot/bitters) for scaffold application styles
+* [Sidekiq](https://github.com/mperham/sidekiq) for background
+  processing
+* [Flutie](https://github.com/thoughtbot/flutie) for `page_title` and `body_class` view
+  helpers
+* [High Voltage](https://github.com/thoughtbot/high_voltage) for static pages
+* [jQuery Rails](https://github.com/rails/jquery-rails) for jQuery
+* [Neat](https://github.com/thoughtbot/neat) for semantic grids
+* [Normalize](https://necolas.github.io/normalize.css/) for resetting browser styles
+* [Postgres](https://github.com/ged/ruby-pg) for access to the Postgres database
+* [Rack Canonical Host](https://github.com/tylerhunt/rack-canonical-host) to
+  ensure all requests are served from the same domain
+* [Rack Timeout](https://github.com/heroku/rack-timeout) to abort requests that are
+  taking too long
+* [Recipient Interceptor](https://github.com/croaky/recipient_interceptor) to
+  avoid accidentally sending emails to real people from staging
+* [Refills](https://github.com/thoughtbot/refills) for “copy-paste” components
+  and patterns based on Bourbon, Neat and Bitters
+* [Sentry](https://sentry.io) for exception notification
+* [Simple Form](https://github.com/plataformatec/simple_form) for form markup
+  and style
+* [Skylight](https://www.skylight.io/) for monitoring performance
+* [Title](https://github.com/calebthompson/title) for storing titles in
+  translations
+* [Puma](https://github.com/puma/puma) to serve HTTP requests
+
+And development gems like:
+
+* [Dotenv](https://github.com/bkeepers/dotenv) for loading environment variables
+* [Pry Rails](https://github.com/rweng/pry-rails) for interactively exploring
+  objects
+* [ByeBug](https://github.com/deivid-rodriguez/byebug) for interactively
+  debugging behavior
+* [Bullet](https://github.com/flyerhzm/bullet) for help to kill N+1 queries and
+  unused eager loading
+* [Bundler Audit](https://github.com/rubysec/bundler-audit) for scanning the
+  Gemfile for insecure dependencies based on published CVEs
+* [Spring](https://github.com/rails/spring) for fast Rails actions via
+  pre-loading
+* [Web Console](https://github.com/rails/web-console) for better debugging via
+  in-browser IRB consoles.
+
+And testing gems like:
+
+* [Capybara](https://github.com/jnicklas/capybara) and
+  [Capybara WebKit](https://github.com/thoughtbot/capybara-webkit) for
+  integration testing
+* [Factory Girl](https://github.com/thoughtbot/factory_girl) for test data
+* [Formulaic](https://github.com/thoughtbot/formulaic) for integration testing
+  HTML forms
+* [RSpec](https://github.com/rspec/rspec) for unit testing
+* [RSpec Mocks](https://github.com/rspec/rspec-mocks) for stubbing and spying
+* [Shoulda Matchers](https://github.com/thoughtbot/shoulda-matchers) for common
+  RSpec matchers
+* [Timecop](https://github.com/ferndopolis/timecop-console) for testing time
+
+## Other goodies
+
+Armadura also comes with:
+
+* The [`./bin/setup`][setup] convention for new developer setup
+* The `./bin/deploy` convention for deploying to Heroku
+* Rails' flashes set up and in application layout
+* A few nice time formats set up for localization
+* `Rack::Deflater` to [compress responses with Gzip][compress]
+* A [low database connection pool limit][pool]
+* [Safe binstubs][binstub]
+* [t() and l() in specs without prefixing with I18n][i18n]
+* An automatically-created `SECRET_KEY_BASE` environment variable in all
+  environments
+* Configuration for [CircleCI][circle] Continuous Integration (tests)
+* Configuration for [Hound][hound] Continuous Integration (style)
+* The analytics adapter [Segment][segment] (and therefore config for Google
+  Analytics, Intercom, Facebook Ads, Twitter Ads, etc.)
+
+[setup]: https://robots.thoughtbot.com/bin-setup
+[compress]: https://robots.thoughtbot.com/content-compression-with-rack-deflater
+[pool]: https://devcenter.heroku.com/articles/concurrency-and-database-connections
+[binstub]: https://github.com/thoughtbot/suspenders/pull/282
+[i18n]: https://github.com/thoughtbot/suspenders/pull/304
+[circle]: https://circleci.com/docs
+[hound]: https://houndci.com
+[segment]: https://segment.com
+
+## Heroku
+
+You can optionally create Heroku staging and production apps:
+
+    armadura app --heroku true
+
+This:
+
+* Creates a staging and production Heroku app
+* Sets them as `staging` and `production` Git remotes
+* Configures staging with `RACK_ENV` environment variable set
+  to `staging`
+* Adds the [Rails Stdout Logging][logging-gem] gem
+  to configure the app to log to standard out,
+  which is how [Heroku's logging][heroku-logging] works.
+* Creates a [Heroku Pipeline] for review apps
+
+[logging-gem]: https://github.com/heroku/rails_stdout_logging
+[heroku-logging]: https://devcenter.heroku.com/articles/logging#writing-to-your-log
+[Heroku Pipeline]: https://devcenter.heroku.com/articles/pipelines
+
+You can optionally specify alternate Heroku flags:
+
+    armadura app \
+      --heroku true \
+      --heroku-flags "--region eu --addons sendgrid,ssl"
+
+See all possible Heroku flags:
+
+    heroku help create
+
+## Git
+
+This will initialize a new git repository for your Rails app. You can
+bypass this with the `--skip-git` option:
+
+    armadura app --skip-git true
+
+## GitHub
+
+You can optionally create a GitHub repository for the suspended Rails app. It
+requires that you have [Hub](https://github.com/github/hub) on your system:
+
+    curl http://hub.github.com/standalone -sLo ~/bin/hub && chmod +x ~/bin/hub
+    armadura app --github organization/project
+
+This has the same effect as running:
+
+    hub create organization/project
+
+## Spring
+
+Armadura uses [spring](https://github.com/rails/spring) by default.
+It makes Rails applications load faster, but it might introduce confusing issues
+around stale code not being refreshed.
+If you think your application is running old code, run `spring stop`.
+And if you'd rather not use spring, add `DISABLE_SPRING=1` to your login file.
+
+## Dependencies
+
+Armadura requires the latest version of Ruby.
+
+Some gems included in Armadura have native extensions. You should have GCC
+installed on your machine before generating an app with Armadura.
+
+Use [OS X GCC Installer](https://github.com/kennethreitz/osx-gcc-installer/) for
+Snow Leopard (OS X 10.6).
+
+Use [Command Line Tools for Xcode](https://developer.apple.com/downloads/index.action)
+for Lion (OS X 10.7) or Mountain Lion (OS X 10.8).
+
+We use [Capybara WebKit](https://github.com/thoughtbot/capybara-webkit) for
+full-stack JavaScript integration testing. It requires QT. Instructions for
+installing QT are
+[here](https://github.com/thoughtbot/capybara-webkit/wiki/Installing-Qt-and-compiling-capybara-webkit).
+
+PostgreSQL needs to be installed and running for the `db:create` rake task.
+
+## Issues
+
+If you have problems, please create a
+[GitHub Issue](https://github.com/mcmire/armadura/issues).
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+Thank you, [contributors]!
+
+[contributors]: https://github.com/thoughtbot/armadura/graphs/contributors
+
+## License
+
+Armadura is copyright © 2016 Elliot Winkler.
+It is adapted from [Suspenders], a [thoughtbot] project.
+It is free software, and may be redistributed under the terms specified in the
+[LICENSE] file.
+
+[Suspenders]: https://github.com/thoughtbot/suspenders
+[thoughtbot]: http://thoughtbot.com
+[LICENSE]: LICENSE

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/setup'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:rspec)
+
+desc 'Run the test suite'
+task :default => :rspec

data/USAGE

@@ -0,0 +1,9 @@
+Description:
+    Armadura is a gem that lets you generate a Rails application, preconfigured
+    with sensible defaults.
+
+Example usage:
+    # Instead of saying:
+    rails new weblog
+    # say:
+    armadura weblog

data/armadura.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path('../lib', __FILE__)
+require 'armadura/version'
+require 'date'
+
+Gem::Specification.new do |s|
+  s.required_ruby_version = ">= #{Armadura::RUBY_VERSION}"
+  s.authors = ['Elliot Winkler <elliot.winkler@gmail.com>']
+  s.date = Date.today.strftime('%Y-%m-%d')
+  s.description = "Armadura generates Rails projects, preconfigured with sensible defaults."
+  s.summary = "Armadura generates Rails projects, preconfigured with sensible defaults."
+  s.email = 'elliot.winkler@gmail.com'
+  s.executables = ['armadura']
+  s.extra_rdoc_files = %w[README.md LICENSE]
+  s.files = `git ls-files`.split("\n")
+  s.homepage = 'https://github.com/mcmire/armadura'
+  s.license = 'MIT'
+  s.name = 'armadura'
+  s.rdoc_options = ['--charset=UTF-8']
+  s.require_paths = ['lib']
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.version = Armadura::VERSION
+
+  s.add_dependency 'bitters', '~> 1.3'
+  s.add_dependency 'bundler', '~> 1.3'
+  s.add_dependency 'rails', Armadura::RAILS_VERSION
+
+  s.add_development_dependency 'rspec', '~> 3.2'
+end

data/bin/armadura

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+require 'pathname'
+
+source_path = (Pathname.new(__FILE__).dirname + '../lib').expand_path
+$LOAD_PATH << source_path
+
+require 'armadura'
+
+if ARGV.empty?
+  puts "Please provide a path for the new application"
+  puts
+  puts "See --help for more info"
+  exit 0
+elsif ['-v', '--version'].include? ARGV[0]
+  puts Armadura::VERSION
+  exit 0
+end
+
+templates_root = File.expand_path(File.join("..", "templates"), File.dirname(__FILE__))
+Armadura::AppGenerator.source_root templates_root
+Armadura::AppGenerator.source_paths << Rails::Generators::AppGenerator.source_root << templates_root
+
+Armadura::AppGenerator.start

data/bin/rake

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rake', 'rake')

data/bin/rspec

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rspec-core', 'rspec')

data/bin/setup

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+# Run this script immediately after cloning the codebase.
+
+# Exit if any subcommand fails
+set -e
+
+# Set up Ruby dependencies via Bundler
+bundle install
+
+# Add binstubs to PATH in ~/.zshenv like this:
+#   export PATH=".git/safe/../../bin:$PATH"
+mkdir -p .git/safe

data/lib/armadura.rb

@@ -0,0 +1,7 @@
+require 'armadura/version'
+require 'armadura/generators/app_generator'
+require 'armadura/generators/static_generator'
+require 'armadura/generators/stylesheet_base_generator'
+require 'armadura/actions'
+require "armadura/adapters/heroku"
+require 'armadura/app_builder'

data/lib/armadura/actions.rb

@@ -0,0 +1,33 @@
+module Armadura
+  module Actions
+    def replace_in_file(relative_path, find, replace)
+      path = File.join(destination_root, relative_path)
+      contents = IO.read(path)
+      unless contents.gsub!(find, replace)
+        raise "#{find.inspect} not found in #{relative_path}"
+      end
+      File.open(path, "w") { |file| file.write(contents) }
+    end
+
+    def action_mailer_host(rails_env, host)
+      config = "config.action_mailer.default_url_options = { host: #{host} }"
+      configure_environment(rails_env, config)
+    end
+
+    def configure_application_file(config)
+      inject_into_file(
+        "config/application.rb",
+        "\n\n    #{config}",
+        before: "\n  end"
+      )
+    end
+
+    def configure_environment(rails_env, config)
+      inject_into_file(
+        "config/environments/#{rails_env}.rb",
+        "\n\n  #{config}",
+        before: "\nend"
+      )
+    end
+  end
+end