{ "info": { "author": "Gustavo Fonseca", "author_email": "gustavo.fonseca@scielo.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Programming Language :: Python", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "scieloapi.py\n============\n\nThin wrapper around the SciELO Manager RESTful API.\n\n[![Build Status](https://travis-ci.org/scieloorg/scieloapi.py.png?branch=master)](https://travis-ci.org/scieloorg/scieloapi.py)\n\nUsage example:\n\n import scieloapi\n\n client = scieloapi.Client('some.user', 'some.api_key')\n \n for journal in client.journals.all():\n print journal['id'], journal['title']\n\n\nHow to install\n--------------\n\nYou can install it via `pip`, directly from the github repo:\n\n pip install -e git+git://github.com/scieloorg/scieloapi.py.git#egg=scieloapi\n\nOr from PyPi (more stable):\n\n pip install scieloapi\n\n\nBasics\n------\n\nWhen a `Client` instance is initialized, the process automaticaly instrospects the API server\nin order to make available only the endpoints part of the specified API version. The API version\nmay be passed as keyword argument `version` when creating the `Client` instance. If ommited, \nthe highest version is used.\n\n\n >>> client = scieloapi.Client('some.user', 'some.api_key', api_uri='http://manager.scielo.org/api/', version='v1')\n \n\nListing available endpoints:\n\n >>> client.endpoints\n [u'pressreleases', u'users', u'sections', u'sponsors', u'collections', u'changes', u'apressreleases', u'uselicenses', u'journals', u'issues']\n >>>\n\nListing all items of an endpoint:\n\n >>> for journal in client.journals.all(): print journal['title']\n ...\n Acta M\u00e9dica Costarricense\n Acta Pedi\u00e1trica Costarricense\n Actualidades Investigativas en Educaci\u00f3n\n Adolescencia y Salud\n Agronom\u00eda Costarricense\n Agronom\u00eda Mesoamericana\n Annali dell'Istituto Superiore di Sanit\u00e0\n Arquivos em Odontologia\n Brazilian Journal of Oral Sciences\n Bulletin of the World Health Organization\n Cadernos de Sa\u00fade P\u00fablica\n >>> \n\n\nListing items matching some params:\n\n >>> for journal in client.journals.filter(collection='saude-publica'): print journal['title']\n ...\n Annali dell'Istituto Superiore di Sanit\u00e0\n Bulletin of the World Health Organization\n Cadernos de Sa\u00fade P\u00fablica\n Ci\u00eancia & Sa\u00fade Coletiva\n Gaceta Sanitaria\n MEDICC Review\n Revista Brasileira de Epidemiologia\n Revista Cubana de Salud P\u00fablica\n Revista de Salud P\u00fablica\n >>>\n\n\nGetting a specific item:\n\n >>> journal = client.journals.get(62)\n >>> journal['title']\n u'Acta M\\xe9dica Costarricense'\n >>>\n\n\nUse license\n-----------\n\nThis project is licensed under FreeBSD 2-clause. See `LICENSE` for more details.\n\n\nHistory\n=======\n\n0.5 (2014-02-10)\n----------------\n\n* Added `tox.ini` to help the porting to Python3.3.\n* Support for https (without verifiying CA).\n* Added `Content-Type: application/json` HTTP header to all post requests.\n* Added a do-nothing logger handler by default.\n\n\n0.4 (2013-08-30)\n----------------\n\n* Params are sorted by key before the GET request is dispatched. This minor\n change aims to improve server-side caching capabilities.\n* Minor changes to the API of the function `httpbroker.get`. It now accepts a `auth` kwarg\n to handle server-side authentication.\n* Minor changes to `scieloapi.Connector`:\n * A custom http broker can be passed as `http_broker` kwarg during init.\n * Http methods are created dinamically during initialization, with user credentials bound \n into it. Api_key is no longer maintained by the instance.\n* `Client.fetch_relations` now accepts the param `only` to specify a subset of relations to fetch.\n* Now the User-Agent is set to `scieloapi/:version`.\n* The module `scieloapi.scieloapi` was renamed to `scieloapi.core` to make things clearer.\n* Added POST method capabilities on endpoints.\n* Added the exception `exceptions.MethodNotAllowed` to represent 405 status code.\n\n\n0.3 (2013-08-02)\n----------------\n\n* Added more unit tests (Now at 73% of code coverage).\n* Minor adjusts at `setup.py` installation script.\n* New exceptions to represent http status codes.\n* Better documentation at `http://docs.scielo.org/projects/scieloapipy/`.\n\n\n0.2 (2013-07-26)\n----------------\n\n* Slumber dependency was removed. The module `scieloapi.httpbroker` was created\n to deal with http requests and responses.\n* Better test reports now using Nosetests + coverage.\n* Added method `Client.fetch_relations` to fetch all first-level relations of\n a document and replace the value by the full document.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://docs.scielo.org", "keywords": null, "license": "BSD License", "maintainer": null, "maintainer_email": null, "name": "scieloapi", "package_url": "https://pypi.org/project/scieloapi/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/scieloapi/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://docs.scielo.org" }, "release_url": "https://pypi.org/project/scieloapi/0.5/", "requires_dist": null, "requires_python": null, "summary": "Thin wrapper around the SciELO Manager RESTful API.", "version": "0.5" }, "last_serial": 996206, "releases": { "0.2": [ { "comment_text": "", "digests": { "md5": "48766bdf7dbd6e1ff73a9f924ca51ed2", "sha256": "9bda6dce2a9fdb7376bda1514de9dd4737525c3920a58b2cdd1c3e2c0a9b2ca7" }, "downloads": -1, "filename": "scieloapi-0.2.tar.gz", "has_sig": false, "md5_digest": "48766bdf7dbd6e1ff73a9f924ca51ed2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6495, "upload_time": "2013-07-26T17:30:08", "url": "https://files.pythonhosted.org/packages/61/dd/03d8f47de143eef27752e064087b97b6c79e95e993e7e2b86c38a8457943/scieloapi-0.2.tar.gz" }, { "comment_text": "", "digests": { "md5": "5e0e12d4598e56f28bdfc978af751eaf", "sha256": "3fee10c823f1bc493865967d0d0be45a362aa158f55eea0691f314a62201f022" }, "downloads": -1, "filename": "scieloapi-0.3.tar.gz", "has_sig": false, "md5_digest": "5e0e12d4598e56f28bdfc978af751eaf", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7764, "upload_time": "2013-08-02T20:00:59", "url": "https://files.pythonhosted.org/packages/69/e3/3fdd3a817b3368b76f067e7ebd273b33abe00adaf184336e5ae6675fe344/scieloapi-0.3.tar.gz" } ], "0.3": [], "0.4": [ { "comment_text": "", "digests": { "md5": "3e13d78d2e0d30cad4eefab475e6c82c", "sha256": "cf443c1655a4feab064a018b2982b7263e7ba010675f816e5c45dc19ff2f2308" }, "downloads": -1, "filename": "scieloapi-0.4.tar.gz", "has_sig": false, "md5_digest": "3e13d78d2e0d30cad4eefab475e6c82c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10483, "upload_time": "2013-08-30T20:16:17", "url": "https://files.pythonhosted.org/packages/07/ad/4621894845ef1083b3c49ac66bba2b127f7ac9861711ccb81faa1669e8c9/scieloapi-0.4.tar.gz" } ], "0.5": [ { "comment_text": "", "digests": { "md5": "38aef3203fe4dc7889891150c3d75cd0", "sha256": "618100fb8fef0c8e6bc13b1a61f49a67cc8428e00e2fd45a7ffc9de0b4597bd2" }, "downloads": -1, "filename": "scieloapi-0.5.tar.gz", "has_sig": false, "md5_digest": "38aef3203fe4dc7889891150c3d75cd0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11101, "upload_time": "2014-02-10T14:13:32", "url": "https://files.pythonhosted.org/packages/f9/e0/a6645c41b67d085fb9acdc4958437606df38bcc6fc50c34fcd8a42fbf6b3/scieloapi-0.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "38aef3203fe4dc7889891150c3d75cd0", "sha256": "618100fb8fef0c8e6bc13b1a61f49a67cc8428e00e2fd45a7ffc9de0b4597bd2" }, "downloads": -1, "filename": "scieloapi-0.5.tar.gz", "has_sig": false, "md5_digest": "38aef3203fe4dc7889891150c3d75cd0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11101, "upload_time": "2014-02-10T14:13:32", "url": "https://files.pythonhosted.org/packages/f9/e0/a6645c41b67d085fb9acdc4958437606df38bcc6fc50c34fcd8a42fbf6b3/scieloapi-0.5.tar.gz" } ] }