RubyGems - omnizip - Versions diffs - 0.4.9-arm-linux → 0.4.11-arm-linux - Mend

omnizip 0.4.9-arm-linux → 0.4.11-arm-linux

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (94) hide show

checksums.yaml +4 -4
data/.rubocop-oss.yml +814 -0
data/.rubocop.yml +15 -1
data/.rubocop_todo.yml +7 -1
data/CHANGELOG.md +17 -0
data/Gemfile +23 -1
data/README.adoc +101 -1282
data/docs/compatibility.adoc +1 -2
data/docs/lychee.toml +1 -7
data/lib/omnizip/algorithms/deflate/constants.rb +5 -3
data/lib/omnizip/implementations/rust/archive.rb +9 -41
data/lib/omnizip/implementations/rust/ffi_library.rb +127 -0
data/lib/omnizip/implementations/rust/fiddle_library.rb +144 -0
data/lib/omnizip/implementations/rust/library.rb +39 -104
data/lib/omnizip/implementations/rust.rb +2 -0
data/lib/omnizip/version.rb +1 -1
data/lib/tasks/docs.rake +146 -0
data/readme-docs/rar-archives.adoc +505 -0
data/scripts/generate_rar_oracle_fixtures.rb +177 -0
data/vendor/libomnizip_ffi.so +0 -0
metadata +21 -74
data/TODO.refactor/00-overview.md +0 -67
data/TODO.refactor/01-registry-base-class.md +0 -81
data/TODO.refactor/02-error-hierarchy.md +0 -57
data/TODO.refactor/03-autoload-entry-point.md +0 -69
data/TODO.refactor/04-filter-base-consolidation.md +0 -49
data/TODO.refactor/05-send-private-methods.md +0 -64
data/TODO.refactor/06-instance-variable-access.md +0 -69
data/TODO.refactor/07-respond-to-replacement.md +0 -237
data/TODO.refactor/08-spec-doubles.md +0 -27
data/TODO.refactor/09-cli-shared-module.md +0 -35
data/TODO.refactor/10-format-detector-ocp.md +0 -34
data/TODO.refactor/11-convenience-decoupling.md +0 -38
data/TODO.refactor/12-thread-safety.md +0 -8
data/TODO.refactor/13-lutaml-model-migration.md +0 -158
data/TODO.refactor/14-add-missing-specs.md +0 -25
data/docs/.github/workflows/docs.yml +0 -142
data/docs/.gitignore +0 -21
data/docs/Gemfile +0 -13
data/docs/README.md +0 -101
data/docs/_config.yml +0 -112
data/docs/comparison/feature-matrix.adoc +0 -694
data/docs/comparison/index.adoc +0 -113
data/docs/comparison/vs-7zip.adoc +0 -309
data/docs/comparison/vs-peazip.adoc +0 -77
data/docs/comparison/vs-rubyzip.adoc +0 -342
data/docs/comparison/vs-winrar.adoc +0 -100
data/docs/concepts/index.adoc +0 -129
data/docs/developer/architecture.adoc +0 -256
data/docs/developer/contributing.adoc +0 -158
data/docs/developer/index.adoc +0 -25
data/docs/developer/testing.adoc +0 -212
data/docs/getting-started/basic-usage.adoc +0 -263
data/docs/getting-started/index.adoc +0 -42
data/docs/getting-started/installation.adoc +0 -138
data/docs/getting-started/quick-start.adoc +0 -183
data/docs/getting-started/your-first-archive.adoc +0 -219
data/docs/guides/advanced-features/encryption.adoc +0 -277
data/docs/guides/advanced-features/index.adoc +0 -59
data/docs/guides/advanced-features/parallel-processing.adoc +0 -144
data/docs/guides/advanced-features/progress-tracking.adoc +0 -124
data/docs/guides/advanced-features/streaming.adoc +0 -142
data/docs/guides/archive-formats/gzip-format.adoc +0 -105
data/docs/guides/archive-formats/index.adoc +0 -160
data/docs/guides/archive-formats/ole-format.adoc +0 -151
data/docs/guides/archive-formats/rar-format.adoc +0 -104
data/docs/guides/archive-formats/rar5.adoc +0 -521
data/docs/guides/archive-formats/rpm-format.adoc +0 -108
data/docs/guides/archive-formats/seven-zip-format.adoc +0 -35
data/docs/guides/archive-formats/tar-format.adoc +0 -106
data/docs/guides/archive-formats/xz-format.adoc +0 -118
data/docs/guides/archive-formats/zip-format.adoc +0 -35
data/docs/guides/compression-algorithms/bzip2.adoc +0 -114
data/docs/guides/compression-algorithms/deflate.adoc +0 -313
data/docs/guides/compression-algorithms/index.adoc +0 -190
data/docs/guides/compression-algorithms/lzma.adoc +0 -394
data/docs/guides/compression-algorithms/lzma2.adoc +0 -244
data/docs/guides/compression-algorithms/ppmd.adoc +0 -313
data/docs/guides/compression-algorithms/zstandard.adoc +0 -296
data/docs/guides/creating-archives.adoc +0 -348
data/docs/guides/extracting-archives.adoc +0 -53
data/docs/guides/format-conversion.adoc +0 -64
data/docs/guides/index.adoc +0 -49
data/docs/guides/migration-rubyzip.adoc +0 -217
data/docs/guides/parity-archives.adoc +0 -605
data/docs/guides/performance-tuning.adoc +0 -88
data/docs/index.adoc +0 -228
data/docs/reference/api/overview.adoc +0 -187
data/docs/reference/cli/compress-command.adoc +0 -114
data/docs/reference/cli/overview.adoc +0 -140
data/docs/reference/index.adoc +0 -26
data/docs/resources/faq.adoc +0 -185
data/docs/resources/quick-reference.adoc +0 -222
data/docs/troubleshooting/index.adoc +0 -207

