stipa 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 387748a4e29d9918defffcbf6e020d826933bc96619f9579f27bbcc4bde3a8c8
-  data.tar.gz: e7a6122363efaeff5405b48bb5fe8b334af837b9269b8ad854fdc2aa020b8186
+  metadata.gz: c22dd3975ab3276a80054b24f2b9e04912139c30e57d2500ffbc79bdf9de37da
+  data.tar.gz: 8013ed53bddd21485caff447749c2c36fcdba2344930e283dc70003097b40337
 SHA512:
-  metadata.gz: b2787738c43370505fec1cecdf96ce6d5ff951abd4eb0c80dfd4328dad29e24c9c322c8f0d85faee29d918d40f904da6bc7cf59bfdca7383420c4644b2a897ba
-  data.tar.gz: d3bfdfcd68a3920214ab00547e9272d7d7ad2f721c4062793aa38bddaf0f256d9eeeafcc3d2ed0e49c9d5fd3df15c7cec50d917b6b0073f6667b6d642c3c9f81
+  metadata.gz: a4f9cb7efbc203c13bd8fb2a0071761b3fa28c22b63d843a40eff56a6234a30a5ba342b29da7145f3af46ff6a42ce11e4ba3fa958083e09d1a99873fba19f736
+  data.tar.gz: cae5c45e818554b9732bf6668feff3b932cf9c0cacc107b5678e5a789debe4b89eea691c0f85514be026ae566801fe0159a70f457827722fdb1a0009097e37dc

data/lib/stipa/generators/api.rb

