yard-lint 1.10.1 → 1.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0c63ea819ad85e3c0878e26d37ea3b59bb61598804d3963425ff5882931b1a22
-  data.tar.gz: 5b613e3ba58f6773abd4b47b23c64e94d223ddecde10a743db5de1525b0f5ec2
+  metadata.gz: e1b9f3a39ce5fb15c2a1ace664e45d393fb70e429220085ebd4a7881aa2496cc
+  data.tar.gz: 207fb47ddd283bd62755c6f5736652166caed19a342f601ce78cfe73c0aad5e9
 SHA512:
-  metadata.gz: 608923c037bde8d53573ae6f7d3487d1b156ba04ae94c143675c5c5f6c541ccb6266df7acf1748e7fd54e9e3bb92942a28fd2d62d560b92b6ee6e5373f60c822
-  data.tar.gz: 91863e353c9be138fa4bd93db36ce4cdf85209a85863dca25f6d7c1f3a794673018946d7e8160fedf801a4c80cf7377359f675462d87c7955aaf4b80fcffa68f
+  metadata.gz: 7898934b15acdea1b39a244e6224969cef3848427b02db1711c87480ff8459b481920eb6a378fe25296bf0c2dc708d7f3b63ec7c8bd25effb7ea92d8c21179df
+  data.tar.gz: cb7525e59baebfe5cbb1e192ed91d38c6c75d04a4fd1ed9c60db1616794e66b67b46b39cefd5fa734565b30bb7bb4419fe672cbe798b2019443c0d5f59e7f7ae

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 1.10.2 (2026-07-24)
+- **[Bugfix]** `Semantic/AbstractMethods` no longer flags an `@abstract` method whose body is `fail NotImplementedError`. `fail` is a built-in alias of `raise` (`Kernel#fail`), so `fail NotImplementedError` is an identical abstract-method guard to `raise NotImplementedError`, but the `AllowedImplementations` patterns are written with `raise` and were matched literally. A leading `fail` keyword is now normalized to `raise` before matching, so both forms are recognized (and any custom `raise`-based `AllowedImplementations` pattern automatically covers its `fail` alias). Identifiers such as `failure` and non-leading `fail(...)` calls are left untouched.
+
 ## 1.10.1 (2026-07-24)
 - **[Bugfix]** `Documentation/BlankLineBeforeDefinition` no longer reports a foreign comment block above a definition as documentation that was accidentally detached from it. When the object is documented (non-empty docstring) but that docstring did not come from the comment block sitting above this definition, the block is not a detached docstring - it is a file-level license/copyright banner, an encoding note, or an unrelated comment above a namespace reopening whose documentation lives in another file. The check compares the object's docstring against the block's text, so it recognizes any such banner without hardcoding its wording. Definitions whose documentation was genuinely lost (an undocumented object with a comment block detached above it) are still reported.
 

data/lib/yard/lint/validators/semantic/abstract_methods/validator.rb

@@ -46,7 +46,7 @@ module Yard
               has_real_implementation = body_lines.any? do |line|
                 next false if line.start_with?('#') || line == 'end'
 
-                allowed.none? { |pattern| line.match?(pattern) }
+                allowed.none? { |pattern| normalize_raise_alias(line).match?(pattern) }
               end
 
               return unless has_real_implementation
@@ -69,6 +69,18 @@ module Yard
               end
             end
 
+            # Rewrites a leading `fail` keyword to `raise` so the two are treated alike when
+            # matching AllowedImplementations. `fail` is a built-in alias of `raise`
+            # (`Kernel#fail`), so `fail NotImplementedError` is an identical abstract-method
+            # guard to `raise NotImplementedError`, but the configured patterns are written
+            # with `raise`. Only a leading keyword is rewritten, so identifiers such as
+            # `failure` or a `fail(...)` call elsewhere in a line are left untouched.
+            # @param line [String] a stripped body line
+            # @return [String]
+            def normalize_raise_alias(line)
+              line.sub(/\Afail\b/, 'raise')
+            end
+
             # Joins lines that are continuations of the previous statement (the
             # previous line ends with a comma or a backslash) into a single
             # logical line.

data/lib/yard/lint/version.rb

@@ -3,6 +3,6 @@
 module Yard
   module Lint
     # @return [String] version of the YARD Lint gem
-    VERSION = '1.10.1'
+    VERSION = '1.10.2'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yard-lint
 version: !ruby/object:Gem::Version
-  version: 1.10.1
+  version: 1.10.2
 platform: ruby
 authors:
 - Maciej Mensfeld