lean_pool 0.1.0

data/lib/lean_pool.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require "concurrent-ruby"
+require_relative "lean_pool/version"
+require_relative "lean_pool/pool"
+require_relative "lean_pool/errors"
+require_relative "lean_pool/http_pool"
+
+# LeanPool is a lightweight, process-free resource pool implementation for Ruby.
+#
+# This module provides efficient resource management without creating per-resource
+# processes, making it perfect for managing sockets, HTTP connections, ports, and
+# other resources that need efficient pooling with minimal overhead.
+#
+# The library is built on top of `concurrent-ruby` for reliable thread safety and
+# provides a clean, Ruby-idiomatic interface for resource pooling.
+#
+# @example Basic usage with a Redis connection pool
+#   require 'lean_pool'
+#   
+#   pool = LeanPool::Pool.new(size: 5) do
+#     Redis.new(host: "localhost", port: 6379)
+#   end
+#   
+#   pool.checkout do |redis|
+#     redis.get("my_key")
+#     redis.set("my_key", "value")
+#   end
+#
+# @example Using HTTP connection pool
+#   require 'lean_pool'
+#   
+#   http_pool = LeanPool::HTTPPool.new("api.example.com", 443, size: 10, use_ssl: true)
+#   response = http_pool.get("/users")
+#   puts response[:body]
+#
+# @example Custom resource pool with state
+#   require 'lean_pool'
+#   
+#   pool = LeanPool::Pool.new(
+#     size: 10,
+#     timeout: 5.0,
+#     lazy: true,
+#     pool_state: { database: "production", timeout: 30 }
+#   ) do |state|
+#     DatabaseConnection.new(
+#       database: state[:database],
+#       timeout: state[:timeout]
+#     )
+#   end
+#   
+#   pool.checkout do |db|
+#     db.query("SELECT * FROM users")
+#   end
+#
+# @see LeanPool::Pool The main pool class for managing resources
+# @see LeanPool::HTTPPool Example HTTP connection pool implementation
+# @see LeanPool::Error Base error class for all LeanPool errors
+#
+# @since 0.1.0
+module LeanPool
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: lean_pool
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Junaid Farooq
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: |
+  LeanPool is a tiny, efficient resource pool implementation for Ruby that provides
+  direct resource access without per-resource processes. Inspired by Elixir's nimble_pool,
+  it's perfect for managing sockets, HTTP connections, ports, and other resources that
+  need efficient pooling with minimal overhead.
+email:
+- fjunaid252@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rspec_status"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- PUBLISH.md
+- QUICKSTART.md
+- README.md
+- Rakefile
+- examples/basic_usage.rb
+- lean_pool.gemspec
+- lib/lean_pool.rb
+- lib/lean_pool/errors.rb
+- lib/lean_pool/http_pool.rb
+- lib/lean_pool/pool.rb
+- lib/lean_pool/version.rb
+homepage: https://github.com/half-blood-labs/lean_pool
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/half-blood-labs/lean_pool
+  source_code_uri: https://github.com/half-blood-labs/lean_pool
+  changelog_uri: https://github.com/half-blood-labs/lean_pool/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: A lightweight, process-free resource pool for Ruby using concurrent-ruby
+test_files: []