omoteura 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ca58b0ba1eb05afa2ee6b151008508d44a1e88be87e1f41618dc7a747422534
-  data.tar.gz: ccbbec8982f2bc72c21763dee7d2fbc9dec9e3af31c005c1a16ecd9b4ad5e68e
+  metadata.gz: 666f7a37974455a114aad72db4711311e3ca439e6caaec4059021892995343b2
+  data.tar.gz: 0a5dd61b7e1430f808fd31981bf6094614453dc0acecc1a4ba12546b9ee96934
 SHA512:
-  metadata.gz: 0fdd215e98b8ec711a342e93299811b5f36b572bc0e16b99b6ca90f6e658a0bbd1c5fc9dccde2fbff91b02216756fd2f8fbf6ff197ea14bae67e502e6fa4cc7e
-  data.tar.gz: 4488b548be964eed8893d0673a77689bf472d223fca52725d1b6f5b310979803e6f377874d7fc625e930678fcf6b50d4289eda15a3c6b878a68fa965826af69c
+  metadata.gz: 8762cf7aca1530b115431533a7ef631f690b7186d4c261eaae99ef2551b14a04774df586e370509eab8977fc115e40651caf2839e4084f27db80aaa84659346b
+  data.tar.gz: 0bff7167d9ca5cb70060afa8d1c94588ee4f471bcd1f83032fac4109154b5c193621ae0d919060ed0a95cdbf39844a16b7c1ecdec5929c3e67565136f5081fd9

data/CHANGELOG.md

@@ -6,6 +6,21 @@ project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## Unreleased
 
+## 0.2.0 - 2026-10-23
+
+Minitest support.
+
+### Added
+
+- Minitest tests are examples, like RSpec's: a test class is an example group
+  and its `test "…"` blocks and `test_…` methods are examples, so links can
+  name a test by its description, and drafts and the link picker list them.
+- `omoteura-minitest`, a Minitest reporter that records test results like
+  the RSpec formatter, turned on by `require "omoteura/minitest"` in
+  `test/test_helper.rb`. The `omoteura` gem now installs it too.
+- `omoteura coverage` also looks for a file's Minitest test, such as
+  `test/models/user_test.rb` for `app/models/user.rb`, beside its spec.
+
 ## 0.1.1 - 2026-10-23
 
 No changes to the gems. Released with the same version as the VS Code

data/README.md

@@ -11,7 +11,7 @@ Code in front, context behind.
 
 The code is the *omote* (front). Behind it sits an Excalidraw drawing, the
 *ura* (back): diagrams, notes and the reasons behind the code, with shapes
-that link to the specs and methods they describe.
+that link to the tests and methods they describe.
 
 > **Status:** pre-release, not yet on RubyGems. The gems below already resolve
 > links, check them in CI and record test results. The VS Code extension in
@@ -55,7 +55,7 @@ as well as time. Files without a magic comment are skipped without allocating.
 
 * Rails 7.1, 7.2, 8.0, 8.1 projects; Omoteura reads their files and never loads Rails
 
-* RSpec 3.12+
+* RSpec 3.12+ or Minitest 5.21+
 
 * Excalidraw (`.excalidraw`) and Obsidian Excalidraw (`.excalidraw.md`)
 
@@ -71,7 +71,7 @@ end
 ```
 
 `require: false` keeps Rails from loading Omoteura into your application; the
-`omoteura` command and RSpec load what they need. Then bundle:
+`omoteura` command and your test framework load what they need. Then bundle:
 
 ```sh
 % bundle
@@ -82,7 +82,8 @@ end
 | gem | contents |
 | --- | --- |
 | `omoteura-core` | Diagram files, `omoteura:` links and the `omoteura` command |
-| `omoteura-rspec` | A formatter that records test results for diagrams |
+| `omoteura-rspec` | A formatter that records RSpec results for diagrams |
+| `omoteura-minitest` | A reporter that records Minitest results for diagrams |
 
 
 ## Attaching Diagrams
@@ -188,19 +189,34 @@ Actions, add `--format github` to see the problems as annotations.
 
 ## Recording Test Results
 
-Add the formatter to `.rspec`, next to your usual one:
+With RSpec, add the formatter to `.rspec`, next to your usual one:
 
 ```text
 --format progress
 --format Omoteura::RSpec::Formatter --out tmp/omoteura/results.json
 ```
 
-Each example's status and failure message go to `tmp/omoteura/results.json`.
-Keep `tmp/omoteura/` out of version control.
+With Minitest, including Rails' `bin/rails test`, require the reporter in
+`test/test_helper.rb`:
+
+```ruby
+require "omoteura/minitest"
+```
+
+Each test's status and failure message go to `tmp/omoteura/results.json`
+(for Minitest, `OMOTEURA_RESULTS` names another path). Keep `tmp/omoteura/`
+out of version control.
+
+Minitest tests link like RSpec examples: in a test class such as
+`UserTest < ActiveSupport::TestCase`, `test "requires an email"` is
+`omoteura:#requires an email`, and `def test_display_name` is
+`omoteura:#test_display_name`. The coverage panel looks for
+`test/models/user_test.rb` as well as `spec/models/user_spec.rb`.
 
 When something already measures coverage, as SimpleCov does, the formatter
-also records which lines of your code ran, so the coverage panel can tell
-which methods the tests called. It never starts coverage itself.
+and the reporter also record which lines of your code ran, so the coverage
+panel can tell which methods the tests called. They never start coverage
+themselves.
 
 
 ## In VS Code
@@ -212,7 +228,7 @@ opens in Excalidraw with linked shapes outlined by test status; clicking a
 link opens the code. Saving writes the file's own format, so an Obsidian note
 keeps everything around the drawing, and a change made elsewhere since it
 opened is never overwritten. A coverage panel lists which declarations and
-public methods of the open file its specs cover.
+public methods of the open file its tests cover.
 
 
 ## Commands
@@ -224,7 +240,7 @@ public methods of the open file its specs cover.
 | `omoteura inspect FILE` | Print one file's diagram, links and test results as JSON, for editors |
 | `omoteura diagram FILE` | Print one diagram's drawing, links and test results as JSON, for editors |
 | `omoteura links FILE` | Print the places in one code file a shape can link to, with their links, as JSON, for editors |
-| `omoteura coverage FILE` | Print which declarations and public methods of one file its specs cover, as JSON, for editors |
+| `omoteura coverage FILE` | Print which declarations and public methods of one file its tests cover, as JSON, for editors |
 | `omoteura save FILE` | Save a drawing an editor changed, read as JSON from stdin, in the file's format |
 | `omoteura version` | Print the version |
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omoteura
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - KAIBYAKU K.K
@@ -15,29 +15,43 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: omoteura-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.1.1
-description: Meta gem that installs omoteura-core and omoteura-rspec.
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: omoteura-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+description: Meta gem that installs omoteura-core, omoteura-rspec and omoteura-minitest.
 executables: []
 extensions: []
 extra_rdoc_files: []