Unofficial Python API for Adobe Kuler.
Project description
#Help on module kuler:
###NAME
kuler - Unofficial API for Adobe Kuler service (kuler.adobe.com).
###FILE
/Users/krikava/Documents/Projects/pykuler/src/kuler.py
###DESCRIPTION
Sample example that prints out TOP 10 themes sorted by raiting (default)
k = Kuler(apiKey)
for (i, theme) in enumerate(k.list(maxItems=10)):
print '%d. %s' % (i, theme)
More information: http://learn.adobe.com/wiki/display/kulerdev/B.+Feeds
###CLASSES
Color
Kuler
Theme
class Color
| Class wrapping an RGB color
|
| Methods defined here:
|
| __init__(self, r, g, b)
|
| __str__(self)
|
| asRGB(self)
|
| asRGB16(self)
|
| ----------------------------------------------------------------------
| Class methods defined here:
|
| fromHexRGB(cls, hexrgb) from __builtin__.classobj
| Factory method that creates a Color instance from HTML like color string
| #rrggbb with 8 or 16 bit.
|
| fromRGB(cls, r, g, b) from __builtin__.classobj
class Kuler
| Facade of the Kuler API
|
| Methods defined here:
|
| __init__(self, apiKey)
| apiKey: Mandatory. API key obtained from the Kuler service. (You can
| get it from http://kuler.adobe.com/api)
|
| list(self, listType='raiting', startIndex=0, itemsPerPage=20, timeSpan=0, maxItems=100)
| Returns a generator of themes from a feeds of a specified type.
|
| listType: Optional. One of the strings recent (the default), popular,
| rating, or random.
|
| startIndex: Optional. A 0-based index into the list that specifies the
| first item to display. Default is 0, which displays the first item in
| the list.
|
| itemsPerPage: Optional. The maximum number of items to display on a
| page, in the range 1..100. Default is 20.
|
| timeSpan: Optional. Value in days to limit the set of themes retrieved.
| Default is 0, which retrieves all themes without time limit.
|
| maxItems: Optional. The number of items returned at most.
|
| search(self, themeID=None, userID=None, email=None, tag=None, hex=None, title=None, startIndex=0, itemsPerPage=20, maxItems=100)
| Returns a generator of themes from a feeds that meet specified search criteria.
|
| Caller needs to specify one of the following parameter:
| themeID: search on a specific themeID
| userID: search on a specific userID
| email: search on a specific email
| tag: search on a tag word
| hex: search on a hex color value (can be in the format "ABCDEF" or "0xABCDEF")
| title: search on a theme title
|
| startIndex: Optional. A 0-based index into the list that specifies the
| first item to display. Default is 0, which displays the first item in
| the list.
|
| itemsPerPage: Optional. The maximum number of items to display on a
| page, in the range 1..100. Default is 20.
|
| maxItems: Optional. The number of items returned at most.
class Theme
| Class wrapping a Kuler theme.
|
| Properties:
| title: theme title name
| themeId: theme ID
| colors: a tuple of Color instances in defined in the theme
|
| Methods defined here:
|
| __getitem__(self, index)
|
| __init__(self, themeID, title, colors)
| colors: Mandatory. Parameter that is an iterable object containing Color instances.
|
| __iter__(self)
|
| __len__(self)
|
| __str__(self)
|
| items(self)
###FUNCTIONS
main()
Sample example
###NAME
kuler - Unofficial API for Adobe Kuler service (kuler.adobe.com).
###FILE
/Users/krikava/Documents/Projects/pykuler/src/kuler.py
###DESCRIPTION
Sample example that prints out TOP 10 themes sorted by raiting (default)
k = Kuler(apiKey)
for (i, theme) in enumerate(k.list(maxItems=10)):
print '%d. %s' % (i, theme)
More information: http://learn.adobe.com/wiki/display/kulerdev/B.+Feeds
###CLASSES
Color
Kuler
Theme
class Color
| Class wrapping an RGB color
|
| Methods defined here:
|
| __init__(self, r, g, b)
|
| __str__(self)
|
| asRGB(self)
|
| asRGB16(self)
|
| ----------------------------------------------------------------------
| Class methods defined here:
|
| fromHexRGB(cls, hexrgb) from __builtin__.classobj
| Factory method that creates a Color instance from HTML like color string
| #rrggbb with 8 or 16 bit.
|
| fromRGB(cls, r, g, b) from __builtin__.classobj
class Kuler
| Facade of the Kuler API
|
| Methods defined here:
|
| __init__(self, apiKey)
| apiKey: Mandatory. API key obtained from the Kuler service. (You can
| get it from http://kuler.adobe.com/api)
|
| list(self, listType='raiting', startIndex=0, itemsPerPage=20, timeSpan=0, maxItems=100)
| Returns a generator of themes from a feeds of a specified type.
|
| listType: Optional. One of the strings recent (the default), popular,
| rating, or random.
|
| startIndex: Optional. A 0-based index into the list that specifies the
| first item to display. Default is 0, which displays the first item in
| the list.
|
| itemsPerPage: Optional. The maximum number of items to display on a
| page, in the range 1..100. Default is 20.
|
| timeSpan: Optional. Value in days to limit the set of themes retrieved.
| Default is 0, which retrieves all themes without time limit.
|
| maxItems: Optional. The number of items returned at most.
|
| search(self, themeID=None, userID=None, email=None, tag=None, hex=None, title=None, startIndex=0, itemsPerPage=20, maxItems=100)
| Returns a generator of themes from a feeds that meet specified search criteria.
|
| Caller needs to specify one of the following parameter:
| themeID: search on a specific themeID
| userID: search on a specific userID
| email: search on a specific email
| tag: search on a tag word
| hex: search on a hex color value (can be in the format "ABCDEF" or "0xABCDEF")
| title: search on a theme title
|
| startIndex: Optional. A 0-based index into the list that specifies the
| first item to display. Default is 0, which displays the first item in
| the list.
|
| itemsPerPage: Optional. The maximum number of items to display on a
| page, in the range 1..100. Default is 20.
|
| maxItems: Optional. The number of items returned at most.
class Theme
| Class wrapping a Kuler theme.
|
| Properties:
| title: theme title name
| themeId: theme ID
| colors: a tuple of Color instances in defined in the theme
|
| Methods defined here:
|
| __getitem__(self, index)
|
| __init__(self, themeID, title, colors)
| colors: Mandatory. Parameter that is an iterable object containing Color instances.
|
| __iter__(self)
|
| __len__(self)
|
| __str__(self)
|
| items(self)
###FUNCTIONS
main()
Sample example