diff options
author | Paul Duncan <pabs@pablotron.org> | 2016-08-10 21:04:41 -0400 |
---|---|---|
committer | Paul Duncan <pabs@pablotron.org> | 2016-08-10 21:04:41 -0400 |
commit | 25199ab4c29057d7c0a73812fc8f2ac3605c1d86 (patch) | |
tree | 78f93a21b23da48b8cd0113e8262876426cfa7e6 /README.md | |
parent | 533ee3ceb098919da478a6be57a2f4342712aca5 (diff) | |
download | zip-crystal-25199ab4c29057d7c0a73812fc8f2ac3605c1d86.tar.bz2 zip-crystal-25199ab4c29057d7c0a73812fc8f2ac3605c1d86.zip |
add documentation
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 66 |
1 files changed, 0 insertions, 66 deletions
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 |