openusd 1.0.0

data/lib/openusd/value.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module OpenUSD
+  # A USD token. It remains distinct from a string for serialization.
+  class Token < String
+    def initialize(value)
+      super(String(value))
+      freeze
+    end
+  end
+
+  # An authored USD asset path, optionally paired with its resolved path.
+  class AssetPath
+    attr_reader :path, :resolved_path
+
+    def initialize(path, resolved_path: nil)
+      @path = String(path).dup.freeze
+      @resolved_path = resolved_path.nil? ? nil : resolved_path.to_s.dup.freeze
+      freeze
+    end
+
+    def eql?(other)
+      other.is_a?(self.class) && path == other.path && resolved_path == other.resolved_path
+    end
+    alias == eql?
+
+    # @return [Integer] value hash
+    def hash
+      [path, resolved_path].hash
+    end
+
+    # @return [String] authored, unresolved asset path
+    def to_s
+      path
+    end
+  end
+
+  # Preserves a USDA list-edit operator together with its value.
+  class ListOp
+    attr_reader :operation, :value
+
+    def initialize(operation, value)
+      @operation = operation.to_sym
+      @value = value
+      freeze
+    end
+
+    # Compare the list operation and value.
+    def ==(other)
+      other.is_a?(self.class) && operation == other.operation && value == other.value
+    end
+  end
+
+  # A layer reference and optional target prim.
+  class Reference
+    attr_reader :asset_path, :prim_path
+
+    class << self
+      # Build an internal reference to a prim in the same layer stack.
+      # @return [Reference]
+      def internal(prim_path)
+        new(nil, prim_path)
+      end
+    end
+
+    def initialize(asset_path = nil, prim_path = nil)
+      if asset_path.is_a?(Path) && prim_path.nil?
+        prim_path = asset_path
+        asset_path = nil
+      end
+      raise OpenUSD::TypeError, "a reference requires an asset path or prim path" if asset_path.nil? && prim_path.nil?
+
+      @asset_path = normalize_asset_path(asset_path)
+      @prim_path = prim_path.nil? ? nil : Path.parse(prim_path)
+      freeze
+    end
+
+    # Whether this reference targets the current layer stack.
+    def internal?
+      asset_path.nil?
+    end
+
+    # Compare asset and target paths.
+    def ==(other)
+      other.is_a?(self.class) && asset_path == other.asset_path && prim_path == other.prim_path
+    end
+
+    private
+
+    def normalize_asset_path(value)
+      return if value.nil?
+      return value if value.is_a?(AssetPath)
+
+      AssetPath.new(value)
+    end
+  end
+
+  # Authored contents of one variant choice.
+  Variant = Data.define(:properties, :children)
+end

data/lib/openusd/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module OpenUSD
+  # Semantic version of the openusd gem.
+  VERSION = "1.0.0"
+end

data/lib/openusd.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative "openusd/version"
+require_relative "openusd/errors"
+require_relative "openusd/path"
+require_relative "openusd/value"
+require_relative "openusd/types"
+require_relative "openusd/attribute_spec"
+require_relative "openusd/relationship_spec"
+require_relative "openusd/prim_spec"
+require_relative "openusd/format/registry"
+require_relative "openusd/layer"
+require_relative "openusd/format/usda/lexer"
+require_relative "openusd/format/usda/property_merger"
+require_relative "openusd/format/usda/reference_metadata"
+require_relative "openusd/format/usda/parser"
+require_relative "openusd/format/usda/writer"
+require_relative "openusd/asset_resolver"
+require_relative "openusd/composition"
+require_relative "openusd/metadata_view"
+require_relative "openusd/attribute"
+require_relative "openusd/relationship"
+require_relative "openusd/prim"
+require_relative "openusd/stage"
+require_relative "openusd/format/usdz/reader"
+require_relative "openusd/format/usdz/writer"
+require_relative "openusd/schema/base"
+require_relative "openusd/schema/xform"
+require_relative "openusd/schema/mesh"
+require_relative "openusd/schema/camera"
+require_relative "openusd/schema/material"
+require_relative "openusd/schema/scope"
+require_relative "openusd/cli"
+
+# Pure Ruby APIs for reading, composing, editing, and writing OpenUSD assets.
+module OpenUSD
+end
+
+# Compatibility for the name generated by early versions of the gem skeleton.
+Openusd = OpenUSD unless defined?(Openusd)

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification
+name: openusd
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Yudai Takada
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Read, compose, edit, and write USDA and USDZ assets without native dependencies.
+email:
+- t.yudai92@gmail.com
+executables:
+- openusd
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- ".yardopts"
+- LICENSE.txt
+- README.md
+- Rakefile
+- benchmark/RESULTS.md
+- benchmark/parser.rb
+- docs/CLI_SMOKE_TEST.md
+- exe/openusd
+- lib/openusd.rb
+- lib/openusd/asset_resolver.rb
+- lib/openusd/attribute.rb
+- lib/openusd/attribute_spec.rb
+- lib/openusd/cli.rb
+- lib/openusd/composition.rb
+- lib/openusd/errors.rb
+- lib/openusd/format/registry.rb
+- lib/openusd/format/usda/lexer.rb
+- lib/openusd/format/usda/parser.rb
+- lib/openusd/format/usda/property_merger.rb
+- lib/openusd/format/usda/reference_metadata.rb
+- lib/openusd/format/usda/writer.rb
+- lib/openusd/format/usdz/reader.rb
+- lib/openusd/format/usdz/writer.rb
+- lib/openusd/layer.rb
+- lib/openusd/metadata_view.rb
+- lib/openusd/path.rb
+- lib/openusd/prim.rb
+- lib/openusd/prim_spec.rb
+- lib/openusd/relationship.rb
+- lib/openusd/relationship_spec.rb
+- lib/openusd/schema/base.rb
+- lib/openusd/schema/camera.rb
+- lib/openusd/schema/material.rb
+- lib/openusd/schema/mesh.rb
+- lib/openusd/schema/scope.rb
+- lib/openusd/schema/xform.rb
+- lib/openusd/stage.rb
+- lib/openusd/types.rb
+- lib/openusd/value.rb
+- lib/openusd/version.rb
+homepage: https://github.com/ydah/openusd
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ydah/openusd
+  source_code_uri: https://github.com/ydah/openusd/tree/main
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Pure Ruby tools for reading and writing OpenUSD assets
+test_files: []