{
    "info": {
        "author": "ffeast",
        "author_email": "ffeast@gmail.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# finam-export\n[![Build Status](https://travis-ci.org/ffeast/finam-export.svg?branch=master)](https://travis-ci.org/ffeast/finam-export)\n\nPython client library to download data from finam.ru\n\n## Capabilities\n* Contracts lookup by market categories, id, code, name or their combinations using a rich set of mathching options\n* Download data of any timeframe available on finam.ru ranging from ticks to monthly resolution\n\n## Samples provided\n* `samples/listing.py` - simply lists some contracts from every supported market\n* `samples/download.py` - downloads some data and prints it out\n* `samples/lookups.py` - shows how you can leverage lookup capabilities\n\n## Utility scripts\n* `scripts/finam-download.py` - feature-rich standalone script to download finam's data\n* `scripts/finam-lookup.py` - to quickly check what's availble on finam\n\n## Show me something working!\nHere's the output\n```\n./samples/download.py\n*** Current Russian ruble exchange rates ***\n... some debugging output omitted ...\n            <OPEN>  <HIGH>    <LOW>  <CLOSE>       <VOL>\nindex\n2016-11-07  63.945  64.085  63.6625   63.695  1214085000\n\n[1 rows x 5 columns]\n*** Current Brent Oil price ***\nINFO:root:Loading data from http://export.finam.ru/table.csv?sep=3&at=1&e=.csv&d=d&f=table&dtf=1&MSOR=0&tmf=3&mstimever=1&mstime=on&sep2=1&em=19473&code=BZ&cn=BZ&df=1&yf=2007&dt=7&datf=5&yt=2016&market=24&mf=0&mt=10&p=8\nINFO:root:Decoding response\n            <OPEN>  <HIGH>  <LOW>  <CLOSE>  <VOL>\nindex\n2016-11-07   45.95   46.38   45.8    46.01  52605\n\n[1 rows x 5 columns]\n```\nand here's the code producing this output:\n```\nimport logging\n\nfrom finam.export import Exporter, Market, LookupComparator\n\n\"\"\"\nFull-on example displaying up-to-date values of some important indicators\n\"\"\"\n\ndef main():\n    exporter = Exporter()\n    print('*** Current Russian ruble exchange rates ***')\n    rub = exporter.lookup(name='USDRUB_TOD', market=Market.CURRENCIES)\n    assert len(rub) == 1\n    data = exporter.download(rub.index[0], market=Market.CURRENCIES)\n    print(data.tail(1))\n\n    print('*** Current Brent Oil price ***')\n    oil = exporter.lookup(name='Brent', market=Market.COMMODITIES,\n                          name_comparator=LookupComparator.EQUALS)\n    assert len(oil) == 1\n    data = exporter.download(oil.index[0], market=Market.COMMODITIES)\n    print(data.tail(1))\n\n\nif __name__ == '__main__':\n    logging.basicConfig(level=logging.DEBUG)\n    main()\n```\n\n# Playing samples\nIf you haven't installed it from PyPi:\n```bash\npip install -r ./requirements.txt\n./samples/listing.py\n```\n\nOnce you have it installed just run\n```bash\n./samples/listing.py\n```\n\n## Technical details\n* Targeted to Linux/Mac\n* Uses pandas inside, all data returned is pandas DataFrames\n* Tested with python2.7 and python3.6+\n* Good tests coverage\n* Detailed logging of what's going on\n\n## Development\n* clone the repo\n* `pip install -r ./requirements.txt`\n* run tests to ensure all is fine\n* `nosetests`\n* go ahead and enhance it!\n* don't forget to cover your changes with tests\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/ffeast/finam-export",
        "keywords": "",
        "license": "Apache-2",
        "maintainer": "",
        "maintainer_email": "",
        "name": "finam-export",
        "package_url": "https://pypi.org/project/finam-export/",
        "platform": "",
        "project_url": "https://pypi.org/project/finam-export/",
        "project_urls": {
            "Homepage": "https://github.com/ffeast/finam-export"
        },
        "release_url": "https://pypi.org/project/finam-export/1.0.1/",
        "requires_dist": [
            "pandas (>=0.24.2)",
            "requests (<3,>=2.20.0)",
            "enum34",
            "click (>=6.7)",
            "click-datetime (>=0.2)"
        ],
        "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, <4",
        "summary": "Python library to download historical data from finam.ru",
        "version": "1.0.1"
    },
    "last_serial": 5197250,
    "releases": {
        "1.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "278ae86d67be0276ef9021f012912a73",
                    "sha256": "1f3155eb936dfe7681f817f6fac8782fa2fcf454c3d66504ad070c64b76aff81"
                },
                "downloads": -1,
                "filename": "finam_export-1.0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "278ae86d67be0276ef9021f012912a73",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, <4",
                "size": 16646,
                "upload_time": "2019-04-27T17:16:40",
                "url": "https://files.pythonhosted.org/packages/f3/6c/15b67ce9e557ebe69de60292b7840fd653ad1240a1f3227206db0dfd7488/finam_export-1.0.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "ecdf1f524b7ba366251ebff9afc5fc31",
                    "sha256": "b33466c333644f50849b008178b53ba5d4906a7b5c8e3cd7227c760f85578a7f"
                },
                "downloads": -1,
                "filename": "finam-export-1.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "ecdf1f524b7ba366251ebff9afc5fc31",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, <4",
                "size": 8546,
                "upload_time": "2019-04-27T17:16:58",
                "url": "https://files.pythonhosted.org/packages/0a/3b/dd0b7e360a622d0495c6266ead8a977215d7ef5ff276ff391ba4e54bc5b2/finam-export-1.0.1.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "278ae86d67be0276ef9021f012912a73",
                "sha256": "1f3155eb936dfe7681f817f6fac8782fa2fcf454c3d66504ad070c64b76aff81"
            },
            "downloads": -1,
            "filename": "finam_export-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "278ae86d67be0276ef9021f012912a73",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, <4",
            "size": 16646,
            "upload_time": "2019-04-27T17:16:40",
            "url": "https://files.pythonhosted.org/packages/f3/6c/15b67ce9e557ebe69de60292b7840fd653ad1240a1f3227206db0dfd7488/finam_export-1.0.1-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "ecdf1f524b7ba366251ebff9afc5fc31",
                "sha256": "b33466c333644f50849b008178b53ba5d4906a7b5c8e3cd7227c760f85578a7f"
            },
            "downloads": -1,
            "filename": "finam-export-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "ecdf1f524b7ba366251ebff9afc5fc31",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, <4",
            "size": 8546,
            "upload_time": "2019-04-27T17:16:58",
            "url": "https://files.pythonhosted.org/packages/0a/3b/dd0b7e360a622d0495c6266ead8a977215d7ef5ff276ff391ba4e54bc5b2/finam-export-1.0.1.tar.gz"
        }
    ]
}