piko-tools 1.0.2 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c9ae4a74e5273b80eaf96c47b449628d39ab61150bf92bfd9e2dbda159ec90c
-  data.tar.gz: 8907d0f6812d7ddbd609322325e285502610a034cc2c95272414090f638c00b4
+  metadata.gz: 7bf8c65f75aad253dae581f3b224a307bae2ae11e6287c3c2a82ce669a68c6db
+  data.tar.gz: d6450a1138e28358eece0626d185b66a640230f32648567bce7f73d30039feaa
 SHA512:
-  metadata.gz: 26f14abc9c411d268ebb72413be66b5a9e7deaade3bc936c37eb1ee6d961264bc0c3161e84f577e3fdcf33d3fdb580dd80cc0590de4c2b399074f5841f852178
-  data.tar.gz: 4de4b2b6990eb2c983c703d5be91ce190e53a7120498090f6c518fc749bb4f87425726188c1cf217b585551b0940d522e87b6dfadbecb785ef56736a75c3d486
+  metadata.gz: 616e52664b0662f36a4ba8f633a13cc8347452d82cf947467cde6d5e6437df94263a61515b4c8257a18b5bc0741ba9fa6d54b49c24fc28f7185e5233546046b2
+  data.tar.gz: 8f9dffd341e6e134241ecbc70b2d10499bc65ae729fb992d90d0a26c18e9656f06b59b372a9537d089ab3fbf80b683b4095980077bf5d7937bc5874399fc5d9b

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.0.3] - 2026-05-21
+
+### Changed
+
+- Cleanup, tests, optimization
+
+## [1.0.2] - 2025-09-02
+
+### Fixed
+
+- Fix state check
+
 ## [1.0.1] - 2025-09-02
 
 ### Added
@@ -14,6 +26,10 @@ Init
 
 - Init
 
+[1.0.3]: https://gitlab.com/skopciewski/piko-tools/-/compare/1.0.2...1.0.3
+
+[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.
+
+```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.4"
 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.4
 platform: ruby
 authors:
 - Szymon Kopciewski
@@ -65,7 +65,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Micro-framework for building applications with data-driven architecture
+description: 'PikoTools bundles three foundational patterns for Ruby applications:
+  a lazy lifecycle manager (State), a fluent builder DSL (Builder), and a config-driven
+  mixin (Component). Designed for minimal overhead with no external dependencies.'
 email:
 - s.kopciewski@dlamnie.net
 executables: []
@@ -101,5 +103,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Micro-framework for building applications with data-driven architecture
+summary: Data-driven application toolkit with lifecycle, builder, and component patterns
 test_files: []