idn2_wrap 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f6393803ea2a8301848ea439a8149786dc2374f3e8a81241d55eb5e11a2d96eb
+  data.tar.gz: a6b1ea77c0239796b8c33901ad3c91c282f92d02af86a8611a4959b8880e9b95
+SHA512:
+  metadata.gz: c20f49a55e11dbaaad8c0915c73596a297ab5632c5fc667d7a35ed36d6ce017aa8a4a15e7ad906cc86a1a87669c5144e800ae838cfa247cfbeb32266de6013b8
+  data.tar.gz: 8e25e81052d24c426384b430636bd8cf568096b8ee6b250c6db2a13ca1e6574bbfed2f0015ea460220f92479775f57dd3f6b38134ecf3eab0580c1c7945f8d64

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+
+begin
+  require "rspec/core/rake_task"
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+#rescue LoadError
+  # If rspec isn't installed yet, keep a build fallback:
+#  task default: :build
+end

data/idn2_wrap.gemspec

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+Gem::Specification.new do |spec|
+  spec.name          = "idn2_wrap"
+  spec.version       = File.read(File.expand_path("lib/idn2_wrap/version.rb", __dir__)).match(/VERSION\s*=\s*["'](.+)["']/)[1]
+  spec.authors       = ["Alexey Makhotkin / ChatGPT"]
+  spec.email         = ["squadette@gmail.com"]
+
+  spec.summary       = "Minimal FFI wrapper for libidn2: to_ascii / to_unicode"
+  spec.description   = "A tiny Ruby FFI wrapper exposing libidn2's to_ascii and to_unicode functions."
+  spec.homepage      = "https://github.com/squadette/idn2_wrap"
+  spec.license       = "MIT"
+
+  spec.files         = Dir["lib/**/*", "README.md", "Rakefile", "Gemfile", "idn2_wrap.gemspec"]
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "ffi", ">= 1.15", "< 2.0"
+
+  spec.add_development_dependency "rspec", "~> 3.12"
+
+  spec.metadata = {
+    "source_code_uri" => spec.homepage
+  }
+end

data/lib/idn2_wrap/ffi.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "ffi"
+
+module Idn2Wrap
+  module LibC
+    extend FFI::Library
+    ffi_lib FFI::Library::LIBC
+    attach_function :free, [:pointer], :void
+  end
+
+  module IDN2
+    extend FFI::Library
+    # On most systems this will resolve correctly as "idn2".
+    # If needed, set ENV["IDN2_LIB"] to an explicit path or library name.
+    ffi_lib(ENV["IDN2_LIB"] || "idn2")
+
+    # int idn2_to_ascii_8z(const char *input, char **output, int flags);
+    attach_function :idn2_to_ascii_8z, [:string, :pointer, :int], :int
+
+    # int idn2_to_unicode_8z8z(const char *input, char **output, int flags);
+    attach_function :idn2_to_unicode_8z8z, [:string, :pointer, :int], :int
+
+    # const char *idn2_strerror(int rc);
+    attach_function :idn2_strerror, [:int], :string
+
+    # const char *idn2_check_version(const char *req_version);
+    attach_function :idn2_check_version, [:string], :string
+  end
+
+  # Raised on non-zero libidn2 return codes.
+  class Error < StandardError
+    attr_reader :code
+    def initialize(code, message)
+      @code = code
+      super("[libidn2 #{code}] #{message}")
+    end
+  end
+
+  # Common flags people often want (values are stable in libidn2,
+  # but we keep them optional to avoid drift; pass integers if you prefer).
+  # If you know specific flags you want, pass them via `flags:`.
+  module Flags
+    # These values match libidn2 headers as of typical distributions.
+    # They are provided for convenience; you can omit and keep flags=0.
+    NFC_INPUT         = 0x0001  # IDN2_NFC_INPUT
+    ALLOW_UNASSIGNED  = 0x0002  # IDN2_ALLOW_UNASSIGNED
+    USE_STD3_ASCII    = 0x0004  # IDN2_USE_STD3_ASCII_RULES
+    TRANSITIONAL      = 0x0008  # IDN2_TRANSITIONAL
+    NONTRANSITIONAL   = 0x0010  # IDN2_NONTRANSITIONAL
+  end
+
+  module_function
+
+  # Convert a Unicode domain (e.g., "münich.example") to ASCII/Punycode ("xn--mnich-kva.example").
+  #
+  # @param input [String] Unicode domain or label
+  # @param flags [Integer] Optional libidn2 flags (default 0)
+  # @return [String] ASCII/Punycode domain
+  # @raise [Idn2Wrap::Error] on libidn2 failure
+  def to_ascii(input, flags: 0)
+    out_pp = FFI::MemoryPointer.new(:pointer)
+    rc = IDN2.idn2_to_ascii_8z(input, out_pp, flags)
+    raise Error.new(rc, IDN2.idn2_strerror(rc)) unless rc == 0
+
+    out_p = out_pp.read_pointer
+    begin
+      out_p.read_string
+    ensure
+      LibC.free(out_p)
+    end
+  end
+
+  # Convert an ASCII/Punycode domain (e.g., "xn--mnich-kva.example") to Unicode ("münich.example").
+  #
+  # @param input [String] ASCII/Punycode domain or label
+  # @param flags [Integer] Optional libidn2 flags (default 0)
+  # @return [String] Unicode domain
+  # @raise [Idn2Wrap::Error] on libidn2 failure
+  def to_unicode(input, flags: 0)
+    out_pp = FFI::MemoryPointer.new(:pointer)
+    rc = IDN2.idn2_to_unicode_8z8z(input, out_pp, flags)
+    raise Error.new(rc, IDN2.idn2_strerror(rc)) unless rc == 0
+
+    out_p = out_pp.read_pointer
+    begin
+      out_p.read_string.force_encoding("UTF-8").encode("UTF-8", invalid: :replace, undef: :replace)
+    ensure
+      LibC.free(out_p)
+    end
+  end
+
+  # Return the libidn2 version string, or nil if the runtime version is
+  # older than the given minimum.
+  #
+  # @param req_version [String, nil] Minimum version required (e.g., "2.3.0"), or nil
+  # @return [String, nil] Actual version string, or nil if requirement not met
+  def check_version(req_version = nil)
+    v = IDN2.idn2_check_version(req_version)
+    v.nil? ? nil : v.dup.force_encoding("UTF-8")
+  end
+end

data/lib/idn2_wrap/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Idn2Wrap
+  VERSION = "0.1.0"
+end

data/lib/idn2_wrap.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "idn2_wrap/version"
+require_relative "idn2_wrap/ffi"

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: idn2_wrap
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alexey Makhotkin / ChatGPT
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.15'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.15'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+description: A tiny Ruby FFI wrapper exposing libidn2's to_ascii and to_unicode functions.
+email:
+- squadette@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Rakefile
+- idn2_wrap.gemspec
+- lib/idn2_wrap.rb
+- lib/idn2_wrap/ffi.rb
+- lib/idn2_wrap/version.rb
+homepage: https://github.com/squadette/idn2_wrap
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/squadette/idn2_wrap
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: 'Minimal FFI wrapper for libidn2: to_ascii / to_unicode'
+test_files: []