Update .gitignore

.gitignore

@@ -0,0 +1,4 @@
+/.rake_tasks~
+/temp.db
+/vendor/
+/bin/

Gemfile

@@ -4,6 +4,13 @@ gem 'roda'
 gem 'rack-unreloader'
 gem 'tilt'
 gem 'erubi'
+gem 'sequel'
+gem 'rake'
+
+# Change to whatever database you plan to use
+gem 'sqlite3'
+# gem 'pg' # will also want gem sequel-pg
+# gem 'mysql2'
 
 # change to gunicorn or passenger if you prefer:
 gem 'puma'

README.md

@@ -2,6 +2,8 @@
 
 For the single file app template, really the only file you need is the config.ru and run it with puma.
 
+## Database
+
 ## Views
 
 In this template, I've taken the single-file template and split up the config.ru to put routes and app logic in app.rb and call on templates to render proper html pages.  `tilt` and `erubi` gems are added to do the rendering, and `rack-unreloader` gem is added to have puma automatically load file changes while running in development mode.
@@ -12,6 +14,17 @@ Next Roda app template iterations will add database, then authentication.
 
 ## Setup
 
+### Get git
+
+```
+sudo apt install git
+git config --global user.email "myemail@gmail.com"
+git config --global user.name "Full Name"
+git config --global credential.helper "cache"
+
+git clone https://path/to/project.git
+```
+
 ### Prereq installs
 
 Will need ruby; install it via package manager or a ruby manager like rbenv/ruby-build.  Will need the roda gem, and then an application server such as puma (recommended), gunicorn, or passenger.  My examples will use system ruby and puma.
@@ -21,31 +34,64 @@ Will need ruby; install it via package manager or a ruby manager like rbenv/ruby
 With this example, will basically just ignore the project's Gemfile.  Debian 12 has a pretty current ruby version so just using it.
 
 ```
-sudo apt install ruby ruby-rack puma ruby-erubi ruby-tilt
+sudo apt install ruby ruby-rack puma ruby-erubi ruby-tilt ruby-sequel ruby-sqlite3 rake
 sudo gem install roda rack-unreloader
+
+cd my-project
 ```
 
-#### Option 2: Bundler
+#### Option 2a: Bundler system package
 
-Run the bundle command from the project's root directory
+Run the bundle install command from the project's root directory
 
 ```
-sudo apt install ruby ruby-bundler
-bundle config set --local path 'vendor/bundle'
+sudo apt install ruby ruby-bundler ruby-dev gcc pkgconf make g++ libyaml-dev libffi-dev
+echo 'gem:  --no-document' >> ~/.gemrc
+sudo cp ~/.gemrc /root/
+bundle config set --global path 'vendor/bundle'
+sudo cp -r .bundle /root/
+
+cd my-project
 bundle install
 ```
 
+#### Option 2b: Bundler system gem (recommended)
+
+Similar to above but might as well use the gem install to get the latest bundler.  The Debian apt packaged bundler is currently a bit outdated and missing some features compared to the latest.
+
+```
+sudo apt install ruby ruby-dev gcc pkgconf make g++ libyaml-dev # zlib1g-dev libffi-dev #(for rails stuff) 
+echo 'gem:  --no-document' >> ~/.gemrc
+sudo cp ~/.gemrc /root/
+sudo gem install bundler
+bundle config set --global path 'vendor/bundle'
+sudo cp -r .bundle /root/
+
+cd my-project
+bundle install
+```
+
+#### Option 3: Rbenv Ruby
+
+Todo
+
 ## Run it
 
 In the project root directory:
 
 ```
+bundle exec puma
+
+# or if you did not use bundler to install puma...
 puma
 ```
 
 This default to development mode.  Run it in production mode with:
 
 ```
+RACK_ENV=production bundle exec puma
+
+# or if you did not install puma
 RACK_ENV=production puma
 ```
 
@@ -53,7 +99,7 @@ For development, just run it like that.  For production, probably want to set up
 
 ### Run it with systemd in production
 
-Copy the example myapp.service file to `/etc/systemd/system/` and edit accordingly.  The example assumes a user named "myapp" with a group name "myapp", the application files are in `/opt/myapp/`, and puma is the system puma.
+Copy the example myapp.service file to `/etc/systemd/system/` and edit accordingly.  The example assumes a user named "myapp" with a group name "myapp", the application files are in `/opt/myapp/`, and puma is the system puma.  If you installed puma with bundler, the exe will be at `/opt/myapp/vendor/bundle/ruby/3.1.0/bin/puma`.
 
 ### Notes
 

