piko-tools 1.0.1 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 707325cfcdbacb3bdc3593c85dc36fdfa8cca8022221fae40de7c61c3b03ecc9
-  data.tar.gz: ed49ea56c64556b74dc4a8217cce3e58c50dc3422cd35e200906ee4e4b3601ff
+  metadata.gz: b24d94cf9680123a4cc1c2b421fe6d35db7ddc083dcf5558f8cbcf2950e115cf
+  data.tar.gz: 0a43ccdded4b3f0122a2a21eebd6f8a974925663c454f172ca21814bbb145727
 SHA512:
-  metadata.gz: 84f7eb1e60b7cefba7af8f7b9d2e254876c8847e72a7c7809e49111881e2766ac5533225672c84dc46623a307b8a294cefa76e953dbde983a77560d2de230177
-  data.tar.gz: 90b8556195e4bc810b0a3fc45f8a6715523f97be089f8c39d22fc6425071cb863871be67a58d25ef7d429eca9f70279d5ee09f756555cff1c8149fcb7725d76a
+  metadata.gz: 11b82066788856f87b1ece4f1b41345f8d5a10cfce114091378998bee60a057917e5a961b0456e335bee773cf4f2139575040afef6398740956a036db2ef0cda
+  data.tar.gz: 7be734cea5b77fb79e92da3fcce5c32d04ddff0e8292f49dc0dfdb7ecbd6368d6e83a5c775392b21b8f0dc46563bd48ad2b86e7ec5833cbf19568d26a9070b34

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.0.2] - 2025-09-02
+
+### Fixed
+
+- Fix state check
+
+## [1.0.1] - 2025-09-02
+
+### Added
+
+- Add exception for starting undefined keys
+
 ## [1.0.0] - 2025-07-07
 
 Init
@@ -8,6 +20,10 @@ Init
 
 - Init
 
+[1.0.2]: https://gitlab.com/skopciewski/piko-tools/-/compare/1.0.1...1.0.2
+
+[1.0.1]: https://gitlab.com/skopciewski/piko-tools/-/compare/1.0.0...1.0.1
+
 [1.0.0]: https://gitlab.com/skopciewski/piko-tools/-/compare/0.0.0...1.0.0
 
 [0.0.0]: https://gitlab.com/skopciewski/piko-tools

data/README.md

@@ -1,23 +1,85 @@
-# Piko-tools
+# PikoTools
+
+Micro-framework for building applications with data-driven architecture.
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add to your Gemfile:
 
-    gem 'piko-tools'
+```ruby
+gem "piko-tools"
+```
 
-And then execute:
+Or install directly:
 
-    $ bundle
+```bash
+gem install piko-tools
+```
 
-Or install it yourself as:
+## Usage
 
-    $ gem install piko-tools
+### State
 
-## Usage
+Lazy lifecycle manager with start/stop semantics.
+
+```ruby
+state = PikoTools::State.new do |s|
+  s.define(:db,     -> { Database.connect },     stop: ->(conn) { conn.close })
+  s.define(:cache,  -> { Cache.new },             stop: ->(c)    { c.flush })
+  s.define(:logger, -> { Logger.new })
+end
+
+# Lazy start — connects on first access
+logger = state[:logger]
+
+# Query state
+state.started?(:db)     # => false
+state.start_all
+state.started?(:db)     # => true
+
+# Stop with teardown callback
+state.stop(:db)         # calls Database#close
+
+# Reload (stop + start)
+state.reload(:cache)
+
+# Stop all in reverse order, then clear definitions
+state.clear!
+```
+
+### Builder
+
+Fluent builder for composing objects with keyword arguments.
+
+```ruby
+class Handler
+  def initialize(args = {})
+    @args = args
+  end
+end
+
+handler = PikoTools::Builder.new(Handler)
+  .set(foo: 1, bar: 2)
+  .build(baz: 3)
+
+handler    # => #<Handler @args={foo: 1, bar: 2, build_args: {baz: 3}}>
+```
+
+### Component
+
+Mixin providing config-based private attributes via `OpenStruct`.
+
+```ruby
+class MyComponent
+  include PikoTools::Component
+  attr_struct :host, :port
+end
 
-## Versioning
+component = MyComponent.new(host: "localhost", port: 3000)
+component.send(:host)  # => "localhost"
+component.send(:port)  # => 3000
+```
 
-See [semver.org][semver]
+## Requirements
 
-[semver]: http://semver.org/
+Ruby >= 3.2. No runtime dependencies.

data/lib/piko_tools/component.rb

@@ -1,5 +1,3 @@
-require "ostruct"
-
 module PikoTools
   module Component
     def self.included(base)
@@ -9,7 +7,7 @@ module PikoTools
 
     module PrepMethods
       def initialize(config = {})
-        @config = OpenStruct.new(config.to_h).to_h
+        @config = config.to_h.transform_keys(&:to_sym)
         super if initialize_in_ancestor?
       end
 

data/lib/piko_tools/state.rb

@@ -17,14 +17,12 @@ module PikoTools
 
     def start(key)
       return @instances[key] if started?(key)
-      # puts "[system] starting #{key}"
+      raise KeyError, "Key not defined: '#{key}'" unless define?(key)
       @instances[key] = @definitions[key][:start].call
     end
 
     def stop(key)
       return unless started?(key)
-      raise KeyError, "Key not defined: '#{key}'" unless defined?(key)
-      # puts "[system] stopping #{key}"
       @definitions[key][:stop]&.call(@instances[key])
       @instances.delete(key)
     end
@@ -37,7 +35,7 @@ module PikoTools
       @instances.key?(key)
     end
 
-    def defined?(key)
+    def define?(key)
       @definitions.key?(key)
     end
 

data/lib/piko_tools/version.rb

@@ -1,3 +1,3 @@
 module PikoTools
-  VERSION = "1.0.1"
+  VERSION = "1.0.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: piko-tools
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.3
 platform: ruby
 authors:
 - Szymon Kopciewski