gettextpo 0.1.0

data/README.md

@@ -0,0 +1,105 @@
+# GettextPO
+
+This is a Ruby library for the GNU gettext PO files.  This is a C
+binding of the libgettextpo library, which is provided by the GNU
+gettext package.  It is designed to promote Ruby's idiomatic coding
+style while avoiding memory leaks.
+
+## Installation
+
+Prerequisites: `libgettextpo` library.  On Linux and similar systems,
+you should be able to install it as a distribution package on most
+platforms.  For example, on Ubuntu it was as follows
+(2026-03-07T15:48:13+09:00):
+
+``` shell
+apt search libgettextpo
+# Sorting... Done
+# Full Text Search... Done
+# libgettextpo-dev/noble 0.21-14ubuntu2 amd64 <----- This one!
+#   process PO files - static libraries and headers
+#
+# libgettextpo0/noble 0.21-14ubuntu2 amd64
+#   process PO files - shared library
+```
+
+Install the gem and add to the application's `Gemfile` by executing:
+
+```bash
+bundle add gettextpo
+```
+
+If Bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install gettextpo
+```
+
+## Usage
+
+Say we have a PO file like:
+
+```po
+msgid "msgid1"
+msgstr "msgstr1"
+```
+
+at `po_path`, then,
+
+```ruby
+require "gettextpo"
+
+GettextPO::File.read(po_path).message_iterator.each do |message|
+  pp({ source: message.msgid, translation: message.msgstr })
+  #=> {source: "msgid1", translation: "msgstr1"}
+end
+```
+
+Please refer to the API documentation and test cases for details.
+
+## Development
+
+`./bin/debug` to debug when segmentation fault.
+
+References: [RubyのC APIの手引き 決定版][def], [Developers'
+documentation for Ruby][dev], [Rubyの拡張ライブラリの作り方][ext],
+[library rdoc/parser/c][parser], and [library rdoc][rdoc].
+
+After checking out the repo, run `bin/setup` to install
+dependencies. Then, run `rake test` to run the tests. You can also run
+`bin/console` for an interactive prompt that will allow you to
+experiment.
+
+To install this gem onto your local machine, run `bundle exec rake
+install`.  To release a new version, update the version number in
+`version.rb`, and then run `bundle exec rake release`, which will
+create a git tag for the version, push git commits and the created
+tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+[def]: https://gemmaro.github.io/emberb/
+[dev]: https://docs.ruby-lang.org/capi/en/master/index.html
+[ext]: https://docs.ruby-lang.org/en/master/extension_ja_rdoc.html
+[parser]: https://docs.ruby-lang.org/ja/latest/library/rdoc=2fparser=2fc.html
+[rdoc]: https://docs.ruby-lang.org/ja/latest/library/rdoc.html
+
+## Contributing
+
+Bug reports and pull requests are welcome on Disroot at
+<https://git.disroot.org/gemmaro/ruby-gettextpo>.
+
+## License
+
+Copyright (C) 2026  gemmaro
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.

data/Rakefile

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# Copyright (C) 2026  gemmaro
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+require "rake/extensiontask"
+
+task build: :compile
+
+GEMSPEC = Gem::Specification.load("gettextpo.gemspec")
+
+Rake::ExtensionTask.new("gettextpo", GEMSPEC) do |ext|
+  ext.lib_dir = "lib/gettextpo"
+end
+
+task default: %i[clobber compile test]

data/ext/gettextpo/extconf.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+# Copyright (C) 2026  gemmaro
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+require "mkmf"
+
+# Makes all symbols private by default to avoid unintended conflict
+# with other gems. To explicitly export symbols you can use RUBY_FUNC_EXPORTED
+# selectively, or entirely remove this flag.
+append_cflags("-fvisibility=hidden")
+
+have_header("gettext-po.h") or raise "gettext-po.h not found"
+have_library("gettextpo") or raise "gettextpo library not found"
+# TODO: check library function
+
+create_makefile("gettextpo/gettextpo")