lantern-rails 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a10d9bbf6c76960298040e88390464ba2d451640e1abfb62bd5e7f8b46dc3aa9
-  data.tar.gz: 8e86338e7c02d61ef522140726562c5941ab725daf823360d748ab9402da7b8c
+  metadata.gz: 9e80b02c09f20e01a8a0b0f4f502708feba44f3d8bffaa9cf0bbded0ee2bf079
+  data.tar.gz: 4dba6effb791874dbd11fe35d125b6637668b75792f3fd3c0efe9bf1069e9fcc
 SHA512:
-  metadata.gz: 57cfc0136452511b7a42e5799489a09450e39f22828505506f7c1c6150101a901779c01e4adae57c4add0b47e4da22b6deb7bfd88004470358c5da7de93e10c0
-  data.tar.gz: 55de2b34703ca25621026c177c35a701b0bacb323bb0a5c96f0ba2b74ae64574141c496ff621104d14de382900649b25bfb79e453f4a98b1da9955f276033909
+  metadata.gz: 0feab9b70da80d79b7455d28703ce83cc252520ca75988976751efea292d4bd201b8ecd25e133f4050f9a7be32f96a1b54b2fade5539eed629b16299fbe15f2d
+  data.tar.gz: 20c7cc314a052d6bc9d12de1b4175bc5b83b8f0670cb06ba4c20505f577bb6837d3c61c43c86f14ef10f7e4e68cf4b3acd4eda3548ec5e41b692780beb125f0c

data/README.md

@@ -16,50 +16,24 @@ Then run:
 bundle install
 ```
 
-## Setup
+## Quick start
 
-1. Generate an API key at [uselantern.dev](https://uselantern.dev)
-2. Store the key using one of the options below
-3. Create an initializer
-
-### Store your API key
-
-**Option A: Environment variable**
+1. Sign up for a free API key at [uselantern.dev](https://uselantern.dev)
+2. Run the installer:
 
 ```
-LANTERN_API_KEY=lnt_your_key_here
+rails generate lantern:install
 ```
 
-**Option B: Rails credentials**
+3. Add your API key to the generated initializer (`config/initializers/lantern.rb`) via environment variable or Rails credentials:
 
 ```
-bin/rails credentials:edit
-```
-
-Flat:
-```yaml
-lantern_api_key: lnt_your_key_here
-```
-
-Or nested:
-```yaml
-lantern:
-  api_key: lnt_your_key_here
+LANTERN_API_KEY=lnt_your_key_here
 ```
 
-### Create the initializer
-
-```ruby
-# config/initializers/lantern.rb
-Lantern::Rails.configure do |config|
-  # Match how you stored the key above:
-  config.api_key = ENV["LANTERN_API_KEY"]
-  # Or: config.api_key = Rails.application.credentials.lantern_api_key
-  # Or: config.api_key = Rails.application.credentials.dig(:lantern, :api_key)
-end
-```
+4. Deploy — Lantern starts collecting automatically.
 
-That's it. The collector starts automatically when your Rails app boots in production.
+That's it. Open [uselantern.dev](https://uselantern.dev) to see your dashboard.
 
 ## Configuration
 

data/lib/generators/lantern/install_generator.rb

@@ -0,0 +1,23 @@
+module Lantern
+  class InstallGenerator < ::Rails::Generators::Base
+    source_root File.expand_path("templates", __dir__)
+
+    desc "Creates a Lantern initializer with your API key."
+
+    def copy_initializer
+      template "lantern.rb.tt", "config/initializers/lantern.rb"
+    end
+
+    def print_next_steps
+      say ""
+      say "Lantern installed!", :green
+      say ""
+      say "Next steps:"
+      say "  1. Add your API key to config/initializers/lantern.rb"
+      say "     Get your free key at: https://uselantern.dev"
+      say "  2. Deploy your app — Lantern starts collecting automatically"
+      say "  3. Open https://uselantern.dev to see your dashboard"
+      say ""
+    end
+  end
+end

data/lib/generators/lantern/templates/lantern.rb.tt

@@ -0,0 +1,11 @@
+Lantern::Rails.configure do |config|
+  # Your API key from https://uselantern.dev
+  # Sign up for free, add a database, and copy the key here.
+  config.api_key = Rails.application.credentials.dig(:lantern, :api_key) || ENV["LANTERN_API_KEY"]
+
+  # Collection interval in seconds (default: 300 = 5 minutes)
+  # config.interval = 300
+
+  # Environments to collect in (default: production and staging)
+  # config.collect_in_environments = %w[production staging]
+end

data/lib/lantern/rails/railtie.rb

@@ -11,9 +11,24 @@ module Lantern
 
       config.after_initialize do
         config = Lantern::Rails.configuration
-        next unless config.valid?
-        next unless config.enabled
-        next unless config.collect_in_environments.include?(::Rails.env.to_s)
+
+        unless config.valid?
+          ::Rails.logger.info(
+            "[Lantern] No API key configured. Get your free key at https://uselantern.dev " \
+            "then run: rails generate lantern:install"
+          )
+          next
+        end
+
+        unless config.enabled
+          ::Rails.logger.info("[Lantern] Disabled via configuration.")
+          next
+        end
+
+        unless config.collect_in_environments.include?(::Rails.env.to_s)
+          ::Rails.logger.info("[Lantern] Skipping collection in #{::Rails.env} environment.")
+          next
+        end
 
         runner = Lantern::Rails::Runner.new(config)
 

data/lib/lantern/rails/version.rb

@@ -1,5 +1,5 @@
 module Lantern
   module Rails
-    VERSION = "0.2.2"
+    VERSION = "0.3.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lantern-rails
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Eric Mumbower
@@ -29,6 +29,8 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- lib/generators/lantern/install_generator.rb
+- lib/generators/lantern/templates/lantern.rb.tt
 - lib/lantern-rails.rb
 - lib/lantern/rails/collector.rb
 - lib/lantern/rails/configuration.rb