Clean up code

- Fixed docstrings

bigchaindb/backend/mongodb/query.py

@@ -371,8 +371,8 @@ def text_search(conn, search, *, language='english', case_sensitive=False,
 
     if text_score:
         return cursor
-    else:
-        return (_remove_text_score(asset) for asset in cursor)
+
+    return (_remove_text_score(asset) for asset in cursor)
 
 
 def _remove_text_score(asset):

bigchaindb/backend/query.py

@@ -363,17 +363,19 @@ def text_search(conn, search, *, language='english', case_sensitive=False,
     """Return all the assets that match the text search.
 
     The results are sorted by text score.
+    For more information about the behavior of text search on MongoDB see
+    https://docs.mongodb.com/manual/reference/operator/query/text/#behavior
 
     Args:
         search (str): Text search string to query the text index
         language (str, optional): The language for the search and the rules for
-            stemmer and tokenizer. If the language is `None` text search uses
+            stemmer and tokenizer. If the language is ``None`` text search uses
             simple tokenization and no stemming.
         case_sensitive (bool, optional): Enable or disable case sensitive
             search.
         diacritic_sensitive (bool, optional): Enable or disable case sensitive
             diacritic search.
-        text_score (bool, optional): If `True` returns the text score with
+        text_score (bool, optional): If ``True`` returns the text score with
             each document.
         limit (int, optional): Limit the number of returned documents.
 

tests/db/test_bigchain_api.py

@@ -246,9 +246,8 @@ class TestBigchainApi(object):
             assets = list(b.text_search('bigchaindb'))
         except OperationError as exc:
             assert not isinstance(b.connection, MongoDBConnection)
-            return
-
-        assert len(assets) == 3
+        else:
+            assert len(assets) == 3
 
     @pytest.mark.genesis
     def test_text_search_returns_valid_only(self, monkeypatch, b):