flex-cartesian 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6da0e2d7afc6efca08b21663c3a4d7e80a924fb1707b02aae11c866a515fc067
-  data.tar.gz: dfd7f4fb1f71ec9ed4f469831a3efca245e43fe379fc7af51b6a708842906bdf
+  metadata.gz: 7f3e10474552a7bfa80b189b46769b1dc621468b9a068918e42cce44d14879ab
+  data.tar.gz: 1dd5bea186d416ebb39bc6f74d268d271516cbbf945a9c3fbfa97d4682bf85bc
 SHA512:
-  metadata.gz: 5afd71db98e0446c6e32478ec41db552811d68b3e40b915d34193c7d6ca9065ab19ebe154612886fa755074ace224b8db6799a9657710ca658af64671f4fc327
-  data.tar.gz: 49affdbb1e79d165f51f4e1698d3948dfb5e0e3de543711f39696cf0a7ab5bb355f8cb35eb98d7cfd64cfd69db228a473744de27e647e61a6ebbf6bd01a0aada
+  metadata.gz: eefbe47d1db3cf1e4316502de159d68963c633d72ea84fc38a378eefa235747845b8d7496d26534eeed6986e2e16cf9728366a1b3015e6e509f0c57a8ace5b3a
+  data.tar.gz: d4eaf78c1280145ad57841a984bde38b0f5f25b69845a59300877ed04ad6c48a2f325a144b6ff97aad6933fb9ed0b36bdc9b6c0c8156126fffd4a8c1d55aca32

data/README.md

@@ -24,10 +24,10 @@
 
 ## Installation
 
-Install dependencies:
-
 ```bash
 bundle install
+gem build flex-cartesian.gemspec
+gem install flex-cartesian-*.gem
 ```
 
 ## Usage
