namo.rb 0.31.7 → 0.32.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 929afa1d55a647d886b7bd2aa61865223c187d0ce4b961063366b11190090edd
-  data.tar.gz: 9087955ffb7d10e85c95ad67646085895ff2ed1d0e12d7dc3c0ecee9142b141c
+  metadata.gz: 761839d0eae1156db148dffa532a094b3863721739b1ec62ef402014b05d1941
+  data.tar.gz: 6401e2a0ff2821478b540a73cb994e879fcb90207441f8e2c5e399c4b773bd24
 SHA512:
-  metadata.gz: 3973ae39888e5ff688206292d9523f31a89bd0bbe771be02c6dbbf2655311abe38234fd34d44ee6de8d74e16e6df43da1acc6d490a1308824ddbc67216319b67
-  data.tar.gz: e5485f7223ab6c78d952fd8bbec07b1d0ce029401e9c6be2430485144e16d6e2844ade74bbccadda6c0c51bf0815fb13c819eabb90ca53ba20893a1026db85f0
+  metadata.gz: 94533d7f08bb438468911e069cea7d2c106f39587ab563af57b4327524f0fc14caf4ffb9aeda69915fc81ddf4493f47f327f3657a34e931f42406686765cd52f
+  data.tar.gz: d432f9e57b6f505749e135b2abd35e2e49e5523e67b37c4842f74886c887cd2a1f640e9dc89b16118fe1afaf43fdb2e0d1121ff360f332eb8b0e67faca6bc066

data/CHANGELOG

@@ -1,5 +1,27 @@
 # CHANGELOG
 
+## 20260828
+
+0.32.1: ~ install.sh: it runs the same piped from curl as from a clone, and forces no package manager; ~ README.md: + the one-line install.
+
+1. ~ install.sh: the handover is to `namo setup` on the PATH rather than to bin/namo beside the script. It had found bin/namo by its own path, so piped from curl it looked in the working directory and failed there. It now finds nothing by its path and so runs from anywhere. The check is for the namo command rather than for the gem, that being what the next step needs: an older namo installs no executable.
+2. ~ install.sh: + agreed, + parse_arguments, + usage, and install_homebrew is reached only where Ruby is missing and neither Homebrew nor MacPorts is present — a package manager already installed being used before one is installed, so a MacPorts machine is never asked about Homebrew. Homebrew is used where it is already installed, and installed only on a yes — -y answers in advance, and a script piped into a shell, having nobody able to refuse, is taken to have refused. Where Ruby is missing and Homebrew is declined, + ruby_routes names the ways to get Ruby — Homebrew as the command it is, MacPorts and ruby-install as pages, and a distribution's own package manager on Linux — rather than reporting only that no package manager was found.
+3. ~ install.sh: + report_path. gem puts the command in its own directory, which is on the PATH on some machines and not on others; where it is not, the directory is named rather than somebody's shell configuration being written to.
+4. ~ README.md: + the one-line install, for a machine with neither Ruby nor the gem.
+5. ~ Namo::VERSION: /0.32.0/0.32.1/
+
+
+## 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/README.md

@@ -18,6 +18,12 @@ Or in your Gemfile:
 gem 'namo'
 ```
 
+Or from nothing at all — Ruby, the gem, and the gems its scripts want, each step skipped where it is already there. Where Ruby is missing, Homebrew or MacPorts supplies it if either is already installed; where neither is, you are asked before Homebrew is installed; `-y` answers yes in advance, and a machine with nobody at the keyboard is taken to have said no:
+
+```
+sh -c "$(curl -fsSL https://raw.githubusercontent.com/thoran/namo/master/install.sh)"
+```
+
 ## Usage
 
 Create a Namo instance from an array of hashes:

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,69 @@
+#!/usr/bin/env ruby
+# namo
+
+# 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.1'
 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,76 @@
+# 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 part a Ruby script cannot do — the Ruby the script would be
+  # running on, and the gem which carries the command it hands over to.  Its
+  # syntax is asserted and its body is not run: a test which executed it on a
+  # machine without Ruby would install Ruby.
+  #
+  # It hands over by name rather than by path, which is what lets it run piped
+  # from curl — an assertion that it finds nothing by SCRIPT_DIR.
+  #
+  # It installs Homebrew only through `agreed`, which answers no unless -y was
+  # given or somebody is there to say yes.  What is asserted is that the curl of
+  # Homebrew's installer sits behind that gate: an unguarded call is the failure
+  # this is written against.
+  it "has a shell bootstrap which parses, hands over by name, and gates the one install it forces" 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_ruby/)
+    _(body).must_match(/install_namo/)
+    _(body).must_match(/command -v port/)
+    _(body).must_match(/ruby_routes/)
+    _(body).must_match(/namo setup/)
+    _(body).wont_match(/SCRIPT_DIR/)
+    _(body).must_match(/elif agreed .*Install Homebrew\?.*; then\n\s+\/bin\/bash -c/)
+  end
+
+  it "declines to install anything where nothing can answer" do
+    root = File.expand_path('..', __dir__)
+    output = IO.popen([File.join(root, 'install.sh'), '--help'], chdir: root, err: [:child, :out]){|io| io.read}
+    _($?.success?).must_equal true
+    _(output).must_match(/-y, --yes/)
+  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.1
 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