{ "info": { "author": "Sebastian Vetter", "author_email": "seb@roadsi.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Environment :: Web Environment", "Intended Audience :: Developers", "License :: OSI Approved :: GNU General Public License (GPL)", "Natural Language :: English", "Operating System :: MacOS :: MacOS X", "Operating System :: Microsoft :: Windows", "Operating System :: OS Independent", "Operating System :: POSIX", "Programming Language :: Python", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "The ColourLovers Python API\n===========================\n\n.. image:: https://travis-ci.org/elbaschid/python-colourlovers.png?branch=master\n :target: https://travis-ci.org/elbaschid/python-colourlovers\n\n.. image:: https://pypip.in/v/python-colourlovers/badge.png\n :target: https://crate.io/packages/python-colourlovers/\n\n.. image:: https://pypip.in/d/python-colourlovers/badge.png\n :target: https://crate.io/packages/python-colourlovers/\n\n\nThis Python package ``python-colourlovers`` access to the ColourLovers.com\nAPI, a web service that allows users to publish colour themes and rate them.\nThe API of this webservice allows to search for users (Lovers) and their\nposted contents (Colours, Patterns, Palettes).\n\nAccessing the API requires an instance of ``ColourLovers``\nwhich provides the methods to access the different content types:\n*Colour*, *Palette*, *Pattern*, *Lover*. Sending a request to\nColourLovers is as easy as calling the corresponding method such as\n``ColourLovers.palettes()`` to search for palettes.\nAdditionally, the following arguments can be specified ``new``, ``top``,\n``random`` with additional parameters. Please refer to the ColourLovers\nAPI documentation to find out more about the specific parameters and\ntheir restrictions at http://www.colourlovers.com/api.\n\nYou find the ColourLovers website at: http://www.colourlovers.com\n\nThe ColourLovers.com API is provided under the Creative Commons\n**Attribution-Noncommercial-Share Alike** license. Please refer to\nhttp://www.colourlovers.com/api for more information on the license\nand Terms Of Use.\n\nYou find the source code and the latest development version on github:\nhttps://github.com/elbaschid/python-colourlovers. That's also the place\nwhere you can leave feedback and contribute your own code. Just fork the\nrepo, make your changes and send me a pull request :)\n\n\nColours\n-------\n\nThe ColourLovers.com API provides two different ways to retrieve a\ncolour or a list of colours.\n\n1. Searching for a single colour by calling the ``ColourLovers.color()``\n method with the desired colour's hexcode, e.g. ``#37cbff``. This will\n return the corresponding colour as ``ColourLovers.Colour`` instance.\n2. Searching for multiple colours by calling ``ColourLovers.colours()``\n with one of these arguments: ``new``, ``top``, ``random``. This will\n return a list of ``ColourLovers.Colour`` objects.\n\nFor details on additional parameters please refer to the documentation at\nhttp://python-colourlovers.readthedocs.org\n\nExample::\n\n >>> from colourlovers import ColourLovers\n >>> cl = ColourLovers()\n >>> cl.color('#37cbff')\n []\n >>> cl.palettes('new', keywords='funky', numResults=3)\n [,\n ,\n ]\n\nPalettes\n--------\n\nThe ColourLovers.com API provides two different ways to retrieve a\npalette or a list of palettes:\n\n1. Searching for a single palette by calling the ``ColourLovers.palette()``\n method with the desired palette ID, e.g. ``1942043``. This will\n return the corresponding colour as ``ColourLovers.Palette`` instance.\n2. Searching for multiple palettes by calling ``ColourLovers.palettes()``\n with one of these arguments: ``new``, ``top``, ``random``. This will\n return a list of ``ColourLovers.Palette`` objects.\n\nFor details on additional parameters please refer to the documentation at\nhttp://python-colourlovers.readthedocs.org\n\nExample::\n\n >>> from colourlovers import ColourLovers\n >>> cl = ColourLovers()\n >>> cl.palettes('random')\n []\n >>> cl.palette(1942043)\n []\n\nPatterns\n--------\n\nThe ColourLovers.com API provides two different ways to retrieve a\npattern or a list of patterns.\n\n1. Searching for a single pattern by calling the ``ColourLovers.pattern()``\n method with the desired pattern's ID, e.g. ``2111513``. This will\n return the corresponding pattern as ``ColourLovers.Pattern`` instance.\n2. Searching for multiple patterns by calling ``ColourLovers.patterns()``\n with one of these arguments: ``new``, ``top``, ``random``. This will\n return a list of ``ColourLovers.Pattern`` objects.\n\nFor details on additional parameters please refer to the documentation at\nhttp://python-colourlovers.readthedocs.org\n\nExample::\n\n >>> from colourlovers import ColourLovers\n >>> cl = ColourLovers()\n >>> cl.patterns('random')\n []\n >>> cl.pattern(2111513)\n []\n\n\nLovers\n------\n\nThe ColourLovers.com API provides two different ways to retrieve a\n'lover' or a list of 'lovers'.\n\n1. Searching for a single lover by calling the ``ColourLovers.lover()``\n method with the desired lover's user name, e.g. ``Alkalaiblue``. This will\n return the corresponding lover as ``ColourLovers.Lover`` instance.\n2. Searching for multiple lovers by calling ``ColourLovers.lovers()``\n with one of these arguments: ``new`` and ``top`` (``random`` is not\n available in this case). This will return a list of\n ``ColourLovers.Lover`` objects.\n\nFor details on additional parameters please refer to the documentation at\nhttp://python-colourlovers.readthedocs.org\n\n\nExample::\n\n >>> from colourlovers import ColourLovers\n >>> cl = ColourLovers()\n >>> cl.lovers('new', numResults=4)\n [,\n ,\n ,\n ]\n >>> cl.lover('Alkalaiblue')\n []\n\nStats\n-----\n\nTo retrieve some basic statistics for certain content types provided on\nColourLovers.com you can call ``ColourLovers.stats`` with one of the following\n*stat_types*: ``colours``, ``palettes``, ``patterns``, ``lovers``. Each call\nreturns a ``ColourLovers.Stats`` instance holding the total number of the\nrequested content type on ColourLovers.com.\n\nExample::\n\n >>> from colourlovers import ColourLovers\n >>> cl = ColourLovers()\n >>> cl.stats('lovers')\n \n >>> cl.stats('patterns')\n \n\n\n=========\nChangelog\n=========\n\n0.1.0\n-----\n\n* Improve test coverage and clean up of test code.\n* Switch from ``urllib2`` to ``requests`` library for HTTP requests.\n\n0.0.1\n-----\n\n* Initial release", "description_content_type": null, "docs_url": null, "download_url": null, "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://python-colourlovers.readthedocs.org", "keywords": null, "license": "GNU General Public License (GPL)", "maintainer": null, "maintainer_email": null, "name": "python-colourlovers", "package_url": "https://pypi.org/project/python-colourlovers/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/python-colourlovers/", "project_urls": { "Homepage": "http://python-colourlovers.readthedocs.org" }, "release_url": "https://pypi.org/project/python-colourlovers/0.1.1/", "requires_dist": [ "requests (>=1.0)" ], "requires_python": null, "summary": "An API providing access to the ColourLovers website.", "version": "0.1.1" }, "last_serial": 1216916, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "d6068a33b1d3ef2c2247844af2cff672", "sha256": "e2d07b1d58a4ea13df28b8e1f28f65b4bc99b30f32a63da618f7ca5a11451a4c" }, "downloads": -1, "filename": "python-colourlovers-0.0.1.tar.gz", "has_sig": false, "md5_digest": "d6068a33b1d3ef2c2247844af2cff672", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20238, "upload_time": "2012-08-26T00:02:53", "url": "https://files.pythonhosted.org/packages/69/3c/80884293dbbf4abd101cd710140d82bf4be16421aee61ad83b16abef0bf5/python-colourlovers-0.0.1.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "518de7fd9d2129497d5c5bbae9ba8ecc", "sha256": "a3c39de16bb354c075aa793b8cb71726735b00e1c133b315e1044bd37dc858ad" }, "downloads": -1, "filename": "python-colourlovers-0.1.0.tar.gz", "has_sig": false, "md5_digest": "518de7fd9d2129497d5c5bbae9ba8ecc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22350, "upload_time": "2013-06-08T07:58:11", "url": "https://files.pythonhosted.org/packages/09/29/9705cb2e6eb559ff9502626c5345058042df27e403a9fd6fb7bf6af91582/python-colourlovers-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "7430500278d8608212e9bbcda17ebae0", "sha256": "95b53a4d5233d82c1486f453660411e94217b11ca6dc5c6516f3e1410b1ac29c" }, "downloads": -1, "filename": "python_colourlovers-0.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "7430500278d8608212e9bbcda17ebae0", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 11678, "upload_time": "2014-09-08T13:40:01", "url": "https://files.pythonhosted.org/packages/86/00/5da8c079a1ac02d442d0c2286e34147601fb502b8826f28e94637f06853e/python_colourlovers-0.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "025d4389f5680cfa5c48539c1515b768", "sha256": "2f1e6f08010569d1d8050693f62413c0269c9840f297efea64ee017d3e23ebec" }, "downloads": -1, "filename": "python-colourlovers-0.1.1.tar.gz", "has_sig": false, "md5_digest": "025d4389f5680cfa5c48539c1515b768", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21439, "upload_time": "2014-09-08T13:40:04", "url": "https://files.pythonhosted.org/packages/0c/90/c4fe3319a3018e0d9195fbf4a1359bd7ecf0459383310313afb5480d3f11/python-colourlovers-0.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "7430500278d8608212e9bbcda17ebae0", "sha256": "95b53a4d5233d82c1486f453660411e94217b11ca6dc5c6516f3e1410b1ac29c" }, "downloads": -1, "filename": "python_colourlovers-0.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "7430500278d8608212e9bbcda17ebae0", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 11678, "upload_time": "2014-09-08T13:40:01", "url": "https://files.pythonhosted.org/packages/86/00/5da8c079a1ac02d442d0c2286e34147601fb502b8826f28e94637f06853e/python_colourlovers-0.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "025d4389f5680cfa5c48539c1515b768", "sha256": "2f1e6f08010569d1d8050693f62413c0269c9840f297efea64ee017d3e23ebec" }, "downloads": -1, "filename": "python-colourlovers-0.1.1.tar.gz", "has_sig": false, "md5_digest": "025d4389f5680cfa5c48539c1515b768", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21439, "upload_time": "2014-09-08T13:40:04", "url": "https://files.pythonhosted.org/packages/0c/90/c4fe3319a3018e0d9195fbf4a1359bd7ecf0459383310313afb5480d3f11/python-colourlovers-0.1.1.tar.gz" } ] }