pdfzus-zusammenfuegen-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8226950f7f452293ab6eb5eaa5b48b9ea8db26945d7584f6b0015acc27f6a7ee
+  data.tar.gz: 49b462d5a79ecdc030cbec33b940a7190d4e2a20ac8325f9436765cf1dc2afdf
+SHA512:
+  metadata.gz: e635c0f3187c6a9cad48a4f21781b5fd367bb8c37a59d4e53c7ea2077913469b73c5147085261d512bba903f42adec67cfb38c4dad36358519aa9dc0a610f9b1
+  data.tar.gz: f453e93d00bbc1662336e4f386bb3cb7d09746164000a524fdbc123822299c0e7099153e1da7aa55784976086f16abb2228583cffd07791c547735dbcd18c179

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pdfzus
+
+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,42 @@
+# pdfzus-zusammenfuegen-cli
+
+`pdfzus-zusammenfuegen-cli` ist ein praktisches Ruby-Tool, um mehrere PDF-Dateien in definierter Reihenfolge zusammenzufuegen.
+
+Homepage: https://pdfzus.de/
+
+## Funktionen
+
+- Fuegt mehrere PDF-Dateien stabil in Eingabereihenfolge zusammen
+- Nutzbar als Ruby-API fuer Automatisierung
+- CLI fuer schnelle Terminal-Workflows
+- Klare Fehlerausgaben bei ungueltigen Eingaben
+
+## Installation
+
+```bash
+gem install pdfzus-zusammenfuegen-cli
+```
+
+## CLI Nutzung
+
+```bash
+pdfzus-merge -o merged.pdf a.pdf b.pdf c.pdf
+```
+
+## Ruby API Nutzung
+
+```ruby
+require "pdfzus-zusammenfuegen-cli"
+
+out = Pdfzus::Zusammenfuegen.merge_pdfs(
+  inputs: ["a.pdf", "b.pdf"],
+  output: "merged.pdf"
+)
+
+puts out
+```
+
+## Exit Codes
+
+- `0`: Erfolg
+- `2`: Ungueltige Parameter oder unlesbare Dateien

data/exe/pdfzus-merge

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+require "pdfzus-zusammenfuegen-cli"
+
+options = {}
+
+parser = OptionParser.new do |opts|
+  opts.banner = "Usage: pdfzus-merge -o OUTPUT.pdf INPUT1.pdf INPUT2.pdf [INPUT3.pdf ...]"
+  opts.on("-o", "--output FILE", "Pfad fuer die Ausgabe-PDF") { |v| options[:output] = v }
+  opts.on("-h", "--help", "Zeigt Hilfe") do
+    puts opts
+    exit 0
+  end
+end
+
+begin
+  parser.parse!(ARGV)
+
+  if options[:output].nil? || ARGV.length < 2
+    warn parser.to_s
+    exit 2
+  end
+
+  output = Pdfzus::Zusammenfuegen.merge_pdfs(inputs: ARGV, output: options[:output])
+  puts "Zusammengefuegte PDF erstellt: #{output}"
+  exit 0
+rescue OptionParser::ParseError, ArgumentError, Pdfzus::Zusammenfuegen::Error => e
+  warn "Fehler: #{e.message}"
+  exit 2
+end

data/lib/pdfzus/zusammenfuegen/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Pdfzus
+  module Zusammenfuegen
+    VERSION = "0.1.0"
+  end
+end

data/lib/pdfzus/zusammenfuegen.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "combine_pdf"
+require "fileutils"
+require_relative "zusammenfuegen/version"
+
+module Pdfzus
+  module Zusammenfuegen
+    class Error < StandardError; end
+
+    module_function
+
+    def merge_pdfs(inputs:, output:)
+      raise ArgumentError, "Mindestens 2 Eingabe-PDFs sind erforderlich." if inputs.length < 2
+      raise ArgumentError, "Output muss auf .pdf enden." unless output.downcase.end_with?(".pdf")
+
+      normalized_inputs = inputs.map do |raw|
+        path = File.expand_path(raw)
+        raise ArgumentError, "Datei nicht gefunden: #{raw}" unless File.file?(path)
+        raise ArgumentError, "Keine PDF-Datei: #{raw}" unless path.downcase.end_with?(".pdf")
+
+        path
+      end
+
+      output_path = File.expand_path(output)
+      FileUtils.mkdir_p(File.dirname(output_path))
+
+      merged = CombinePDF.new
+      normalized_inputs.each do |pdf_path|
+        merged << CombinePDF.load(pdf_path)
+      rescue StandardError => e
+        raise Error, "PDF konnte nicht gelesen werden (#{pdf_path}): #{e.message}"
+      end
+
+      merged.save(output_path)
+      output_path
+    end
+  end
+end

data/lib/pdfzus-zusammenfuegen-cli.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "pdfzus/zusammenfuegen"

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: pdfzus-zusammenfuegen-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- pdfzus
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2026-03-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: combine_pdf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !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: Ein praktisches Gem fuer das sichere Zusammenfuegen von PDF-Dateien in
+  fester Reihenfolge.
+email:
+- support2@pdfzus.de
+executables:
+- pdfzus-merge
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- exe/pdfzus-merge
+- lib/pdfzus-zusammenfuegen-cli.rb
+- lib/pdfzus/zusammenfuegen.rb
+- lib/pdfzus/zusammenfuegen/version.rb
+homepage: https://pdfzus.de/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://pdfzus.de/
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: PDF zusammenfuegen per Ruby CLI und API.
+test_files: []