From 25199ab4c29057d7c0a73812fc8f2ac3605c1d86 Mon Sep 17 00:00:00 2001 From: Paul Duncan Date: Wed, 10 Aug 2016 21:04:41 -0400 Subject: add documentation --- README.md | 66 --------------------------------------------------------------- 1 file changed, 66 deletions(-) delete mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md deleted file mode 100644 index d378703..0000000 --- a/README.md +++ /dev/null @@ -1,66 +0,0 @@ -# zip-crystal - -Read and write zip archives natively from -[Crystal](http://crystal-lang.org/). - -## Installation - - -Add this to your application's `shard.yml`: - -```yaml -dependencies: - zip-crystal: - github: pablotron/zip-crystal -``` - - -## Usage - - -```crystal -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 = MemoryIO.new - -# open "/some/other/path/image.png" for writing -File.open("/some/other/path/image.png", "wb") do |file_io| - # read from "foo.zip" - Zip.read("foo.zip") do |zip| - # extract "bar.txt" to mem_io - zip["bar.txt"].read(mem_io) - - # extract "image.png" to file_io - zip["image.png"].read(file_io) - end -end -``` - -See the [API documentation](https://pablotron.github.com/zip-crystal/) -for additional information. - -## Development - -TODO: Write development instructions here - -## 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](https://github.com/pablotron) Paul Duncan - creator, maintainer -- cgit v1.2.3