inclusive 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e972fc6385483574fb08cfcc3a4cf320b162b8e7bd726a1074e917a308114bc
-  data.tar.gz: 6d1fed490b2da13b72acaaa16ebacaea3623fdd4d98904523ee8e6d6f7428ef7
+  metadata.gz: ddc29ec0efef46b8a13bfc7a1d4012928ea69918692e8901af90d841a352f830
+  data.tar.gz: 19318553d2e8204bdf1d46675f1f3325582bc8aedd04eba8f02102f082d31860
 SHA512:
-  metadata.gz: 22c5f46c10692394cff02977e1017b84009ff19f268357703b84c3ce1c2d06ca4c5f8a839dcedf98cb9dfeedb7a0f070bd27ef923df0bebcb57977cabc5bd4cc
-  data.tar.gz: 9e22d54b55eb4c10ecac7b1c5962dca0772ec66a06d3728e22a06a1c663afbf971524095b1516fb7ec80cc9bb3429cb9c5346f7711af3aaf2c1f57c25e8404f7
+  metadata.gz: da061549c1075f7734b3c5a4283b9e8df8fc9f668fc74cbe547e98e8a451c889aea9a10cf1e8f6e31197d54650ae6386605bd0c47e718a6fb661f5799e0fb0f3
+  data.tar.gz: de76bc81d7667c5c5a349bc7aad0c3e25eb4bc9c4cd4cd93f46bbf751a7c1a5a468574d82d87d04726df0752230c7c1bf7390d966f1841ec684556ea0b2d004d

data/.ruby-version

@@ -1 +1 @@
-3.1.4
+3.2.6

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [1.1.0] - 2025-08-25
+
+- Migrate to Codeberg
+
 ## [1.0.0] - 2024-06-30
 
 - Initial release

data/README.md

@@ -43,7 +43,7 @@ class GetToThePoint
 end
 ```
 
-The import syntax is an array because you can import multiple packages. The imported packages will "compose" together, meaning the methods from the various package modules will all be available simultaneously.
+The import syntax is an array because you can import multiple packages. The imported packages will "compose" together, meaning the methods from the various package modules will all be available simultaneously. (Under the hood, a new anonymous module is created with mixins of the modules you are importing as the packages.)
 
 In addition to creating instance methods using the `packages` class helper, you can use the `packages` method inline:
 
@@ -58,9 +58,28 @@ end
 This approach isn't recommended unless you're in a context where using the class helper is impossible, such as a template (ERB, etc.) or a block which is executed by a framework. You can also call the `packages` method directly on the `Inclusive` module:
 
 ```ruby
-my_math = Inclusive.packages(MyOrg::Math)
+my_math = Inclusive.packages[MyOrg::Math]
 ```
 
+Class-level methods can also be created using `packages` on the "class instance" (aka singleton class) which is also helpful for other modules:
+
+```ruby
+module MyModule
+  class << self
+    extend Inclusive::Class
+
+    packages def utils = [
+      Packages::ThingOne,
+      Packages::ThingTwo,
+    ]
+  end
+end
+
+MyModule.utils.run # a method from one of the imported packages
+```
+
+### Public Package Methods
+
 If you want to be able to call a package method directly on its own module, you can extend your module and use the `public_function` helper:
 
 ```ruby
@@ -85,37 +104,15 @@ Packages::MyPackage.some_method
 
 This is only recommended if you need to mantain an existing module's legacy behavior in a codebase while incrementally adopting Inclusive.
 
-### Packages Are Duplicated
+## but y tho 🤔
 
-One of the aspects of Inclusive which make it more useful than merely using standard Ruby modules is each imported package is actually a cloned module. This means a module can actually contain internal state, much like an object:
+Why is this gem even needed? Well, any significantly-large project (and certainly the [Bridgetown framework](https://www.bridgetownrb.com) which gave rise to this effort) will have a "pile o' functions" which are loosely-related at best. Sometimes they're all crammed into a giant utility module or two, other times they're broken out into a handful of classes or whatever…even if they don't really need to be classes in the traditional object-oriented sense. Many other languages don't seem to have an issue with just writing utility functions and explicitly importing them in places where they're needed, but that hasn't been The Ruby Way. 
 
-```ruby
-module Packages
-  module Ownership
-    attr_accessor :owner
+Until now. 😄
 
-    def owner_classname
-      owner.class.name
-    end
-  end
-end
-
-class SomeObject
-  def try_out_ownership
-    ownership = packages[Package::Ownership].tap { _1.owner = self }
-
-    puts ownership.owner_classname # this will be `SomeObject`
-  end
-end
+Maybe Inclusive isn't for you, but for what we need, it gets the job done. Give it a try!
 
-class SomeOtherObject
-  def try_out_ownership
-    ownership = packages[Package::Ownership].tap { _1.owner = self }
-
-    puts ownership.owner_classname # this will be `SomeOtherObject`
-  end
-end
-```
+----
 
 ## Development
 
@@ -125,12 +122,8 @@ To install this gem onto your local machine, run `bin/rake install`. To release
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/bridgetownrb/inclusive. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/bridgetownrb/inclusive/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://codeberg.org/jaredwhite/inclusive. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://codeberg.org/jaredwhite/inclusive/src/branch/main/CODE_OF_CONDUCT.md).
 
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the Inclusive project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/bridgetownrb/inclusive/blob/main/CODE_OF_CONDUCT.md).

data/lib/inclusive/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Inclusive
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inclusive
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Bridgetown Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-06-30 00:00:00.000000000 Z
+date: 2025-08-26 00:00:00.000000000 Z
 dependencies: []
 description:
 email: maintainers@bridgetownrb.com
@@ -25,12 +25,12 @@ files:
 - Rakefile
 - lib/inclusive.rb
 - lib/inclusive/version.rb
-homepage: https://github.com/bridgetownrb/inclusive
+homepage: https://codeberg.org/jaredwhite/inclusive
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/bridgetownrb/inclusive
-  source_code_uri: https://github.com/bridgetownrb/inclusive
+  homepage_uri: https://codeberg.org/jaredwhite/inclusive
+  source_code_uri: https://codeberg.org/jaredwhite/inclusive
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
@@ -47,7 +47,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Compose globally-scoped Ruby modules into local packages