hoboken 0.0.1 → 0.9.0

data/lib/hoboken/templates/Gemfile.erb.tt

@@ -1,17 +1,40 @@
-source "https://rubygems.org"
-ruby "<%= options[:ruby_version] %>"
+# frozen_string_literal: true
 
-gem "rack_csrf", "~> 2.4.0"
-gem "sinatra",   "~> 1.4.3"
-gem "thin",      "~> 1.5.1"
+source 'https://rubygems.org'
+ruby '<%= options[:ruby_version] %>'
+
+<% unless options[:api_only] -%>
+gem 'erubi', '~> 1.10'
+<% end -%>
+gem 'puma', '~> 5.2'
+gem 'rack_csrf', '~> 2.6'
+gem 'sinatra', '~> 2.1'
+gem 'sinatra-contrib', '~> 2.1'
+<% unless options[:api_only] -%>
+gem 'sinatra-flash', '~> 0.3'
+<% end -%>
 
 group :development do
-  gem "rake",             "~> 10.1.0"
-  gem "sinatra-reloader", "~> 1.0"
+  gem 'better_errors', '~> 2.9'
+  gem 'binding_of_caller', '~> 1.0'
+  gem 'dotenv', '~> 2.7'
+  gem 'pry-byebug', '~> 3.9'
+  gem 'racksh', '~> 1.0'
+  gem 'rake', '~> 13.0'
+  gem 'rerun', '~> 0.13'
+  gem 'rb-fsevent', '~> 0.10'
 end
 
 group :test do
-  gem "contest", "~> 0.1.3"
+<% if 'test-unit' == options[:test_framework] -%>
+  gem 'contest', '~> 0.1'
+<% end -%>
+  gem 'rack-test', '~> 1.1'
+<% if 'rspec' == options[:test_framework] -%>
+  gem 'rspec', '~> 3.10'
+<% end -%>
+<% if 'test-unit' == options[:test_framework] -%>
+  gem 'test-unit', '~> 3.4'
+<% end -%>
+  gem 'warning', '~> 1.2'
 end
-
-gem "dotenv", "~> 0.9.0", group: :development

data/lib/hoboken/templates/README.md.tt

@@ -1,50 +1,120 @@
 # <%= titleized_name %>
 
+## Overview
+
 TODO: Project description.
 
+* TODO: a list of
+* high level features
+* ...
+
+### Links
+* [Production](TODO)
+* [QA](TODO)
+* [Issue Tracking](TODO)
+* [Continuous Integration](TODO)
+
+### Table of Contents
+
+* [Overview](#overview)
+* [Getting Started](#getting-started)
+* [Configuration](#configuration)
+<% if 'rspec' == options[:test_framework] -%>
+* [Specs](#specs)
+<% else -%>
+* [Tests](#tests)
+<% end -%>
+* [Rake Tasks](#rake-tasks)
+* [Logging](#logging)
+* [Deploying](#deploying)
+* [Dev Notes](#dev-notes)
+
 ## Getting Started
 
-### Starting the Server
+The following pre-requisites are needed to build this project:
+* Ruby <%= RUBY_VERSION %>
+* [Bundler](https://bundler.io/)
 
-### Project Layout
+After cloning this repository, the project can be setup by running the `./bin/setup` script. This script will install dependencies and perform any other required setup tasks.
 
-## Notes / Use
+Once setup is complete, you can start a local development server by running the `./bin/server` script. Additionally, you can start a development console using the `./bin/console` script. The console uses the [racksh](https://github.com/sickill/racksh) gem which exposes a `$rack` variable that can be used to make simulated HTTP requests.
 
-## Contributing
+## Configuration
+Environment variables are used for project configuration. For local development, the `.env` file is used. Below is a sample `.env` file that contains the minimum required configuration.
 
-### Issues / Roadmap
+```
+RACK_ENV=development
+```
 
-Use GitHub issues for reporting bug and feature requests.
+Here is a table containing all available environment variable configuration options and their descriptions.
 
-### Patches / Pull Requests
-* Fork the project.
-* Make your feature addition or bug fix.
-* Add tests for it. This is important so I don’t break it in a future version
-  unintentionally.
-* Commit, do not mess with Rakefile, version, or history (if you want to have
-  your own version, that is fine but bump version in a commit by itself I can
-  ignore when I pull).
-* Send me a pull request. Bonus points for topic branches.
+<table>
+    <thead>
+        <tr>
+            <th>Name</th>
+            <th>Required?</th>
+            <th>Default Value</th>
+            <th>Description</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>MAX_THREADS</td>
+            <td>No</td>
+            <td>5</td>
+            <td>The maximum number of threads that a Puma worker process should use</td>
+        </tr>
+        <tr>
+            <td>PORT</td>
+            <td>No</td>
+            <td>9292</td>
+            <td>Web server port</td>
+        </tr>
+        <tr>
+            <td>RACK_ENV</td>
+            <td>No</td>
+            <td>production</td>
+            <td>Web server environment (i.e. development, test, production, etc.)</td>
+        </tr>
+        <tr>
+            <td>WEB_CONCURRENCY</td>
+            <td>No</td>
+            <td>1</td>
+            <td>The number of Puma worker processes</td>
+        </tr>
+    </tbody>
+</table>
 
-## License
-(The MIT License)
+## Development
+This project has the following default behavior:
 
-Copyright (c) <%= Date.today.year %> <%= author %>
+* helpers scripts for common project actions; refer to the `bin` folder
+* uses [Puma](https://github.com/puma/puma) as the default web server
+* [erubi](https://github.com/jeremyevans/erubi) for templating; escaping is done by default
+* [Rack::Csrf](http://rubygems.org/gems/rack_csrf") is turned on by default
+* environment variable support via the [dotenv](http://rubygems.org/gems/dotenv) gem
+* Procfile for [foreman](https://github.com/ddollar/foreman) support; if foreman is not installed uses rackup instead
+* code reloading via the [rerun](https://github.com/alexch/rerun) gem is enabled for the development environment
+* [pry-byebug](https://github.com/deivid-rodriguez/pry-byebug") is installed for debugging
 
-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.
+<% if 'rspec' == options[:test_framework] -%>
+## Specs
+This project uses [RSpec](https://rspec.info/) for testing. Specs can be ran using the rake task `rake spec`.
+<% else -%>
+## Tests
+This project uses [Test Unit](https://test-unit.github.io/) for testing. Tests can be ran using the rake task `rake test:all`.
+<% end -%>
+
+## Rake Tasks
+To see a list of available tasks run the `rake -T` command.
+
+## Logging
+TODO: Describe how logging is setup (i.e. files, STDOUT, services like Papertrail, DataDog, etc.).
+
+## Deploying
+TODO: Describe how to deploy the project (QA, production, CI setup, etc.). Don't forget to describe how project environment variables are set for the various deployment targets.
+
+## Dev Notes
+
+## License
+Copyright (c) <%= Date.today.year %> <%= author %>

data/lib/hoboken/templates/Rakefile.tt

@@ -1,28 +1,16 @@
-require "rake/testtask"
-
-task :default => "test:all"
+# frozen_string_literal: true
 
 # Import any external rake tasks
 Dir.glob('tasks/*.rake').each { |r| import r }
 
-desc "Start the development server"
-task :server do
-  port = ENV["PORT"] || 9292
-  rack_env = ENV["RACK_ENV"] || "development"
-  exec("bundle exec thin start -p #{port} -e #{rack_env}")
-end
-
-namespace :test do
-  Rake::TestTask.new(:unit) do |t|
-    t.libs << 'test/unit'
-    t.test_files = Dir["test/unit/**/*_test.rb"]
-  end
+<% if 'test-unit' == options[:test_framework] -%>
+task default: 'test:all'
 
-  Rake::TestTask.new(:integration) do |t|
-    t.libs << 'test/unit'
-    t.test_files = Dir["test/integration/**/*_test.rb"]
-  end
+desc 'Run CI checks'
+task ci: ['test:all']
+<% else -%>
+task default: 'spec'
 
-  desc "Run all tests"
-  task :all => %w[test:unit test:integration]
-end
+desc 'Run CI checks'
+task ci: ['spec']
+<% end -%>

data/lib/hoboken/templates/classic.rb.tt

@@ -1,16 +1,43 @@
-require "bundler/setup"
-require "sinatra"
-require "rack/csrf"
+# frozen_string_literal: true
 
-Dir.glob(File.join("helpers", "**", "*.rb")).each do |helper|
+require 'bundler/setup'
+
+<% unless options[:api_only] -%>
+require 'erubi'
+<% end -%>
+require 'rack/csrf'
+require 'sinatra'
+<% if options[:api_only] -%>
+require 'sinatra/json'
+<% else -%>
+require 'sinatra/flash'
+<% end -%>
+
+Dir.glob(File.join('helpers', '**', '*.rb')).each do |helper|
   require_relative helper
 end
 
-require "sinatra/reloader" if development?
+configure do
+  use Rack::Session::Cookie, secret: 'TODO: CHANGE ME'
+  use Rack::Csrf, raise: true
+<% unless options[:api_only] -%>
+
+  set :erb, { escape_html: true }
+<% end -%>
+end
 
-use Rack::Session::Cookie, :secret => "TODO: CHANGE ME"
-use Rack::Csrf, :raise => true
+configure :development do
+  require 'better_errors'
+  use BetterErrors::Middleware
+  BetterErrors.application_root = __dir__
+end
 
-get "/" do
+<% if options[:api_only] -%>
+get '/' do
+  json message: 'Smoke test successful!'
+end
+<% else -%>
+get '/' do
   erb :index
 end
+<% end -%>

data/lib/hoboken/templates/config.ru.tt

@@ -1,5 +1,7 @@
-require "bundler/setup"
-require "dotenv"
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'dotenv'
 Dotenv.load
-require File.expand_path("../app", __FILE__)
+require File.expand_path('app', __dir__)
 run Sinatra::Application

data/lib/hoboken/templates/console.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle exec racksh

data/lib/hoboken/templates/db.rb.tt

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+if ENV['DATABASE_URL']
+  require 'logger'
+  require 'sequel'
+
+  args = 'test' == ENV['RACK_ENV'] ? ['tmp/db_test.log', 'daily'] : [$stdout]
+  DB = Sequel.connect(ENV['DATABASE_URL'], loggers: [Logger.new(*args)])
+  Sequel.extension :migration
+
+  unless Dir.glob('db/migrate/*.rb').empty?
+    begin
+      Sequel::Migrator.check_current(DB, 'db/migrate')
+    rescue Sequel::Migrator::NotCurrentError
+      puts 'Pending migrations detected... running migrations'
+      Sequel::Migrator.run(DB, 'db/migrate')
+      puts 'Database migrations completed'
+    end
+  end
+  DB.freeze unless 'development' == ENV['RACK_ENV']
+  puts 'Database connected'
+else
+  puts 'DATABASE_URL not set; skipping database initialization'
+end

data/lib/hoboken/templates/github_action.tt

@@ -0,0 +1,28 @@
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+
+name: Ruby
+
+on:
+  push:
+  pull_request:
+  schedule:
+    - cron: "0 4 * * *"
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: [<%= RUBY_VERSION %>]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+        bundler-cache: true
+    - name: Run tests
+      run: bundle exec rake ci

data/lib/hoboken/templates/gitignore

@@ -1,5 +1,12 @@
 .DS_Store
 .bundle
+.byebug_history
+.env
+.env.test
+.rspec_status
 /tmp
+coverage
+db/*.db
+public
+spec/examples.txt
 tags
-.env

data/lib/hoboken/templates/metrics.rake.tt

@@ -1,9 +1,11 @@
+# frozen_string_literal: true
+
 unless 'production' == ENV['RACK_ENV']
   require 'flay'
-  desc "Analyze code for structural similarities"
+  desc 'Analyze code for structural similarities'
   task :flay do
     flay = Flay.new
-    files = FileList["app.rb", "app/**/*.rb"]
+    files = FileList['app.rb', 'app/**/*.rb']
     flay.process(*files)
     threshold = 200
 
@@ -13,21 +15,20 @@ unless 'production' == ENV['RACK_ENV']
     end
   end
 
-  require "flog"
+  require 'flog'
   desc 'Analyze code complexity'
   task :flog do
     flog = Flog.new
-    flog.flog FileList["app.rb", "app/**/*.rb"]
+    files = FileList['app.rb', 'app/**/*.rb']
+    flog.flog(*files)
     threshold = 50
 
-    bad_methods = flog.totals.select do |name, score|
+    bad_methods = flog.totals.select do |_name, score|
       score > threshold
     end
 
-    bad_methods.sort do |a, b|
-      a[1] <=> b[1]
-    end.each do |name, score|
-      puts "%8.1f: %s" % [score, name]
+    bad_methods.sort { |a, b| a[1] <=> b[1] }.each do |name, score|
+      puts format('%<score>8.1f: %<name>s', score: score, name: name)
     end
 
     unless bad_methods.empty?

data/lib/hoboken/templates/modular.rb.tt

@@ -1,27 +1,56 @@
-require "bundler/setup"
-require "sinatra/base"
-require "rack/csrf"
+# frozen_string_literal: true
 
-Dir.glob(File.join("helpers", "**", "*.rb")).each do |helper|
+require 'bundler/setup'
+
+<% unless options[:api_only] -%>
+require 'erubi'
+<% end -%>
+require 'rack/csrf'
+require 'sinatra/base'
+<% if options[:api_only] -%>
+require 'sinatra/json'
+<% else -%>
+require 'sinatra/flash'
+<% end -%>
+
+Dir.glob(File.join('helpers', '**', '*.rb')).each do |helper|
   require_relative helper
 end
 
 module <%= camel_name %>
+  # Sinatra web application
+  #
   class App < Sinatra::Base
-    set :root, File.dirname(__FILE__)
+    configure do
+      set :root, File.dirname(__FILE__)
+<% unless options[:api_only] -%>
+      set :erb, { escape_html: true }
+<% end -%>
 
-    enable :logging
+      enable :logging
 
-    use Rack::Session::Cookie, :secret => "TODO: CHANGE ME"
-    use Rack::Csrf, :raise => true
+      use Rack::Session::Cookie, secret: 'TODO: CHANGE ME'
+      use Rack::Csrf, raise: true
+<% unless options[:api_only] -%>
+
+      register Sinatra::Flash
+<% end -%>
+    end
 
     configure :development do
-      require "sinatra/reloader"
-      register Sinatra::Reloader
+      require 'better_errors'
+      use BetterErrors::Middleware
+      BetterErrors.application_root = __dir__
     end
 
-    get "/" do
+<% if options[:api_only] -%>
+    get '/' do
+      json message: 'Smoke test successful!'
+    end
+<% else -%>
+    get '/' do
       erb :index
     end
+<% end -%>
   end
 end