python-colourlovers 0.1.1

颜色

ColourLovers.com API提供了两种方式来检索颜色或颜色列表。

1. 通过调用带有所需颜色十六进制代码的ColourLovers.color()方法来搜索单个颜色，例如#37cbff。这将返回相应的颜色作为ColourLovers.Colour实例。

2. 通过调用带有以下参数之一的ColourLovers.colours()来搜索多个颜色：new、top、random。这将返回一个包含ColourLovers.Colour对象的列表。

有关其他参数的详细信息，请参阅http://python-colourlovers.readthedocs.org上的文档。

示例

>>> 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'>]

调色板

ColourLovers.com API提供了两种方式来检索调色板或调色板列表。

1. 通过调用带有所需调色板ID的ColourLovers.palette()方法来搜索单个调色板，例如1942043。这将返回相应的调色板作为ColourLovers.Palette实例。

2. 通过调用带有以下参数之一的ColourLovers.palettes()来搜索多个调色板：new、top、random。这将返回一个包含ColourLovers.Palette对象的列表。

有关其他参数的详细信息，请参阅http://python-colourlovers.readthedocs.org上的文档。

示例

>>> 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'>]

图案

ColourLovers.com API提供了两种方式来检索图案或图案列表。

1. 通过调用带有所需图案ID的ColourLovers.pattern()方法来搜索单个图案，例如2111513。这将返回相应的图案作为ColourLovers.Pattern实例。

2. 通过调用带有以下参数之一的ColourLovers.patterns()来搜索多个图案：new、top、random。这将返回一个包含ColourLovers.Pattern对象的列表。

有关其他参数的详细信息，请参阅http://python-colourlovers.readthedocs.org上的文档。

示例

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

爱好者

ColourLovers.com API提供了两种方式来检索“爱好者”或爱好者列表。

1. 通过调用带有所需爱好者用户名的ColourLovers.lover()方法来搜索单个爱好者，例如Alkalaiblue。这将返回相应的爱好者作为ColourLovers.Lover实例。

2. 通过调用带有以下参数之一的ColourLovers.lovers()来搜索多个爱好者：new和top（在这种情况下不可用random）。这将返回一个包含ColourLovers.Lover对象的列表。

有关其他参数的详细信息，请参阅http://python-colourlovers.readthedocs.org上的文档。

示例

>>> 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'>]

统计数据

要检索ColorLovers.com上提供的某些内容类型的基本统计数据，可以调用ColourLovers.stats，并带有以下stat_types之一：colours、palettes、patterns、lovers。每次调用都返回一个包含在ColorLovers.com上请求的内容类型的总数ColourLovers.Stats实例。

示例

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

0.1.0

• 提高测试覆盖率和清理测试代码。

• 从urllib2切换到requests库进行HTTP请求。

0.0.1

• 初始版本