trmnlp-test 0.1.11 → 0.1.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a8cf6e0c24f5af6b9efe85a649ba2db67c317879b1fceadcb65d1ffc067eebe
-  data.tar.gz: 2b6815bf81815329f8acc596fb42ef20f58166ed34e0b834929a3e9bb6b904e8
+  metadata.gz: a85d35469820b185b895fa3d414e16615b96da98daac3ceb03e2a2efb1acb485
+  data.tar.gz: 125994095861e0b2fa05b4bdb894d96b881394d607669d368b97cc017ed4c42e
 SHA512:
-  metadata.gz: 89a21ae5fec6701fe57b7601467ab61de49e27eae862b4081853e8989150024767813610c1b685243b8308e12e3a7407b74d7757c69c668ead777a732195bc79
-  data.tar.gz: 918d5191358825fa4f6a00022c232030e5e97b5d8d8bc43fbd55ed22c0f1442e3a381156d45763a556e37ef17e38b3c3b22ee6fd43a8430f0a4dfe7983728d8c
+  metadata.gz: 5953aee8123875b73f26f388070c128dfd82e11e7242d8d2409aeb53e4fbde364418cccc562027333e901779311355262ee19db3ec595029f9202a529b643e37
+  data.tar.gz: 1fea3465492de2efd996a3bc8ee94d8ffa165003708f2e6fd3232cb9250ade51f5e776feb323568e5aac26c7b2ecc6505dc7867e99fdbede925379d53e9f80b7

data/README.md

@@ -23,6 +23,8 @@ 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 views.spec        # only some tests (a file or a filter); Playwright args pass through
+trmnlp-test run -- --rebaseline  # args after -- reach the specs: require('trmnlp-test').args
 trmnlp-test help | --version   # all commands and options / versions of trmnlp-test, trmnlp, Playwright
 ```
 
@@ -88,6 +90,7 @@ test('menu', async ({ trmnl }) => {
   await expect(screen).toHaveQr('BCD\n002...');             // black on white; { inverted: true | 'any' } for dark codes
   await expect(screen).toMatchScreen();                     // PNG snapshot (--update-snapshots)
   await expect(screen).toFitDeviceImageLimit();
+  await expect(screen).toMatchReference('refs/photo.png', { selector: '.dial', refRect, minIoU: 0.93 });  // diff attached
   const png = await screen.png();                           // pixel(x,y), colors(), inkRatio(rect), inkBounds(), crop()
 });
 
@@ -114,7 +117,7 @@ Other helpers: `trmnl.plugin('other/dir')`, `trmnl.lint()` with `toPassLint({ al
 
 ## How it works
 
-See [docs/README.md](docs/README.md) for diagrams of the components, a render, sessions and the file structure.
+See [docs/README.md](docs/README.md) for diagrams and [docs/SPEC.md](docs/SPEC.md) for the full specification.
 
 ## Examples and self-tests
 

data/exe/trmnlp-test

@@ -2,7 +2,8 @@
 # frozen_string_literal: true
 
 # Runs trmnlp-test (a Docker image) against a TRMNL plugin repository.
-#   trmnlp-test [--repo DIR] [--mount DIR]... [run|init|models|versions|refresh|update|shell|version] [playwright args]
+#   trmnlp-test [run|init|models|versions|refresh|update|shell|version|help] [args] [-- spec args]
+# --repo DIR, --mount DIR and --env NAME[=VALUE] are taken from anywhere before `--`.
 require 'etc'
 require 'fileutils'
 require_relative '../lib/trmnlp_test/version'
@@ -11,12 +12,25 @@ require_relative '../lib/trmnlp_test/version'
 image = ENV.fetch('TRMNLP_TEST_IMAGE', "#{TrmnlpTest::IMAGE}:latest")
 repo = Dir.pwd
 mounts = []
-args = ARGV.dup
-while %w[--repo --mount].include?(args.first)
-  flag, dir = args.shift(2)
-  abort "trmnlp-test: #{flag} needs a directory" unless dir
-  path = File.realpath(dir)
-  flag == '--repo' ? repo = path : mounts += ['-v', "#{path}:#{path}"]
+# the container sees TRMNLP_TEST_* and CI; --env NAME[=VALUE] passes more
+env = %w[CI FORCE_COLOR].flat_map { |k| ['-e', k] } + ENV.keys.grep(/\ATRMNLP_TEST_/).flat_map { |k| ['-e', k] }
+args = []
+rest = ARGV.dup
+until rest.empty?
+  arg = rest.shift
+  if arg == '--'
+    args.push(arg, *rest)
+    break
+  elsif %w[--repo --mount --env].include?(arg)
+    value = rest.shift or abort("trmnlp-test: #{arg} needs a value")
+    case arg
+    when '--repo' then repo = File.realpath(value)
+    when '--mount' then (path = File.realpath(value)) && mounts.push('-v', "#{path}:#{path}")
+    else env.push('-e', value)
+    end
+  else
+    args << arg
+  end
 end
 
 USAGE = File.read(File.expand_path('../lib/trmnlp_test/usage.txt', __dir__))
@@ -59,6 +73,5 @@ if args.first == 'shell'
   entry = ['--entrypoint', 'bash']
 end
 tty = $stdout.tty? ? ['-t'] : []
-env = %w[CI TRMNLP_TEST_DEBUG TRMNLP_TEST_WORKERS TRMNLP_TEST_SHOW_DIFFERENCES FORCE_COLOR].flat_map { |k| ['-e', k] }
 exec 'docker', 'run', '--rm', '-i', *tty, '--init', '--ipc=host', '-u', "#{Process.uid}:#{Process.gid}",
      '-v', "#{repo}:#{repo}", '-w', repo, '-v', "#{cache}:/cache", *mounts, *env, *entry, image, *args

data/lib/trmnlp_test/usage.txt

@@ -1,9 +1,10 @@
-Usage: trmnlp-test [options] [command] [args]
+Usage: trmnlp-test [command] [args] [options] [-- spec 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
+  run [playwright args]   run the tests (default), e.g. -g "dark", --update-snapshots, -j 4;
+                          a spec file or filter in first place runs those: trmnlp-test views.spec
   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
@@ -18,6 +19,9 @@ Options:
   --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")
+  --env NAME[=VALUE]      pass an environment variable to the specs (repeatable);
+                          TRMNLP_TEST_* variables always pass
+  -- ARGS                 everything after -- reaches the specs as require('trmnlp-test').args
   -h, --help              show this help
   -v, --version           show versions
 

data/lib/trmnlp_test/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module TrmnlpTest
-  VERSION = '0.1.11'
+  VERSION = '0.1.13'
   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.11
+  version: 0.1.13
 platform: ruby
 authors:
 - ExcuseMi