trmnlp-test 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cfefb51546891c33222e11f7c2ba094168787d9207966a1addbc307462290fd2
-  data.tar.gz: 4323d3400e827f4d88913f1d624ccf7d64bd65e0f15428add123b8c3af01e782
+  metadata.gz: efb7aad66d6a83a5934eded406dd8baa6518e1ce540bb25397e80331f47b0e55
+  data.tar.gz: fa3e89415e15fe30244ea93d8ca18f556f4fe1d2cd6c625b07dbbd1f48ab7e0e
 SHA512:
-  metadata.gz: 2b4b67e735b844dc2510eac564e98a825217516709ef67fd68e78294ffddb40bdc99075045e1390b09dde904e3bc2311b8974ffa1d70bf230f4ab6d36b1996a1
-  data.tar.gz: 6b590003ac56c97e22392b85376d3fcce7bb22d172e25636a02489ac9a0304b8c3d6ed83c7c8b9f5e8a06b2598379607b872e4bdf82085827686f617a78f9a67
+  metadata.gz: 2fff9a02ffcd2fe841301bff6f8537ac582bfe2f494cd1026c09ae032b74baa7807a6c0b24d54c7f1cb03580902b721ddc740be458103ca8fca88ca4a37aac98
+  data.tar.gz: 2adbec49c1a68f78988ea3cab4e39a8345bf679c043dcb1e262d0c2b2f582b80058b014d580147e363692ecf5447643f000b089a3421ed37228d13cb80b839a2

data/README.md

@@ -23,6 +23,7 @@ trmnlp-test init               # trmnlp-test.config.js + test/trmnl/plugin.spec.
 trmnlp-test                    # run; Playwright args pass through (-g, --update-snapshots)
 trmnlp-test models | versions  # device models / framework versions
 trmnlp-test update             # pull the image now (otherwise at most once a day)
+trmnlp-test help | --version   # all commands and options / versions of trmnlp-test, trmnlp, Playwright
 ```
 
 `--repo DIR` runs against another directory. `--mount DIR` mounts an extra directory.

data/exe/trmnlp-test

@@ -19,9 +19,19 @@ while %w[--repo --mount].include?(args.first)
   flag == '--repo' ? repo = path : mounts += ['-v', "#{path}:#{path}"]
 end
 
+USAGE = File.read(File.expand_path('../lib/trmnlp_test/usage.txt', __dir__))
+args[0] = { '-h' => 'help', '--help' => 'help', '-v' => 'version', '--version' => 'version' }.fetch(args[0], args[0]) if args.any?
 case args.first
+when 'help'
+  puts USAGE
+  exit
 when 'version'
-  puts "trmnlp-test #{TrmnlpTest::VERSION} (#{image})"
+  puts "launcher #{TrmnlpTest::VERSION}, image #{image}"
+  if system('docker', 'image', 'inspect', image, out: File::NULL, err: File::NULL)
+    exec 'docker', 'run', '--rm', image, 'version'
+  else
+    puts 'image not pulled yet (trmnlp-test update)'
+  end
   exit
 when 'update'
   exec 'docker', 'pull', image
@@ -37,10 +47,10 @@ present = system('docker', 'image', 'inspect', image, out: File::NULL, err: File
 stamp = File.join(cache, '.pulled-' + image.gsub(/[^A-Za-z0-9.]+/, '_'))
 stale = image.end_with?(':latest') && (!File.exist?(stamp) || Time.now - File.mtime(stamp) > 86_400)
 if !present || (stale && !ENV['TRMNLP_TEST_NO_PULL'])
-  warn "trmnlp-test: pulling #{image}"
-  pulled = system('docker', 'pull', '-q', image, out: File::NULL)
+  warn "trmnlp-test: pulling #{image}" unless present
+  pulled = system('docker', 'pull', '-q', image, out: File::NULL, err: present ? File::NULL : $stderr)
   abort("trmnlp-test: could not pull #{image}") if !pulled && !present
-  FileUtils.touch(stamp) if pulled
+  FileUtils.touch(stamp) # checked today, whether or not the registry had it
 end
 entry = []
 if args.first == 'shell'

data/lib/trmnlp_test/usage.txt

@@ -0,0 +1,30 @@
+Usage: trmnlp-test [options] [command] [args]
+
+Tests TRMNL plugins in the trmnlp format, in Docker.
+
+Commands:
+  run [playwright args]   run the tests (default), e.g. -g "dark", --update-snapshots, -j 4
+  init                    create trmnlp-test.config.js and test/trmnl/plugin.spec.js
+  models                  list the TRMNL device models and their palettes
+  versions                list the TRMNL framework versions
+  refresh                 re-download models, palettes and framework versions
+  update                  pull the newest image now (otherwise at most once a day)
+  shell                   open a shell in the image
+  version                 show the versions of trmnlp-test, trmnlp and Playwright
+  help                    show this help (run --help: the Playwright test options)
+
+Options:
+  --repo DIR              the plugin repository (default: the current directory)
+  --mount DIR             also mount DIR into the container (repeatable)
+  --root DIR              the directory with trmnlp-test.config.js, inside the repository
+  --report DIR            where the report goes (default: config "report")
+  -h, --help              show this help
+  -v, --version           show versions
+
+Environment:
+  TRMNLP_TEST_WORKERS     parallel workers, a number or "50%" (default: half the CPUs)
+  TRMNLP_TEST_IMAGE       image to run (default: ghcr.io/excusemi/trmnlp-test:latest)
+  TRMNLP_TEST_CACHE_DIR   cache directory (default: ~/.cache/trmnlp-test)
+  TRMNLP_TEST_NO_PULL=1   never pull the image automatically
+
+Docs: https://github.com/ExcuseMi/trmnlp-test

data/lib/trmnlp_test/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module TrmnlpTest
-  VERSION = '0.1.2'
+  VERSION = '0.1.3'
   IMAGE = 'ghcr.io/excusemi/trmnlp-test'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trmnlp-test
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - ExcuseMi
@@ -21,6 +21,7 @@ files:
 - LICENSE
 - README.md
 - exe/trmnlp-test
+- lib/trmnlp_test/usage.txt
 - lib/trmnlp_test/version.rb
 homepage: https://github.com/ExcuseMi/trmnlp-test
 licenses: