trmnl_preview 0.17.2 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 835368508a529b50bb30de82e6a0170a9d5c14f6edebeb4ffdd2afc774273e58
-  data.tar.gz: 7cf9003dde78b9688674ff48fe0e0fa7decd50ee36204de9196078141ae3defa
+  metadata.gz: 53759b5b952609676a6313c40932bf0aa015ba665044fa2dae6d6dd25e96dfc1
+  data.tar.gz: 906e518e4193951665996a4ed7a49ff07e94cfec35269412f6fe2a172b1ae4c4
 SHA512:
-  metadata.gz: 339f9c574ee307ebc59ed949d6b12bcdb7c58aaa6191564f0b8b6d5b91c675322e2f329055b2630f6d29db3ca341386e09aded2f02e928c129f297890584fbb4
-  data.tar.gz: 3d5c286313c7a75f2b6beaba417917fdc932a51dd8e4e9f3953065111f1accec23d3480164f47588547b6bcc2b482abbe534368328c8107e034308f354197dfd
+  metadata.gz: 51e39569a0ade12fc7f435176438ce3319adbaac3f613a4b36f441b3c01e7a89917f5df96395a62ad3a7a1dce3efb1e021847e1178afe84c47cdabfbec9b6f9d
+  data.tar.gz: a7b3b71f8fb839bca061a9b2083622d076f9290a6f4f128cacaea34b36cc6e0833ea3ae7876b13358dc7670c4fb71a6b973564866614474893efdd5715f898f8

data/CHANGELOG.md

@@ -1,6 +1,10 @@
 
 # Changelog
 
