namo.rb 0.31.7 → 0.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 929afa1d55a647d886b7bd2aa61865223c187d0ce4b961063366b11190090edd
-  data.tar.gz: 9087955ffb7d10e85c95ad67646085895ff2ed1d0e12d7dc3c0ecee9142b141c
+  metadata.gz: 394855a4344fa3257333f89bcf0422fb7916d7e0fc517c1d5afcb9f19f7a72f4
+  data.tar.gz: 9efd44d4d29889d11631f0cb7d0a0669e2614cb6b667ce5e8abaf65cb652785a
 SHA512:
-  metadata.gz: 3973ae39888e5ff688206292d9523f31a89bd0bbe771be02c6dbbf2655311abe38234fd34d44ee6de8d74e16e6df43da1acc6d490a1308824ddbc67216319b67
-  data.tar.gz: e5485f7223ab6c78d952fd8bbec07b1d0ce029401e9c6be2430485144e16d6e2844ade74bbccadda6c0c51bf0815fb13c819eabb90ca53ba20893a1026db85f0
+  metadata.gz: 0a49de0c3b6a29e5a44151065038c4b63c6645fcffca299a6b7a3efa93ee8fb27ead37eb387373a7f0c211bc53fe5925b675aabf45e14fb0595de9e6693a00ef
+  data.tar.gz: 2241f0e878f16f6dfd32a97b91645212c0b85c3e75f53c0fb3491c270a62239b402926f862fe908a1648a518bf29a3727476559dbc1ffecdf6655a6d72949b28

data/CHANGELOG

@@ -1,5 +1,16 @@
 # CHANGELOG
 
+## 20260828
+
+0.32.0: + bin/namo, the gem's first executable, and the gems it installs.
+
+1. + bin/namo: a setup subcommand which installs the gems Namo's scripts want — Namo itself, so that a clone leaves require 'namo' working, and measurand, which the demo's uncertainty section does without when it is missing — and a console subcommand which is bin/console. Each step asks first and says so when there is nothing to do.
+2. + install.sh: the two things a Ruby script cannot do for itself, Homebrew and the Ruby it would be running on, handed over to bin/namo for the rest. It is not shipped: a bootstrap for a machine without the gem cannot arrive by way of the gem.
+3. ~ namo.gemspec, namo.rb.gemspec: + Dir['bin/*'] to spec.files, + spec.bindir, + spec.executables. Shipping bin/namo without declaring it would carry a script nobody could run.
+4. + test/namo_command_test.rb: the subcommands are named, setup reports rather than acts where a gem is present, an unknown subcommand fails, and it runs with RUBYLIB unset.
+5. ~ Namo::VERSION: /0.31.7/0.32.0/
+
+
 ## 20260827
 
 0.31.7: + namo.rb.gemspec, so that the gem resolves under both names.

data/bin/console

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+# console
+
+# 20260826
+# 0.0.0
+
+# An irb session with Namo loaded, for asking a question of the library without
+# writing a file first.  require_relative rather than bundler/setup, so that it
+# runs on a clean clone as script/demo and script/sizing do.
+#
+# The demo's own prompt is elsewhere: pressing i at a pause in script/demo opens
+# irb on the binding that run has been using, which is the better tool for asking
+# a question of what is on the screen — the objects themselves rather than a
+# second process holding equal ones.
+
+require_relative '../lib/namo'
+require 'irb'
+
+IRB.start

data/bin/namo

@@ -0,0 +1,72 @@
+#!/usr/bin/env ruby
+# namo
+
+# 20260827
+# 0.0.0
+
+# Description: Install the gems Namo's own scripts want, and hand you a prompt
+# with Namo loaded.
+#
+# Homebrew and Ruby are install.sh's business, not this file's: a Ruby script
+# cannot install the Ruby it is running on, and saying "Ruby is already
+# installed!" is the only thing it could ever truthfully report.  Every step here
+# asks first and says so when there is nothing to do, so running it twice is not
+# a mistake.
+
+def usage
+  puts 'namo - Get a machine ready to run Namo.'
+  puts
+  puts 'Usage: namo [setup | console]'
+  puts
+  puts '  setup    install the gems the scripts want, skipping whatever is there'
+  puts '  console  an irb session with Namo loaded'
+  puts
+  puts 'The comparison scripts want two gems beyond these — sqlite3 and monotonic.rb —'
+  puts 'and a database which is not in this repository, so setup leaves them alone.'
+end
+
+def run(command)
+  puts '', command, ''
+  system(command)
+end
+
+def gem_installed?(name)
+  system("gem list -i #{name} > /dev/null 2>&1")
+end
+
+def install_gem(name)
+  if gem_installed?(name)
+    puts "#{name} is already installed!"
+  else
+    run("gem install #{name}")
+  end
+end
+
+# Namo itself first: arriving by `git clone` leaves the source on disk and nothing
+# on the load path, so the gem is what makes `require 'namo'` work from anywhere
+# else.  Arriving by `gem install namo` has it already, and the step says so.
+#
+# measurand is the one the demo asks for and does without: its uncertainty section
+# skips itself when it is missing, and every other section runs regardless.
+def setup
+  install_gem('namo')
+  install_gem('measurand')
+end
+
+def console
+  exec(File.join(__dir__, 'console'))
+end
+
+def main
+  case ARGV[0]
+  when 'setup'; setup
+  when 'console'; console
+  when '--help', '-h', 'help', nil; usage
+  else
+    puts "Error: unknown command '#{ARGV[0]}'"
+    puts 'Use --help for usage'
+    exit 1
+  end
+end
+
+main

