Re-introduce system executable

Similar to the last rewrite, we generate a new gem and do a directory
swap, while making sure to preserve important files like NEWS.md.

This branch will serve as a new base for us to merge into while we build
up an [application template][template].

This approach is largely inspired by [staples][].

[template]: https://guides.rubyonrails.org/generators.html#application-templates
[staples]: https://github.com/stevepolitodesign/staples

Author: stevepolitodesign

.github/workflows/main.yml

@@ -1,4 +1,4 @@
-name: CI
+name: Ruby
 
 on:
   push:
@@ -8,28 +8,78 @@ on:
   pull_request:
 
 jobs:
-  lint:
+  build:
     runs-on: ubuntu-latest
+    name: Ruby ${{ matrix.ruby }}
+    strategy:
+      matrix:
+        ruby:
+          - '3.4.7'
 
     steps:
-    - uses: actions/checkout@v4
-    - name: Set up Ruby
-      uses: ruby/setup-ruby@v1
-      with:
-        bundler-cache: true
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run the default task
+        run: bundle exec rake
 
-    - name: Lint
-      run: bin/rails standard
-
-  test:
+  test-template:
     runs-on: ubuntu-latest
 
-    steps:
-    - uses: actions/checkout@v4
-    - name: Set up Ruby
-      uses: ruby/setup-ruby@v1
-      with:
-        bundler-cache: true
+    services:
+      postgres:
+        image: postgres
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+        ports:
+          - 5432:5432
+        options: --health-cmd="pg_isready" --health-interval=10s --health-timeout=5s --health-retries=3
 
-    - name: Run tests
-      run: bin/rails test
+    steps:
+      - name: Checkout template
+        uses: actions/checkout@v4
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4.7'
+          bundler-cache: false
+      - name: Install Rails
+        run: gem install rails
+      - name: Install dependencies
+        run: bundle install
+      - name: Install Staples
+        run: bundle exec rake install
+      - name: Generate new Rails app with template
+        run: |
+          cd /tmp
+          suspenders test_app
+      - name: Set up generated app
+        env:
+          DATABASE_URL: postgres://postgres:postgres@localhost:5432
+        working-directory: /tmp/test_app
+        run: |
+          bundle install
+          bin/setup --skip-server
+          bin/rails db:migrate
+      - name: Run tests in generated app
+        env:
+          RAILS_ENV: test
+          DATABASE_URL: postgres://postgres:postgres@localhost:5432
+        working-directory: /tmp/test_app
+        run: |
+          bin/rails db:test:prepare
+          bin/rails test:all
+      - name: Verify app can start
+        env:
+          DATABASE_URL: postgres://postgres:postgres@localhost:5432
+        working-directory: /tmp/test_app
+        run: |
+          timeout 10 bin/rails server > /dev/null 2>&1 &
+          sleep 5
+          curl -f http://localhost:3000 || exit 1

.gitignore

@@ -1,11 +1,11 @@
 /.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
 /doc/
-/log/*.log
 /pkg/
+/spec/reports/
 /tmp/
-/test/dummy/db/*.sqlite3
-/test/dummy/db/*.sqlite3-*
-/test/dummy/log/*.log
-/test/dummy/storage/
-/test/dummy/tmp/
-node_modules
+
+# rspec failure tracking
+.rspec_status

.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

.standard.yml

@@ -1,5 +1,3 @@
-ruby_version: 3.0.5
-ignore:
-  - "templates/partials/db_optimizations_configuration.rb"
-  - "templates/partials/pull_requests_config.rb"
-  - "templates/partials/email_smtp.rb"
+# For available configuration options, see:
+#   https://github.com/standardrb/standard
+ruby_version: 3.2

CONTRIBUTING.md

@@ -20,16 +20,10 @@ Run the setup script.
 ./bin/setup
 ```
 
-Make sure the tests pass:
+Make sure everything passes:
 
 ```
-bin/rails test
-```
-
-Make sure there are no linting violations:
-
-```
-bin/rails standard
+bundle exec rake
 ```
 
 Make your change, with new passing tests.
@@ -46,16 +40,10 @@ This is a time for discussion and improvements,
 and making the necessary changes will be required before we can
 merge the contribution.
 
-## Testing Generators
-
-There is a smaller dummy application at `test/dummy`. This application is used
-as a mounting point for the engine, to make testing the engine extremely simple.
-
-There are a number of [assertions][] and [helpers][] that make testing
-generators easier.
+## Testing the executable Locally
 
-[assertions]: https://api.rubyonrails.org/classes/Rails/Generators/Testing/Assertions.html
-[helpers]: https://api.rubyonrails.org/classes/Rails/Generators/Testing/Behavior.html
+To install this gem onto your local machine, run `bundle exec rake install`.
+From there, you can run `suspenders <app_name>` to test the current code.
 
 ## Publishing to RubyGems
 

Gemfile

@@ -1,12 +1,13 @@
+# frozen_string_literal: true
+
 source "https://rubygems.org"
-git_source(:github) { |repo| "https://github.com/#{repo}.git" }
 
-# Specify your gem's dependencies in suspenders.gemspec.
+# Specify your gem's dependencies in suspenders.gemspec
 gemspec
 
-gem "puma"
+gem "irb"
+gem "rake", "~> 13.0"
 
-gem "sqlite3", ">= 2.1"
+gem "rspec", "~> 3.0"
 
-# Start debugger with binding.b [https://github.com/ruby/debug]
-# gem "debug", ">= 1.0.0"
+gem "standard", "~> 1.3"