{ "info": { "author": "Daniel Reeves", "author_email": "", "bugtrack_url": null, "classifiers": [], "description": "BLS Connect\n===========\n\nBLS Connect is an integration of BLS's API built for Python. It provides users an easy and intuitive way to import BLS data into pandas DataFrames.\n\n``RequestBLS().series()`` takes a Series ID input and returns a pandas DataFrame. It contains tons of useful functionality in keyword arguments, including:\n\n- ``shape`` : Import multiple time series in either wide or long formats.\n- ``interpolate`` : Interpolate missing data.\n- ``groupby`` : Group by period.\n\nAfter running the ``.series()`` method, the ``RequestBLS()`` class also stores messages in ``.messages`` and a data catalog (if the API key was defined) in ``.catalog``. (Other than that, the data from the request is not stored in the class; be sure to assign it to a variable.) These attributes reset each time the ``.series()`` method is run.\n\n``bls_search()`` makes it easy and intuitive to retrieve the Series ID's for the data you want for various popular series. This function seamlessly handles list inputs, returning a dictionary of all possible permutations from the lists provided.\n\n**Note:** Functionality for ``bls_search()`` is currently limited. Check out the docs to see what it can do so far.\n\nDocs coming soon. In the meanwhile, check out the docstrings.\n\nInstallation and Setup\n----------------------\n\nInstall and update using `pip`_:\n\n.. code-block:: text\n\n pip install -U blsconnect\n\nThe BLS Connect module works better if you have a BLS API key; you can register for one `here`_.\n\nA Simple Example\n----------------\n\n.. code-block:: python\n\n import pandas as pd\n from blsconnect import RequestBLS, bls_search\n\n MY_API_KEY = \"\"\n bls = RequestBLS(key=MY_API_KEY)\n\n # Get seasonally-adjusted unemployment rates for Florida, Georgia, and all U.S.\n series_names = bls_search(data=\"U3\",\n state=[\"FL\", \"GA\", \"US\"],\n sa=True)\n\n df = bls.series(series_names,\n start_year=2010,\n end_year=2019)\n\n df.head()\n\nAbout\n-----\n\nBLS Connect was created by Daniel Reeves in collaboration with `Employ America`_, a Washington D.C. based organization that seeks to promote macroeconomic policies that ensure the sustained advancement of labor market outcomes for all American workers.\n\n.. _Employ America: https://employamerica.org/\n.. _here: https://data.bls.gov/registrationEngine/\n.. _pip: https://pip.pypa.io/en/stable/quickstart/\n.. _check out the docs: docs/\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/dwreeves/blsconnect", "keywords": "", "license": "", "maintainer": "Daniel Reeves", "maintainer_email": "", "name": "blsconnect", "package_url": "https://pypi.org/project/blsconnect/", "platform": "", "project_url": "https://pypi.org/project/blsconnect/", "project_urls": { "Homepage": "https://github.com/dwreeves/blsconnect" }, "release_url": "https://pypi.org/project/blsconnect/0.9.1/", "requires_dist": null, "requires_python": "", "summary": "Integration of BLS's API built for Python.", "version": "0.9.1" }, "last_serial": 5594552, "releases": { "0.0.0": [ { "comment_text": "", "digests": { "md5": "3e4df8173dab7ae0c9b0955ba20ec7cd", "sha256": "2777feda20f956bb920632e542bbf5edca7f1fcc2327ebe33985dc595e5766cf" }, "downloads": -1, "filename": "blsconnect-0.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "3e4df8173dab7ae0c9b0955ba20ec7cd", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 13400, "upload_time": "2019-07-25T20:20:51", "url": "https://files.pythonhosted.org/packages/fd/81/0031db0560cef8cdc78007c5b7d395dcaba3692eda68436ac9f1f3196820/blsconnect-0.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "888892da376712df103773f66d058714", "sha256": "9fa6c1e78d490d315b1bf16277fe55af00c6c8b61e4e03712cc4e8ec856320c0" }, "downloads": -1, "filename": "blsconnect-0.0.0.tar.gz", "has_sig": false, "md5_digest": "888892da376712df103773f66d058714", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8365, "upload_time": "2019-07-25T20:20:53", "url": "https://files.pythonhosted.org/packages/b4/be/2e402aa37fd6b424ef8b966463e47cba4ce7b1315746d510873561a1ae9f/blsconnect-0.0.0.tar.gz" } ], "0.9.1": [ { "comment_text": "", "digests": { "md5": "cf8795f9caf7ab554fb9f364d37d226b", "sha256": "3601aedcd6168331f132c6fbe94bdcdaefdc9702b3a7a4234b5ce70212868fcf" }, "downloads": -1, "filename": "blsconnect-0.9.1-py3-none-any.whl", "has_sig": false, "md5_digest": "cf8795f9caf7ab554fb9f364d37d226b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 15183, "upload_time": "2019-07-28T02:16:58", "url": "https://files.pythonhosted.org/packages/04/54/4aaef50639f5373d33b1c0f13d06925975a2af8b09b5067d91381451a3bb/blsconnect-0.9.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8155ae2bafb64b784c03a783692ab4ed", "sha256": "ddb7d9d6ed3d128a2821bff53e8befc2c0eec711f8fa644480f57fc2fda4577a" }, "downloads": -1, "filename": "blsconnect-0.9.1.tar.gz", "has_sig": false, "md5_digest": "8155ae2bafb64b784c03a783692ab4ed", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11101, "upload_time": "2019-07-28T02:17:00", "url": "https://files.pythonhosted.org/packages/1b/2a/fbd488fe4049d0801210128c46c015cda300f741d9ac4eb7478504c089fe/blsconnect-0.9.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "cf8795f9caf7ab554fb9f364d37d226b", "sha256": "3601aedcd6168331f132c6fbe94bdcdaefdc9702b3a7a4234b5ce70212868fcf" }, "downloads": -1, "filename": "blsconnect-0.9.1-py3-none-any.whl", "has_sig": false, "md5_digest": "cf8795f9caf7ab554fb9f364d37d226b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 15183, "upload_time": "2019-07-28T02:16:58", "url": "https://files.pythonhosted.org/packages/04/54/4aaef50639f5373d33b1c0f13d06925975a2af8b09b5067d91381451a3bb/blsconnect-0.9.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8155ae2bafb64b784c03a783692ab4ed", "sha256": "ddb7d9d6ed3d128a2821bff53e8befc2c0eec711f8fa644480f57fc2fda4577a" }, "downloads": -1, "filename": "blsconnect-0.9.1.tar.gz", "has_sig": false, "md5_digest": "8155ae2bafb64b784c03a783692ab4ed", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11101, "upload_time": "2019-07-28T02:17:00", "url": "https://files.pythonhosted.org/packages/1b/2a/fbd488fe4049d0801210128c46c015cda300f741d9ac4eb7478504c089fe/blsconnect-0.9.1.tar.gz" } ] }