litestack 0.4.2 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 98a82dcbe7e4fe0b215e254fac5791127142fcbfd4a156b2509434f97b58aea9
-  data.tar.gz: a914b64d6e031559b1bdca83a8198426a49005f56ca1d0b4da2a7c6cb2384ab7
+  metadata.gz: ddcc1a0b4d5a5547b3e3deec7ce5abec68e31ffce348913867368513276ac69a
+  data.tar.gz: 743a21e710d5351131a2cbe50a94de13653a034b88d08b82e470bb3aac2bdfbb
 SHA512:
-  metadata.gz: 72935d15fcced99bcc0da9cfb6c1ffcd43478a5456c073a3d8ab468a3e49f7c681bbdec861cb7c1e2c16659e0d11429e16d855be38fd30735448078977205dc9
-  data.tar.gz: ac181213e66533926ce5d075e8256dcf2c5dfa727ff7becaa244bbf053f354c564f29a294f4b2b8c1436320d41e9dc4e4697ba9e3169324bc798c60d8bfc762a
+  metadata.gz: f54bdc732995e8083791c6b214ec6058bb439548ffdcbb14f33fbbeadbca870f4941cff558cdcbfa26212e53080534c12bfacfdfa2ba8ca689f380679ef0504a
+  data.tar.gz: f0a1fe1c95a592e69175e55ad212e351d5bca907b43c4215a4eca919d8dc2dfda68d80fa0ceb74da5909bf822adf0b2ea45e9108fcf0cd995a0a4b337a908ad0

data/.standard.yml

@@ -1,3 +1,5 @@
 ignore:
   - 'test/**/*':
-    - Style/GlobalVars
+    - Style/GlobalVars
+
+ruby_version: 3.0

data/BENCHMARKS.md

