superp-rubyzip 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZTM1OWI1MWE3MTk4MWVkNWM3ZTBmOGNiNmNlYzExMjY1YWRjOGFmNA==
+  data.tar.gz: !binary |-
+    MWIzOGRkZjVjNzc2NTE2NDQ0ODExNzZhMGFiMDZkNDg5NGQ2MTY3Mg==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    MWU4ZGFiNzE1ZTNhYzcyNzI5ODdkMzg3YTg4NmZmNGQxYjhmNDJjNTQ5MmZk
+    MzU0NGQ1YzViZTk2MzFjZTgwZmEyZGE0ZDMyZGEzYmYxNDk4MGY1MjViOTY3
+    MDMyY2RkOWMzZjZjNjAyMjM3YjBiYmNmMDc4OTUwYWIwNTAzNjI=
+  data.tar.gz: !binary |-
+    MTliZWVlMjQyYmE5MDY3YWE0NmU3Mjk3YjYzZWNjMTM3ZGVhYjVkZjI4NTcy
+    Nzc2NzhmMjgyOTI1YjI2N2EwOTQ4NGQ2NTk2MWQxN2U5NjJlYjg1MTZkYzc5
+    NjY2YjJmZjhmOTA0MjdiODUzZmEzZDM0ODA4NWQ3NjdhOWRkN2E=

data/NEWS

