一个提供访问配色爱好者网站的API。
python-colourlovers的Python项目详细描述
这个python包python-colourlovers访问colourlowers.com api，一种允许用户发布颜色主题并对其进行评级的web服务。 此Web服务的API允许搜索用户（情人）及其 张贴内容（颜色、图案、调色板）。
访问api需要^{tt2}的实例$ 它提供了访问不同内容类型的方法： colour，palette，pattern，lover。向发送请求 颜色爱好者很容易调用相应的方法，如 ColourLovers.palettes()搜索调色板。 另外，可以指定以下参数new，top， random附加参数。请向色彩爱好者咨询 API文档以了解有关特定参数和 他们在http://www.colourlovers.com/api的限制。
您可以在以下网址找到爱色人士的网站：http://www.colourlovers.com
Colourlowers.com API在Creative Commons下提供 attribution相似的非商业共享许可证。请参考 http://www.colourlovers.com/api有关许可证的详细信息 以及使用条款。
您可以在github上找到源代码和最新的开发版本： https://github.com/elbaschid/python-colourlovers。那也是个地方 在那里你可以留下反馈和贡献你自己的代码。把叉子叉开 repo，进行更改并向我发送请求：）
颜色
colourlowers.com API提供了两种不同的方法来检索 颜色或颜色列表。
- 通过调用^{tt7}搜索单一颜色$ 具有所需颜色的十六进制的方法，例如#37cbff。这个遗嘱 将相应的颜色返回为ColourLovers.Colourinstance。
- 通过调用^{tt10}搜索多种颜色$ 其中一个参数是：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'>]
调色板
colourlowers.com API提供了两种不同的方法来检索 调色板或调色板列表：
- 通过调用^{tt15}搜索单个调色板$ 具有所需调色板ID的方法，例如1942043。这个遗嘱 将相应的颜色返回为ColourLovers.Paletteinstance。
- 通过调用^{tt3}搜索多个选项板$ 其中一个参数是：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'>]
模式
colourlowers.com API提供了两种不同的方法来检索 模式或模式列表。
- 通过调用^{tt23}搜索单个模式$ 具有所需模式ID的方法，例如2111513。这个遗嘱 将对应的模式返回为ColourLovers.Patterninstance。
- 通过调用^{tt26}搜索多个模式$ 其中一个参数是：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'>]
恋人
colourlowers.com API提供了两种不同的方法来检索 “情人”或“情人”列表。
- 通过呼叫^{tt31}寻找单身情人$ 方法使用所需情人的用户名，例如Alkalaiblue。这个遗嘱 将相应的情人作为ColourLovers.Loverinstance返回。
- 通过呼叫^{tt34}搜索多个情人$ 使用以下参数之一：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'>]
统计信息
检索上提供的某些内容类型的一些基本统计信息 你可以打电话给ColourLovers.stats具有下列之一 stat_类型：colours，palettes，patterns，lovers。每次通话 返回一个ColourLovers.Stats实例，其中包含 在Colourlowers.com上请求内容类型。
示例：
>>> from colourlovers import ColourLovers
>>> cl = ColourLovers()
>>> cl.stats('lovers')
<Stat total='1113083'>
>>> cl.stats('patterns')
<Stat total='2096087'>
变更日志
0.1.0
- 提高测试覆盖率并清理测试代码。
- 为http请求从urllib2切换到requests库。
0.0.1
- 初始版本
欢迎加入QQ群-->： 979659372
