Add file each message method.

Author: gemmaro

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## Unreleased
 
+- Add `GettextPO::File#each_message` method.
+
 ## CRuby version 0.2.1 - 2026-03-16
 
 - CRuby: Fix to work with gettext 0.23.

ext/gettextpo/gettextpo.c

@@ -803,6 +803,11 @@ gettextpo_po_file_m_domains (VALUE self)
 
 /**
  * call-seq: message_iterator (domain = nil) -> GettextPO::MessageIterator
+ *
+ * You may find it handy to use the #each_message method instead of
+ * this to iterate over the messages.  This method is for more
+ * versatile manipulation; the returned iterator can insert messages,
+ * for example.
  */
 VALUE
 gettextpo_po_file_m_message_iterator (int argc, VALUE *argv, VALUE self)

mrblib/mrb_gettextpo_common.rb

@@ -78,6 +78,19 @@ def file_positions
     end
   end
 
+  class File
+    def each_message(domain = nil) # yields: message
+      iter = message_iterator(domain)
+      while true
+        begin
+          yield iter.next
+        rescue StopIteration
+          return
+        end
+      end
+    end
+  end
+
   # This class doesn't provide the +new+ class method.  See also
   # GettextPO::Message#filepos.
   class FilePos

test/file.rb

@@ -66,6 +66,14 @@
   true
 end
 
+assert 'each message' do
+  path = File.expand_path(File.join(__FILE__, "../../test.cruby/resources/ok.po"))
+  messages = []
+  GettextPO::File.read(path).each_message { |message| messages << message.msgid }
+  assert_equal ['', 'msgid1'], messages
+  true
+end
+
 assert 'header field' do
   assert_nil GettextPO::File.new.domain_header