@@ -0,0 +1,176 @@
+= Version 0.9.9
+
+Added support for backslashes in zip files (generated by the default Windows
+zip packer for example) and comment sections with the comment length set to zero
+even though there is actually a comment.
+
+= Version 0.9.8
+
+Fixed: "Unitialized constant NullInputStream" error
+
+= Version 0.9.5
+
+Removed support for loading ruby in zip files (ziprequire.rb).
+
+= Version 0.9.4
+
+Changed ZipOutputStream.put_next_entry signature (API CHANGE!). Now
+allows comment, extra field and compression method to be specified.
+
+= Version 0.9.3
+
+Fixed: Added ZipEntry::name_encoding which retrieves the character
+encoding of the name and comment of the entry. Also added convenience
+methods ZipEntry::name_in(enc) and ZipEntry::comment_in(enc) for
+getting zip entry names and comments in a specified character
+encoding.
+
+= Version 0.9.2
+
+Fixed: Renaming an entry failed if the entry's new name was a
+different length than its old name. (Diego Barros)
+
+= Version 0.9.1
+
+Added symlink support and support for unix file permissions. Reduced
+memory usage during decompression.
+
+New methods ZipFile::[follow_symlinks, restore_times, restore_permissions, restore_ownership].
+New methods ZipEntry::unix_perms, ZipInputStream::eof?.
+Added documentation and test for new ZipFile::extract.
+Added some of the API suggestions from sf.net #1281314.
+Applied patch for sf.net bug #1446926.
+Applied patch for sf.net bug #1459902.
+Rework ZipEntry and delegate classes.
+
+= Version 0.5.12
+
+Fixed problem with writing binary content to a ZipFile in MS Windows.
+
+= Version 0.5.11
+
+Fixed name clash file method copy_stream from fileutils.rb. Fixed
+problem with references to constant CHUNK_SIZE.
+ZipInputStream/AbstractInputStream read is now buffered like ruby IO's
+read method, which means that read and gets etc can be mixed. The
+unbuffered read method has been renamed to sysread.
+
+= Version 0.5.10
+
+Fixed method name resolution problem with FileUtils::copy_stream and
+IOExtras::copy_stream.
+
+= Version 0.5.9
+
+Fixed serious memory consumption issue
+
+= Version 0.5.8
+
+Fixed install script.
+
+= Version 0.5.7
+
+install.rb no longer assumes it is being run from the toplevel source
+dir. Directory structure changed to reflect common ruby library
+project structure. Migrated from RubyUnit to Test::Unit format.  Now
+uses Rake to build source packages and gems and run unit tests.
+
+= Version 0.5.6
+
+Fix for FreeBSD 4.9 which returns Errno::EFBIG instead of
+Errno::EINVAL for some invalid seeks. Fixed 'version needed to
+extract'-field incorrect in local headers.
+
+= Version 0.5.5
+
+Fix for a problem with writing zip files that concerns only ruby 1.8.1.
+
+= Version 0.5.4
+
+Significantly reduced memory footprint when modifying zip files.
+
+= Version 0.5.3
+
+Added optimization to avoid decompressing and recompressing individual
+entries when modifying a zip archive.
+
+= Version 0.5.2
+
+Fixed ZipFile corruption bug in ZipFile class. Added basic unix
+extra-field support.
+
+= Version 0.5.1
+
+Fixed ZipFile.get_output_stream bug.
+
+= Version 0.5.0
+
+List of changes:
+* Ruby 1.8.0 and ruby-zlib 0.6.0 compatibility
+* Changed method names from camelCase to rubys underscore style.
+* Installs to zip/ subdir instead of directly to site_ruby
+* Added ZipFile.directory and ZipFile.file - each method return an
+object that can be used like Dir and File only for the contents of the
+zip file.
+* Added sample application zipfind which works like Find.find, only
+Zip::ZipFind.find traverses into zip archives too.
+
+Bug fixes:
+* AbstractInputStream.each_line with non-default separator
+
+
+= Version 0.5.0a
+
+Source reorganized. Added ziprequire, which can be used to load ruby
+modules from a zip file, in a fashion similar to jar files in
+Java. Added gtkRubyzip, another sample application. Implemented
+ZipInputStream.lineno and ZipInputStream.rewind
+
+Bug fixes:
+
+* Read and write date and time information correctly for zip entries.
+* Fixed read() using separate buffer, causing mix of gets/readline/read to
+cause problems.
+
+= Version 0.4.2
+
+Performance optimizations. Test suite runs in half the time.
+
+= Version 0.4.1
+
+Windows compatibility fixes.
+
+= Version 0.4.0
+
+Zip::ZipFile is now mutable and provides a more convenient way of
+modifying zip archives than Zip::ZipOutputStream. Operations for
+adding, extracting, renaming, replacing and removing entries to zip
+archives are now available.
+
+Runs without warnings with -w switch.
+
+Install script install.rb added.
+
+
+= Version 0.3.1
+
+Rudimentary support for writing zip archives.
+
+
+= Version 0.2.2
+
+Fixed and extended unit test suite. Updated to work with ruby/zlib
+0.5. It doesn't work with earlier versions of ruby/zlib.
+
+
+= Version 0.2.0
+
+Class ZipFile added. Where ZipInputStream is used to read the
+individual entries in a zip file, ZipFile reads the central directory
+in the zip archive, so you can get to any entry in the zip archive
+without having to skipping through all the preceeding entries.
+
+
+= Version 0.1.0
+
+First working version of ZipInputStream.

data/README.md

