Marketplace: Add app reviews and app versions methods

Author: Gonchik Tsymzhitov

README.rst

@@ -3,21 +3,40 @@ Atlassian Python API wrapper
 ============================
 |Build Status| |PyPI version| |PyPI - Downloads| |License| |Codacy Badge| |Docs|
 
+What is it?
+___________
+This package is used to provide a **simple** python interface for interacting with Atlassian products (Server, Data Center and Cloud).
+It is based on the official public Rest API documentation and private methods (+ xml+rpc, raw http request).
+
 Documentation
--------------
+_____________
 
 `Documentation`_
 
 .. _Documentation: https://atlassian-python-api.readthedocs.io
 
-Install
--------
+How to Install?
+_______________
+
+From PyPI
+
 .. code-block:: console
 
    $ pip install atlassian-python-api
 
+From Source
+
+- Git clone repository
+- Use `pip install -r requirements.txt` to install the required packages
+- or `pipenv install && pipenv install --dev`
+
+How to contribute?
+__________________
+Please, click here `Contribution Guidelines for this project`_
+
+
 Examples
---------
+________
 **More examples in ``examples/`` directory.**
 
 Here's a short example of how to create a Confluence page:
@@ -105,7 +124,7 @@ If you want to see the response in pretty print format JSON. Feel free for use c
     pprint(response)
 
 Development and Deployment (For contributors)
----------------------------------------------
+_____________________________________________
 First of all, I am happy for any PR requests.
 Let's fork and provide your changes :)
 See the `Contribution Guidelines for this project`_ for details on how to make changes to this library.
@@ -131,14 +150,17 @@ See the `Contribution Guidelines for this project`_ for details on how to make c
 
 
 Credits
--------
+_______
 In addition to all the contributors we would like to thank these vendors:
 
 * Atlassian_ for developing such a powerful ecosystem.
 * JetBrains_ for providing us with free licenses of PyCharm_
+* Microsoft_ for providing us with free licenses of VSCode_
 * Travis_ for hosting our continuous integration
 
 .. _Atlassian: https://www.atlassian.com/
 .. _JetBrains: http://www.jetbrains.com
 .. _PyCharm: http://www.jetbrains.com/pycharm/
 .. _Travis: https://travis-ci.org/
+.. _Microsoft: https://github.com/Microsoft/vscode/
+.. _VSCode: https://code.visualstudio.com/

atlassian/VERSION

@@ -1 +1 @@
-1.17.3
+1.17.4

atlassian/marketplace.py

@@ -54,3 +54,32 @@ def get_application_info(self, limit=10, offset=10):
             params['limit'] = limit
         url = 'rest/2/applications'
         return self.get(url, params=params)
+
+    def get_app_versions(self, add_on_key, application=None):
+        """
+        Get a list of versions for the specified app.
+        :param add_on_key: The unique identifier for this app,
+                            for example "com.atlassian.confluence.plugins.confluence-questions"
+        :param application: Only returns apps compatible with this application
+        :return:
+        """
+        params = {}
+        if application:
+            params['application'] = application
+        url = 'rest/2/addons/{addonKey}/versions'.format(addonKey=add_on_key)
+        return self.get(url, params=params)
+
+    def get_app_reviews(self, add_on_key, sort=None):
+        """
+        Get a list of reviews for the specified app.
+        :param add_on_key: The unique identifier for this app,
+                            for example "com.atlassian.confluence.plugins.confluence-questions"
+        :param sort: Specifies the review sort order
+                     Valid values: helpful, recent
+        :return:
+        """
+        url = 'rest/2/addons/{addonKey}/reviews'.format(addonKey=add_on_key)
+        params = {}
+        if sort:
+            params['sort'] = sort
+        return self.get(url, params=params)