core-local 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7738c287512d5856b20261ebb71498a81370d3117e822239226111e461033aff
-  data.tar.gz: c1e11995c1449d4a88734e4b275c11d4df11657b8864a431c1e971235c25fe0a
+  metadata.gz: 1cbb44371e75ca683b34bde49d8e10ae841580e5e09706e58fbb9c7c41a34903
+  data.tar.gz: 1ea04b80e6abb2c54619a808d207187d90b1032918d8f241516bbd4f24a9e54f
 SHA512:
-  metadata.gz: 293baad0b168eb9e3040e127ca139f06fa79a96c23e75d56cbbae36e55f7069a638e2f734fe0c547d37cdbbb2ee760c02fde47d59bc18e422491bb2ffa07f334
-  data.tar.gz: af2f168bfb4c1e94ba09ed8d962ee25b38633cd86e2d4212726ce6d8225caf4c8f27ef2d8199fd7a3bb648d93aba130822b8771e6891ae822e0651188efa05c9
+  metadata.gz: cb5c76aeacf5f29b441e42c4302ca3254ce7109de4b14c5b92607b651eb9caa0ff977ec0ee41d08cbad61cc0afd452fa3b37ac3e07f801241ddcac381f60f2fe
+  data.tar.gz: c9de924afeae9afbde335484be912207679f5e6d21b8c104a74b5daeeb9974dd2728a16674163203d55b1b537f8ae431b52ab7eef1f5b379fa876d80058565d1

data/CHANGELOG.md