@@ -125,11 +125,11 @@ On average, Litecable is quite faster than the Redis based version and offers be
 
 > ![litesearch](https://github.com/oldmoe/litestack/blob/master/assets/litesearch_logo_teal.png?raw=true)
 
-Litesearch was benchmarked against Mielsearch, both using their respective ActiveRecord integrations. Mielsearch was running on the same machine as the benchmark script and was using the default configuration options. The dataset used for testing was the infamous Enron email corpus. Redisearch was not benchmarked due to the clients being not Rails 7.1 compatible (yet), will probably bench Redisearch when they are.
+Litesearch was benchmarked against Meilisearch, both using their respective ActiveRecord integrations. Meilisearch was running on the same machine as the benchmark script and was using the default configuration options. The dataset used for testing was the infamous Enron email corpus. Redisearch was not benchmarked due to the clients being not Rails 7.1 compatible (yet), will probably bench Redisearch when they are.
 
 ### Building the index
 
-||MieliSearch|Litesearch|
+||Meilisearch|Litesearch|
 |-:|-:|-:|
 |Time to insert 10K docs|265.42 seconds|29.06 seconds|
 |Inserted docs/second|38|344|
@@ -137,4 +137,4 @@ Litesearch was benchmarked against Mielsearch, both using their respective Activ
 |Searches/second|133|19608|
 |Index rebuild|0.822|0.626|
 
-We only limited the test to 10K documents becuause MieliSearch was taking a long time to index, so we decided to stop at a reasonable sample size. The search numbers for litesearch were double checked, event against a 100K document set and they remained virtually the same. It is clear that litesearch is much faster than MieliSearch in both indexing and searching, this could be partially attributed to litesearch being a simpler text search engine, but still, the difference is huge! For rebuilding the index though, Litesearch is not that much faster than Mielisearch.
+We only limited the test to 10K documents becuause Meilisearch was taking a long time to index, so we decided to stop at a reasonable sample size. The search numbers for litesearch were double checked, event against a 100K document set and they remained virtually the same. It is clear that litesearch is much faster than Meilisearch in both indexing and searching, this could be partially attributed to litesearch being a simpler text search engine, but still, the difference is huge! For rebuilding the index though, Litesearch is not that much faster than Meilisearch.

data/CAVEATS.md

@@ -0,0 +1,20 @@
+# CAVEATS
+
+This is a document that lists some caveats that you need to consider when dealing with Litestack and SQLite applications
+
+## Single host (server) only
+
+By design, SQLite can be accessed only (in a performant and safe way) from a single host machine. That means that you cannot have things like auto-scaling of app servers since there is but a single one of them. This app server can be a huge one, with many processes, but only one app server at a time.
+
+## Containerization becomes a bit tricky
+
+Container technology was originally designed for stateless applications. Based on this, one of the core aspects of containers is that they are immutable, deploying an app to container means destroying one container and creating another. With statefull applications, like database servers and similarly SQLite based applications, this will potentially mean a down time will be perceived, which in some approaches is mitigate but not perfectly (yet). Expect some quirks when dealing with SQLite and containers.
+
+## Single writer / multi reader
+
+In its default configuration, Litestack allows one writer at a time to write to the database file, while simultaneously allowing any number of readers to access the database. Generally SQLite is pretty fast in writes, but you should be aware that a long running write operation will prevent any other writers from proceeding, for example creating an index on a very large table will stop other writers until the index creation is finished. There is no concurrent index creation facility in SQLite, yet.
+
+## Litestack does not release the GVL
+
+This also applies to the Ruby SQLite3 gem, when it is performing a query, it will not allow any other threads in the Ruby process to resume until it returns. Care should be taken when writing low latency multi-threaded applications with Litestack, it is generally recommended to use fibers over threads in that case, since everything is serialized anyway it makes sense to avoid the ovreheads of mult-threaded environments
+

data/CHANGELOG.md

@@ -1,28 +1,59 @@
 ## [Unreleased]
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.4.4...master)
+
+## [0.4.4] - 2024-05-21
+
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.4.3...v0.4.4)
+- Fix a table not defined bug for Litesearch
+- Add conditional mapping of external fields to Litesearch (backed index)
+- As a consequence of the above, support AR polymorphic associations
+- As a consequence of the above, support indexing and searching for ActionText attributes
+- Remove 'hanami-router' as a dependency, rely on vanilla Rack for Liteboard 
+- All configuratin .yml files now support ERB rendering
+- Fix adapter registration with Rails 7.2
+- Ground work for more durable job persistence in case of a process crash
+- Many minor fixes
+
+## [0.4.3] - 2024-02-15
+
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.4.2...v0.4.3)
+- Add "sequel" as a development dependency
+- Diff links in CHANGELOG (thanks Weston Ganger)
+- Fix daemonize type in liteboard (thanks Julian Rubisch)
+- Better Litecache schema (streamlined numeric value support)
+- Support for set_multi and get_multi in Litecache (read_multi and write_multi support for Rails Cache store)
+- More tests written for Litecache and Rails Litecache store
+- Experimenting with removing the Rails LocalCache as it doesn't show enough improvement in performance to compensate for the memory overhead
+- Switch Litecache to a FIFO eviction model vs LRU (thanks Julian Rubisch and Stephen Margheim)
+
 ## [0.4.2] - 2023-11-11
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.4.1...v0.4.2)
 - Add similarity search support for Litesearch (works best for non-trigram indexes)
 - Enable similarity search for ActiveRecord and Sequel models
 - Fix Litesearch tests
 - Suppress chatty Litejob exit detector when there are no jobs in flight
 - Tidy up the test folder
-- [#41](https://github.com/oldmoe/litestack/pull/41) - Fix bug in Litecable where the `connected` event was not getting propogated
+- [#41](https://github.com/oldmoe/litestack/pull/41) - Fix bug in Litecable where the `connected` event was not getting propagated
 - Add Litemetric and Liteboard info to README.doc
 - Fix the testing rake task
 
 ## [0.4.1] - 2023-10-11
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.4.0...v0.4.1)
 - Add missing Litesearch::Model dependency
 
 ## [0.4.0] - 2023-10-11
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.3.0...v0.4.0)
 - Introduced Litesearch, dynamic & fast full text search capability for Litedb
 - ActiveRecord and Sequel integration for Litesearch
 - Slight improvement to the Sequel Litedb adapter for better Litesearch integration
 
 ## [0.3.0] - 2023-08-13
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.2.6...v0.3.0)
 - Reworked the Litecable thread safety model
 - Fixed multiple litejob bugs (thanks Stephen Margheim)
 - Fixed Railtie dependency (thanks Marco Roth)
@@ -32,6 +63,7 @@
 
 ## [0.2.6] - 2023-07-16
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.2.3...v0.2.6)
 - Much improved database location setting (thanks Brad Gessler)
 - A Rails generator for better Rails Litestack defaults (thanks Brad Gessler)
 - Revamped Litemetric, now much faster and more accurate (still experimental)