data/docs/guides/compression-algorithms/deflate.adoc DELETED Viewed

@@ -1,313 +0,0 @@
----
-title: Deflate
-nav_order: 5
-parent: Compression Algorithms
-grand_parent: Guides
----
-== Purpose
-Deflate is the standard ZIP compression algorithm, offering a good balance between compression ratio and speed. It's universally supported and provides fast compression and decompression.
-== Key Characteristics
-[cols="1,3"]
-|===
-|Property |Value
-|Compression Ratio
-|Good
-|Compression Speed
-|Fast
-|Decompression Speed
-|Very fast
-|Memory Usage
-|Low
-|Compatibility
-|Universal (ZIP standard)
-|Best For
-|General use, speed-critical applications, maximum compatibility
-|===
-== When to Use Deflate
-**Choose Deflate when**:
-* Speed is more important than maximum compression
-* Creating ZIP archives for broad compatibility
-* Working with already-compressed data
-* Need fast decompression
-* Memory is limited
-**Consider alternatives when**:
-* Maximum compression is priority (use LZMA2)
-* Working with text files (use PPMd)
-* Need even faster compression (use Zstandard)
-== Basic Usage
-=== Create ZIP with Deflate
-[source,ruby]
-----
-# Deflate is the default for ZIP
-Omnizip.compress_directory('project/', 'backup.zip')
-# ZIP entries use Deflate by default
-Omnizip::Archive.create('archive.zip', format: :zip) do |archive|
-  archive.add_directory('files/')
-end
-----
-=== Rubyzip-Compatible API
-[source,ruby]
-----
-require 'omnizip/rubyzip_compat'
-# Standard ZIP creation with Deflate
-Zip::File.open('archive.zip', create: true) do |zip|
-  zip.add('readme.txt', 'README.md')
-  zip.add('data.json', 'config/data.json')
-end
-----
-== Compression Levels
-Deflate supports levels 1-9:
-[cols="1,2,2,2"]
-|===
-|Level |Speed |Ratio |Best For
-|1
-|Fastest
-|Basic
-|Quick archiving, temporary files
-|3
-|Very Fast
-|Moderate
-|Development, testing
-|6
-|Fast
-|Good
-|**Default** - balanced performance
-|9
-|Slower
-|Best
-|Distribution, long-term storage
-|===
-.Level Comparison Example
-[source,ruby]
-----
-[1, 6, 9].each do |level|
-  time = Benchmark.measure do
-    Omnizip.compress_file('data.txt', "output-#{level}.zip",
-      compression: :deflate,
-      level: level
-    )
-  end
-  size = File.size("output-#{level}.zip")
-  puts "Level #{level}: #{size} bytes in #{time.real.round(2)}s"
-end
-# Output:
-# Level 1: 125 KB in 0.05s (fastest)
-# Level 6: 98 KB in 0.12s (balanced)
-# Level 9: 95 KB in 0.28s (best compression)
-----
-== Performance Characteristics
-=== Speed Comparison
-[cols="2,1,1,1"]
-|===
-|File Size |Compress Time |Decompress Time |Throughput
-|1 MB
-|0.1s
-|0.05s
-|~10 MB/s
-|10 MB
-|1s
-|0.5s
-|~10 MB/s
-|100 MB
-|10s
-|5s
-|~10 MB/s
-|1 GB
-|100s
-|50s
-|~10 MB/s
-|===
-*Note: Times for level 6 on modern hardware*
-=== vs Other Algorithms
-[cols="2,1,1,1,1"]
-|===
-|Algorithm |Compress |Decompress |Ratio |When to Choose
-|**Deflate**
-|Fast
-|Very Fast
-|Good
-|Speed + compatibility
-|LZMA2
-|Slow
-|Fast
-|Excellent
-|Better compression
-|Zstandard
-|Very Fast
-|Very Fast
-|Very Good
-|Maximum speed
-|PPMd
-|Very Slow
-|Slow
-|Excellent
-|Text files only
-|===
-== Advanced Options
-=== Window Size
-Deflate uses a 32 KB sliding window:
-[source,ruby]
-----
-# Standard Deflate (32 KB window)
-Omnizip.compress_file('file.txt', 'output.zip',
-  compression: :deflate,
-  window_size: 32768  # 32 KB (standard)
-)
-# For smaller files, smaller window may be faster
-# Dictionary size is fixed at 32 KB for compatibility
-----
-=== Strategy Selection
-Deflate supports different compression strategies:
-[source,ruby]
-----
-# Default strategy (LZ77 + Huffman)
-compression_strategy: :default  # Best for most data
-# Filtered (better for image data)
-compression_strategy: :filtered
-# Huffman only (faster, less compression)
-compression_strategy: :huffman_only
-# RLE (good for repetitive data)
-compression_strategy: :rle
-----
-== Common Use Cases
-=== Quick Backups
-[source,ruby]
-----
-# Fast backup for frequent snapshots
-Omnizip.compress_directory(
-  '/var/www/app/',
-  "backup_#{Date.today}.zip",
-  compression: :deflate,
-  level: 3  # Fast compression
-)
-----
-=== Data Distribution
-[source,ruby]
-----
-# Package for distribution (broad compatibility)
-Omnizip::Archive.create('release-v1.0.zip', format: :zip) do |archive|
-  archive.add_directory('dist/')
-end
-----
-=== Web Uploads
-Process uploads quickly:
-[source,ruby]
-----
-# Handle user uploads efficiently
-uploaded_files.each do |file|
-  Omnizip::Archive.create("#{user_id}-upload.zip", format: :zip) do |archive|
-    archive.add_data(file.original_filename, file.read)
-  end
-end
-----
-== Compatibility
-=== Tool Support
-Deflate is supported by all major archive tools:
-* **7-Zip**: Full support (read/write)
-* **WinZip**: Native support
-* **WinRAR**: Full support
-* **Info-ZIP**: Native algorithm
-* **macOS Archive Utility**: Native support
-* **Windows Explorer**: Native support
-=== Format Support
-Deflate works in multiple formats:
-* **ZIP**: Primary compression method (method ID 8)
-* **7z**: Available as alternative to LZMA
-* **GZIP**: Single-file compression
-* **PNG**: Image compression
-== Technical Specifications
-* **Algorithm**: LZ77 dictionary compression + Huffman coding
-* **Window Size**: 32 KB (fixed)
-* **Match Length**: 3-258 bytes
-* **Based On**: Phil Katz's PKZip algorithm
-* **RFC**: RFC 1951 (DEFLATE specification)
-* **Implementation**: Uses Ruby's zlib library (native C)
-== Optimization Tips
-. **Use Level 6 for General Use**: Good balance of speed and compression
-. **Level 1 for Temporary Files**: When speed matters most
-. **Level 9 for Distribution**: When size matters more than time
-. **Monitor Throughput**: Deflate should process 5-15 MB/s
-. **Consider Deflate64**: For better compression (if compatible)
-== See Also
-* link:deflate64.html[Deflate64] - Enhanced Deflate with larger window
-* link:zstandard.html[Zstandard] - Modern fast compression
-* link:lzma2.html[LZMA2] - Better compression at cost of speed
-* link:../../compatibility.html[Compatibility] - Deflate support across tools

data/docs/guides/compression-algorithms/index.adoc DELETED Viewed

@@ -1,190 +0,0 @@
----
-title: Compression Algorithms
-nav_order: 10
-parent: Guides
-has_children: true
----
-== Compression Algorithms Overview
-Omnizip supports 6 major compression algorithms, each optimized for different use cases. Choose the right algorithm based on your needs for compression ratio, speed, and compatibility.
-== Algorithm Comparison
-[cols="1,1,1,1,2"]
-|===
-|Algorithm |Ratio |Speed |Decompression |Best For
-|link:lzma.html[LZMA]
-|Excellent
-|Slow
-|Fast
-|General purpose, long-term storage
-|link:lzma2.html[LZMA2]
-|Excellent
-|Slow
-|Fast
-|Multi-threading, modern archives
-|link:bzip2.html[BZip2]
-|Very Good
-|Medium
-|Medium
-|Text files, source code
-|link:ppmd.html[PPMd]
-|Excellent
-|Very Slow
-|Slow
-|Text, documents, natural language
-|link:deflate.html[Deflate]
-|Good
-|Fast
-|Very Fast
-|Cross-platform compatibility
-|link:zstandard.html[Zstandard]
-|Very Good
-|Very Fast
-|Very Fast
-|Speed-sensitive applications
-|===
-== Choosing an Algorithm
-=== By Priority
-[cols="1,3"]
-|===
-|Priority |Recommended Algorithm
-|Maximum Compression
-|LZMA2 (level 9) or LZMA (level 9)
-|Best for Text
-|PPMd (for text-heavy content)
-|Speed Critical
-|Zstandard (level 3) or Deflate (level 3)
-|Compatibility
-|Deflate (universally supported)
-|Multi-core Systems
-|LZMA2 (parallel processing)
-|Balanced
-|LZMA2 (level 5-6) or Zstandard (level 5)
-|===
-=== By File Type
-[cols="1,2"]
-|===
-|File Type |Best Algorithm
-|Source Code
-|LZMA2 or PPMd
-|Text Documents
-|PPMd or BZip2
-|Binary Executables
-|LZMA2 with BCJ filter
-|Images (uncompressed)
-|Zstandard or LZMA2
-|Already Compressed
-|Deflate (fast) or store mode
-|Mixed Content
-|LZMA2 with solid archive
-|===
-== Compression Levels
-Most algorithms support compression levels 1-9:
-[cols="1,2,2,2"]
-|===
-|Level |Speed |Ratio |Best For
-|1-2
-|Very Fast
-|Basic
-|Quick archiving, testing
-|3-4
-|Fast
-|Good
-|Development, temporary files
-|5-6
-|Medium
-|Very Good
-|**Default** - balanced performance
-|7-8
-|Slow
-|Excellent
-|Distribution, backups
-|9
-|Very Slow
-|Best
-|Archival, long-term storage
-|===
-== Format Support
-Not all algorithms are supported in all formats:
-[cols="1,1,1,1,1"]
-|===
-|Algorithm |7z |ZIP |RAR |XZ
-|LZMA
-|✅
-|❌
-|✅
-|✅
-|LZMA2
-|✅
-|❌
-|✅
-|✅
-|BZip2
-|✅
-|❌
-|❌
-|❌
-|PPMd
-|✅
-|✅
-|❌
-|❌
-|Deflate
-|✅
-|✅
-|❌
-|❌
-|Zstandard
-|✅
-|❌
-|❌
-|❌
-|===
-== See Also
-* link:../archive-formats/[Archive Formats] - Choose the right container format
-* link:../advanced-features/parallel-processing.html[Parallel Processing] - Speed up compression
-* link:../../compatibility.html[Compatibility] - Tool and format support matrix