release: 2.2.0

Horizon v1.0.0 Compatibility.

#### Added

- Add support for top-level offers endpoint with `seller`, `selling`, and `buying` filter.
  Horizon 1.0 includes a new `/offers` end-point, which allows you to list all offers, supporting filtering by `seller`, `selling`, or `buying` asset.

  You can fetch data from this endpoint by doing `server.offers()` and use any of the following filters:

  - `seller`: `server.offers().for_seller(account_id)`
  - `buying`: `server.offers().for_buying(asset)`
  - `selling`: `server.offers().for_selling(asset)`
  - `offer detail` : `server.offers().offer(offer_id)`

  This introduced a breaking change since it modified the signature for the function `server.offers()`.

  Before, if you wanted to list all the offers for a given account, you'd do:

  ```
  server.offers(account_id)
  ```

  Starting on this version you'll need to do:

  ```
  server.offers().for_seller(account_id)
  ```

  You can do now things that were not possible before, like finding
  all offers for an account filtering by the selling or buying asset

  ```
  server.offers().for_seller(account_id).for_buying(buying_asset).for_selling(selling_asset)
  ```

- Add support for filtering accounts by `signer` or `asset`, this has been released in a previous patch version.
  Horizon 1.0 includes a new `/accounts` end-point, which allows you to list all accounts who have another account as a signer or hold a given asset.

  You can fetch data from this endpoint by doing `server.accounts()` and use any of the following filters:

  - `acount detail`: `server.accounts().account_id(account_id)`, returns a single account.
  - `for signer`: `server.accounts().for_signer(account_id)`, returns accounts where `account_id` is a signer.
  - `for asset`: `server.accounts().for_asset(asset)`, returns accounts which hold the `asset`.

#### Changed

- Regenerate the XDR definitions to include [MetaV2](https://github.com/jonjove/stellar-core/blob/b299b3a458a15f592352c67d4da69baa6e8fbb6a/src/xdr/Stellar-ledger.x#L309) support (also see [#1902](stellar/go#1902)).

#### Fixed

- Fixed some documentation errors.

#### Breaking

- Change function signature for `server.offers`.
  The signature for the function `server.offers()` was changed to bring suppport for other filters.

  Before, if you wanted to list all the offers for a given account, you'd do:

  ```
  server.offers(account_id)
  ```

  Starting on this version you'll need to do:

  ```
  server.offers().for_seller(account_id)
  ```

* `server.accounts().signer` and `server.accounts().asset` are marked as deprecated, use `server.accounts().for_signer` and `server.accounts().for_asset` instead.

There are also some changes related to the horizon's response, currently SDK has not added parse support to it,
so please refer to this [issue](#257) or
release notes of Stellar horizon 1.0.0. In addition, support for parsing the
horizon's responses will be added in the next major update.

CHANGELOG.md

@@ -1,8 +1,8 @@
 Release History
 ===============
-### Version 2.2.0
 
-Unreleased
+### Version 2.2.0
+Released on February 07, 2020
 
 Horizon v1.0.0 Compatibility.
 
@@ -52,7 +52,7 @@ Horizon v1.0.0 Compatibility.
 
 - Regenerate the XDR definitions to include [MetaV2](https://github.com/jonjove/stellar-core/blob/b299b3a458a15f592352c67d4da69baa6e8fbb6a/src/xdr/Stellar-ledger.x#L309) support (also see [#1902](https://github.com/stellar/go/issues/1902)).
 
-### Fixed
+#### Fixed
 
 - Fixed some documentation errors.
 

README.rst

@@ -29,8 +29,6 @@ Stellar Python SDK
     :alt: PyPI - Implementation
     :target: https://pypi.python.org/pypi/stellar-sdk
 
-**This branch is about v2, click** `here <https://github.com/StellarCN/py-stellar-base/tree/v1>`_ **for the v1 branch. Thank you for your patience as we transition!**
-
 py-stellar-sdk is a Python library for communicating with
 a `Stellar Horizon server`_. It is used for building Stellar apps on Python. It supports **Python 3.6+** as
 well as PyPy 3.6+.
@@ -47,11 +45,13 @@ py-stellar-sdk's documentation can be found at https://stellar-sdk.readthedocs.i
 Installing
 ----------
 
+This branch is about v2, click `here <https://github.com/StellarCN/py-stellar-base/tree/v1>`_ for the v1 branch. Thank you for your patience as we transition!
+
 Install and update using `pipenv`_ or `pip`_:
 
 .. code-block:: text
 
-    pip install stellar-sdk==2.1.3
+    pip install stellar-sdk==2.2.0
 
 
 A Simple Example

docs/en/install.rst

@@ -11,7 +11,7 @@ To install py-stellar-sdk, use pipenv to install the module:
 
 .. code-block:: text
 
-    pipenv install stellar-sdk==2.1.3
+    pipenv install stellar-sdk==2.2.0
 
 If you're not using `pipenv <https://docs.pipenv.org/>`_, you should.
 Otherwise, you can install it via plain old `pip <https://pip.pypa.io/en/stable/quickstart/>`_. More on installing Python
@@ -29,5 +29,5 @@ You can clone `the repository <https://github.com/StellarCN/py-stellar-base>`_ d
 
     git clone https://github.com/StellarCN/py-stellar-base.git
     cd py-stellar-base
-    git checkout 2.1.3
+    git checkout 2.2.0
     pip install .

docs/zh_CN/install.rst

@@ -11,7 +11,7 @@
 
 .. code-block:: text
 
-    pipenv install stellar-sdk==2.1.3
+    pipenv install stellar-sdk==2.2.0
 
 我们推荐你使用 `pipenv <https://docs.pipenv.org/>`_ 来安装这个模块。当然你也可以使用 `pip <https://pip.pypa.io/en/stable/quickstart/>`_。
 想要更多的了解如何安装依赖，请参阅 `Hitchhiker's Guide to Python
@@ -28,5 +28,5 @@
 
     git clone https://github.com/StellarCN/py-stellar-base.git
     cd py-stellar-base
-    git checkout 2.1.3
+    git checkout 2.2.0
     pip install .

setup.py

@@ -50,7 +50,7 @@
     packages=find_packages(exclude=["tests", "tests.*"]),
     python_requires=">=3.6.0",
     classifiers=[
-        "Development Status :: 4 - Beta",
+        "Development Status :: 5 - Production/Stable",
         "Intended Audience :: Developers",
         "Natural Language :: English",
         "Operating System :: OS Independent",

stellar_sdk/__version__.py

@@ -11,7 +11,7 @@
 __description__ = "The Python Stellar SDK library provides APIs to build transactions and connect to Horizon."
 __url__ = "https://github.com/StellarCN/py-stellar-base"
 __issues__ = "{}/issues".format(__url__)
-__version__ = "2.2.0-beta2"
+__version__ = "2.2.0"
 __author__ = "Eno, overcat"
 __author_email__ = "appweb.cn@gmail.com, 4catcode@gmail.com"
 __license__ = "Apache License 2.0"