ruby-c2pa 0.1.0

data/lib/c2pa/error.rb

@@ -0,0 +1,6 @@
+module C2PA
+  class Error < StandardError; end
+  class SigningError < Error; end
+  class ReadError < Error; end
+  class InvalidManifestError < Error; end
+end

data/lib/c2pa/version.rb

@@ -0,0 +1,3 @@
+module C2PA
+  VERSION = "0.1.0"
+end

data/lib/c2pa.rb

@@ -0,0 +1,59 @@
+require "json"
+require_relative "c2pa/version"
+require_relative "c2pa/error"
+require "c2pa/c2pa_native"
+
+module C2PA
+  # Sign a file with a C2PA manifest.
+  #
+  # @param file        [String]  path to the input file
+  # @param certificate [String]  path to a PEM-encoded X.509 certificate (chain)
+  # @param key         [String]  path to a PEM-encoded private key
+  # @param output      [String]  path for the signed output; defaults to in-place
+  # @param algorithm   [String]  signing algorithm (default: "es256")
+  # @param manifest    [Hash]    manifest definition; omit for a minimal default
+  # @return            [String]  the output path
+  #
+  # @example In-place signing
+  #   C2PA.sign(file: "photo.jpg", certificate: "cert.pem", key: "key.pem")
+  #
+  # @example With explicit output and manifest
+  #   C2PA.sign(
+  #     file:        "photo.jpg",
+  #     output:      "photo_signed.jpg",
+  #     certificate: "cert.pem",
+  #     key:         "key.pem",
+  #     algorithm:   "ps256",
+  #     manifest:    { title: "My Photo", assertions: [] }
+  #   )
+  def self.sign(file:, certificate:, key:, output: nil, algorithm: "es256", manifest: nil)
+    destination = output || file
+    manifest_json = manifest ? JSON.generate(manifest) : nil
+
+    Native.sign_file(file, destination, certificate, key, algorithm, manifest_json)
+  rescue RuntimeError => e
+    raise SigningError, e.message
+  end
+
+  # Read the C2PA manifest embedded in a signed file.
+  #
+  # @param file [String] path to the signed file
+  # @return     [Hash]   parsed manifest JSON
+  # @raise      [C2PA::ReadError] if the file has no valid manifest
+  #
+  # @example
+  #   manifest = C2PA.read(file: "photo_signed.jpg")
+  #   puts manifest["title"]
+  def self.read(file:)
+    JSON.parse(Native.read_file(file))
+  rescue RuntimeError => e
+    raise ReadError, e.message
+  end
+
+  # Return the version of the underlying c2pa-rs SDK.
+  #
+  # @return [String]
+  def self.sdk_version
+    Native.sdk_version
+  end
+end

data/ruby-c2pa.gemspec

@@ -0,0 +1,25 @@
+require_relative "lib/c2pa/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "ruby-c2pa"
+  spec.version       = C2PA::VERSION
+  spec.authors       = [`git config user.name`.strip]
+  spec.email         = [`git config user.email`.strip]
+  spec.summary          = "Ruby bindings for the c2pa content authenticity library"
+  spec.description      = "Embed and verify C2PA content provenance and authenticity credentials in images, video, and audio files. Ruby bindings for the official Rust c2pa-rs library."
+  spec.license          = "MIT"
+  spec.homepage         = "https://github.com/carlosrodriguez/ruby-c2pa"
+  spec.metadata["source_code_uri"] = spec.homepage
+
+  spec.files         = Dir["lib/**/*.rb", "ext/**/*.{rs,toml,rb}", "Rakefile", "*.gemspec", "LICENSE", "README.md"]
+  spec.require_paths = ["lib"]
+  spec.extensions    = ["ext/c2pa_native/extconf.rb"]
+
+  spec.required_ruby_version = ">= 3.0"
+
+  spec.add_dependency "rb_sys", "~> 0.9"
+
+  spec.add_development_dependency "rake-compiler", "~> 1.2"
+  spec.add_development_dependency "minitest",      "~> 5.0"
+  spec.add_development_dependency "rake",          "~> 13.0"
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: ruby-c2pa
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Carlos Rodriguez
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rb_sys
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Embed and verify C2PA content provenance and authenticity credentials
+  in images, video, and audio files. Ruby bindings for the official Rust c2pa-rs library.
+email:
+- carlos@eddorre.com
+executables: []
+extensions:
+- ext/c2pa_native/extconf.rb
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- ext/c2pa_native/Cargo.toml
+- ext/c2pa_native/extconf.rb
+- ext/c2pa_native/src/lib.rs
+- ext/c2pa_native/target/release/build/oid-registry-c350c75504c969dc/out/oid_db.rs
+- ext/c2pa_native/target/release/build/pix-f303ab89d734032b/out/gamma_lut.rs
+- ext/c2pa_native/target/release/build/serde-2e9abb4d9d73cae4/out/private.rs
+- ext/c2pa_native/target/release/build/serde-f471616b462b0caf/out/private.rs
+- ext/c2pa_native/target/release/build/serde_core-2b94e9134dc44065/out/private.rs
+- ext/c2pa_native/target/release/build/serde_core-3dc945fa0ab21dd5/out/private.rs
+- ext/c2pa_native/target/release/build/thiserror-a1f4c63469c326b9/out/private.rs
+- ext/c2pa_native/target/release/build/typenum-4eb7d34b9fb695ef/out/tests.rs
+- ext/c2pa_native/target/release/build/typenum-b8de96984639a942/out/tests.rs
+- lib/c2pa.rb
+- lib/c2pa/error.rb
+- lib/c2pa/version.rb
+- ruby-c2pa.gemspec
+homepage: https://github.com/carlosrodriguez/ruby-c2pa
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/carlosrodriguez/ruby-c2pa
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Ruby bindings for the c2pa content authenticity library
+test_files: []