boba 0.0.3 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76f99ba4fafb5f1a55c1abb60b0c099569f3f4153c4f0f0b43ced158e02fb59b
-  data.tar.gz: 1de40e562d0dbeb3c0b2a987cd4e2898321a62550a239941cb129f5690da042d
+  metadata.gz: e16935e2db06568259ab419c305c0ed064d4fba98c58d4a1f20dab74dd7daa26
+  data.tar.gz: 96a1a1e8220ce8dc7a3e9a7c2a7a9b0c675fbfcf4e0c5544b033889265c3c1e4
 SHA512:
-  metadata.gz: fbc7d9e5ee8248a1175e499f891716d0397136cc20e1e6db65c22c6d61d777ea756c2c992e48694375358a748986bca2bd2c70393601c8185faf49e1ea7f9e39
-  data.tar.gz: 23d4d817f6b1a14345599d027c5fbed2203a32709d1cd955568ee69b7475b4551e31308936c02d4e2c26c403af292070f301c9258eed40fdba0b17414ad346f4
+  metadata.gz: 246e8b2873276f8e87909aae71dc14143e5635f201246a0b1c9a91a8aa60cec73dfa6e1871672a6e050099f217e646777c0c08a5e9bf5d2ff56cfd71a15de90a
+  data.tar.gz: 9eb1b1c15ba3939c3aec1e76ed83258940d3f3c2afa1f6f054d6189edcbcd65a2f4f853c81a925c2245ed2dd512563eeb689febf7d12fd756f368c2487c20478

data/README.md

@@ -4,9 +4,7 @@
 
 Boba is a collection of compilers for Sorbet & Tapioca.
 
