Metadata-Version: 1.1
Name: python-amazon-simple-product-api
Version: 1.0.2
Summary: A simple Python wrapper for the Amazon.com Product Advertising API
Home-page: https://github.com/yoavaviram/python-amazon-simple-product-api
Author: Yoav Aviram
Author-email: support@cleverblocks.com
License: BSD
Description: Amazon Simple Product API 
        ==========================
        A simple Python wrapper for the Amazon.com Product Advertising API. 
        [![Build Status](https://secure.travis-ci.org/yoavaviram/python-amazon-simple-product-api.png?branch=master)](http://travis-ci.org/yoavaviram/python-amazon-simple-product-api)
        
        
        Features
        --------
        
        * An object oriented interface to Amazon products
        * Supports both item search and item lookup
        * Compatible with Google App Engine
        
        
        Dependencies
        --------------
        Before you get started, make sure you have:
        
        * Installed [Bottlenose](https://github.com/dlo/bottlenose) (`pip install bottlenose`)
        * Installed lxml (`pip install lxml`)
        * An Amazon Product Advertising account
        * An AWS account
        
        
        Usage
        -----
        
        Lookup:
        
             >>> from amazon.api import AmazonAPI
             >>> amazon = AmazonAPI(AMAZON_ACCESS_KEY, AMAZON_SECRET_KEY, AMAZON_ASSOC_TAG)
             >>> product = amazon.lookup(ItemId="B0051QVF7A")
             >>> product.title
             'Kindle, Wi-Fi, 6" E Ink Display - for international shipment'
             >>> product.price_and_currency
             (109.0, 'USD')
             >>> product.ean
             '0814916014354'
             >>> product.large_image_url
             'http://ecx.images-amazon.com/images/I/411H%2B731ZzL.jpg'
             >>> product.get_attribute('Publisher')
             'Amazon Digital Services, Inc'
             >>> product.get_attributes(['ItemDimensions.Width', 'ItemDimensions.Height'])
             {'ItemDimensions.Width': '450', 'ItemDimensions.Height': '34'}
        
        The API wrapper supports many other product attributes as well.
        
        Search:
        
             >>> from amazon.api import AmazonAPI
             >>> amazon = AmazonAPI(AMAZON_ACCESS_KEY, AMAZON_SECRET_KEY, AMAZON_ASSOC_TAG)
             >>> products = amazon.search(Keywords='kindle', SearchIndex='All')
             >>> for i, product in enumerate(products):
             >>>     print "{0}. '{1}'".format(i, product.title)
             0. 'Kindle, Wi-Fi, 6" E Ink Display - includes Special Offers & Sponsored Screensavers'
             1. 'Kindle Fire, Full Color 7" Multi-touch Display, Wi-Fi'
             2. 'Kindle US Power Adapter (Not included with Kindle or Kindle Touch)'
             3. 'Kindle Touch, Wi-Fi, 6" E Ink Display - includes Special Offers & Sponsored Screensavers'
             4. 'Kindle Keyboard 3G, Free 3G + Wi-Fi, 6" E Ink Display - includes Special Offers & Sponsored Screensavers'
             5. 'Kindle Touch 3G, Free 3G + Wi-Fi, 6" E Ink Display - includes Special Offers & Sponsored Screensavers'
             ...
             49. 'Kindle Wireless Reading Device (6" Display, U.S. Wireless)'
        
        The search method returns an iterable that will iterate through all products,
        on all pages available. Additional pages are retrieved automatically as needed.
        Keep in mind that Amazon limits the number of pages it makes available.
        
        For more information about these calls, please consult the [Product Advertising
        API Developer Guide](http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/index.html).
        
        There is also a convenience method to search and return a list of the first N results:
        
             >>> from amazon.api import AmazonAPI
             >>> amazon = AmazonAPI(AMAZON_ACCESS_KEY, AMAZON_SECRET_KEY, AMAZON_ASSOC_TAG)
             >>> products = amazon.search_n(1, Keywords='kindle', SearchIndex='All')
             >>> len(products)
             1
             >>> products[0].title
             'Kindle, Wi-Fi, 6" E Ink Display - includes Special Offers & Sponsored Screensavers'
        
        
        Tests
        ------
        To run the test suite please follow these steps:
        
        * Make sure [Nose](http://readthedocs.org/docs/nose/en/latest/) is installed: (`pip install nose`)
        * Create a local file named: `test_settings.py` with the following variables set to the relevant values: `AMAZON_ACCESS_KEY`, `AMAZON_SECRET_KEY`, `AMAZON_ASSOC_TAG`
        * Run `nosetests`
        
        License
        -------
        
        Copyright &copy; 2012 Yoav Aviram
        
        See LICENSE for details.
        
        
Keywords: amazon,product advertising,api
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: CGI Tools/Libraries
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: BSD License
