namo 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 90910055e2c50136c6b364a227484075c17a4d60f9aeb2eaff2f674d8b214271
+  data.tar.gz: 2210e6e62f753d9e337188f0a6d16095f85565d6f3dc0be5a918f5b1be22c378
+SHA512:
+  metadata.gz: 89647d9897342b47358bc861a05a6b7861545b8257f57e6fd89b802f9deaaabc6b93b75af56f3ed7538e67be5e30fb7d522e20719ed2ce5135d19e7c22bdef37
+  data.tar.gz: '05669679f14b36cba17c1646ac0bfcd755d7c57a17d32ec5f5c2057ae67dde255c0c93b04b439eeb080067be143a317cece7891a9318006aa49159e819ec5558'

data/CHANGELOG

@@ -0,0 +1,11 @@
+CHANGELOG
+_______
+
+2026-03-15
+0.0.0: Initial release.
+
+1. + Namo
+2. + Namo#initialize: Initialise from an array of hashes.
+3. + Namo#dimensions: Dimension names are inferred from hash keys.
+4. + Namo#coordinates: Extract the coordinates by finding unique values per dimension.
+5. + Namo#[]: Select by named dimension using keyword arguments, using any one of a single value, and array, or a range.

data/Gemfile

@@ -0,0 +1,5 @@
+# Gemfile
+
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 thoran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,88 @@
+# Namo
+
+Named dimensional data for Ruby.
+
+Namo is a Ruby library for working with multi-dimensional data using named dimensions. It infers dimensions and coordinates from plain arrays of hashes — the same shape you get from databases, CSV files, JSON, and YAML — so there's no reshaping step.
+
+## Installation
+
+```
+gem install namo
+```
+
+Or in your Gemfile:
+
+```ruby
+gem 'namo'
+```
+
+## Usage
+
+Create a Namo from an array of hashes:
+
+```ruby
+require 'namo'
+
+prices = Namo.new([
+  {date: '2025-01-01', symbol: 'BHP', close: 42.5},
+  {date: '2025-01-01', symbol: 'RIO', close: 118.3},
+  {date: '2025-01-02', symbol: 'BHP', close: 43.1},
+  {date: '2025-01-02', symbol: 'RIO', close: 117.8}
+])
+```
+
+Dimensions and coordinates are inferred:
+
+```ruby
+prices.dimensions
+# => [:date, :symbol, :close]
+
+prices.coordinates[:date]
+# => ['2025-01-01', '2025-01-02']
+
+prices.coordinates[:symbol]
+# => ['BHP', 'RIO']
+```
+
+Select by named dimension using keyword arguments:
+
+```ruby
+# Single value
+prices[symbol: 'BHP']
+
+# Multiple dimensions
+prices[date: '2025-01-01', symbol: 'BHP']
+
+# Range
+prices[close: 42.0..43.0]
+
+# Array of values
+prices[symbol: ['BHP', 'RIO']]
+
+# All data
+prices[]
+```
+
+Selection always returns a new Namo. Omitting a dimension means "all values along that dimension."
+
+## Why?
+
+Every other multi-dimensional array library requires you to pre-shape your data before you can work with it. Namo takes it in the form it already comes in.
+
+## Name
+
+Namo: na(med) (di)m(ensi)o(ns). A companion to Numo (numeric arrays for Ruby).
+
+## Contributing
+
+Fork it (https://github.com/thoran/namo/fork)
+Create your feature branch (git checkout -b my-new-feature)
+Commit your changes (git commit -am 'Add some feature')
+Push to the branch (git push origin my-new-feature)
+Create a new pull request
+License
+The gem is available as open source under the terms of the Ruby License.
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,9 @@
+# Rakefile
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task default: :test

data/lib/Namo/VERSION.rb

@@ -0,0 +1,6 @@
+# Namo/VERSION.rb
+# Namo::VERSION
+
+module Namo
+  VERSION = '0.0.0'
+end

data/lib/namo.rb

@@ -0,0 +1,38 @@
+# namo.rb
+# Namo
+
+class Namo
+  def dimensions
+    @dimensions ||= @data.first.keys
+  end
+
+  def coordinates
+    @coordinates ||= (
+      dimensions.each_with_object({}) do |dimension, hash|
+        hash[dimension] = @data.map{|row| row[dimension]}.uniq
+      end
+    )
+  end
+
+  def [](**selections)
+    selected = (
+      @data.select do |row|
+        selections.all? do |dimension, coordinate|
+          case coordinate
+          when Array, Range
+            coordinate.include?(row[dimension])
+          else
+            coordinate == row[dimension]
+          end
+        end
+      end
+    )
+    self.class.new(selected)
+  end
+
+  private
+
+  def initialize(data)
+    @data = data
+  end
+end

data/namo.gemspec

@@ -0,0 +1,32 @@
+require_relative './lib/Namo/VERSION'
+
+Gem::Specification.new do |spec|
+  spec.name = 'namo'
+  spec.date = '2026-03-15'
+  spec.version = Namo::VERSION
+
+  spec.summary = "Named dimensional data for Ruby."
+  spec.description = "A Ruby library for working with multi-dimensional data using named dimensions. Initialise from an array of hashes making it trivial to use with databases, CSV, JSON, and YAML. Dimensions and coordinates are inferred automatically."
+
+  spec.author = 'thoran'
+  spec.email = 'code@thoran.com'
+  spec.homepage = 'https://github.com/thoran/namo'
+  spec.license = 'MIT'
+
+  spec.required_ruby_version = '>= 2.7'
+  spec.require_paths = ['lib']
+
+  spec.files = [
+    'CHANGELOG',
+    'Gemfile',
+    Dir['lib/**/*.rb'],
+    'LICENSE',
+    'namo.gemspec',
+    'Rakefile',
+    'README.md',
+    Dir['test/**/*.rb'],
+  ].flatten
+
+  spec.add_development_dependency 'minitest'
+  spec.add_development_dependency 'rake'
+end

data/test/namo_test.rb

@@ -0,0 +1,70 @@
+# namo_test.rb
+
+# 20260314
+# 0.0.0
+
+require 'minitest/autorun'
+require_relative '../lib/namo'
+
+describe Namo do
+  let(:sample_data) do
+    [
+      {date: '2025-01-01', symbol: 'BHP', close: 42.5},
+      {date: '2025-01-01', symbol: 'RIO', close: 118.3},
+      {date: '2025-01-02', symbol: 'BHP', close: 43.1},
+      {date: '2025-01-02', symbol: 'RIO', close: 117.8}
+    ]
+  end
+
+  let(:namo){ Namo.new(sample_data) }
+
+  describe '#dimensions' do
+    it 'infers dimensions from hash keys' do
+      _(namo.dimensions).must_equal [:date, :symbol, :close]
+    end
+  end
+
+  describe '#coordinates' do
+    it 'extracts unique values per dimension' do
+      _(namo.coordinates[:date]).must_equal ['2025-01-01', '2025-01-02']
+      _(namo.coordinates[:symbol]).must_equal ['BHP', 'RIO']
+      _(namo.coordinates[:close]).must_equal [42.5, 118.3, 43.1, 117.8]
+    end
+  end
+
+  describe '#[]' do
+    it 'selects by single value' do
+      result = namo[symbol: 'BHP']
+      _(result.coordinates[:date]).must_equal ['2025-01-01', '2025-01-02']
+      _(result.coordinates[:symbol]).must_equal ['BHP']
+      _(result.coordinates[:close]).must_equal [42.5, 43.1]
+    end
+
+    it 'selects by multiple dimensions' do
+      result = namo[date: '2025-01-01', symbol: 'BHP']
+      _(result.coordinates[:date]).must_equal ['2025-01-01']
+      _(result.coordinates[:symbol]).must_equal ['BHP']
+      _(result.coordinates[:close]).must_equal [42.5]
+    end
+
+    it 'selects by range' do
+      result = namo[close: 42.0..43.0]
+      _(result.coordinates[:close]).must_equal [42.5]
+    end
+
+    it 'selects by array of values' do
+      result = namo[symbol: ['BHP', 'RIO']]
+      _(result.coordinates[:symbol]).must_equal ['BHP', 'RIO']
+    end
+
+    it 'returns a Namo' do
+      result = namo[symbol: 'BHP']
+      _(result).must_be_kind_of Namo
+    end
+
+    it 'returns all data when no selections given' do
+      result = namo[]
+      _(result.coordinates).must_equal namo.coordinates
+    end
+  end
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: namo
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- thoran
+bindir: bin
+cert_chain: []
+date: 2026-03-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby library for working with multi-dimensional data using named dimensions.
+  Initialise from an array of hashes making it trivial to use with databases, CSV,
+  JSON, and YAML. Dimensions and coordinates are inferred automatically.
+email: code@thoran.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/Namo/VERSION.rb
+- lib/namo.rb
+- namo.gemspec
+- test/namo_test.rb
+homepage: https://github.com/thoran/namo
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.7
+specification_version: 4
+summary: Named dimensional data for Ruby.
+test_files: []