shill 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c856b97b9e77c751f97f81f2b4ccf1d4bab2d939ad808d86cd86703bbe7616ae
-  data.tar.gz: 2aee215e4a54aed30f179e7da637a3ede554e3a689bc36690f39d7251b1941e0
+  metadata.gz: 4f0ffc8cf45e7690dea17a48ab6370bb9016df49f0e6ca70b701c782316db2ae
+  data.tar.gz: 37f21d5c06c84e3f4afd104331476fb17a8f5789cf6c1bfd230678b5b94218e1
 SHA512:
-  metadata.gz: 7d7abda12e3b7d075e20cce210951639a814379542537cc922cc216178f39e2f6fbbc55ed6ff2bee8973890758f8ff71965d1c87cb128b70ef3757a561ba37a7
-  data.tar.gz: 4dd8770a375b40f3d2440ca5a51859abbd3447306cf1bc8e9df136cbebc1f38daeca369962510fe6865715a349f21bd37fee15a8463cb03ca1871e85217f7427
+  metadata.gz: fa60818f20a34a3080ea6dc83f58a005b546ce59f56a277b245e1f46e6332e284de696e3fe654000b3e8fd0aa3d34ab4401dd3145e0f2a9bb86073a19c8b4329
+  data.tar.gz: a2add6060a5e0af99d10faadd0ce372d054c1780b7515620dae1a6bcc66b33b1e17735c0c2dd9e6a81ca321d8ea9e99a29b3fb236e45e0b8414131d3a6b7076c

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.1.1] - 2025-05-15
+
+- Fix: Replace example URLs
+
 ## [0.1.0] - 2025-05-15
 
 - Initial release

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:
@@ -115,6 +114,39 @@ bundle install
 bundle exec rake test    # runs the Minitest suite
 ```
 
+### Releasing a new version
+
+1. Bump the version in `lib/shill/version.rb` following [Semantic Versioning](https://semver.org/) (e.g. `0.1.1` → `0.1.2`).
+2. Update `CHANGELOG.md` (optional but recommended).
+3. Commit the changes:
+
+    ```bash
+    git commit -am "Bump version to x.y.z"
+    ```
+
+4. Run the Bundler release task (builds, pushes the gem, and tags the commit):
+
+    ```bash
+    bundle exec rake release      # same as `rake release`
+    ```
+
+    Behind the scenes this will:
+
+    * Run `rake build` → creates `pkg/shill-x.y.z.gem`.
+    * Run `gem push` to upload the new gem to RubyGems.org using your saved API key.
+    * Create a Git tag `vX.Y.Z` and push it to the origin.
+
+5. Done! The new version will be live on RubyGems within a minute or so.
+
+If you prefer to do things manually you can replicate the steps yourself:
+
+```bash
+rake build                       # => pkg/shill-x.y.z.gem
+gem push pkg/shill-x.y.z.gem     # upload
+git tag -a vX.Y.Z -m "Release vX.Y.Z"
+git push && git push --tags
+```
+
 ---
 
 ## Contributing
@@ -146,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.0"
+  VERSION = "0.2.0"
 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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shill
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Marc Köhlbrugge
@@ -24,16 +24,18 @@ 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/example/shill
+homepage: https://github.com/marckohlbrugge/shill
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/example/shill
-  source_code_uri: https://github.com/example/shill
-  changelog_uri: https://github.com/example/shill/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/marckohlbrugge/shill
+  source_code_uri: https://github.com/marckohlbrugge/shill
+  changelog_uri: https://github.com/marckohlbrugge/shill/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths: