seedfaker 0.1.0.pre.alpha.14

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4feee9521a45b7a08d1c097de5cc7aceb2c9be089743ff09cc4864c8b7e6a08d
+  data.tar.gz: 95f797bdd2d715d5d87cefcfecb59aaab432aa11f2b8c13160e7dadec2f96c9d
+SHA512:
+  metadata.gz: 4b347226906654ad572fd40814343dfec5258002fc72c17c57c40cf5ae1e47c805f90bdcec6c2c538ca6d9cdcd92fd20e6eeb5aa76a737ca7eed1e983eb5369a
+  data.tar.gz: 523d7910306710bec2e1a93227ea95b83a4a0f28378b6d595ebb65834430ca1c091ed3cbb403e1c9e7f1c3c6f819f41d137d8547e8be50368173e613d2cf26cd

data/LICENSE

@@ -0,0 +1,56 @@
+MIT License
+
+Copyright (c) 2026 Eduard Titov and seedfaker contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+ADDITIONAL NOTICE — SYNTHETIC DATA AND LIABILITY
+
+This software generates synthetic data that mimics the format and
+appearance of real-world data. The generated output is artificial and
+does not represent real, validated, or authoritative data.
+
+The output may resemble sensitive or structured data, including but not
+limited to credentials, identifiers, financial data, government-issued
+identifiers, network values, or cryptographic-looking values. Such
+output is provided solely as synthetic data and does not guarantee
+uniqueness, correctness, validity, compliance with any standard, or
+cryptographic security.
+
+The output may be deterministic or predictable (including through the
+use of seeds).
+
+Generated data MUST NOT be relied upon as secure, unique,
+standard-compliant, or fit for authentication, authorization, financial,
+cryptographic, or identity-related use.
+
+The software does not guarantee that generated data is unique or free
+from similarity to real-world data. Any similarity or correspondence to
+real persons, accounts, credentials, identifiers, or other data is
+purely coincidental.
+
+The user is solely responsible for any use of the software and generated
+data, including use in production systems and any resulting data leaks,
+security incidents, financial loss, or regulatory consequences.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTIES OF ANY KIND.
+
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM OR RELATED TO THE USE
+OR MISUSE OF THE SOFTWARE OR GENERATED DATA.

data/README.md

@@ -0,0 +1,45 @@
+# seedfaker
+
+Ruby FFI binding for [seedfaker](https://github.com/opendsr-std/seedfaker).
+
+[CLI](https://github.com/opendsr-std/seedfaker) · [Node.js](https://www.npmjs.com/package/@opendsr/seedfaker) · [Python](https://pypi.org/project/seedfaker/) · [Browser/WASM](https://www.npmjs.com/package/@opendsr/seedfaker-wasm) · [Go](https://github.com/opendsr-std/seedfaker-go) · [PHP](https://packagist.org/packages/opendsr/seedfaker) · **Ruby** · [MCP](https://github.com/opendsr-std/seedfaker/blob/main/docs/mcp.md)
+
+## Requirements
+
+- Ruby >= 3.1
+- `libseedfaker_ffi` shared library (built from Rust source)
+
+> **Pre-1.0:** API may change between minor versions. Pin your version.
+
+## Usage
+
+```ruby
+require "seedfaker"
+
+f = Seedfaker::SeedFaker.new(seed: "ci", locale: "en")
+
+f.field("name")                                          # "Zoe Kumar"
+f.field("phone", e164: true)                              # "+14155551234"
+
+f.record(["name", "email"], ctx: "strict")               # single record
+f.records(["name", "email"], n: 5, ctx: "strict")        # batch
+f.validate(["name", "email:e164"])                       # check without generating
+
+f.records(["name", "email"], n: 100, corrupt: "high")    # corrupted data
+
+Seedfaker::SeedFaker.fingerprint                         # "sf0-..."
+Seedfaker::SeedFaker.fields                              # all field names
+```
+
+## Documentation
+
+- [Quick start](https://github.com/opendsr-std/seedfaker/blob/main/docs/quick-start.md)
+- [Field reference (200+ fields)](https://github.com/opendsr-std/seedfaker/blob/main/docs/field-reference.md)
+- [Library API](https://github.com/opendsr-std/seedfaker/blob/main/docs/library.md)
+- [Full documentation](https://github.com/opendsr-std/seedfaker)
+
+---
+
+## Disclaimer
+
+This software generates synthetic data that may resemble real-world identifiers, credentials, or personal information. All output is artificial. See [LICENSE](https://github.com/opendsr-std/seedfaker/blob/main/LICENSE) for the full legal disclaimer.

data/lib/seedfaker.rb

@@ -0,0 +1,172 @@
+# frozen_string_literal: true
+
+require "digest"
+require "fiddle"
+require "fiddle/import"
+require "json"
+
+module Seedfaker
+  class SeedFaker
+    def initialize(seed: nil, locale: nil, tz: nil, since: nil, until_time: nil)
+      lib = Seedfaker.find_library
+      raise "seedfaker: native FFI library not found" unless lib
+
+      @ffi = Fiddle.dlopen(lib)
+      opts = JSON.generate({
+        seed: seed, locale: locale, tz: tz,
+        since: since&.to_i, until: until_time&.to_i
+      }.compact)
+      @sf_create = Fiddle::Function.new(@ffi["sf_create"], [Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOIDP)
+      @sf_destroy = Fiddle::Function.new(@ffi["sf_destroy"], [Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOID)
+      @sf_field = Fiddle::Function.new(@ffi["sf_field"], [Fiddle::TYPE_VOIDP, Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOIDP)
+      @sf_records = Fiddle::Function.new(@ffi["sf_records"], [Fiddle::TYPE_VOIDP, Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOIDP)
+      @sf_record = Fiddle::Function.new(@ffi["sf_record"], [Fiddle::TYPE_VOIDP, Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOIDP)
+      @sf_validate = Fiddle::Function.new(@ffi["sf_validate"], [Fiddle::TYPE_VOIDP, Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOIDP)
+      @sf_free = Fiddle::Function.new(@ffi["sf_free"], [Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOID)
+      @sf_last_error = Fiddle::Function.new(@ffi["sf_last_error"], [], Fiddle::TYPE_VOIDP)
+      @handle = @sf_create.call(opts)
+      raise "sf_create failed: #{last_error}" if @handle.null?
+
+      ObjectSpace.define_finalizer(self, SeedFaker.invoke_release(@sf_destroy, @handle))
+    end
+
+    def self.invoke_release(sf_destroy, handle)
+      proc { sf_destroy.call(handle) }
+    end
+
+    def field(name, n: 1, **opts)
+      spec = build_spec(name, opts)
+      if n == 1
+        field_one(spec)
+      else
+        Array.new(n) { field_one(spec) }
+      end
+    end
+
+    def record(fields, ctx: nil, corrupt: nil)
+      opts = JSON.generate({ fields: fields, ctx: ctx, corrupt: corrupt }.compact)
+      ptr = @sf_record.call(@handle, opts)
+      raise "sf_record failed: #{last_error}" if ptr.null?
+      json = ptr.to_s
+      @sf_free.call(ptr)
+      JSON.parse(json)
+    end
+
+    def records(fields, n: 1, ctx: nil, corrupt: nil)
+      opts = JSON.generate({ fields: fields, n: n, ctx: ctx, corrupt: corrupt }.compact)
+      ptr = @sf_records.call(@handle, opts)
+      raise "sf_records failed: #{last_error}" if ptr.null?
+      json = ptr.to_s
+      @sf_free.call(ptr)
+      JSON.parse(json)
+    end
+
+    def validate(fields, ctx: nil, corrupt: nil)
+      opts = JSON.generate({ fields: fields, ctx: ctx, corrupt: corrupt }.compact)
+      ptr = @sf_validate.call(@handle, opts)
+      raise "validate failed: #{last_error}" if ptr.null?
+      @sf_free.call(ptr)
+      nil
+    end
+
+    def self.fields
+      lib = Seedfaker.find_library
+      raise "seedfaker: native FFI library not found" unless lib
+
+      ffi = Fiddle.dlopen(lib)
+      sf_fields = Fiddle::Function.new(ffi["sf_fields_json"], [], Fiddle::TYPE_VOIDP)
+      sf_free = Fiddle::Function.new(ffi["sf_free"], [Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOID)
+      ptr = sf_fields.call
+      json = ptr.to_s
+      sf_free.call(ptr)
+      JSON.parse(json).map { |f| f["name"] }
+    end
+
+    def self.fingerprint
+      lib = Seedfaker.find_library
+      raise "seedfaker: native FFI library not found" unless lib
+
+      ffi = Fiddle.dlopen(lib)
+      sf_fp = Fiddle::Function.new(ffi["sf_fingerprint"], [], Fiddle::TYPE_VOIDP)
+      sf_free = Fiddle::Function.new(ffi["sf_free"], [Fiddle::TYPE_VOIDP], Fiddle::TYPE_VOID)
+      ptr = sf_fp.call
+      val = ptr.to_s
+      sf_free.call(ptr)
+      val
+    end
+
+    private
+
+    def field_one(spec)
+      ptr = @sf_field.call(@handle, spec)
+      raise "sf_field failed for #{spec}: #{last_error}" if ptr.null?
+      val = ptr.to_s
+      @sf_free.call(ptr)
+      val
+    end
+
+    def build_spec(name, opts)
+      skip = %i[n]
+      parts = [name.to_s]
+      opts.each do |k, v|
+        next if skip.include?(k)
+        # Strip 'r' prefix for digit-starting modifiers (r1x1 → 1x1)
+        seg = k.to_s
+        seg = seg[1..] if seg.length > 1 && seg[0] == "r" && seg[1].match?(/\d/)
+        if k == :range && v.is_a?(Array)
+          parts << "#{v[0]}..#{v[1]}"
+        elsif v == true
+          parts << seg
+        elsif v.is_a?(Integer) && k == :omit
+          parts << "omit=#{v}"
+        elsif v.is_a?(Integer) && k == :length
+          parts << v.to_s
+        end
+      end
+      parts.join(":")
+    end
+
+    def last_error
+      ptr = @sf_last_error.call
+      ptr.null? ? "unknown error" : ptr.to_s
+    end
+
+  end
+
+  # @checksum-start
+  # CI replaces this with real SHA256 before building gem.
+  # Empty = dev (running from source). Filled = production (verify mandatory).
+  NATIVE_CHECKSUM = ""
+  # @checksum-end
+
+  def self.find_library
+    ext = case RbConfig::CONFIG["host_os"]
+          when /darwin/ then "dylib"
+          when /mswin|mingw/ then "dll"
+          else "so"
+          end
+    name = "libseedfaker_ffi.#{ext}"
+
+    if NATIVE_CHECKSUM != ""
+      # Production: bundled binary only, verify SHA256, no exceptions.
+      bundled = File.join(__dir__, "..", "bin", name)
+      raise "seedfaker: bundled library not found at #{bundled}" unless File.exist?(bundled)
+      actual = Digest::SHA256.hexdigest(File.binread(bundled))
+      unless actual == NATIVE_CHECKSUM
+        raise "seedfaker: native library integrity check failed. " \
+              "Expected #{NATIVE_CHECKSUM[0, 16]}..., got #{actual[0, 16]}... " \
+              "Reinstall the package or verify your installation."
+      end
+      return bundled
+    end
+
+    # Dev: NATIVE_CHECKSUM empty = running from source.
+    bundled = File.join(__dir__, "..", "bin", name)
+    return bundled if File.exist?(bundled)
+
+    project = File.join(__dir__, "..", "..", "..", "rust", "target", "release", name)
+    return project if File.exist?(project)
+
+    nil
+  end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: seedfaker
+version: !ruby/object:Gem::Version
+  version: 0.1.0.pre.alpha.14
+platform: ruby
+authors:
+- Eduard Titov
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-04-08 00:00:00.000000000 Z
+dependencies: []
+description: 200+ fields, 68 locales. Same seed = same output across CLI, Python,
+  Node.js, Go, PHP, Ruby.
+email: editied@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/darwin-arm64/libseedfaker_ffi.dylib
+- bin/darwin-x86_64/libseedfaker_ffi.dylib
+- bin/linux-arm64/libseedfaker_ffi.so
+- bin/linux-x86_64/libseedfaker_ffi.so
+- lib/seedfaker.rb
+homepage: https://github.com/opendsr-std/seedfaker
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Deterministic synthetic data generator
+test_files: []