swifter_enum 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4faeac3f2e6714d5af882726817712536924044c725a0aa252de4f0e89072f43
-  data.tar.gz: 5c818c9815c9e4e5165475260ffd42b503b815ca7eb92307ea98a703b8c2a933
+  metadata.gz: 9b72cb72dc43be470b8170fd34843f2f2e7ddb4d64a2856c7094b63c0ba091e2
+  data.tar.gz: 791abe5497d7c623e9b5e5ef9554a00f2c242b74b4f0668e018d7cc7be2d0752
 SHA512:
-  metadata.gz: 813389dc72d261ac9aa903484829009f8853ce4a0e6c017f8529996f2816858bdd13b4e5294f10b6a1c6dd93d3c1341e5c4e9a651f6b14712bf8fdddf49255a9
-  data.tar.gz: 39941760574f2ac9438ab61537273ed593e0a813200169dcdb68f863251992b8973aada7f3b094ef0aeb6182e7f87fe5bd30d61303bbd643e5bb0313a7f0e1c5
+  metadata.gz: b4f5bf8eab4588d23098bf11bab794205369820c0b6900b7dfa9f2d51cc85d489af4a9007a807d65c392b313cfb1201249a12650e4674cc77ed682cbb52f305e
+  data.tar.gz: 0a6226463dd0041d3c4999813b483ca274af966d82665cb0b10c7385ea682012775d835196edd231f2400a542c63f14148da2abfab61c0fda825e2af9ab9e8f9

data/CHANGELOG.md

@@ -1,5 +1,10 @@
-## [Unreleased]
 
-## [0.1.0] - 2024-01-22
+
+## [0.9.0] - 2024-03-10
 
 - Initial release
+
+
+## [0.9.1] - 2024-03-10
+
+- Fix use of options to use current syntax. Use prefix: true, rather than _prefix: true

data/README.md

@@ -1,9 +1,8 @@
 # SwifterEnum
 
 SwifterEnum is a Ruby gem for creating enumerated types (enums) in Ruby on Rails applications. 
-It is inspired by Swift's enums, and allows for more expressive and feature-rich enums in your models.
 
-Rather than simply having a key/value, enums are Classes, and can have defined methods.
+It is inspired by Swift's enums, and allows you to keep logic related to your enum directly in your enum class.
 
 so - after defining
 
@@ -14,7 +13,43 @@ so - after defining
 you can then define and access methods on your enum like
 
 `video.camera.icon`