+## 0.18.0
+
+- `it_behaves_like 'a publishable recipe'` checks what a recipe should hold before it is published: every view draws without overflow or page errors on the TRMNL OG (1-bit and 2-bit) and the TRMNL X (landscape and portrait), and the transform runs without error within TRMNL's limits. `trmnlp init`'s starter spec uses it. (#176)
+
 ## 0.17.2
 
 - `trmnlp test` no longer inlines a stylesheet link inside a script's string, such as a CDN fallback written with `document.write`. It broke the script, and every render came out blank. (#174)

data/README.md

@@ -473,7 +473,7 @@ See [TRMNL documentation](https://help.trmnl.com/en/articles/10542599-importing-
 
 ## Testing Plugins
 
-`trmnlp init` starts a plugin with `tests/plugin_spec.rb` (each view draws without overflow or page errors, and the transform stays within TRMNL's limits) and a GitHub workflow that runs it in the `trmnl/trmnlp` image, uploads the report, can rewrite the snapshots on a manual run, and pushes to TRMNL only once lint and tests pass. `trmnlp test` runs the RSpec files in your plugin's `tests/` folder, through the same pipeline `serve` and `build` use, with fake APIs and a fixed clock:
+`trmnlp init` starts a plugin with `tests/plugin_spec.rb` (`it_behaves_like 'a publishable recipe'`, below) and a GitHub workflow that runs it in the `trmnl/trmnlp` image, uploads the report, can rewrite the snapshots on a manual run, and pushes to TRMNL only once lint and tests pass. `trmnlp test` runs the RSpec files in your plugin's `tests/` folder, through the same pipeline `serve` and `build` use, with fake APIs and a fixed clock:
 
 ```ruby
 # tests/weather_spec.rb
@@ -505,6 +505,7 @@ end
 - `mocks:` answer every request the run makes: polling urls, and the transform's own requests in any language, HTTPS included. Keys are urls, with `*` wildcards, a Regexp, or a method first (`'POST https://...'`). Values are `{ json:, body:, status:, headers:, delay:, body_delay:, advance_clock:, error: :reset }` (times in seconds: `body_delay:` sends the headers first and the body later, `advance_clock:` moves the transform's clock on when it answers), a string body, a lambda that takes the request, or an array of answers used in order. An unmocked request gets a 599. `requests` lists every request with its `status`, and `aborted: true` for one the transform gave up on before its answer arrived; `duration_ms` is how long the transform ran.
 - `now:` starts every clock: Liquid's, the markup's scripts', and the transform's, through libfaketime (`brew install libfaketime` or `apt-get install libfaketime`; already in the Docker image). On macOS the interpreter must come from brew, mise or similar, since macOS will not hand libfaketime to its own `/usr/bin` binaries.
 - `trmnlp test --report report` also writes `report/index.html` and `report/report.json`: every example with each screen it rendered (with a switch that outlines every drawn box, and the page's problems) and each transform it ran (time, memory, requests). Under GitHub Actions the counts and failures go to the run's summary too.
+- `it_behaves_like 'a publishable recipe'` is what a recipe should hold before it is published: every view draws without overflow or page errors on the TRMNL OG (1-bit and 2-bit) and the TRMNL X (landscape and portrait), and the transform runs without error within TRMNL's limits. It uses the group's `mocks` and `custom_fields` when the group defines them; `screens: [{ device: 'kobo_libra_2' }, ...]` draws on other devices.
 - `match_snapshot` stores a missing snapshot under `tests/snapshots/<os>/` and fails one on CI; `trmnlp test --update` rewrites them. Fonts render differently per operating system, so run tests in the Docker image when CI should share your snapshots. `fit_image_size_limit` checks the PNG against the model's limit.
 
 ## Development

data/lib/trmnlp/testing/publishable_recipe.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module TRMNLP
+  module Testing
+    # The screens a recipe is drawn on: TRMNL's own devices, and a portrait screen.
+    PUBLISHABLE_RECIPE_SCREENS = [
+      { device: 'og_png' }, { device: 'og_plus' }, { device: 'v2' }, { device: 'v2', orientation: :portrait }
+    ].freeze
+    PUBLISHABLE_RECIPE_VIEWS = %w[full half_horizontal half_vertical quadrant].freeze
+  end
+end
+
+RSpec.shared_examples 'a publishable recipe' do |screens: TRMNLP::Testing::PUBLISHABLE_RECIPE_SCREENS|
+  let(:recipe_inputs) do
+    { mocks: respond_to?(:mocks) ? mocks : {}, custom_fields: respond_to?(:custom_fields) ? custom_fields : {} }
+  end
+
+  TRMNLP::Testing::PUBLISHABLE_RECIPE_VIEWS.product(screens).each do |view, screen|
+    device = screen[:device].is_a?(Hash) ? screen[:device][:model] : screen[:device]
+    screen_name = [device, screen[:orientation]].compact.join(' ')
+
+    it "draws the #{view} view on #{screen_name} without overflow or page errors" do
+      expect(trmnl.render(view:, **screen, **recipe_inputs)).to have_no_overflow.and have_no_problems
+    end
+  end
+
+  it 'runs its transform without error' do
+    expect(trmnl.transform(device: screens.first[:device], **recipe_inputs).error).to be_nil
+  end
+
+  it "stays within TRMNL's serverless limits" do
+    expect(trmnl.transform(device: screens.first[:device], **recipe_inputs)).to stay_within_serverless_limits
+  end
+end

data/lib/trmnlp/testing/rspec.rb

@@ -12,6 +12,7 @@ require_relative 'browser'
 require_relative 'certificate_authority'
 require_relative 'plugin'
 require_relative 'report'
+require_relative 'publishable_recipe'
 require_relative 'snapshot'
 
 module TRMNLP

data/lib/trmnlp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TRMNLP
-  VERSION = '0.17.2'
+  VERSION = '0.18.0'
 end

data/templates/init/tests/plugin_spec.rb

@@ -10,18 +10,8 @@ RSpec.describe 'My Plugin' do
   # The values of the custom fields in src/settings.yml to test with.
   let(:custom_fields) { {} }
 
-  %w[full half_horizontal half_vertical quadrant].each do |view|
-    it "draws the #{view} view without overflow or page errors" do
-      screen = trmnl.render(view:, mocks:, custom_fields:)
-
-      expect(screen).to have_no_overflow
-      expect(screen).to have_no_problems
-    end
-  end
-
-  it "stays within TRMNL's serverless limits" do
-    expect(trmnl.transform(mocks:, custom_fields:)).to stay_within_serverless_limits
-  end
+  # Every view on TRMNL's devices without overflow or page errors, and the transform within TRMNL's limits.
+  it_behaves_like 'a publishable recipe'
 
   # A picture of the full view, compared pixel for pixel on every run. Record it once with
   # `trmnlp test --update` (or the workflow's update_snapshots run) and commit tests/snapshots.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trmnl_preview
 version: !ruby/object:Gem::Version
-  version: 0.17.2
+  version: 0.18.0
 platform: ruby
 authors:
 - Rockwell Schrock
@@ -468,6 +468,7 @@ files:
 - lib/trmnlp/testing/mock_table.rb
 - lib/trmnlp/testing/node_version.rb
 - lib/trmnlp/testing/plugin.rb
+- lib/trmnlp/testing/publishable_recipe.rb
 - lib/trmnlp/testing/report.html.erb
 - lib/trmnlp/testing/report.rb
 - lib/trmnlp/testing/rspec.rb