lara-sdk 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 07f0f176e933b058cb2389a2f42b9eca44f340697f90f7249071ca7db164da86
-  data.tar.gz: f44fd4c0ec64c2051a77273eab0d4fdff5f1f47f4188c8fe6b21f6f3dfd492a6
+  metadata.gz: 40c690defef56e7663867a644181be99f0a6cc6576abc9b4d7f79e57193c3853
+  data.tar.gz: 6d847c2b8b5caeaef7a45ec6624906a9b26ba29ff3105ea76e2eab7eb4d84adf
 SHA512:
-  metadata.gz: f70a02eabf9588e9b6348efcffed1e4e051cfa11fea586c804ffc47e36c8a65fc9da2c1cfa466539a09b8dea0547727ce9d26dde0259056c1ed993409289380d
-  data.tar.gz: 96d6199390210e3b8c8628c9f048668981870671d78e08ee59f9bc1b08b8f856d8cd90070cf9150a2964fcfa3f8ce5198edda88f437e6609a718f5782cd5054d
+  metadata.gz: ec70756013dfda0e007d16fcc2c165836b737017c1a8ad198cfe9d4763694c2a251d069ed9a177d3683b636fdae997a40559a1d6743c8c632387cfa5c628e3bf
+  data.tar.gz: e8672051a95c85a847d66560c5ccbbb16dcbaf2b2d1060f5468d4b609b30cb007b8e1c823c96df2f01259b16da4cd50e5c6272823dec68ba0f90ef00669e608e

data/lib/lara/client.rb

@@ -218,7 +218,7 @@ module Lara
       return response.body if raw_response
 
       content_type = response.headers["content-type"] || response.headers["Content-Type"]
-      return response.body if content_type&.include?("text/csv")
+      return response.body if content_type&.include?("text/csv") || content_type&.include?("application/xml")
 
       if callback || (body && body[:reasoning])
         parse_stream_response(response.body, &callback)

data/lib/lara/glossaries.rb

@@ -6,10 +6,11 @@ module Lara
     module FileFormat
       UNIDIRECTIONAL = "csv/table-uni"
       MULTIDIRECTIONAL = "csv/table-multi"
+      TBX = "tbx"
 
       # @return [Array<String>] All supported formats
       def self.all
-        [UNIDIRECTIONAL, MULTIDIRECTIONAL]
+        [UNIDIRECTIONAL, MULTIDIRECTIONAL, TBX]
       end
 
       # @param format [String] The format to validate
@@ -91,33 +92,28 @@ module Lara
       Lara::Models::GlossaryCounts.new(**@client.get("/v2/glossaries/#{id}/counts").transform_keys(&:to_sym))
     end
 
-    # @param content_type [String] Either FileFormat::UNIDIRECTIONAL or FileFormat::MULTIDIRECTIONAL
-    # @param gzip [Boolean] When true, compress the CSV before upload and set compression=gzip
+    # Import options are independent keyword arguments; omitted options use their defaults.
+    # @param content_type [String] One of FileFormat.all; defaults to UNIDIRECTIONAL
+    # @param gzip [Boolean] Whether the supplied file is already gzip-compressed; defaults to false
     # @param callback_url [String,nil] Optional URL notified when the import completes
     # @return [Lara::Models::GlossaryImport]
-    def import_csv(id, csv_path, content_type: FileFormat::UNIDIRECTIONAL, gzip: false,
-                   callback_url: nil)
+    def import_file(id, file_path, content_type: FileFormat::UNIDIRECTIONAL, gzip: false,
+                    callback_url: nil)
       unless FileFormat.valid?(content_type)
         raise ArgumentError, "Invalid content_type. Supported formats: #{FileFormat.all.join(', ')}"
       end
 
-      basename = File.basename(csv_path)
-      if gzip
-        require "stringio"
-        require "zlib"
-
-        buffer = StringIO.new
-        gz = Zlib::GzipWriter.new(buffer, 7, Zlib::DEFAULT_STRATEGY)
-        File.open(csv_path, "rb") { |_f| IO.copy_stream(_f, gz) }
-        gz.finish
-        buffer.rewind
-
-        body = { "compression" => "gzip" }
-        files = { "csv" => Faraday::UploadIO.new(buffer, "application/gzip", "#{basename}.gz") }
-      else
-        body = {}
-        files = { "csv" => Faraday::UploadIO.new(csv_path, "text/csv", basename) }
-      end
+      basename = File.basename(file_path)
+      mime_type = if gzip
+                    "application/gzip"
+                  elsif content_type == FileFormat::TBX
+                    "application/xml"
+                  else
+                    "text/csv"
+                  end
+      files = { "csv" => Faraday::UploadIO.new(file_path, mime_type, basename) }
+      body = {}
+      body["compression"] = "gzip" if gzip
 
       body["content_type"] = content_type unless content_type == FileFormat::UNIDIRECTIONAL
       body["callback_url"] = callback_url if callback_url
