flex-cartesian 1.2 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ffe9aa47d7a73dc2f4ab52cc4943d3bdec7ce709a0712b7e92cc4077f785f82
-  data.tar.gz: d788a54aee87646c8ab77e58762068dcb4c7d644fdae027365e2ee3446399f8d
+  metadata.gz: 3a2ca7796b432b25c13982324959267a48475d5e9bce840b36309f976e05aa8f
+  data.tar.gz: c43b4a80cda5177c29cd7e07c186d6075fa2597ed3fe3e4e886e49b94b76ef49
 SHA512:
-  metadata.gz: be6655fc4acce24a97f2287ee81df181c2a7426fd70b52d0ba02bae3facb80e9720dc5116a9f1dd0afdc0adf412f48b558ee2e5ef154a178a5da5b45dc5e47de
-  data.tar.gz: 26210fc67b053bd01946d3ce052c13fe54c035235357ddc7778af98b8487c8485af927d092944dabf92a95c91f040da51bb546617772d6aed2246fe52b079120
+  metadata.gz: 8271368f575fdd9dc460d6acb7d37678faf8071293738c9cf421ad7fa3dbc0bcf197590d79e57216cc20ee4b028ffa0b58f84b160dddb900b71d778ba93ef8e8
+  data.tar.gz: 4e55180b78619c9ad100c0b6e7db1b19cc7c74871936939340d53af7b6e01eba82bd2bd2e739e0e33c3ef334cfb66f75284aeae1ef2ca1dcebbe00f60eb5843a

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.2.2 - 2025-07-28
+### Added
+- .dimensions functionality extended to more granular formatting
+
+## 1.2.1 - 2025-07-28
+### Fixed
+- When adding function, check if its namesake exists
+
 ## 1.2 - 2025-07-23
 ## Added
 - Optional progress bar to the function command :run

data/README.md

@@ -211,6 +211,9 @@ puts "\nPrint Cartesian space as Markdown"
 s.output(format: :markdown)
 puts "\nPrint Cartesian space as CSV"
 s.output(format: :csv)
+puts "\nGranular output of Cartesian space dimensions: #{s.dimensions(values: false)}"
+puts "\nGranular output of Cartesian vectors:"
+s.cartesian { |v| puts s.dimensions(v, separator: ' ') }
 
 
 
@@ -435,7 +438,7 @@ Displays a progress bar using `ruby-progressbar`.
 
 ---
 
-### Print Cartesian
+### Generate Output
 ```ruby
 output(separator: " | ", colorize: false, align: true, format: :plain, limit: nil, file: nil)
 ```
@@ -455,6 +458,16 @@ Markdown example:
 |  2   | "b"  |
 ```
 
+```ruby
+dimensions(data = @dimensions, raw: false, separator: ', ', dimensions: true, values: true)
+```
+Generates formatted Cartesian dimensions or vectors of Cartesian space
+- `data`: what to format, either Cartesian vector (usually `s.cartesian { |v| ... }) or entire Cartesian dimensions
+- `raw`: if enabled, overrides any other formarring flags and returns the same as `.inspect`
+- `separator`: how to separate individual components
+- `dimensions`: whether or not show dimension names
+- `values`: whether or not show value(s) associated with dimensions
+
 ---
 
 ### Import from JSON or YAML

data/lib/flex-cartesian.rb

@@ -25,11 +25,11 @@ module FlexOutput
 end
 
 class FlexCartesian
-  attr :dimensions
 
   def initialize(dimensions = nil, path: nil, format: :json)
     if dimensions && path
-      $logger.msg "Please specify either dimensions or path to dimensions", :error
+      puts "Please specify either dimensions or path to dimensions"
+      exit
     end
     @dimensions = dimensions
     @conditions = []
@@ -39,6 +39,18 @@ class FlexCartesian
     import(path, format: format) if path
   end
 
+  def dimensions(data = @dimensions, raw: false, separator: ', ', dimensions: true, values: true)
+    return data.inspect if raw # by default, with no data speciaifed, we assume dimensions of Cartesian
+    return nil if not dimensions and not values
+
+    if data.is_a?(Struct) or data.is_a?(Hash) # vector in Cartesian or entire Cartesian
+      data.each_pair.map { |k, v| (dimensions ? "#{k}" : "") + ((dimensions and values) ? "=" : "") + (values ? "#{v}" : "") }.join(separator)
+    else
+      puts "Incorrect type of dimensions: #{data.class}"
+      exit
+    end
+  end
+
   def cond(command = :print, index: nil, &block)
     case command
     when :set
@@ -114,6 +126,11 @@ end
 
   def add_function(name, &block)
     raise ArgumentError, "Block required" unless block_given?
+    if reserved_function_names.include?(name.to_sym)
+      raise ArgumentError, "Function name '#{name}' has been already added"
+    elsif reserved_struct_names.include?(name.to_sym)
+      raise ArgumentError, "Name '#{name}' has been reserved for internal method, you can't use it for a function"
+    end
     @derived[name.to_sym] = block
   end
 
@@ -282,6 +299,14 @@ end
 
 private
 
+  def reserved_struct_names
+    (base_struct_methods = Struct.new(:dummy).methods(false) + Struct.new(:dummy).instance_methods(false)).uniq
+  end
+
+  def reserved_function_names
+    (self.methods + self.class.instance_methods(false)).uniq
+  end
+
   def fmt_cell(value, colorize, width = nil)
     str = case value
           when String then value

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: flex-cartesian
 version: !ruby/object:Gem::Version
-  version: '1.2'
+  version: 1.2.2
 platform: ruby
 authors:
 - Yury Rassokhin
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-22 00:00:00.000000000 Z
+date: 2025-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colorize