@@ -39,19 +71,23 @@
 
 ## [0.2.3] - 2023-05-20
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.2.2...v0.2.3)
 - Cut back on options defined in the Litejob Rails adapter
 
 ## [0.2.2] - 2023-05-18
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.2.1...v0.2.2)
 - Fix default queue location in Litejob
 
 
 ## [0.2.1] - 2023-05-08
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.2.0...v0.2.1)
 - Fix a race condition in Litecable
 
 ## [0.2.0] - 2023-05-08
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.1.8...v0.2.0)
 - Litecable, a SQLite driver for ActionCable
 - Litemetric for metrics collection support (experimental, disabled by default)
 - New schema for Litejob, old jobs are auto-migrated
@@ -61,6 +97,7 @@
 
 ## [0.1.8] - 2023-03-08
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.1.7...v0.1.8)
 - More code cleanups, more test coverage
 - Retry support for jobs in Litejob
 - Job storage and garbage collection for failed jobs
@@ -69,6 +106,7 @@
 
 ## [0.1.7] - 2023-03-05
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.1.6...v0.1.7)
 - Code cleanup, removal of references to older name
 - Fix for the litedb rake tasks (thanks: netmute)
 - More fixes for the new concurrency model
@@ -76,6 +114,7 @@
 
 ## [0.1.6] - 2023-03-03
 
