Metadata-Version: 2.0
Name: oam-dl
Version: 0.2.1
Summary: Download any or all Ozy and Millie comics
Home-page: https://github.com/lethargilistic/oam-dl
Author: Mike Overby
Author-email: mikeoverby@outlook.com
License: MIT
Keywords: cli,commandline,download,api
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: docopt (==0.6.2)
Requires-Dist: progress (==1.2)
Requires-Dist: requests (==2.8.1)
Requires-Dist: wheel (==0.26.0)

# Ozy and Millie Archive CLI
[![PyPI](https://img.shields.io/pypi/v/oam-dl.svg)](https://pypi.python.org/pypi/oam-dl)
[![PyPI](https://img.shields.io/pypi/l/oam-dl.svg)]()
[![PyPI](https://img.shields.io/pypi/pyversions/oam-dl.svg)]()

oam-dl is inspired by and based on xkcd-dl by Tasdik Rahman, which was inspired by youtube-dl by Daniel Bolton.

It archives the less memetic yet superior (:P) *Ozy and Millie* by Dana Simpson, which ran from 1998 to 2008.

# Features
* Download all *Ozy and Millie* comics.
* Download individual *Ozy and Millie* comics by release number.
* Download ranges of *Ozy and Millie* comics by release number.

# Installation
It's on PyPI: `pip3 install oam-dl`

# Usage
After installing, run `oam-dl --create`.
This creates a json file in your home directory that stores
information on each of the comics.

##`--download`
Downloading a comic will create a directory structure in your
home directory under ~/OAM to automatically organize your comics 
by year and month. You can specify a path other than ~ with the `--path` command, 
and `--pathc` to create your path if it doesn't already exist.

* `oam-dl --download <NUM>` retrieves the `Ozy and Millie` comic with release
number <NUM>.

* `oam-dl --download -a` retrieves every *Ozy and Millie* comic. There are >2000 of them, 
so the download may take a while.

* `oam-dl --download -r <START> <END>` retieves the range of comics between
release numbers <START> and <END>.

* `oam-dl --download [option] --path=path/to/directory` creates the archive at that path.
# TODO
* Download via release date (maybe)

# License
MIT License (see LICENCE.txt)


