Merge branch 'developer'

PRODUCT.md

@@ -0,0 +1,126 @@
+    product
+        asin
+        title
+        url
+
+        product
+            features = []
+            languages = []
+            formats = []
+            pages_count
+            color
+            unit_count
+            size
+            dimensions
+                height
+                    value
+                    unit
+                lenght
+                    value
+                    unit
+                width
+                    value
+                    unit
+            weight
+                value
+                unit
+
+        info
+            contributors = []
+                name
+                role
+            manufacturer
+            brand
+            model
+            part_number
+            product_group
+            binding
+            is_adult
+            audience_rating
+            edition
+            warranty
+            publication_date
+            release_date
+            external_ids
+                ean = []
+                isbn = []
+                upc = []
+
+        images
+            small
+            medium
+            large
+            cropped
+                small = []
+                medium = []
+                large = []
+            variants
+                small = []
+                medium = []
+                large = []
+
+        trade_in
+            elegible
+            price
+            currency
+
+
+        prices
+            price
+                value
+                currency
+                per_unit
+                display
+                savings
+                    value
+                    currency
+                    per_unit
+                    display
+                    percentage
+            pvp
+                value
+                currency
+                per_unit
+                display
+            availability
+                max_order_quantity
+                min_order_quantity
+                type
+                message
+            condition
+                condition
+                condition_display
+                sub_condition
+                sub_condition_display
+            merchant
+                default_shipping_country
+                merchant_id
+                name
+            other
+                buybox_winner
+                loyalty_points
+                amazon_fulfilled
+                free_shipping_eligible
+                prime_eligible
+                prime_exclusive
+                prime_pantry
+                violates_map
+                offer_id
+
+        offers_summary = []
+            highest_price
+                value
+                currency
+                per_unit
+                display
+            lowest_price
+                value
+                currency
+                per_unit
+                display
+            condition
+                condition
+                condition_display
+                sub_condition
+                sub_condition_display
+            offer_count

README.md

@@ -2,10 +2,10 @@ Amazon Product Advertising API 5.0 wrapper for Python
 =======================================================
 A simple Python wrapper for the last version of the Amazon Product Advertising API. This module allows to get product information from Amazon using the official API in an easier way.
 
-[![PyPI](https://img.shields.io/pypi/v/python-amazon-paapi5?color=%231182C2&label=PyPI)](https://pypi.org/project/python-amazon-paapi5/)
+[![PyPI](https://img.shields.io/pypi/v/python-amazon-paapi5?color=%231182C2&label=PyPI)](https://pypi.org/project/python-amazon-paapi/)
 [![Python](https://img.shields.io/badge/Python-2.x%20%7C%203.x-%23FFD140)](https://www.python.org/)
-[![License](https://img.shields.io/badge/License-GPL--3.0-%23e83633)](https://github.com/sergioteula/python-amazon-paapi5/blob/master/LICENSE)
-[![Support](https://img.shields.io/badge/Support-Good-brightgreen)](https://github.com/sergioteula/python-amazon-paapi5/issues)
+[![License](https://img.shields.io/badge/License-GPL--3.0-%23e83633)](https://github.com/sergioteula/python-amazon-paapi/blob/master/LICENSE)
+[![Support](https://img.shields.io/badge/Support-Good-brightgreen)](https://github.com/sergioteula/python-amazon-paapi/issues)
 [![Amazon API](https://img.shields.io/badge/Amazon%20API-5.0-%23FD9B15)](https://webservices.amazon.com/paapi5/documentation/)
 
 
@@ -15,14 +15,17 @@ Features
 * Object oriented interface for simple usage.
 * Get information about a product through its ASIN or URL.
 * Get multiple products at once.
-* Ask for new features through the [issues](https://github.com/sergioteula/python-amazon-paapi5/issues) section.
+* Configurable throttling to avoid requests exceptions.
+* Support for all available countries.
+* Reorganized product information [structure](https://github.com/sergioteula/python-amazon-paapi/blob/master/PRODUCT.md) for simple use.
+* Ask for new features through the [issues](https://github.com/sergioteula/python-amazon-paapi/issues) section.
 
 Installation
 -------------
 
 You can install or upgrade the module with:
 
-    pip install python-amazon-paapi5 --upgrade
+    pip install python-amazon-paapi --upgrade
 
 Usage guide
 -----------
@@ -36,8 +39,8 @@ Basic usage:
 Get multiple product information:
 
     product = amazon.get_product('B01N5IB20Q,B01F9G43WU')
-    print(product[0].image_large)
-    print(product[1].prices.price)
+    print(product[0].images.large)
+    print(product[1].prices.price.value)
 
 Use URL insted of ASIN:
 
@@ -50,6 +53,10 @@ Get the ASIN from a URL:
 
 Changelog
 -------------
+    Version 2.0.0
+        - New structure for product info, adding all available information from the API.
+        - Added raw_data with the information unparsed from the API.
+        - Removed Amazon API version from package name to avoid changes in the future.
 
     Version 1.0.0
         - Added support for getting multiple product information.