piko-tools 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c9ae4a74e5273b80eaf96c47b449628d39ab61150bf92bfd9e2dbda159ec90c
-  data.tar.gz: 8907d0f6812d7ddbd609322325e285502610a034cc2c95272414090f638c00b4
+  metadata.gz: b24d94cf9680123a4cc1c2b421fe6d35db7ddc083dcf5558f8cbcf2950e115cf
+  data.tar.gz: 0a43ccdded4b3f0122a2a21eebd6f8a974925663c454f172ca21814bbb145727
 SHA512:
-  metadata.gz: 26f14abc9c411d268ebb72413be66b5a9e7deaade3bc936c37eb1ee6d961264bc0c3161e84f577e3fdcf33d3fdb580dd80cc0590de4c2b399074f5841f852178
-  data.tar.gz: 4de4b2b6990eb2c983c703d5be91ce190e53a7120498090f6c518fc749bb4f87425726188c1cf217b585551b0940d522e87b6dfadbecb785ef56736a75c3d486
+  metadata.gz: 11b82066788856f87b1ece4f1b41345f8d5a10cfce114091378998bee60a057917e5a961b0456e335bee773cf4f2139575040afef6398740956a036db2ef0cda
+  data.tar.gz: 7be734cea5b77fb79e92da3fcce5c32d04ddff0e8292f49dc0dfdb7ecbd6368d6e83a5c775392b21b8f0dc46563bd48ad2b86e7ec5833cbf19568d26a9070b34

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.0.2] - 2025-09-02
+
+### Fixed
+
+- Fix state check
+
 ## [1.0.1] - 2025-09-02
 
 ### Added
@@ -14,6 +20,8 @@ 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

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

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

data/lib/piko_tools/version.rb

@@ -1,3 +1,3 @@
 module PikoTools
-  VERSION = "1.0.2"
+  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.2
+  version: 1.0.3
 platform: ruby
 authors:
 - Szymon Kopciewski