@@ -0,0 +1,175 @@
+# rubyzip [![Build Status](https://secure.travis-ci.org/rubyzip/rubyzip.png)](http://travis-ci.org/aussiegeek/rubyzip)[![Code Climate](https://codeclimate.com/github/aussiegeek/rubyzip.png)](https://codeclimate.com/github/aussiegeek/rubyzip)
+
+rubyzip is a ruby library for reading and writing zip files.
+
+## Important note
+
+This brucnh for next version of rubyzip. Do not use it on production.
+Rubyzip interface will be changed!!!
+
+## Installation
+rubyzip is available on RubyGems, so:
+
+```
+gem install rubyzip
+```
+
+Or in your Gemfile:
+
+```ruby
+gem 'rubyzip'
+```
+
+## Usage
+
+### Basic zip archive creation
+
+```ruby
+require 'rubygems'
+require 'zip'
+
+folder = "Users/me/Desktop/stuff_to_zip"
+input_filenames = ['image.jpg', 'description.txt', 'stats.csv']
+
+zipfile_name = "/Users/me/Desktop/archive.zip"
+
+Zip::File.open(zipfile_name, Zip::File::CREATE) do |zipfile|
+  input_filenames.each do |filename|
+    # Two arguments:
+    # - The name of the file as it will appear in the archive
+    # - The original file, including the path to find it
+    zipfile.add(filename, folder + '/' + filename)
+  end
+end
+```
+
+### Zipping a directory recursively
+
+```ruby
+require 'rubygems'
+require 'zip'
+
+directory = '/Users/me/Desktop/directory_to_zip/'
+zipfile_name = '/Users/me/Desktop/recursive_directory.zip'
+
+Zip::File.open(zipfile_name, Zip::File::CREATE) do |zipfile|
+	Dir[File.join(directory, '**', '**')].each do |file|
+	  zipfile.add(file.sub(directory, ''), file)
+	end
+end
+```
+
+## Known issues
+
+### Modify docx file with rubyzip
+
+Use `write_buffer` instead `open`. Thanks to @jondruse
+
+```ruby
+buffer = Zip::OutputStream.write_buffer do |out|
+  @zip_file.entries.each do |e|
+    unless [DOCUMENT_FILE_PATH, RELS_FILE_PATH].include?(e.name)
+      out.put_next_entry(e.name)
+      out.write e.get_input_stream.read
+     end
+  end
+
+  out.put_next_entry(DOCUMENT_FILE_PATH)
+  out.write xml_doc.to_xml(:indent => 0).gsub("\n","")
+
+  out.put_next_entry(RELS_FILE_PATH)
+  out.write rels.to_xml(:indent => 0).gsub("\n","")
+end
+
+File.open(new_path, "w") {|f| f.write(buffer.string) }
+```
+
+## Further Documentation
+
+There is more than one way to access or create a zip archive with
+rubyzip. The basic API is modeled after the classes in
+java.util.zip from the Java SDK. This means there are classes such
+as Zip::InputStream, Zip::OutputStream and
+Zip::File. Zip::InputStream provides a basic interface for
+iterating through the entries in a zip archive and reading from the
+entries in the same way as from a regular File or IO
+object. OutputStream is the corresponding basic output
+facility. Zip::File provides a mean for accessing the archives
+central directory and provides means for accessing any entry without
+having to iterate through the archive. Unlike Java's
+java.util.zip.ZipFile rubyzip's Zip::File is mutable, which means
+it can be used to change zip files as well.
+
+Another way to access a zip archive with rubyzip is to use rubyzip's
+Zip::FileSystem API. Using this API files can be read from and
+written to the archive in much the same manner as ruby's builtin
+classes allows files to be read from and written to the file system.
+
+For details about the specific behaviour of classes and methods refer
+to the test suite. Finally you can generate the rdoc documentation or
+visit http://rubyzip.sourceforge.net.
+
+
+## Configuration
+
+By default, rubyzip will not overwrite files if they already exist inside of the extracted path.  To change this behavior, you may specify a configuration option like so:
+
+```ruby
+Zip.on_exists_proc = true
+```
+
+If you're using rubyzip with rails, consider placing this snippet of code in an initializer file such as `config/initializers/rubyzip.rb`
+
+Additionally, if you want to configure rubyzip to overwrite existing files while creating a .zip file, you can do so with the following:
+
+```ruby
+Zip.continue_on_exists_proc = true
+```
+
+If you want to store non english names and want to open properly file on Windows(pre 7) you need to set next option:
+
+```ruby
+Zip.unicode_names = true
+```
+
+All settings in same time
+
+```ruby
+  Zip.setup do |c|
+    c.on_exists_proc = true
+    c.continue_on_exists_proc = true
+    c.unicode_names = true
+  end
+```
+
+## Developing
+
+To run tests you need run next commands:
+
+```
+bundle install
+rake
+```
+
+## Website and Project Home
+
+http://github.com/rubyzip/rubyzip
+
+http://rdoc.info/github/rubyzip/rubyzip/master/frames
+
+## Authors
+
+Alexander Simonov ( alex at simonov.me)
+
+Alan Harper ( alan at aussiegeek.net)
+
+Thomas Sondergaard (thomas at sondergaard.cc)
+
+Technorama Ltd. (oss-ruby-zip at technorama.net)
+
+extra-field support contributed by Tatsuki Sugiura (sugi at nemui.org)
+
+## License
+
+rubyzip is distributed under the same license as ruby. See
+http://www.ruby-lang.org/en/LICENSE.txt