@@ -125,6 +121,16 @@ module Lara
                                                       body: body, files: files).transform_keys(&:to_sym))
     end
 
+    # @deprecated Use #import_file instead.
+    def import_csv(id, csv_path, content_type: FileFormat::UNIDIRECTIONAL, gzip: false,
+                   callback_url: nil)
+      warn "[DEPRECATION] import_csv is deprecated; use import_file instead.", uplevel: 1
+      unless [FileFormat::UNIDIRECTIONAL, FileFormat::MULTIDIRECTIONAL].include?(content_type)
+        raise ArgumentError, "import_csv only supports CSV formats; use import_file for TBX files."
+      end
+      import_file(id, csv_path, content_type: content_type, gzip: gzip, callback_url: callback_url)
+    end
+
     # @return [Lara::Models::GlossaryImport]
     def get_import_status(import_id)
       Lara::Models::GlossaryImport.new(**@client.get("/v2/glossaries/imports/#{import_id}").transform_keys(&:to_sym))
@@ -146,10 +152,10 @@ module Lara
       current
     end
 
-    # Exports a csv file with the glossary content.
-    # @param content_type [String] Either FileFormat::UNIDIRECTIONAL or FileFormat::MULTIDIRECTIONAL
-    # @param source [String, nil] Optional source language
-    # @return [String] bytes
+    # Exports the glossary in the requested format.
+    # @param content_type [String] One of the formats returned by FileFormat.all
+    # @param source [String, nil] Required for unidirectional CSV; omit for multidirectional CSV and TBX
+    # @return [String] Raw CSV or TBX content
     def export(id, content_type: FileFormat::UNIDIRECTIONAL, source: nil)
       unless FileFormat.valid?(content_type)
         raise ArgumentError, "Invalid content_type. Supported formats: #{FileFormat.all.join(', ')}"
@@ -160,8 +166,8 @@ module Lara
     end
 
     # @param callback_url [String] URL notified when the export is ready
-    # @param content_type [String] Either FileFormat::UNIDIRECTIONAL or FileFormat::MULTIDIRECTIONAL
-    # @param source [String, nil] Optional source language (unidirectional exports only)
+    # @param content_type [String] One of the formats returned by FileFormat.all
+    # @param source [String, nil] Required for unidirectional CSV; omit for multidirectional CSV and TBX
     # @return [Lara::Models::GlossaryExport]
     def export_async(id, callback_url:, content_type: FileFormat::UNIDIRECTIONAL, source: nil)
       unless FileFormat.valid?(content_type)

data/lib/lara/memories.rb

@@ -144,20 +144,14 @@ module Lara
       end
     end
 
+    # @param gzip [Boolean] Whether the supplied file is already gzip-compressed; defaults to false
     # @return [Lara::Models::MemoryImport]
-    def import_tmx(id, tmx_path, callback_url: nil)
-      require "stringio"
-      require "zlib"
+    def import_tmx(id, tmx_path, gzip: false, callback_url: nil)
       basename = File.basename(tmx_path)
-
-      buffer = StringIO.new
-      gz = Zlib::GzipWriter.new(buffer, 7, Zlib::DEFAULT_STRATEGY)
-      File.open(tmx_path, "rb") { |_f| IO.copy_stream(_f, gz) }
-      gz.finish
-      buffer.rewind
-
-      files = { "tmx" => Faraday::UploadIO.new(buffer, "application/gzip", "#{basename}.gz") }
-      body = { "compression" => "gzip" }
+      mime_type = gzip ? "application/gzip" : "application/xml"
+      files = { "tmx" => Faraday::UploadIO.new(tmx_path, mime_type, basename) }
+      body = {}
+      body["compression"] = "gzip" if gzip
       body["callback_url"] = callback_url if callback_url
       Lara::Models::MemoryImport.new(**@client.post("/v2/memories/#{id}/import",
                                                     body: body, files: files).transform_keys(&:to_sym))

data/lib/lara/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lara
-  VERSION = "1.7.0"
+  VERSION = "1.8.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lara-sdk
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.0
 platform: ruby
 authors:
 - Translated
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-31 00:00:00.000000000 Z
+date: 2026-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday