shill 0.1.1 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b37e2e8280c1b400c3d5a9d8faa3a292eadc7835090f01511c1d28658d101d1
-  data.tar.gz: 8c9584c5fddc36f5aa515119244687771ac4b2cc32aec5be0e4f2318627a8147
+  metadata.gz: 524172e34543e6279787babb3e191d017c60da59221f550c93057f7a0b223c98
+  data.tar.gz: f9a4ebc9597c2a32f7207d3920e66efcaec55472464228c4b0a796882525bf84
 SHA512:
-  metadata.gz: 7ebf69a9daf634fc8d66547044274e8cd15df36e14fb5216e4fca278ff32c7b3b0b17bb0f7bb2216fdb11aee1322e16452e3476d5d3864b6604ae6af680e18ea
-  data.tar.gz: f1d1170b2606988b8bffee707851191bb921a84c52deb723f27fe7e317bd92ef2b30fe1b803557ca1e656975dd51ff1a7b251e993f1492af2b4f9934a25dcc17
+  metadata.gz: 49d711dd937079351e88e3e1a1365d4b83057de33ab8699e73a9e1fb7de2c89d31de28d147e35d7d404b78bd483b8535c6cf1ccd7bdc63af2dbe594c1c57bbb8
+  data.tar.gz: e0896a8544989da97e060d903991d6b66fdb6348fff6345d3959ed0623f6fe89bb0160d35e917b5a60a3ebd40859e93b78f77f7fcb6572a00c66ef49b27575e2

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.2.1] - 2025-05-15
+
+- Change: `fetch_projects` now always raises `Shill::Error` on failure instead of silently returning `nil`. This prevents `Shill.projects` from ever returning `nil`.
+
+## [0.2.0] - 2025-05-15
+
+- Feature: `shill_projects` and `shill_random_project` view helpers auto-load in Rails apps.
+
 ## [0.1.1] - 2025-05-15
 
 - Fix: Replace example URLs

data/README.md

@@ -14,8 +14,7 @@ A tiny, dependency-free Ruby gem that fetches and exposes a list of projects fro
 Add the gem to your project:
 
 ```ruby
-gem "shill", github: "marckohlbrugge/shill"   # until published on RubyGems
-gem "shill"                                   # once published
+gem "shill"
 ```
 
 Then install:
@@ -179,3 +178,27 @@ Shill.projects(refresh: true)   # bypasses cache and stores fresh data
 ```
 
 ---
+
+## Rails view helpers
+
+Once the gem is loaded in a Rails app, you can access the data directly in any view:
+
+```erb
+<ul>
+  <% shill_projects.each do |project| %>
+    <li>
+      <%= link_to project.name, project.url %> — <%= project.description %>
+    </li>
+  <% end %>
+</ul>
+```
+
+Need just one?
+
+```erb
+<% if (proj = shill_random_project) %>
+  <%= link_to proj.name, proj.url %>
+<% end %>
+```
+
+---

data/lib/shill/helpers.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Shill
+  # View-helper methods for Rails
+  module Helpers
+    # Returns all cached projects (see Shill.projects)
+    def shill_projects
+      Shill.projects
+    end
+
+    # Returns a single random project
+    def shill_random_project
+      Shill.random_project
+    end
+  end
+end 

data/lib/shill/railtie.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "rails/railtie"
+
+module Shill
+  class Railtie < ::Rails::Railtie
+    initializer "shill.view_helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include Shill::Helpers
+      end
+    end
+  end
+end 

data/lib/shill/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Shill
-  VERSION = "0.1.1"
+  VERSION = "0.2.1"
 end

data/lib/shill.rb

@@ -1,6 +1,13 @@
 # frozen_string_literal: true
 
 require_relative "shill/version"
+# Autoload internal files
+require_relative "shill/helpers"
+
+# Load Railtie if Rails is present
+if defined?(Rails::Railtie)
+  require_relative "shill/railtie"
+end
 
 module Shill
   class Error < StandardError; end
@@ -99,8 +106,8 @@ module Shill
       # Return an array of Project objects for nicer dot-notation access.
       parsed.map { |attrs| Project.new(attrs) }
     rescue StandardError => e
-      # Re-wrap into Shill::Error to keep API consistent
-      raise Error, e.message unless e.is_a?(Error)
+      # Always propagate as Shill::Error so callers never receive `nil`.
+      raise Error, e.message
     end
 
     # Ensure we have an array of hashes with required keys.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shill
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
 platform: ruby
 authors:
 - Marc Köhlbrugge
@@ -24,6 +24,8 @@ files:
 - README.md
 - Rakefile
 - lib/shill.rb
+- lib/shill/helpers.rb
+- lib/shill/railtie.rb
 - lib/shill/version.rb
 - sig/shill.rbs
 homepage: https://github.com/marckohlbrugge/shill