-Tapioca is very opinionated about what types of compilers or changes are accepted into the repository. See
-[here](https://github.com/Shopify/tapioca?tab=readme-ov-file#dsl-compilers). Boba come in all
-different shapes, sizes, consistencies, etc, and is much less opinionated about what is or is not accepted. Boba is a collection of optional compilers that you can pick and choose from.
+Tapioca is very opinionated about what types of compilers or changes are accepted into the repository. See [here](https://github.com/Shopify/tapioca?tab=readme-ov-file#dsl-compilers). Boba come in all different shapes, sizes, consistencies, etc, and is much less opinionated about what is or is not accepted. Boba is a collection of optional compilers that you can pick and choose from.
 
 ### Available Compilers
 
@@ -21,8 +19,7 @@ group :development do
 end
 ```
 
-We recommend you also use the `only` configuration option in your Tapioca config (typically `sorbet/tapioca/config.yml`)
-to specify only the Tapioca compilers you wish to use.
+We recommend you also use the `only` configuration option in your Tapioca config (typically `sorbet/tapioca/config.yml`) to specify only the Tapioca compilers you wish to use.
 ```yml
 dsl:
   only:
@@ -31,6 +28,36 @@ dsl:
 ```
 This makes it easy to selectively enable only the compilers you want to use in your project.
 
+### Typing Relations
+
+If you'd like to use relation types in your sigs that are less broad than `ActiveRecord::Relation`, such as those specific to a model, Boba provides a railtie to initialize these constants for each class. Move Boba in your gemfile out of the development group:
+
+```ruby
+  gem 'boba'
+```
+
+The railtie will automatically define the `PrivateRelation` constant on each model that inherits from `ActiveRecord::Base`. It can then be used in typing, like thus:
+```ruby
+class Post < ::ActiveRecord::Base
+  scope :recent -> { where('created_at > ?', Date.current) }
+
+  belongs_to :author
+  has_many :comments
+end
+
+sig { params(author: Author).returns(Post::PrivateRelation) }
+def posts_from_author(author); end
+```
+
+and the following should not raise an error:
+
+```ruby
+sig { params(author: Author).returns(Post::PrivateRelation) }
+def recent_posts_from_author(author)
+  posts_from_author(author).recent
+end
+```
+
 ## Contributing
 
 Bugs and feature requests are welcome and should be [filed as issues on github](https://github.com/angellist/boba/issues).
@@ -39,9 +66,7 @@ Bugs and feature requests are welcome and should be [filed as issues on github](
 
 Compilers for any commonly used Ruby or Rails gems are welcome to be contributed. See the [Writing New Compilers section of the Tapioca docs](https://github.com/Shopify/tapioca?tab=readme-ov-file#writing-custom-dsl-compilers) for an introduction to writing compilers.
 
-Since Boba is intended to be used alongside Tapioca and the compilers provided by Boba are intended to be fully optional,
-we will not accept compilers which overwrite the Tapioca default compilers. See the [Tapioca Manual](https://github.com/Shopify/tapioca/blob/main/manual/compilers.md) for a list of these
-compilers. Instead, compilers which extend or overwrite the default Tapioca compilers should be given unique names.
+Since Boba is intended to be used alongside Tapioca and the compilers provided by Boba are intended to be fully optional, we will not accept compilers which overwrite the Tapioca default compilers. See the [Tapioca Manual](https://github.com/Shopify/tapioca/blob/main/manual/compilers.md) for a list of these compilers. Instead, compilers which extend or overwrite the default Tapioca compilers should be given unique names.
 
 Contributed compilers should be well documented, and named after and include a link or reference to the Gem, DSL, or other module they implement RBIs for.
 

data/lib/boba/relations_railtie.rb

@@ -0,0 +1,26 @@
+# typed: true
+# frozen_string_literal: true
+
+require "rails/railtie"
+
+class Boba::RelationsRailtie < Rails::Railtie
+  railtie_name(:boba)
+
+  initializer("boba.add_private_relation_constant") do
+    ActiveSupport.on_load(:active_record) do
+      module AciveRecordInheritDefineRelationTypes
+        def inherited(child)
+          super(child)
+
+          child.const_set("PrivateRelation", Object)
+        end
+      end
+
+      class ::ActiveRecord::Base
+        class << self
+          prepend AciveRecordInheritDefineRelationTypes
+        end
+      end
+    end
+  end
+end

data/lib/boba/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Boba
-  VERSION = "0.0.3"
+  VERSION = "0.0.5"
 end

data/lib/boba.rb

@@ -0,0 +1,7 @@
+# typed: true
+# frozen_string_literal: true
+
+module Boba
+  require "boba/version"
+  require "boba/relations_railtie" if defined?(Rails)
+end

data/lib/tapioca/dsl/compilers/state_machines_extended.rb

@@ -0,0 +1,37 @@
+# typed: ignore
+# frozen_string_literal: true
+
+return unless defined?(Tapioca)
+
+require "tapioca/dsl/compilers/state_machines"
+
+module Tapioca
+  module Dsl
+    module Compilers
+      # `Tapioca::Dsl::Compilers::StateMachinesExtended` extends the default state machines compiler provided by Tapioca
+      # to allow for calling `with_state` and `without_state` on all Active Record relations. This is a temporary fix
+      # until a more durable solution can be found for this type of issue.
+      # See https://github.com/Shopify/tapioca/pull/1994#issuecomment-2302624697.
+      class StateMachinesExtended < ::Tapioca::Dsl::Compilers::StateMachines
+        ACTIVE_RECORD_RELATION_MODULE_NAMES = [
+          "GeneratedRelationMethods",
+          "GeneratedAssociationRelationMethods",
+        ].freeze
+
+        def decorate
+          return if constant.state_machines.empty?
+
+          super()
+
+          root.create_path(T.unsafe(constant)) do |klass|
+            class_module_name = "StateMachineClassHelperModule"
+
+            ACTIVE_RECORD_RELATION_MODULE_NAMES.each do |module_name|
+              klass.create_module(module_name).create_include(class_module_name)
+            end
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: boba
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.5
 platform: ruby
 authors:
 - Angellist
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-21 00:00:00.000000000 Z
+date: 2024-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sorbet-static-and-runtime
@@ -47,18 +47,21 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- lib/boba.rb
+- lib/boba/relations_railtie.rb
 - lib/boba/version.rb
 - lib/tapioca/dsl/compilers/active_record_associations_persisted.rb
 - lib/tapioca/dsl/compilers/active_record_columns_persisted.rb
 - lib/tapioca/dsl/compilers/money_rails.rb
+- lib/tapioca/dsl/compilers/state_machines_extended.rb
 homepage: https://github.com/angellist/boba
 licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/angellist/boba/issues
-  changelog_uri: https://github.com/angellist/boba/blob/0.0.3/History.md
+  changelog_uri: https://github.com/angellist/boba/blob/0.0.5/History.md
   homepage_uri: https://github.com/angellist/boba
-  source_code_uri: https://github.com/angellist/boba/tree/0.0.3
+  source_code_uri: https://github.com/angellist/boba/tree/0.0.5
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []