rubocop-yard 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40bdb35bd0b95a6bc84afcf35b31d27acfb45eba7dae27862fef99b4fb961f29
-  data.tar.gz: 00341d80e3051ed88f0ecc390e463c5a6e2edc25f63a4d00ee1b1fba56d83ce2
+  metadata.gz: 449e11faef5dc981174c81ee97c4ce139c6129a66fe36e9f9620372ce382912e
+  data.tar.gz: 3f4560fca83dece9a2699f5148166dd60f02e64e47e7a9b3fc7856aecd87db90
 SHA512:
-  metadata.gz: b63811dcf428762af0afa33d0e237aa44b49846793ab7b19d66d4f5e5c1fd1484081e2b9a1b4ba999b535ea55572704369d484c4266bd28bd77117d9636f3b7c
-  data.tar.gz: a8c37ca47cfd1bd6dcc0a3f7d6e05f198ade8f7f530ba142593aee19be660c233912ff456f261162f9b9b98f2ed648f89b3cfe1ddce7b5e55f28d865e94bc9d8
+  metadata.gz: 6c96ee6d17d64f6009cb3458f8db1f993c2e91c45d7d4446c39b3a92948c12edf75721d1176fe2db68fce5374bcb901a38bed3f10805de8d2b5ae74b8a9c6fad
+  data.tar.gz: 3b7fe8c5915caf08361c7ea49e5e81084ec9e3e3513dbb8d688e933a09aca76f30aaa526bf5db4cd9ba990f1819693e4b20bcf5b4a1bd1669bda3bcd404db791

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+* `YARD/MeaninglessTag`: Allow `@param` on `Struct.new`/`Data.define` constant assignments (https://github.com/ksss/rubocop-yard/issues/36)
+
+## [1.1.0] - 2026-01-29
+
+* Fix NoMethodError when method signature includes **nil by @ksss in https://github.com/ksss/rubocop-yard/pull/39
+* Migrate smoke tests to RSpec by @ksss in https://github.com/ksss/rubocop-yard/pull/38
+
+## [1.0.0] - 2025-06-21
+
+* Use plugins instead of require by @sue445 in https://github.com/ksss/rubocop-yard/pull/34
+
 ## [0.10.0] - 2024-11-20
 
 * Guess argument types by @ksss in https://github.com/ksss/rubocop-yard/pull/32

data/lib/rubocop/cop/yard/meaningless_tag.rb

@@ -19,12 +19,26 @@ module RuboCop
       #
       #   # good
       #   CONST = 1
+      #
+      #   # good (Struct/Data constant assignments accept @param)
+      #   # @param name [String]
+      #   # @param age [Integer]
+      #   Person = Struct.new(:name, :age, keyword_init: true)
       class MeaninglessTag < Base
         include YARD::Helper
         include RangeHelp
         include DocumentationComment
         extend AutoCorrector
 
+        # @!method struct_or_data_definition?(node)
+        #   @param node [RuboCop::AST::Node]
+        def_node_matcher :struct_or_data_definition?, <<~PATTERN
+          (casgn _ _ {
+            (block (send (const _ {:Struct :Data}) {:new :define} ...) ...)
+            (send (const _ {:Struct :Data}) {:new :define} ...)
+          })
+        PATTERN
+
         def on_class(node)
           check(node)
         end
@@ -40,6 +54,7 @@ module RuboCop
 
           docstring.tags.each do |tag|
             next unless tag.tag_name == 'param' || tag.tag_name == 'option'
+            next if tag.tag_name == 'param' && struct_or_data_definition?(node)
 
             comment = preceding_lines.find { |line| line.text.include?("@#{tag.tag_name}") }
             next unless comment

data/lib/rubocop/cop/yard/mismatch_name.rb

@@ -72,7 +72,8 @@ module RuboCop
           end
           node.arguments.each do |argument|
             next if argument.type == :blockarg
-            next if argument.name.nil?
+            next if argument.type == :kwnilarg
+            next if !argument.respond_to?(:name) || argument.name.nil?
 
             found = docstring.tags.find do |tag|
               next unless tag.tag_name == 'param' || tag.tag_name == 'option'

data/lib/rubocop/yard/version.rb

@@ -2,6 +2,6 @@
 
 module RuboCop
   module YARD
-    VERSION = "1.0.0"
+    VERSION = "1.2.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubocop-yard
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0
 platform: ruby
 authors:
 - ksss
@@ -100,7 +100,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.0.dev
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Check yardoc format.
 test_files: []