data/Rakefile

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'rake/testtask'
+
+task :default => [:test]
+
+Rake::TestTask.new(:test) do |test|
+  test.libs << File.join(File.dirname(__FILE__), 'lib')
+  test.libs << File.join(File.dirname(__FILE__), 'test')
+  test.pattern = File.join(File.dirname(__FILE__), 'test/alltests.rb')
+  test.verbose = true
+  Dir.chdir File.join(File.dirname(__FILE__), 'test')
+end
+

data/TODO

@@ -0,0 +1,16 @@
+
+* ZipInputStream: Support zip-files with trailing data descriptors
+* Adjust rdoc stylesheet to advertise inherited methods if possible
+* Suggestion: Add ZipFile/ZipInputStream example that demonstrates extracting all entries.
+* Suggestion: ZipFile#extract destination should default to "."
+* Suggestion: ZipEntry should have extract(), get_input_stream() methods etc
+* Suggestion: ZipInputStream/ZipOutputStream should accept an IO object in addition to a filename.
+* (is buffering used anywhere with write?)
+* Inflater.sysread should pass the buffer to produce_input.
+* Implement ZipFsDir.glob
+* ZipFile.checkIntegrity method
+* non-MSDOS permission attributes
+** See mail from Ned Konz to ruby-talk subj. "Re: SV: [ANN] Archive 0.2"
+* Packager version, required unpacker version in zip headers
+** See mail from Ned Konz to ruby-talk subj. "Re: SV: [ANN] Archive 0.2"
+* implement storing attributes and ownership information

data/lib/zip.rb

@@ -0,0 +1,52 @@
+require 'delegate'
+require 'singleton'
+require 'tempfile'
+require 'fileutils'
+require 'stringio'
+require 'zlib'
+require 'zip/dos_time'
+require 'zip/ioextras'
+require 'rbconfig'
+require 'zip/entry'
+require 'zip/extra_field'
+require 'zip/entry_set'
+require 'zip/central_directory'
+require 'zip/file'
+require 'zip/input_stream'
+require 'zip/output_stream'
+require 'zip/decompressor'
+require 'zip/compressor'
+require 'zip/null_decompressor'
+require 'zip/null_compressor'
+require 'zip/null_input_stream'
+require 'zip/pass_thru_compressor'
+require 'zip/pass_thru_decompressor'
+require 'zip/inflater'
+require 'zip/deflater'
+require 'zip/streamable_stream'
+require 'zip/streamable_directory'
+require 'zip/constants'
+require 'zip/errors'
+
+module Zip
+  extend self
+  attr_accessor :unicode_names, :on_exists_proc, :continue_on_exists_proc
+
+  def reset!
+    @_ran_once = false
+    @unicode_names = false
+    @on_exists_proc = false
+    @continue_on_exists_proc = false
+  end
+
+  def setup
+    yield self unless @_ran_once
+    @_ran_once = true
+  end
+
+  reset!
+end
+
+# Copyright (C) 2002, 2003 Thomas Sondergaard
+# rubyzip is free software; you can redistribute it and/or
+# modify it under the terms of the ruby license.