micompress 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5bb22286474daaaaa3282785ff4887fa39cc071050e9a90a29834cc2c2d06eb2
+  data.tar.gz: 22e556306149811d188f7e278100898e33400957a2fc6de1c29c6cdb5f567286
+SHA512:
+  metadata.gz: f8814ecd628c6ebe11627886effaf7d0b18b3a082787b6b7ed5efd8900b43ed1e3211d4f12ff33b4e8055743a563cfdd8a2726d126e68d46de285563a76c34d0
+  data.tar.gz: c4af22c5e3561ab916574050bb7aa4d7fd32ef8b3b6667291baabc0c1e3127bd47c2fc3ebab99f03d0c4890d09311855153eccfffcae310f24f4327635922638

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MiCompress (https://micompress.com)
+
+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.

data/README.md

@@ -0,0 +1,41 @@
+# micompress (Ruby)
+
+> Compress **images, PDFs, video, audio, documents & archives** from the command line or Ruby.
+> Powered by [**micompress.com**](https://micompress.com/?utm_source=rubygems&utm_medium=cli&utm_campaign=extend).
+
+Zero runtime dependencies (standard library only).
+
+```bash
+gem install micompress
+```
+
+## CLI
+
+```bash
+micompress photo.jpg
+micompress *.png --preset extreme
+micompress report.pdf -o out/
+```
+
+## Library
+
+```ruby
+require "micompress"
+
+bytes, meta = Micompress.compress_file("photo.jpg", preset: "extreme")
+File.binwrite("photo-min.jpg", bytes)
+puts "#{meta['savedPercent']}% smaller"
+```
+
+## Build & publish
+
+Requires Ruby (not available on this build server):
+
+```bash
+gem build micompress.gemspec
+gem push micompress-0.1.0.gem
+```
+
+## License
+
+MIT © [MiCompress](https://micompress.com)

data/exe/micompress

@@ -0,0 +1,69 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+require "micompress"
+
+options = { preset: "recommended", base_url: Micompress::DEFAULT_BASE, suffix: "-min" }
+parser = OptionParser.new do |o|
+  o.banner = "Usage: micompress <file...> [options]"
+  o.on("-o", "--output DIR", "Output directory") { |v| options[:output] = v }
+  o.on("-p", "--preset NAME", %w[lossless recommended extreme], "lossless|recommended|extreme") { |v| options[:preset] = v }
+  o.on("--max-width PX", Integer, "Resize images to max width") { |v| options[:max_width] = v }
+  o.on("--token JWT", "Auth token for higher limits") { |v| options[:token] = v }
+  o.on("--api URL", "API base URL") { |v| options[:base_url] = v }
+  o.on("--suffix STR", "Default output suffix (default -min)") { |v| options[:suffix] = v }
+  o.on("-q", "--quiet", "Only print errors") { options[:quiet] = true }
+  o.on("-v", "--version", "Show version") { puts Micompress::VERSION; exit }
+  o.on("-h", "--help", "Show help") { puts o; exit }
+end
+files = parser.parse(ARGV)
+
+if files.empty?
+  puts parser
+  exit 1
+end
+
+def human(n)
+  return "?" if n.nil?
+  units = %w[B KB MB GB]
+  v = n.to_f
+  i = 0
+  while v >= 1024 && i < units.length - 1
+    v /= 1024
+    i += 1
+  end
+  i.zero? ? "#{v.round}#{units[i]}" : format("%.1f%s", v, units[i])
+end
+
+def out_path(input, options)
+  base = File.basename(input)
+  if options[:output]
+    require "fileutils"
+    FileUtils.mkdir_p(options[:output])
+    return File.join(options[:output], base)
+  end
+  ext = File.extname(base)
+  stem = base[0...(base.length - ext.length)]
+  File.join(File.dirname(input), "#{stem}#{options[:suffix]}#{ext}")
+end
+
+failed = 0
+files.each do |file|
+  begin
+    bytes, meta = Micompress.compress_file(
+      file, base_url: options[:base_url], preset: options[:preset],
+      max_width: options[:max_width], token: options[:token]
+    )
+    dest = out_path(file, options)
+    File.binwrite(dest, bytes)
+    unless options[:quiet]
+      puts "✔ #{file} → #{dest}  #{human(meta['inputSize'])} → #{human(meta['outputSize'])} (-#{meta['savedPercent']}%)"
+    end
+  rescue Micompress::Error, SystemCallError => e
+    failed += 1
+    warn "✗ #{file}: #{e.message}"
+  end
+end
+
+exit(failed.zero? ? 0 : 1)

data/lib/micompress/categories.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Micompress
+  # File extension -> MiCompress category. Mirrors services/formatDetector.js.
+  EXT_CATEGORY = {
+    "jpg" => "image", "jpeg" => "image", "png" => "image", "webp" => "image", "gif" => "image",
+    "bmp" => "image", "tiff" => "image", "tif" => "image", "avif" => "image", "svg" => "image",
+    "heic" => "image", "heif" => "image", "ico" => "image", "psd" => "image", "dng" => "image",
+    "raw" => "image", "cr2" => "image", "arw" => "image", "nef" => "image",
+    "mp4" => "video", "mov" => "video", "avi" => "video", "mkv" => "video", "webm" => "video",
+    "mpeg" => "video", "mpg" => "video", "m4v" => "video", "wmv" => "video", "flv" => "video", "3gp" => "video",
+    "mp3" => "audio", "wav" => "audio", "flac" => "audio", "ogg" => "audio", "m4a" => "audio",
+    "aac" => "audio", "wma" => "audio", "opus" => "audio",
+    "pdf" => "pdf",
+    "csv" => "document", "json" => "document", "xml" => "document", "md" => "document",
+    "odt" => "document", "ods" => "document", "docx" => "document", "doc" => "document",
+    "ppt" => "document", "pptx" => "document", "xls" => "document", "xlsx" => "document",
+    "epub" => "document", "html" => "document", "htm" => "document", "hwp" => "document",
+    "txt" => "document", "rtf" => "document",
+    "zip" => "archive", "7z" => "archive", "tar" => "archive", "gz" => "archive", "tgz" => "archive", "rar" => "archive"
+  }.freeze
+
+  CATEGORY_PATH = {
+    "image" => "image-compressors", "video" => "video-compressors", "audio" => "audio-compressors",
+    "document" => "document-compressors", "pdf" => "pdf-compressors", "archive" => "archive-compressors"
+  }.freeze
+
+  module_function
+
+  def ext_of(filename)
+    ext = File.extname(filename.to_s).sub(".", "").downcase
+    ext.empty? ? nil : ext
+  end
+
+  def category_for(filename)
+    EXT_CATEGORY[ext_of(filename)]
+  end
+
+  def endpoint_path(category)
+    CATEGORY_PATH[category]
+  end
+end

data/lib/micompress/client.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+require_relative "categories"
+
+module Micompress
+  DEFAULT_BASE = "https://micompress.com"
+  UTM = "utm_source=rubygems&utm_medium=cli&utm_campaign=extend"
+  USER_AGENT = "micompress-ruby/#{VERSION} (+https://micompress.com)"
+
+  class Error < StandardError; end
+
+  # Compress a single file. Returns [bytes, meta_hash].
+  def self.compress_file(path, base_url: DEFAULT_BASE, preset: "recommended", max_width: nil, token: nil)
+    base = base_url.chomp("/")
+    filename = File.basename(path)
+    category = category_for(filename)
+    raise Error, "Unsupported file type \".#{ext_of(filename) || '?'}\". See #{base}/all-tools" unless category
+    raise Error, "File not found: #{path}" unless File.file?(path)
+
+    uri = URI("#{base}/#{endpoint_path(category)}/compress")
+    req = Net::HTTP::Post.new(uri)
+    req["Accept"] = "application/json"
+    req["User-Agent"] = USER_AGENT
+    req["Authorization"] = "Bearer #{token}" if token
+
+    form = [["file", File.open(path, "rb"), { filename: filename, content_type: "application/octet-stream" }],
+            ["preset", preset]]
+    form << ["maxWidth", max_width.to_s] if max_width
+    req.set_form(form, "multipart/form-data")
+
+    json = request_json(uri, req)
+    unless json["success"] && json["downloadUrl"]
+      raise Error, (json["error"] || "Compression failed")
+    end
+
+    bytes = download("#{base}#{json['downloadUrl']}", token)
+    [bytes, json]
+  end
+
+  def self.request_json(uri, req)
+    res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
+      http.read_timeout = 120
+      http.request(req)
+    end
+    JSON.parse(res.body)
+  rescue JSON::ParserError
+    raise Error, "Unexpected response (HTTP #{res&.code})"
+  end
+
+  def self.download(url, token)
+    uri = URI(url)
+    req = Net::HTTP::Get.new(uri)
+    req["User-Agent"] = USER_AGENT
+    req["Authorization"] = "Bearer #{token}" if token
+    res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
+      http.read_timeout = 120
+      http.request(req)
+    end
+    raise Error, "Download failed (HTTP #{res.code})" unless res.is_a?(Net::HTTPSuccess)
+    res.body
+  end
+end

data/lib/micompress/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Micompress
+  VERSION = "0.1.0"
+end

data/lib/micompress.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "micompress/version"
+require_relative "micompress/categories"
+require_relative "micompress/client"
+
+module Micompress
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: micompress
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- MiCompress
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-07-29 00:00:00.000000000 Z
+dependencies: []
+description: A tiny command-line client and library for the micompress.com compression
+  API.
+email:
+executables:
+- micompress
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- exe/micompress
+- lib/micompress.rb
+- lib/micompress/categories.rb
+- lib/micompress/client.rb
+- lib/micompress/version.rb
+homepage: https://micompress.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://micompress.com
+  source_code_uri: https://github.com/micompress/micompress-ruby
+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.3.15
+signing_key:
+specification_version: 4
+summary: Compress images, PDFs, video, audio, documents & archives via micompress.com
+test_files: []