Merge branch 'dev-refactor' into develop

Author: sergioteula

PRODUCT.md

@@ -1,13 +1,15 @@
 # Amazon Product Advertising API 5.0 wrapper for Python
 
-A simple Python wrapper for the [last version of the Amazon Product Advertising API](https://webservices.amazon.com/paapi5/documentation/quick-start/using-sdk.html). This module allows to get product information from Amazon using the official API in an easier way.
+A simple Python wrapper for the [last version of the Amazon Product Advertising API](https://webservices.amazon.com/paapi5/documentation/quick-start/using-sdk.html). This module allows interacting with Amazon using the official API in an easier way.
 
 [![PyPI](https://img.shields.io/pypi/v/python-amazon-paapi?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/)
+[![Python](https://img.shields.io/badge/Python->3.6-%23FFD140)](https://www.python.org/)
 [![License](https://img.shields.io/badge/License-MIT-%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/)
 
+> If you are still using the old version, go [here](https://github.com/sergioteula/python-amazon-paapi/blob/master/amazon/README).
+
 ## Features
 
 - Object oriented interface for simple usage.
@@ -16,9 +18,8 @@ A simple Python wrapper for the [last version of the Amazon Product Advertising
 - Get browse nodes information.
 - Get multiple results at once without the 10 items limitation from Amazon.
 - Configurable throttling to avoid requests exceptions.
-- Built-in serializer for Django REST framework.
+- Type hints to help you coding.
 - Support for [all available countries](https://github.com/sergioteula/python-amazon-paapi/blob/master/amazon/paapi.py#L31).
-- 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.
 - Join our [Telegram group](https://t.me/PythonAmazonPAAPI) for support or development.
 
@@ -28,94 +29,72 @@ You can install or upgrade the module with:
 
     pip install python-amazon-paapi --upgrade
 
-If you get `ModuleNotFoundError`, try installing this:
-
-    pip install amightygirl.paapi5-python-sdk
-
 ## Usage guide
 
 **Basic usage:**
 
 ```python
-from amazon.paapi import AmazonApi
+from amazon_paapi import AmazonApi
 amazon = AmazonApi(KEY, SECRET, TAG, COUNTRY)
-product = amazon.get_product('B01N5IB20Q')
-print(product.title)
+item = amazon.get_items('B01N5IB20Q')[0]
+print(item.item_info.title.display_value) # Item title
 ```
 
-**Get multiple product information:**
+**Get multiple items information:**
 
 ```python
-product = amazon.get_products('B01N5IB20Q,B01F9G43WU')
-print(product[0].images.large)
-print(product[1].prices.price.value)
+items = amazon.get_items(['B01N5IB20Q', 'B01F9G43WU'])
+for item in items:
+    print(item.images.primary.large.url) # Primary image url
+    print(item.offers.listings[0].price.amount) # Current price
 ```
 
 **Use URL insted of ASIN:**
 
 ```python
-product = amazon.get_product('https://www.amazon.com/dp/B01N5IB20Q')
+item = amazon.get_items('https://www.amazon.com/dp/B01N5IB20Q')
 ```
 
-**Get product variations:**
+**Get item variations:**
 
 ```python
-product = amazon.get_variations('B01N5IB20Q')
-print(product[0].title)
+variations = amazon.get_variations('B01N5IB20Q')
+for item in variations.items:
+    print(item.detail_page_url) # Affiliate url
 ```
 
-**Search product:**
+**Search items:**
 
 ```python
-product = amazon.search_products(item_count=25, keywords='speaker')
-print(product[14].url)
+search_result = amazon.search_items(keywords='nintendo')
+for item in search_result.items:
+    print(item.item_info.product_info.color) # Item color
 ```
 
 **Get browse node information:**
 
 ```python
-node = amazon.get_browsenodes(browse_nodes=browsenodes_list)
+browse_nodes = amazon.get_browse_nodes(['667049031', '599385031'])
+for browse_node in browse_nodes:
+    print(browse_node.display_name) # The name of the node
 ```
 
-**Get the ASIN from a URL:**
+**Get the ASIN from URL:**
 
 ```python
-from amazon.tools import get_asin
+from amazon_paapi import get_asin
 asin = get_asin('https://www.amazon.com/dp/B01N5IB20Q')
 ```
 
 **Throttling:**
 
-Throttling value must be `greater than 0` or `False` to disable it. This value throttles requests to a maximum of one request every `1 / value` seconds. Note that this value is a per-worker throttling, so applications with multiple workers may make more requests per second. Throttling value is [set by default](https://github.com/sergioteula/python-amazon-paapi/blob/master/amazon/paapi.py#L36) to `0.8` or one request every 1.25 seconds.
-
-```python
-amazon = AmazonApi(KEY, SECRET, TAG, COUNTRY, throttling=0.5)  # Max one request every two seconds
-amazon = AmazonApi(KEY, SECRET, TAG, COUNTRY, throttling=False)  # Unlimited requests per second
-```
-
-**Serializer for Django:**
-
-We provide a serializer for Django REST framework, which speeds up your API
-implementation.
+Throttling value represents the wait time in seconds between API calls, being the default value 1 second. Use it to avoid reaching Amazon request limits.
 
 ```python
-from amazon.serializers import AmazonProductSerializer
-from rest_framework import serializers
-
-serialized_product = AmazonProductSerializer(product)
-serialized_product.data
+amazon = AmazonApi(KEY, SECRET, TAG, COUNTRY, throttling=4)  # Makes 1 request every 4 seconds
+amazon = AmazonApi(KEY, SECRET, TAG, COUNTRY, throttling=0)  # No wait time between requests
 ```
 
-If you want to serialize a list of products:
-
-```python
-serialized_products = AmazonProductSerializer(products, many=True)
-serialized_products.data
-```
-
-For more information on how to work with serializers, check the documentation for
-[Django REST framework](https://www.django-rest-framework.org/api-guide/serializers/).
-
 ## License
 
-Copyright © 2020 Sergio Abad. See [license](https://github.com/sergioteula/python-amazon-paapi/blob/master/LICENSE) for details.
+Copyright © 2021 Sergio Abad. See [license](https://github.com/sergioteula/python-amazon-paapi/blob/master/LICENSE) for details.