-or `video.camera.default_exposure`
+
+This avoids helper methods which distribute your enum logic around your application.
+
+**Before**
+
+helper method somewhere in the app
+
+    #app/helpers/controller_helper.rb
+
+    def icon_for(camera:)
+      ...
+    end
+
+called with
+
+    icon_for(camera:my_model.camera)
+
+**After**
+
+logic encapsluated within the enum class
+
+    #app/models/swifter_enum/camera_enum.rb
+    class CameraEnum < SwifterEnum::Base
+      def self.values
+        { videographer: 0, handcam: 1 }.freeze
+      end
+
+      def icon
+        ...
+      end
+    end
+
+called with
+
+    my_model.camera.icon
+
+I was prompted to create this gem by reading about enum approaches in [the RailsNotes Newsletter](https://railsnotes.beehiiv.com/p/issue-17-enums-value-objects-field-guide-enum-sort-in-order-of). Like any good programmer, none of those solutions *quite* met my requirements. Hopefully it will be useful. I welcome feedback, fixes and pull requests.
 
 
 ## Installation
@@ -23,16 +58,14 @@ Add this line to your application's Gemfile:
 
     gem 'swifter_enum'
 
-And then execute:
-
-    bundle install
-
 ## Usage
 
 ### Overview
 
 
-SwifterEnums act like a normal Rails enum - except that instead of returning symbol values, they return an instance of your selected class
+SwifterEnums act like a normal Rails enum - except that instead of returning string values, they return an instance of your selected class.
+
+They also have various affordances so that in many cases, you can treat them as if they return symbol values.
 
 We have a Video ActiveModel with an enum defined by
 
@@ -153,6 +186,8 @@ Now replace the definition in your model file with
 
     swifter_enum :album_status, AlbumStatusEnum, prefix: true
 
+(note - prefix: optional. I'm adding it here because it was an option I used on my original standard Rails enum)
+
 Optionally, add
 
     validates :album_status, swifter_enum: true

data/Rakefile

@@ -12,4 +12,35 @@ Rake::TestTask.new do |t|
   t.verbose = true
 end
 
+
+# publish with rake release:publish
+namespace :release do
+  desc "Read version, build gem, tag and push release"
+  task :publish do
+    # Read version
+    version_file_path = File.expand_path("../lib/swifter_enum/version.rb", __FILE__)
+    version_file_content = File.read(version_file_path)
+    version_match = version_file_content.match(/VERSION = "(\d+\.\d+\.\d+)"/)
+    unless version_match
+      puts "Version could not be found in #{version_file_path}"
+      exit 1
+    end
+    version = version_match[1]
+    gem_name = "swifter_enum-#{version}.gem"
+
+    # Build gem
+    Rake::Task["build"].invoke
+
+    # Git tag
+    system("git add .")
+    system("git commit -m 'Release version #{version}'")
+    system("git tag -a #{version} -m 'Version #{version} release'")
+    system("git push origin main --tags")
+
+    # Push gem to RubyGems
+    system("gem push pkg/#{gem_name}")
+  end
+end
+
+
 task default: [:standard, :test]

data/lib/swifter_enum/swifter_enum.rb

@@ -5,8 +5,9 @@ module SwifterEnum
 
   class_methods do
     def swifter_enum(enum_name, enum_klass, enum_options = {})
+
       # Define the enum using values from the enum class
-      enum(enum_name => enum_klass.values, **enum_options)
+      enum(enum_name, enum_klass.values, **enum_options)
 
       # Define getter method
       define_method(enum_name) do

data/lib/swifter_enum/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SwifterEnum
-  VERSION = "0.9.0"
+  VERSION = "0.9.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: swifter_enum
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Rob Jonson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-03-09 00:00:00.000000000 Z
+date: 2024-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -80,10 +80,24 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.22'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Simple enum for active record that takes inspiration from Swift's enums
-  to allow you to add logic to your enum definition. This is easy to drop-in as a
-  replacement for regular rails enums, with minimal changes required. Once you switch,
-  then you can easily extend your enums with methods.
+  to allow you to encapsulate enum logic within an enum class. This is easy to drop-in
+  as a replacement for regular rails enums, with minimal changes required. Once you
+  switch, then you can easily extend your enums with methods.
 email:
 - rob@hobbyistsoftware.com
 executables: []
@@ -104,7 +118,6 @@ files:
 - lib/swifter_enum/swifter_enum_validator.rb
 - lib/swifter_enum/version.rb
 - sig/swifter_enum.rbs
-- swifter_enum.gemspec
 homepage: https://github.com/ConfusedVorlon/SwifterEnum
 licenses:
 - MIT

data/swifter_enum.gemspec

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/swifter_enum/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "swifter_enum"
-  spec.version = SwifterEnum::VERSION
-  spec.authors = ["Rob Jonson"]
-  spec.email = ["rob@hobbyistsoftware.com"]
-
-  spec.summary = "Active Record enum that uses a class, so you can add methods."
-  spec.description = "Simple enum for active record that takes inspiration from Swift's enums to allow you to add logic to your enum definition. This is easy to drop-in as a replacement for regular rails enums, with minimal changes required. Once you switch, then you can easily extend your enums with methods."
-  spec.homepage = "https://github.com/ConfusedVorlon/SwifterEnum"
-  spec.license = "MIT"
-
-  #I'm using 3.2 and above. If you're willing/able to test on lower rubies, then please let me know and feel free to change this.
-  spec.required_ruby_version = ">= 3.2.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/ConfusedVorlon/SwifterEnum"
-  spec.metadata["changelog_uri"] = "https://github.com/ConfusedVorlon/SwifterEnum"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[bin/ test/ spec/ features/ .git appveyor Gemfile])
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_dependency "activerecord", "~> 7.0"
-  spec.add_dependency "activesupport", "~> 7.0"
-  spec.add_dependency "activemodel", "~> 7.0"
-
-  # Specify development dependencies
-  spec.add_development_dependency "sqlite3", "~> 1.4" # For using SQL
-  spec.add_development_dependency "minitest", "~> 5.22"
-
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
-end