zip-crystal v0.2.0

Read and write Zip Archives with Crystal.

zip-crystal

Read and write zip archives natively from Crystal.

Features

  • Read and write zip files
  • Native Crystal, no dependencies other than zlib
  • Stream writing (e.g. write zip to socket, pipe, or other arbitrary, non-seekable IO)
  • ZIP64 support
  • Store and DEFLATE compression
  • UTF-8 filename and comment support (EFS)

TODO

  • LZMA and BZip2 compression
  • Encryption (Legacy and Strong Encryption)
  • Split archives (e.g. multi-disk archives)
  • Legacy Unicode support

Installation

Add this to your application's shard.yml:

dependencies:
  zip-crystal:
    github: pablotron/zip-crystal

Usage

require "zip-crystal/zip"

# write to "foo.zip"
Zip.write("foo.zip") do |zip|
  # add "bar.txt" with contents "hello!"
  zip.add("bar.txt", "hello!")

  # add local file "/path/to/image.png" as "image.png"
  zip.add_file("image.png", "/path/to/image.png")
end

# create memory io
mem_io = IO::Memory.new

# read from "foo.zip"
Zip.read("foo.zip") do |zip|
  # extract "bar.txt" to mem_io
  zip["bar.txt"].write(mem_io)

  # extract "image.png" to "output-image.png"
  zip["image.png"].write("output-image.png")
end

See the API documentation for additional information.

Contributing

  1. Fork it ( https://github.com/pablotron/zip-crystal/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

  • pablotron Paul Duncan - creator, maintainer
Repository

zip-crystal

Owner
Statistic
  • 6
  • 1
  • 1
  • 1
  • 0
  • almost 8 years ago
  • August 10, 2016
License

MIT License

Links
Synced at

Thu, 07 Nov 2024 01:28:31 GMT

Languages