Project

downlow

0.01
No commit activity in last 3 years
No release in over 3 years
Downlow provides an easy way to fetch files or archives and extract them with minimal hassle.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 1.2

Runtime

 Project Readme

downlow¶ ↑

Downloading files on the DL

Installation¶ ↑

gem install downlow

Tested against Ruby 1.8.7 and 1.9.1

What¶ ↑

Why is downloading and extracting files such a pain in Ruby?

Downlow to the rescue.

$ irb -rubygems -rdownlow
>> DL('http://gist.github.com/gists/290151/download', '~/Desktop/gist')
=> #<Pathname:/Users/aaronquint/Desktop/gist>

$ ls -l ~/Desktop/gist/
total 8
drwxrwxr-x  3 aaronquint  aaronquint  102 Jan 30 00:17 gist290151-4d195b0fc72a4b5e52f8e2b5d1670d078c03a018

>> DL('git://github.com/quirkey/resque-status.git', '~/Desktop')
Initialized empty Git repository in /Users/aaronquint/Sites/__active/downlow/tmp/resque-status/.git/
remote: Counting objects: 323, done.
remote: Compressing objects: 100% (186/186), done.
remote: Total 323 (delta 166), reused 169 (delta 83)
Receiving objects: 100% (323/323), 42.84 KiB, done.
Resolving deltas: 100% (166/166), done.
=> #<Pathname:/Users/aaronquint/Desktop/resque-status>

Sweet.

BONUS BEATS FOR GITHUB Downloads the tarball and extracts.

>> DL('gh://quirkey/sammy', ~/Desktop')

Usage¶ ↑

Downlow is comprised of two main features: Fetchers and Extractors. They do what they sound like they do.

To just fetch a remote (or local file or directory)

Downlow::Fetcher.fetch('remote', :destination => 'local')

Fetcher currently handles these styles of URL

Git (git://)
HTTP (http://)
Github (gh://user/project)
Local (anything else)

Extractors take a local file, and extract them based on their extension:

Downlow::Extractor.extract('local.archive', :destination => 'directory')

The extractors currently supported are

.tar.gz
.zip
dir (everything else)

DL() is just an alias for Downlow.get() which is just a wrapper around .fetch() and then .extract()

Thanks¶ ↑

Thanks to @mxcl for the awesome pathname extensions in homebrew/ Thanks to @defunkt as I took some ideas from rip.

Note on Patches/Pull Requests¶ ↑

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don’t break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.

Copyright © 2010 Aaron Quint. See LICENSE for details.