Class: Lutaml::UmlRepository::PackageExporter

Inherits:
Object
  • Object
show all
Defined in:
lib/lutaml/uml_repository/package_exporter.rb

Overview

PackageExporter handles exporting UmlRepository instances to LUR (LutaML UML Repository) package files.

LUR packages are ZIP archives containing:

  • Serialized Document model

  • Serialized indexes for fast loading

  • Metadata about the package

  • Statistics about the model

Examples:

Export with defaults

exporter = PackageExporter.new(repository)
exporter.export("model.lur")

Export with PackageMetadata

metadata = PackageMetadata.new(
  name: "Urban Model",
  version: "2.0",
  publisher: "City Planning",
  license: "CC-BY-4.0"
)
exporter = PackageExporter.new(repository, metadata: metadata)
exporter.export("model.lur")

Export with metadata hash (backward compatible)

exporter = PackageExporter.new(repository,
  name: "My Model",
  version: "2.0",
  serialization_format: :yaml
)
exporter.export("model.lur")

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(repository, options = {}) ⇒ PackageExporter

Initialize a new PackageExporter.

Parameters:

  • repository (UmlRepository) —

    The repository to export

  • options (Hash) (defaults to: {}) —

    Export options

Options Hash (options):

  • :metadata (PackageMetadata, Hash) —

    Package metadata (can be PackageMetadata object or Hash)

  • :serialization_format (Symbol) — default: :yaml —

    Format for Document serialization (:yaml)

  • :include_xmi (Boolean) — default: false —

    Include source XMI in package

  • :compression_level (Integer) — default: 6 —

    ZIP compression level (0-9)

  • :name (String) — default: "UML Model" —

    Package name (deprecated, use :metadata)

  • :version (String) — default: "1.0" —

    Package version (deprecated, use :metadata)



65
66
67
68
69
 
# File 'lib/lutaml/uml_repository/package_exporter.rb', line 65

def initialize(repository, options = {})
  @repository = repository
  @options = default_options.merge(options)
  @metadata = build_metadata(@options)
end

Instance Attribute Details

#metadata ⇒ PackageMetadata (readonly)

Returns The package metadata.

Returns:



47
48
49
 
# File 'lib/lutaml/uml_repository/package_exporter.rb', line 47

def metadata
  @metadata
end

#options ⇒ Hash (readonly)

Returns Export options.

Returns:

  • (Hash) —

    Export options



44
45
46
 
# File 'lib/lutaml/uml_repository/package_exporter.rb', line 44

def options
  @options
end

#repository ⇒ UmlRepository (readonly)

Returns The repository being exported.

Returns:



41
42
43
 
# File 'lib/lutaml/uml_repository/package_exporter.rb', line 41

def repository
  @repository
end

Instance Method Details

#export(output_path) ⇒ void

This method returns an undefined value.

Export the repository to a LUR package file.

Examples:

exporter.export("model.lur")

Parameters:

  • output_path (String) —

    Path for the output .lur file

Raises:

  • (ArgumentError) —

    If serialization format is invalid



78
79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/lutaml/uml_repository/package_exporter.rb', line 78

def export(output_path) # rubocop:disable Metrics/MethodLength
  validate_options!

  retries = 0
  begin
    write_lur_package(output_path)
  rescue Errno::EACCES
    retries += 1
    retry if retries < 3
    raise
  end
end