Search User Experience Improvements

Changes
========
* PYCBC-1690: Update SearchQuery to provide `__repr__` methods that reflect the
  query JSON that will be sent to the search service
* Update tests to confirm functionality
* PYCBC-1691: Improve developer experience by allowing various
  SearchQuery types to handle args and kwargs
* Update docstrings and API docs

Change-Id: Ib8b68f63faa4631a721a811c915e1370beead08e
Reviewed-on: https://review.couchbase.org/c/couchbase-python-client/+/232130
Tested-by: Build Bot <build@couchbase.com>
Reviewed-by: Dimitris Christodoulou <dimitris.christodoulou@couchbase.com>

Author: thejcfactor

couchbase/logic/search.py

@@ -119,6 +119,10 @@ def _genprop_str(*apipaths, **kwargs):
 
     @staticmethod
     def _gen_location(value):
+        if isinstance(value, dict):
+            if 'lon' in value and 'lat' in value:
+                return [float(value['lon']), float(value['lat'])]
+            raise InvalidArgumentException(message='Requires a dict with keys: lon, lat')
         if len(value) != 2 or not all(map(lambda pt: isinstance(pt, (int, float)), value)):
             raise InvalidArgumentException(message='Requires a tuple: (lon, lat)')
         return [float(value[0]), float(value[1])]
@@ -174,8 +178,7 @@ def _assign_kwargs(cls, kwargs):
     def _validate_range_query(self, r1, r2, **kwargs):
         _QueryBuilder._assign_kwargs(self, kwargs)
         if r1 is None and r2 is None:
-            raise TypeError('At least one of {0} or {1} should be specified',
-                            *self._MINMAX)
+            raise ValueError(f'At least one of the following params should be specified: {", ".join(self._MINMAX)}')
         if r1 is not None:
             setattr(self, self._MINMAX[0], r1)
         if r2 is not None:
@@ -198,10 +201,12 @@ def class_wrapper(cls):
                     field_prop = _COMMON_FIELDS[f]
                     setattr(cls, f, field_prop)
 
-            def new_init(self, term, *args, **kwargs):
+            def new_init(self, *args, **kwargs):
                 super(type(self), self).__init__()
                 if self._TERMPROP not in kwargs:
-                    kwargs[self._TERMPROP] = term
+                    if len(args) == 0:
+                        raise ValueError(f'{cls.__name__} missing required property: {self._TERMPROP}')
+                    kwargs[self._TERMPROP] = args[0]
                 _QueryBuilder._assign_kwargs(self, kwargs)
 
             cls.__init__ = new_init