data/lib/Namo/VERSION.rb

@@ -2,5 +2,5 @@
 # Namo::VERSION
 
 class Namo
-  VERSION = '0.31.7'
+  VERSION = '0.32.0'
 end

data/namo.rb.gemspec

@@ -21,9 +21,13 @@ Gem::Specification.new do |spec|
   spec.license = 'MIT'
 
   spec.required_ruby_version = '>= 2.7'
+
+  spec.bindir = 'bin'
+  spec.executables = ['namo']
   spec.require_paths = ['lib']
 
   spec.files = [
+    Dir['bin/*'],
     Dir['lib/**/*.rb'],
     Dir['test/**/*.rb'],
     'CHANGELOG',

data/test/namo_command_test.rb

@@ -0,0 +1,56 @@
+# test/namo_command_test.rb
+
+require 'minitest/autorun'
+require 'minitest-spec-context'
+
+# bin/namo is the setup subcommand in the shape startor, shellac and mercurial use
+# it: a predicate per prerequisite, an install which says so when there is nothing
+# to do, and setup calling them in order.  What is worth asserting is the surface —
+# that it reports rather than acts when everything is present, and that it refuses
+# what it does not know — not that it can install Homebrew.
+
+describe 'bin/namo' do
+  def namo(*arguments)
+    root = File.expand_path('..', __dir__)
+    IO.popen([File.join(root, 'bin', 'namo'), *arguments],
+      chdir: root, err: [:child, :out]){|io| io.read}
+  end
+
+  it "names its subcommands" do
+    output = namo('--help')
+    _(output).must_match(/setup/)
+    _(output).must_match(/console/)
+  end
+
+  it "reports rather than acts where a gem is already there" do
+    output = namo('setup')
+    _($?.success?).must_equal true
+    _(output).must_match(/namo is already installed!/)
+    _(output).must_match(/measurand is already installed!/)
+  end
+
+  # install.sh is the half a Ruby script cannot do — Homebrew, and the Ruby the
+  # script would be running on.  Its syntax is asserted and its body is not run:
+  # a test which executed it on a machine lacking Homebrew would install Homebrew.
+  it "has a shell bootstrap which parses, and which hands over to this" do
+    root = File.expand_path('..', __dir__)
+    system("sh -n #{File.join(root, 'install.sh')}")
+    _($?.success?).must_equal true
+    body = File.read(File.join(root, 'install.sh'))
+    _(body).must_match(/install_homebrew/)
+    _(body).must_match(/install_ruby/)
+    _(body).must_match(%r{bin/namo" setup})
+  end
+
+  it "refuses a subcommand it does not have" do
+    namo('nonsense')
+    _($?.success?).must_equal false
+  end
+
+  it "needs nothing but the gem's own dependencies" do
+    root = File.expand_path('..', __dir__)
+    output = IO.popen({'RUBYLIB' => nil}, [File.join(root, 'bin', 'namo'), '--help'],
+      chdir: root, err: [:child, :out]){|io| io.read}
+    _(output).wont_match(/LoadError/)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: namo.rb
 version: !ruby/object:Gem::Version
-  version: 0.31.7
+  version: 0.32.0
 platform: ruby
 authors:
 - thoran
@@ -55,7 +55,8 @@ description: A Ruby library for working with multi-dimensional data using named
   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: []
+executables:
+- namo
 extensions: []
 extra_rdoc_files: []
 files:
@@ -64,6 +65,8 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- bin/console
+- bin/namo
 - lib/Namo/Collection.rb
 - lib/Namo/Enumerable.rb
 - lib/Namo/Formulae.rb
@@ -81,6 +84,7 @@ files:
 - test/Symbol_test.rb
 - test/console_test.rb
 - test/demo_test.rb
+- test/namo_command_test.rb
 - test/namo_test.rb
 - test/sizing_test.rb
 homepage: https://github.com/thoran/namo