+- [View Diff](https://github.com/oldmoe/litestack/compare/v0.1.0...v0.1.6)
 - Revamped the locking model, more robust, minimal performance hit
 - Introduced a new resource pooling class
 - Litecache and Litejob now use the resource pool

data/FILESYSTEMS.md

@@ -0,0 +1,55 @@
+# Filesystems & Litestack
+
+In the containerized world we live in, many layers of the hardware/software stacks are far abstracted that we no longer know they exist. For the filesystem enthusiasts out there this is a quick overview of how Litestack (and hence SQLite) can benefit from different filesystem
+
+## XFS
+
+A very stable and trusted filesystem with excellent performance characteristics
+
+- Fast reads / writes
+
+## EXT4
+
+Another stable and performant filesystem
+
+- Fast reads / writes
+
+## F2FS
+
+Specially built for solid state storage, has an atomic write mode that is supported by SQLite
+
+- Fast reads
+- Reasonably fast durable writes in synchronous mode
+- Compression (not very useful)
+
+## ZFS
+
+Copy-on-write filesystem with a nifty set of features, very fast snapshotting but only for the FS as a whole, can send incremental snapshots to another host for backup. Naturally a lot more pages are written on write operations thus it is a bit slower in writes.
+
+- Fast reads
+- Slower writes
+- FS Snapshotting with send/recv
+- fast device cache
+- Compression
+
+## Btrfs
+
+Another CoW filesystem that delivers snapshotting and incremental send/recv at a much granular level.
+
+- Fast reads
+- Slower writes
+- Fast copies (free backups)
+- Sub volume Snapshotting with send/recv
+- Compression
+
+## Bcachefs
+
+A new CoW filesystem built on the foundations of the bcache module. Improving rapidly but still lacks a few of the common CoW fs features
+
+- Fast reads
+- Slower writes
+- fast device cache
+
+
+
+

data/Gemfile

@@ -4,3 +4,5 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in litestack.gemspec
 gemspec
+
+# gem "rails"

data/README.md

@@ -1,5 +1,9 @@
 ![litestack](https://github.com/oldmoe/litestack/blob/master/assets/litestack_logo_teal_large.png?raw=true)
 
+<a href="https://badge.fury.io/rb/litestack" target="_blank"><img height="21" style='border:0px;height:21px;' border='0' src="https://badge.fury.io/rb/litestack.svg" alt="Gem Version"></a>
+<a href='https://github.com/oldmoe/litestack/actions' target='_blank'><img src="https://github.com/oldmoe/litestack/actions/workflows/ruby.yml/badge.svg?branch=master" style="max-width:100%;" height='21' style='border:0px;height:21px;' border='0' alt="CI Status"></a>
+<a href='https://rubygems.org/gems/litestack' target='_blank'><img height='21' style='border:0px;height:21px;' src='https://img.shields.io/gem/dt/litestack?color=brightgreen&label=Rubygems%20Downloads' border='0' alt='RubyGems Downloads' /></a>
+
 All your data infrastructure, in a gem!
 
 Litestack is a Ruby gem that provides both Ruby and  Ruby on Rails applications an all-in-one solution for web application data infrastructure. It exploits the power and embeddedness of SQLite to deliver a full-fledged SQL database, a fast cache , a robust job queue, a reliable message broker, a full text search engine and a metrics platform all in a single package.
@@ -24,7 +28,7 @@ With litestack you only need to add a single gem to your app which would replace
 - Cache Server (e.g. Redis, Memcached)
 - Job Processor (e.g. Sidekiq, Goodjob)
 - Pubsub Server (e.g. Redis, PostgreSQL)
-- Fulltext Search Server (e.g. Elasticsearch, Mielisearch)
+- Fulltext Search Server (e.g. Elasticsearch, Meilisearch)
 
 To make it even more efficient, litestack will detect the presence of Fiber based IO frameworks like Async (e.g. when you use the Falcon web server) or Polyphony. It will then switch its background workers for caches and queues to fibers (using the semantics of the existing framework). This is done transparently and will generally lead to lower CPU and memory utilization.
 
@@ -55,7 +59,7 @@ litedb is a wrapper around SQLite3, offering a better default configuration that
 
 #### Direct litedb usage
 
-litedb can be used exactly as the SQLite3 gem, since litedb iherits from SQLite3
+litedb can be used exactly as the SQLite3 gem, since litedb inherits from SQLite3
 
 ```ruby
 require 'litestack'
@@ -205,7 +209,7 @@ idx.search('kamal')
 idx.search('subject: awa') 
 ```
 
-Litesearch integrates tightly with ActiveRecord ans Sequel, here are integration examples
+Litesearch integrates tightly with ActiveRecord and Sequel, here are integration examples
 
 #### ActiveRecord
 
@@ -258,7 +262,7 @@ Book.search('author: writer').limit(1).all
 > ![litemetric](https://github.com/oldmoe/litestack/blob/master/assets/litemetric_logo_teal.png?raw=true)
 
 ### Litemetric
-Litestack comes with a mdoule that can collect useful metrics for its different components, in each component, you need to add the following to the respective .yml file (database.yml in case of Litedb)
+Litestack comes with a module that can collect useful metrics for its different components, in each component, you need to add the following to the respective .yml file (database.yml in case of Litedb)
 ```yml
     metrics: true # default is false
 ```

data/ROADMAP.md

@@ -21,25 +21,25 @@ This is a list of functional/non-functional features that litestack targets to i
   - [ ] Automated testing matrix
   - [ ] Automated gem builds
 - [ ] Litedb improvements
-  - [ ] ActiveRecord Sqlite3 Adapter compatibility mode    
+  - [ ] ActiveRecord Sqlite3 Adapter compatibility mode
   - [ ] Sequel Sqlite3 Adapter compatibility mode
-  - [ ] Extension bundling/loading    
+  - [ ] Extension bundling/loading
 - [ ] Liteiob improvements
   - [ ] Persist jobs even during execution
   - [ ] Zombie job detection
-  - [ ] Better process exit handling 
+  - [ ] Better process exit handling
   - [ ] Faster job dispatch for the no delay case
 - [ ] Database maintenance scripts
   - [ ] Online backup
   - [ ] Restore
   - [ ] Litestream integration
-  - [ ] CoW filesystems specific backup path
+  - [ ] CoW filesystem-specific backup path
 - [ ] Zero downtime deployment scripts
   - [ ] Rails
-  - [ ] Genereic Rack Applications
+  - [ ] Generic Rack Applications
 - [ ] Litemetric improvements
   - [ ] Rails performance module
   - [ ] Ruby Memory/GC module
   - [ ] Restore generic module
   - [ ] Better HTML/CSS
-- [ ] Kredis replacement implementation?    
+- [ ] Kredis replacement implementation?

data/bench/bench.rb

@@ -1,5 +1,7 @@
 require "sqlite3"
 
+#RubyVM::YJIT.enable
+
 def bench(msg, iterations = 1000)
   GC.start
   # GC.compact

data/bench/bench_cache_rails.rb

@@ -1,8 +1,8 @@
 require "active_support"
 require_relative "../lib/litestack"
-require_relative "./bench"
+require_relative "bench"
 
-cache = ActiveSupport::Cache::Litecache.new({path: "../db/rails_cache.db"})
+cache = ActiveSupport::Cache::Litecache.new
 
 # can only use the lookup method when the gem is installed
 # cache = ActiveSupport::Cache.lookup_store(:litecache, {path: '../db/rails_cache.db'})
@@ -31,6 +31,21 @@ count = 1000
     redis.write(keys[i], values[i])
   end
 
+  puts "== Multi Writes =="
+  bench("litecache multi-writes", count / 5) do |i|
+    idx = i * 5
+    payload = {}
+    5.times { |j| payload[keys[idx + j]] = values[idx + j] }
+    cache.write_multi(payload)
+  end
+
+  bench("Redis multi-writes", count / 5) do |i|
+    idx = i * 5
+    payload = {}
+    5.times { |j| payload[keys[idx + j]] = values[idx + j] }
+    redis.write_multi(payload)
+  end
+
   puts "== Reads =="
   bench("litecache reads", count) do |i|
     cache.read(random_keys[i])
@@ -39,6 +54,22 @@ count = 1000
   bench("Redis reads", count) do |i|
     redis.read(random_keys[i])
   end
+
+  puts "== Multi Reads =="
+  bench("litecache multi-reads", count / 5) do |i|
+    idx = i * 5
+    payload = []
+    5.times { |j| payload << random_keys[idx + j] }
+    cache.read_multi(*payload)
+  end
+
+  bench("Redis multi-reads", count / 5) do |i|
+    idx = i * 5
+    payload = []
+    5.times { |j| payload << random_keys[idx + j] }
+    redis.read_multi(*payload)
+  end
+
   puts "=========================================================="
 
   keys = []

data/bench/bench_cache_raw.rb

@@ -1,6 +1,6 @@
 require "redis"
 require "sqlite3"
-require_relative "./bench"
+require_relative "bench"
 
 # require 'polyphony'
 require "async/scheduler"
@@ -11,7 +11,7 @@ Fiber.scheduler.run
 require_relative "../lib/litestack/litecache"
 # require 'litestack'
 
-cache = Litecache.new({path: "../db/cache.db"}) # default settings
+cache = Litecache.new # ({path: "../db/cache.db"}) # default settings
 redis = Redis.new # default settings
 
 values = []
@@ -35,28 +35,52 @@ count.times { keys << random_str(10) }
     cache.set(keys[i], values[i])
   end
 
-  # bench("file writes", count) do |i|
-  #  f = File.open("../files/#{keys[i]}.data", 'w+')
-  #  f.write(values[i])
-  #  f.close
-  # end
-
   bench("Redis writes", count) do |i|
     redis.set(keys[i], values[i])
   end
 
+  puts "== Multi Writes =="
+  bench("litecache multi-writes", count / 5) do |i|
+    idx = i * 5
+    payload = {}
+    5.times { |j| payload[keys[idx + j]] = values[idx + j] }
+    cache.set_multi(payload)
+  end
+
+  bench("Redis multi-writes", count / 5) do |i|
+    idx = i * 5
+    payload = []
+    5.times { |j|
+      payload << keys[idx + j]
+      payload << values[idx + j]
+    }
+    redis.mset(*payload)
+  end
+
   puts "== Reads =="
   bench("litecache reads", count) do |i|
     cache.get(random_keys[i])
   end
 
-  # bench("file reads", count) do |i|
-  #  data = File.read("../files/#{keys[i]}.data")
-  # end
-
   bench("Redis reads", count) do |i|
     redis.get(random_keys[i])
   end
+
+  puts "== Multi Reads =="
+  bench("litecache multi-reads", count / 5) do |i|
+    idx = i * 5
+    payload = []
+    5.times { |j| payload << random_keys[idx + j] }
+    cache.get_multi(*payload)
+  end
+
+  bench("Redis multi-reads", count / 5) do |i|
+    idx = i * 5
+    payload = []
+    5.times { |j| payload << random_keys[idx + j] }
+    redis.mget(*payload)
+  end
+
   puts "=========================================================="
 
   values = []

data/bench/bench_jobs_rails.rb

@@ -19,9 +19,9 @@ require "./rails_job"
 RailsJob.queue_adapter = :sidekiq
 t = Time.now.to_f
 puts "Make sure sidekiq is started with -c ./rails_job.rb"
-bench("enqueuing sidekiq jobs", count) do
-  RailsJob.perform_later(count, t)
-end
+#bench("enqueuing sidekiq jobs", count) do
+#  RailsJob.perform_later(count, t)
+#end
 
 puts "Don't forget to check the sidekiq log for processing time conclusion"
 

data/bench/bench_jobs_raw.rb

@@ -18,9 +18,9 @@ require "./skjob"
 
 t = Process.clock_gettime(Process::CLOCK_MONOTONIC)
 puts "make sure sidekiq is started with skjob.rb as the job"
-bench("enqueuing sidekiq jobs", count) do |i|
-  SidekiqJob.perform_async(count, t, delay)
-end
+#bench("enqueuing sidekiq jobs", count) do |i|
+#  SidekiqJob.perform_async(count, t, delay)
+#end
 
 puts "Don't forget to check the sidekiq log for processing time conclusion"
 

data/bin/liteboard

@@ -2,19 +2,23 @@
 # frozen_string_literal: true
 
 require 'optparse'
+require 'erb'
+require 'yaml'
+require 'rackup'
 require_relative '../lib/litestack/liteboard/liteboard'
 DEFAULTS = {
   config_path: Litemetric::DEFAULT_OPTIONS[:config_path],
   path: Litemetric::DEFAULT_OPTIONS[:path]
 }
 
-options = { 
+options = {
   config_path: nil,
   path: nil,
-  deamonize: false,
+  daemonize: false,
   Port: 9292,
   Host: 'localhost',
   environment: 'production',
+  pid: './liteboard.pid',
   quiet: false
 }
 
@@ -25,9 +29,9 @@ OptionParser.new do |parser|
   parser.on("-s", "--server SERVER", "use SERVER (e.g. puma/falcon/iodine)") { |v| options[:port] = v }
   parser.on("-H", "--host HOST", "listen on HOST (default: #{options[:Host]})") { |v| options[:Host] = v }
   parser.on("-p", "--port PORT", "use PORT (default: #{options[:Port]})") { |v| options[:Port] = v.to_i rescue options[:Port] }
-  parser.on("-D", "--deamonize", "run in the background") { |v| options[:deamonize] = true }  
-  parser.on("-E", "--env ENVIRONMENT", "which environment to use (default: #{options[:environment]})") { |v| options[:environment] = v }  
-  parser.on("-q", "--quiet", "turn off logging") { |v| options[:quiet] = true }  
+  parser.on("-D", "--daemonize", "run in the background") { |v| options[:daemonize] = true }
+  parser.on("-E", "--env ENVIRONMENT", "which environment to use (default: #{options[:environment]})") { |v| options[:environment] = v }
+  parser.on("-q", "--quiet", "turn off logging") { |v| options[:quiet] = true }
   parser.on("-h", "--help", "print this message") do
     puts parser
     exit
@@ -35,40 +39,39 @@ OptionParser.new do |parser|
 end.parse!
 
 def check_database(path)
-  unless File.exist?(path) 
+  unless File.exist?(path)
     puts "liteboard: missing database file, please ensure the db path is correct"
     puts "liteboard: exiting"
     exit
   end
 end
 
-check_database(options[:path]) if options[:path] 
+check_database(options[:path]) if options[:path]
 
 # if there is a config file then we need to check it
 config = nil
 if options[:config_path]
   begin
-    config = Yaml.load_file(options[:config_path]) 
+    config = YAML.load(ERB.new(File.read(options[:config_path])).result)
   rescue
     puts "liteboard: missing or bad config file, please ensure the config file path is correct"
     puts "liteboard: exiting"
     exit
-  end 
+  end
 else # no config path! use the default
-  config = Yaml.load_file(DEFAULTS[:config_path]) rescue nil 
+  config = YAML.load(ERB.new(File.read(DEFAULTS[:config_path])).result) rescue nil 
 end
 
 if config
   if options[:path].nil?
     path = config['path'] || config[options[:environment]]['path']
     options[:path] = path
-  end  
+  end
 end
 
 # if still no path we assume a default db path
 options[:path] = DEFAULTS[:path] if options[:path].nil?
 
-
 # check the validity of the path before starting the server
 check_database(options[:path])
 Litemetric.options = options
@@ -78,4 +81,4 @@ options[:app] = Liteboard.app
 require_relative '../lib/litestack'
 puts "Starting Liteboard version #{Litestack::VERSION}"
 
-Rack::Server.start(options)
+Rackup::Server.start(options)

data/gemfiles/rails70.gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gemspec path: "../"
+
+gem "rails", "~> 7.0"

data/gemfiles/rails71.gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gemspec path: "../"
+
+gem "rails", "~> 7.1"