@@ -1,14 +1,27 @@
-## [v0.1.0](https://github.com/metabahn/corerb/releases/tag/2021-07-07)
+## [v0.2.0](https://github.com/bryanp/corerb/releases/tag/2023-12-24)
+
+*released on 2023-12-24*
+
+  * `dep` [#143](https://github.com/bryanp/corerb/pull/143) Deprecate `Is::*` and `Refine::*` namespaces ([bryanp](https://github.com/bryanp))
+  * `dep` [#135](https://github.com/bryanp/corerb/pull/135) Remove Ruby 2 support ([bryanp](https://github.com/bryanp))
+
+## [v0.1.2](https://github.com/bryanp/corerb/releases/tag/2021-11-02)
+
+*released on 2021-11-02*
+
+  * `chg` [#97](https://github.com/bryanp/corerb/pull/97) Designate internal state with leading and trailing double underscores ([bryanp](https://github.com/bryanp))
+
+## [v0.1.0](https://github.com/bryanp/corerb/releases/tag/2021-07-07)
 
 *released on 2021-07-07*
 
-  * `chg` [#46](https://github.com/metabahn/corerb/pull/46) Improve performance of localization by removing finalizers ([bryanp](https://github.com/bryanp))
-  * `chg` [#43](https://github.com/metabahn/corerb/pull/43) Drop Ruby 2.6 support from core-local ([bryanp](https://github.com/bryanp))
+  * `chg` [#46](https://github.com/bryanp/corerb/pull/46) Improve performance of localization by removing finalizers ([bryanp](https://github.com/bryanp))
+  * `chg` [#43](https://github.com/bryanp/corerb/pull/43) Drop Ruby 2.6 support from core-local ([bryanp](https://github.com/bryanp))
 
-## [v0.0.0](https://github.com/metabahn/corerb/releases/tag/2021-02-10)
+## [v0.0.0](https://github.com/bryanp/corerb/releases/tag/2021-02-10)
 
 *released on 2021-02-10*
 
-  * `add` [#5](https://github.com/metabahn/corerb/pull/5) Initial core-local behavior ([bryanp](https://github.com/bryanp))
+  * `add` [#5](https://github.com/bryanp/corerb/pull/5) Initial core-local behavior ([bryanp](https://github.com/bryanp))
 
 

data/lib/core/local/store.rb

@@ -7,13 +7,13 @@ module Core
     # [public] Simple key/value store, localized to a thread or fiber.
     #
     class Store
-      include Is::Global
+      include Core::Global
 
       extend Forwardable
       def_delegators :state, :[], :[]=, :fetch, :delete, :clear, :count
 
       def initialize
-        @key = :"__corerb_localized_state_#{object_id}"
+        @key = :"__corerb_localized_state_#{object_id}__"
       end
 
       # [public] Returns a proc that, when called, deletes the key from the global store.

data/lib/core/local/version.rb

@@ -2,7 +2,7 @@
 
 module Core
   module Local
-    VERSION = "0.1.1"
+    VERSION = "0.2.0"
 
     def self.version
       VERSION

data/lib/core/local.rb

@@ -1,10 +1,59 @@
 # frozen_string_literal: true
 
+require "core/extension"
+
 module Core
+  # [public] Manage thread-local program state for an object.
+  #
   module Local
     require_relative "local/store"
     require_relative "local/version"
+
+    extend Core::Extension
+
+    # [public] Localize `value` for `key` in the current thread or fiber.
+    #
+    # Be aware that you can easily introduce memory leaks into your program if you aren't careful to clean up localized
+    # state. There's two ways to approach this:
+    #
+    #   1. Pass a block to `localize`. The value will be localized and cleaned up after being yielded to the block.
+    #
+    #   2. Call `unlocalize` manually when you no longer need the localized value.
+    #
+    def localize(key, value)
+      key = localized_key(key)
+
+      Core::Local::Store[key] = value
+
+      if block_given?
+        begin
+          yield value
+        ensure
+          Core::Local::Store.delete(key)
+        end
+      else
+        value
+      end
+    end
+
+    # [public] Returns the localized value for `key`, or `fallback`.
+    #
+    def localized(key, fallback = nil)
+      Core::Local::Store.fetch(localized_key(key), fallback)
+    end
+
+    # [public] Deletes the localized value for `key`.
+    #
+    def unlocalize(key)
+      Core::Local::Store.delete(localized_key(key))
+    end
+
+    private def localized_key(name)
+      "#{localized_key_prefix}_#{name}"
+    end
+
+    private def localized_key_prefix
+      @__localized_key_prefix__ ||= "__corerb_localized_#{object_id}__"
+    end
   end
 end
-
-require_relative "../is/localized"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: core-local
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Bryan Powell
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-15 00:00:00.000000000 Z
+date: 2023-12-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: core-extension
@@ -16,30 +16,30 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: core-global
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.0'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.0'
+        version: '0.3'
 description: Manage thread-local program state.
-email: bryan@metabahn.com
+email: bryan@bryanp.org
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -49,8 +49,7 @@ files:
 - lib/core/local.rb
 - lib/core/local/store.rb
 - lib/core/local/version.rb
-- lib/is/localized.rb
-homepage: https://github.com/metabahn/corerb/
+homepage: https://github.com/bryanp/corerb/
 licenses:
 - MPL-2.0
 metadata: {}
@@ -62,14 +61,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.5.1
 signing_key:
 specification_version: 4
 summary: Manage thread-local program state.

data/lib/is/localized.rb

@@ -1,58 +0,0 @@
-# frozen_string_literal: true
-
-require "core/extension"
-
-require_relative "../core/local/store"
-
-module Is
-  # [public] Manage thread-local program state for an object.
-  #
-  module Localized
-    extend Is::Extension
-
-    # [public] Localize `value` for `key` in the current thread or fiber.
-    #
-    # Be aware that you can easily introduce memory leaks into your program if you aren't careful to clean up localized
-    # state. There's two ways to approach this:
-    #
-    #   1. Pass a block to `localize`. The value will be localized and cleaned up after being yielded to the block.
-    #
-    #   2. Call `unlocalize` manually when you no longer need the localized value.
-    #
-    def localize(key, value)
-      key = localized_key(key)
-
-      Core::Local::Store[key] = value
-
-      if block_given?
-        begin
-          yield value
-        ensure
-          Core::Local::Store.delete(key)
-        end
-      else
-        value
-      end
-    end
-
-    # [public] Returns the localized value for `key`, or `fallback`.
-    #
-    def localized(key, fallback = nil)
-      Core::Local::Store.fetch(localized_key(key), fallback)
-    end
-
-    # [public] Deletes the localized value for `key`.
-    #
-    def unlocalize(key)
-      Core::Local::Store.delete(localized_key(key))
-    end
-
-    private def localized_key(name)
-      "#{localized_key_prefix}_#{name}"
-    end
-
-    private def localized_key_prefix
-      @__localized_key_prefix ||= "__corerb_localized_#{object_id}"
-    end
-  end
-end