Metadata-Version: 2.1
Name: acs-download
Version: 0.1.3
Summary: Download American Community Survey (ACS) complete Public Use Micro Sample (PUMS) data files from census FTP server.
Home-page: https://github.com/chekos/acs_download
Author: Sergio Sánchez Zavala
Author-email: sergio@cimarron.io
License: MIT license
Keywords: acs_download
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: Click (>=6.0)
Requires-Dist: us (>=1.0)
Requires-Dist: tqdm (>=4.31)

============
acs_download
============


.. image:: https://img.shields.io/pypi/v/acs_download.svg
        :target: https://pypi.python.org/pypi/acs_download

.. image:: https://img.shields.io/travis/chekos/acs_download.svg
        :target: https://travis-ci.org/chekos/acs_download

.. image:: https://readthedocs.org/projects/acs-download/badge/?version=latest
        :target: https://acs-download.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status




Download American Community Survey (ACS) complete Public Use Micro Sample (PUMS) data files from census FTP server.


* Free software: MIT license
* Documentation: https://acs-download.readthedocs.io.

Usage
-----

.. code:: python

   import acs_download as acs

   acs.get_data(
       year = 2017,
       state = 'California',
       download_path = '../data/raw/',
       extract = True,
       extract_path = '../data/interim/',
   )

This will download ACS PUMS data file of California to your
``../data/raw/`` folder and extract it to ``../data/interim/`` folder.

``acs_download`` uses pypi package ``us``, which uses ``jellyfish``, to
handle ``state`` input so you can use variations

Features
--------

* TODO

Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.1.0 (2019-04-10)
------------------

* First release on PyPI.