@@ -77,6 +77,108 @@ s.output(format: :markdown, align: true)
 s.output(format: :csv)
 ```
 
+## API Overview
+
+### Initialization
+```ruby
+FlexCartesian.new(dimensions_hash)
+```
+- `dimensions_hash`: a hash with named dimensions; each value can be an `Enumerable` (e.g., arrays, ranges).
+
+Example:
+```ruby
+dimensions = {
+  dim1: [1, 2],
+  dim2: ['x', 'y'],
+  dim3: [true, false]
+}
+
+FlexCartesian.new(dimensions)
+```
+
+---
+
+### Iterate Over All Combinations
+```ruby
+# With block
+cartesian(dims = nil, lazy: false) { |vector| ... }
+
+# Without block: returns Enumerator
+cartesian(dims = nil, lazy: false)
+```
+- `dims`: optional dimensions hash (default is the one provided at initialization).
+- `lazy`: if true, returns a lazy enumerator.
+
+Each combination is passed as a `Struct` with fields matching the dimension names:
+```ruby
+s.cartesian { |v| puts "#{v.dim1} - #{v.dim2}" }
+```
+
+---
+
+### Count Total Combinations
+```ruby
+size(dims = nil) → Integer
+```
+Returns the number of possible combinations.
+
+---
+
+### Convert to Array
+```ruby
+to_a(limit: nil) → Array
+```
+- `limit`: maximum number of combinations to collect.
+
+---
+
+### Iterate with Progress Bar
+```ruby
+progress_each(dims = nil, lazy: false, title: "Processing") { |v| ... }
+```
+Displays a progress bar using `ruby-progressbar`.
+
+---
+
+### Print Table to Console
+```ruby
+output(
+  separator: " | ",
+  colorize: false,
+  align: false,
+  format: :plain  # or :markdown, :csv
+  limit: nil
+)
+```
+Prints all combinations in table form (plain/markdown/CSV).  
+Markdown example:
+```
+| dim1 | dim2 |
+|------|------|
+|  1   | "a"  |
+|  2   | "b"  |
+```
+
+---
+
+### Load from JSON or YAML
+```ruby
+FlexCartesian.from_json("file.json")
+FlexCartesian.from_yaml("file.yaml")
+```
+
+---
+
+### Output from Vectors
+Each yielded combination is a `Struct` extended with:
+```ruby
+output(separator: " | ", colorize: false, align: false)
+```
+Example:
+```ruby
+s.cartesian { |v| v.output(colorize: true, align: true) }
+```
+
 ## License
 
 This project is licensed under the terms of the GNU General Public License v3.0.  

data/lib/golden.rb

@@ -0,0 +1,137 @@
+require 'ostruct'
+require 'progressbar'
+require 'colorize'
+require 'json'
+require 'yaml'
+
+module FlexOutput
+  def output(separator: " | ", colorize: false, align: false)
+    return puts "(empty struct)" unless respond_to?(:members) && respond_to?(:values)
+
+    values_list = members.zip(values.map { |v| v.inspect })
+
+    # calculate widths, if align required
+    widths = align ? values_list.map { |k, v| [k.to_s.size, v.size].max } : []
+
+    line = values_list.each_with_index.map do |(_, val), i|
+      str = val.to_s
+      str = str.ljust(widths[i]) if align
+      colorize ? str.colorize(:cyan) : str
+    end
+
+    puts line.join(separator)
+  end
+end
+
+class FlexCartesian
+  attr :dimensions
+
+  def initialize(dimensions = nil)
+    @dimensions = dimensions
+  end
+
+  def cartesian(dims = nil, lazy: false)
+    dimensions = dims || @dimensions
+    return nil unless dimensions.is_a?(Hash)
+
+    names = dimensions.keys
+    values = dimensions.values.map { |dim| dim.is_a?(Enumerable) ? dim.to_a : [dim] }
+
+    return to_enum(:cartesian, dims, lazy: lazy) unless block_given?
+    return if values.any?(&:empty?)
+
+    struct_class = Struct.new(*names).tap { |sc| sc.include(FlexOutput) }
+
+    base = values.first.product(*values[1..])
+    enum = lazy ? base.lazy : base
+
+    enum.each do |combo|
+      yield struct_class.new(*combo)
+    end
+  end
+
+  def size(dims = nil)
+    dimensions = dims || @dimensions
+    return 0 unless dimensions.is_a?(Hash)
+
+    values = dimensions.values.map { |dim| dim.is_a?(Enumerable) ? dim.to_a : [dim] }
+    return 0 if values.any?(&:empty?)
+
+    values.map(&:size).inject(1, :*)
+  end
+
+  def to_a(limit: nil)
+    result = []
+    cartesian do |v|
+      result << v
+      break if limit && result.size >= limit
+    end
+    result
+  end
+
+  def progress_each(dims = nil, lazy: false, title: "Processing")
+    total = size(dims)
+    bar = ProgressBar.create(title: title, total: total, format: '%t [%B] %p%% %e')
+
+    cartesian(dims, lazy: lazy) do |v|
+      yield v
+      bar.increment
+    end
+  end
+
+def output(separator: " | ", colorize: false, align: false, format: :plain, limit: nil)
+  rows = []
+  cartesian do |v|
+    rows << v
+    break if limit && rows.size >= limit
+  end
+  return if rows.empty?
+
+  headers = rows.first.members.map(&:to_s)
+
+  # Get widths
+  widths = align ? headers.to_h { |h|
+    [h, [h.size, *rows.map { |r| fmt_cell(r[h], false).size }].max]
+  } : {}
+
+  # Title
+  case format
+  when :markdown
+    puts "| " + headers.map { |h| h.ljust(widths[h] || h.size) }.join(" | ") + " |"
+    puts "|-" + headers.map { |h| "-" * (widths[h] || h.size) }.join("-|-") + "-|"
+  when :csv
+    puts headers.join(",")
+  else
+    puts headers.map { |h| fmt_cell(h, colorize, widths[h]) }.join(separator)
+  end
+
+  # Rows
+  rows.each do |row|
+    line = headers.map { |h| fmt_cell(row[h], colorize, widths[h]) }
+    puts format == :csv ? line.join(",") : line.join(separator)
+  end
+end
+
+  def self.from_json(path)
+    data = JSON.parse(File.read(path), symbolize_names: true)
+    new(data)
+  end
+
+  def self.from_yaml(path)
+    data = YAML.safe_load(File.read(path), symbolize_names: true)
+    new(data)
+  end
+
+private
+
+def fmt_cell(value, colorize, width = nil)
+  str = case value
+        when String then value  # rows - without inspect
+        else value.inspect      # the rest is good to inspect
+        end
+  str = str.ljust(width) if width
+  colorize ? str.colorize(:cyan) : str
+end
+
+end
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: flex-cartesian
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Yury Rassokhin
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-02 00:00:00.000000000 Z
+date: 2025-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colorize
@@ -52,26 +52,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: yaml
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-description: |
-  Flexible and human-friendly Cartesian product enumerator for Ruby.
-  Supports dimension-agnostic iteration, named dimensions, structured output,
+description: Supports dimension-agnostic iterators, named dimensions, tabular output,
   lazy/eager evaluation, progress bar, JSON/YAML loading, and export to Markdown/CSV.
-
-  Code example: https://github.com/Yuri-Rassokhin/flex-cartesian/blob/main/README.md#usage
 email:
 - yuri.rassokhin@gmail.com
 executables: []
@@ -82,6 +64,7 @@ files:
 - LICENSE
 - README.md
 - lib/flex-cartesian.rb
+- lib/golden.rb
 homepage: https://github.com/Yuri-Rassokhin/flex-cartesian
 licenses:
 - GPL-3.0