Rakefile

@@ -0,0 +1,33 @@
+namespace :db do
+
+  migrator = lambda do |version|
+    require_relative 'db'
+    Sequel.extension :migration
+    Sequel::Migrator.apply(DB, 'migrate', version)
+  end
+
+  namespace :migrate do
+
+    desc "Perform migration up to latest migration available"
+    task :up do
+      migrator.call(nil)
+    end
+
+    desc "Perform migration all the way down (erase all data)"
+    task :down do
+      migrator.call(0)
+    end
+
+  end
+
+  desc "Erase all data, then bring back to latest migration"
+  task :reset do
+    migrator.call(0)
+    Sequel::Migrator.apply(DB, 'migrate')
+  end
+  
+  #desc "Migrate to a specific version"
+  #task :migrate do |version|
+  #end
+
+end

app.rb

@@ -14,10 +14,17 @@ class App < Roda
       view :index
     end
 
-    r.is String do |name|
-      @page_title = 'A Custom Greeting'
-      @name = name.capitalize
-      view :greeting
+    r.is 'users' do
+      @users = User.order(:id)
+      view :users
+    end
+
+    r.on 'hello' do
+      r.is String do |name|
+        @page_title = 'A Custom Greeting'
+        @name = name.capitalize
+        view :greeting
+      end
     end
   end
 end

config.ru

@@ -3,7 +3,8 @@ dev = ENV['RACK_ENV'] == 'development'
 
 require 'rack/unreloader'
 
-Unreloader = Rack::Unreloader.new(:subclasses=>%w'Roda', :reload=>dev){App}
+Unreloader = Rack::Unreloader.new(:subclasses=>%w'Roda Sequel::Model', reload: dev, autoload: dev){App}
+Unreloader.require './models.rb'
 Unreloader.require './app.rb'
 
 run(dev ? Unreloader : App)

db.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+require 'sequel/core'
+
+DB = Sequel.connect('sqlite://temp.db')

migrate/001_create_users_table.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  change do
+    create_table(:users) do
+      primary_key :id
+      String :name, unique: true, null: false
+    end
+  end
+end
+

models.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+require_relative 'db'
+require 'sequel/model'
+
+if ENV['RACK_ENV'] == 'development'
+  Sequel::Model.cache_associations = false
+end
+
+unless defined?(Unreloader)
+  require 'rack/unreloader'
+  Unreloader = Rack::Unreloader.new(reload: false, autoload: !ENV['NO_AUTOLOAD'])
+end
+
+Unreloader.autoload('models'){|f| Sequel::Model.send(:camelize, File.basename(f).sub(/\.rb\z/, ''))}

models/user.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+class User < Sequel::Model
+end

views/greeting.erb

@@ -1,3 +1,3 @@
-<p class="subtitle is-3">
+<p class="subtitle">
   Hello, <%= @name %>!
 </p>

views/index.erb

@@ -1,3 +1,3 @@
-<p class="subtitle is-3">
-  Welcome to my new page!
+<p class="subtitle">
+  Welcome to my new page!  Running in <%= ENV['RACK_ENV'] %> mode!
 </p>

views/layout.erb

@@ -1,16 +1,17 @@
 <!DOCTYPE html>
 <html>
   <head>
-    <meta charset="utf-8"/>
+    <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <title><%= @page_title || "My Website" %></title>
-    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bulma@0.9.4/css/bulma.min.css">
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bulma@1/css/bulma.min.css">
   </head>
   <body>
   <section class="section">
     <div class="container">
-      <h1 class="title is-1"><%= @page_title || 'Page Title Placeholder' %></h1>
-      <% # maybe put a flash section here some day %>
+      <h1 class="title">
+        <%= @page_title || 'Page Title Placeholder' %>
+      </h1>
       <%== yield %>
     </div>
   </section>

views/users.erb

@@ -0,0 +1,5 @@
+<% for u in @users do %>
+  <p class="subtitle">
+    Hello, <%= u.name %>!  You're #<%= u.id %>!
+  </p>
+<% end %>