= AptDownloader

http://rubyforge.org/projects/uwruby/
http://uwruby/rubyforge.org/apt_downloader

== DESCRIPTION:

Apt-Downloader is intended as a useful tool for
developers working on embedded linux.

When working on embedded linux it can be difficult to get programs working
on your target due to the shear number of dependencies needed to run
them. Debian has done an excellent job of building and testing their
software packages on a large number of architectures. The debian apt system
makes it easy for debian users to get access to this software on their own
platforms, but it's a bit obsfuscated how to use thier software to say,
download a package and all of it's dependencies to the root filesystem of
your target and target architecture.

Apt-Downloader is front end to apt that is intended to make this easy.

== FEATURES/PROBLEMS:

Features:
*Automatically builds up package lists from debian
*Automatically determines all dependency packages and dowloads them.
*Allows users to pick an output directory for either deb packages, the
extraction of such packages, or both.
*Cleans up after itself - all temp files are deleted at program exit.
*Clean and simple to use.

Problems:
*Takes a little while: building package lists is a slow process, especially
over a slow internet connection
*Does not (yet) support reusing the temp files that take a while to generate/
download before packages can be installed.
*Does not (yet) support reusing any downloaded files. Files are re-downloaded
from scratch each time they are needed.
*Checks your package names against the host system. If host and target servers
don't match, this could create a problem.
*Not capable of uninstall. If you don't like what you get, you will need to
regenerate your rootFS (however you could just install apt in your root fs
with this tool and then use it nativiely if your target has an internet
connection

== SYNOPSIS:

ad = AptDownloader.new
ad.architecture = 'arm'
ad.addPackages 'perl', 'ruby', 'ffmpeg'
ad.output_directory = '~/arm_deb_packages'
ad.go

== REQUIREMENTS:

You must have the apt (Advanced Package Tool) toolset
installed on your distrobution of linux. Apt is was designed for
Debian and is also in use on Ubuntu and FIXME-- ADD OTHER DISTROS HERE

== INSTALL:

sudo gem install
thats it.

== LICENSE:

(The MIT License)

Copyright (c) 2008 FIX

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
'Software'), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.