python-colourlovers 0.1.0 (beta)

An API providing access to the ColourLovers website.

Colours

The ColourLovers.com API provides two different ways to retrieve a colour or a list of colours.

1. Searching for a single colour by calling the ColourLovers.color() method with the desired colour's hexcode, e.g. #37cbff. This will return the corresponding colour as ColourLovers.Colour instance.
2. Searching for multiple colours by calling ColourLovers.colours() with one of these arguments: new, top, random. This will return a list of ColourLovers.Colour objects.

For details on additional parameters please refer to the documentation at http://python-colourlovers.readthedocs.org

Example:

>>> from colourlovers import ColourLovers
>>> cl = ColourLovers()
>>> cl.color('#37cbff')
[<Colour id='4767129' title='i feel pretty' rgb=(55, 203, 255)>]
>>> cl.palettes('new', keywords='funky', numResults=3)
[<Palette id='1940972' title='"Funky President"'>,
 <Palette id='1936394' title='Barbie Doll Blonde'>,
 <Palette id='1936247' title='Lily's Rainbow'>]

Palettes

The ColourLovers.com API provides two different ways to retrieve a palette or a list of palettes:

1. Searching for a single palette by calling the ColourLovers.palette() method with the desired palette ID, e.g. 1942043. This will return the corresponding colour as ColourLovers.Palette instance.
2. Searching for multiple palettes by calling ColourLovers.palettes() with one of these arguments: new, top, random. This will return a list of ColourLovers.Palette objects.

For details on additional parameters please refer to the documentation at http://python-colourlovers.readthedocs.org

Example:

>>> from colourlovers import ColourLovers
>>> cl = ColourLovers()
>>> cl.palettes('random')
[<Palette id='114699' title='chunky butt'>]
>>> cl.palette(1942043)
[<Palette id='1942043' title='Drinking Game 2'>]

Patterns

The ColourLovers.com API provides two different ways to retrieve a pattern or a list of patterns.

1. Searching for a single pattern by calling the ColourLovers.pattern() method with the desired pattern's ID, e.g. 2111513. This will return the corresponding pattern as ColourLovers.Pattern instance.
2. Searching for multiple patterns by calling ColourLovers.patterns() with one of these arguments: new, top, random. This will return a list of ColourLovers.Pattern objects.

For details on additional parameters please refer to the documentation at http://python-colourlovers.readthedocs.org

Example:

>>> from colourlovers import ColourLovers
>>> cl = ColourLovers()
>>> cl.patterns('random')
[<Pattern id='391644' title='acanalado'>]
>>> cl.pattern(2111513)
[<Pattern id='2111513' title='Converse on Nothing'>]

Lovers

The ColourLovers.com API provides two different ways to retrieve a 'lover' or a list of 'lovers'.

1. Searching for a single lover by calling the ColourLovers.lover() method with the desired lover's user name, e.g. Alkalaiblue. This will return the corresponding lover as ColourLovers.Lover instance.
2. Searching for multiple lovers by calling ColourLovers.lovers() with one of these arguments: new and top (random is not available in this case). This will return a list of ColourLovers.Lover objects.

For details on additional parameters please refer to the documentation at http://python-colourlovers.readthedocs.org

Example:

>>> from colourlovers import ColourLovers
>>> cl = ColourLovers()
>>> cl.lovers('new', numResults=4)
[<Lover username='alliesuesue'>,
 <Lover username='NAJ910'>,
 <Lover username='VooDooDoll23'>,
 <Lover username='kidknie'>]
>>> cl.lover('Alkalaiblue')
[<Lover username='Alkalaiblue'>]

Stats

To retrieve some basic statistics for certain content types provided on ColourLovers.com you can call ColourLovers.stats with one of the following stat_types: colours, palettes, patterns, lovers. Each call returns a ColourLovers.Stats instance holding the total number of the requested content type on ColourLovers.com.

Example:

>>> from colourlovers import ColourLovers
>>> cl = ColourLovers()
>>> cl.stats('lovers')
<Stat total='1113083'>
>>> cl.stats('patterns')
<Stat total='2096087'>

0.1.0

• Improve test coverage and clean up of test code.
• Switch from urllib2 to requests library for HTTP requests.

0.0.1

• Initial release