@@ -23,6 +23,7 @@ module Stipa
 
       def files
         {
+          '.gitignore'                             => t_gitignore,
           'Gemfile'                                => t_gemfile,
           'server.rb'                              => t_server,
           'config/routes.rb'                       => t_routes(
@@ -34,6 +35,10 @@ module Stipa
         }
       end
 
+      def t_gitignore
+        t_gitignore_common
+      end
+
       def t_server
         <<~RUBY
           require 'stipa'

data/lib/stipa/generators/base.rb

@@ -23,6 +23,7 @@ module Stipa
         make_dirs
         write_files
         post_generate
+        init_git
         say done_message
       end
 
@@ -41,14 +42,46 @@ module Stipa
 
       def post_generate = nil
 
+      def init_git
+        return unless git_available?
+
+        Dir.chdir(target) do
+          system('git init -q')
+          system('git add .')
+          system("git commit -q -m 'Initial commit'")
+        end
+        say '  git     initialized repository with initial commit'
+      rescue => e
+        say "  warn    git init failed: #{e.message}"
+      end
+
       def say(msg) = puts(msg)
 
       def app_title
         name.split(/[-_]/).map(&:capitalize).join(' ')
       end
 
+      def git_available?
+        system('git --version > /dev/null 2>&1')
+      end
+
       # ── Shared templates ───────────────────────────────────────────────────────
 
+      def t_gitignore_common
+        <<~GITIGNORE
+          # Ruby
+          .bundle/
+          vendor/bundle/
+          Gemfile.lock
+
+          # OS
+          .DS_Store
+          Thumbs.db
+          *.swp
+          *.swo
+        GITIGNORE
+      end
+
       def t_gemfile
         <<~RUBY
           source 'https://rubygems.org'

data/lib/stipa/generators/vue.rb

@@ -53,6 +53,7 @@ module Stipa
 
       def files
         {
+          '.gitignore'                             => t_gitignore,
           'Gemfile'                                => t_gemfile,
           'package.json'                           => t_package_json,
           'rollup.config.js'                       => t_rollup_config,
@@ -75,6 +76,20 @@ module Stipa
         }
       end
 
+      def t_gitignore
+        t_gitignore_common + <<~GITIGNORE
+
+          # Node
+          node_modules/
+          package-lock.json
+
+          # Build output
+          public/app.js
+          public/app.js.map
+          public/vendor/
+        GITIGNORE
+      end
+
       def t_package_json
         JSON.pretty_generate(
           name: name,
@@ -84,7 +99,7 @@ module Stipa
             'copy:vue'  => 'cp node_modules/vue/dist/vue.esm-browser.prod.js public/vendor/vue.esm-browser.prod.js',
             build:       'npm run copy:vue && rollup -c',
             watch:       'rollup -c --watch',
-            dev:         'npm run copy:vue && concurrently "bundle exec ruby server.rb" "rollup -c --watch"',
+            dev:         'npm run copy:vue && concurrently "STIPA_RELOAD=1 bundle exec ruby server.rb" "rollup -c --watch"',
             typecheck:   'vue-tsc --noEmit',
           },
           devDependencies: {

data/lib/stipa/reloader.rb

@@ -0,0 +1,85 @@
+module Stipa
+  # Development file watcher that restarts the process when Ruby source files change.
+  #
+  # Enabled when:
+  #   - STIPA_RELOAD=1 environment variable is set, OR
+  #   - reload: true is passed to App#start / Server#start
+  #
+  # Strategy:
+  #   A background thread polls the mtime of all .rb files visible to Ruby
+  #   ($LOADED_FEATURES) plus any extra watch paths supplied by the user.
+  #   When a change is detected it calls exec($0, *ARGV) which replaces the
+  #   current process image with a fresh one — same PID namespace, same
+  #   command line arguments, all changes picked up from scratch.
+  #
+  # Why exec instead of in-process reload:
+  #   In-process reload requires clearing constants, unloading files, and
+  #   rebuilding the route table. exec is simpler, safer, and handles any
+  #   kind of change (routes, middleware, config, gems) without edge cases.
+  class Reloader
+    DEFAULT_INTERVAL = 0.5 # seconds between polls
+
+    def initialize(logger:, interval: DEFAULT_INTERVAL, watch: [])
+      @logger   = logger
+      @interval = interval
+      @extra    = Array(watch).map { |p| File.expand_path(p) }
+      @mtimes   = {}
+      @thread   = nil
+    end
+
+    def start
+      snapshot!
+      @thread = Thread.new { watch_loop }
+      @thread.name = 'stipa-reloader'
+      @thread.abort_on_exception = false
+      @logger.warn('reloader active — watching for file changes')
+    end
+
+    def stop
+      @thread&.kill
+    end
+
+    private
+
+    def watch_loop
+      loop do
+        sleep @interval
+        if changed?
+          @logger.warn('file change detected — restarting')
+          $stdout.flush
+          $stderr.flush
+          exec($0, *ARGV)
+        end
+      end
+    rescue => e
+      @logger.error("reloader crashed: #{e.class}: #{e.message}")
+    end
+
+    # Collect the current set of watched files: everything Ruby has loaded
+    # plus any extra paths the user specified.
+    def watched_files
+      ($LOADED_FEATURES + @extra).uniq
+    end
+
+    def snapshot!
+      watched_files.each do |path|
+        @mtimes[path] = mtime(path)
+      end
+    end
+
+    def changed?
+      watched_files.any? do |path|
+        current = mtime(path)
+        previous = @mtimes[path]
+        @mtimes[path] = current
+        current != previous
+      end
+    end
+
+    def mtime(path)
+      File.mtime(path)
+    rescue Errno::ENOENT
+      nil
+    end
+  end
+end

data/lib/stipa/server.rb

@@ -53,6 +53,7 @@ module Stipa
       max_body_size:       1 * 1024 * 1024,
       backpressure:        :drop,   # :drop (503) or :block (wait briefly)
       log_level:           :info,
+      reload:              ENV['STIPA_RELOAD'] == '1',
     }.freeze
 
     def initialize(app:, **overrides)
@@ -64,7 +65,8 @@ module Stipa
         queue_depth: @config[:queue_depth],
         on_error:    method(:pool_error),
       )
-      @running = false
+      @running  = false
+      @reloader = @config[:reload] ? Reloader.new(logger: @logger) : nil
     end
 
     # Start the server. Blocks until SIGTERM/SIGINT.
@@ -73,6 +75,7 @@ module Stipa
       @running = true
 
       register_signals
+      @reloader&.start
 
       @logger.info(
         req: nil, res: nil,
@@ -85,6 +88,7 @@ module Stipa
 
       accept_loop
     ensure
+      @reloader&.stop
       @server&.close rescue nil
       @logger.info(req: nil, res: nil, msg: 'Stīpa stopped')
     end

data/lib/stipa/version.rb

@@ -1,3 +1,3 @@
 module Stipa
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
 end

data/lib/stipa.rb

@@ -20,6 +20,7 @@
 require_relative 'stipa/version'
 require_relative 'stipa/logger'
 require_relative 'stipa/thread_pool'
+require_relative 'stipa/reloader'
 require_relative 'stipa/middleware'
 require_relative 'stipa/static'
 require_relative 'stipa/template'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stipa
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Pedro Harbs
@@ -100,6 +100,7 @@ files:
 - lib/stipa/generators/vue.rb
 - lib/stipa/logger.rb
 - lib/stipa/middleware.rb
+- lib/stipa/reloader.rb
 - lib/stipa/request.rb
 - lib/stipa/response.rb
 - lib/stipa/server.rb