[EN-1570] docstrings refactoring

Author: iamishalkin

dxfeed/core/DXFeedPy.pyx

@@ -96,12 +96,6 @@ cdef class SubscriptionClass:
     cdef void *u_data
 
     def __init__(self):
-        """
-        Parameters
-        ----------
-        data_len: int
-            Sets maximum amount of events, that are kept in Subscription class
-        """
         self.subscription = NULL
         self.__event_handler = None
 
@@ -199,7 +193,7 @@ def dxf_create_connection_auth_bearer(address: Union[str, unicode, bytes],
         raise RuntimeError(f"In underlying C-API library error {error_code} occurred!")
     return cc
 
-def dxf_create_subscription(ConnectionClass cc, event_type: str, data_len: int = 100000):
+def dxf_create_subscription(ConnectionClass cc, event_type: str):
     """
     Function creates subscription and writes all relevant information to SubscriptionClass.
 

dxfeed/core/utils/handler.pyx

@@ -5,16 +5,16 @@ from typing import Iterable
 
 
 cdef class EventHandler:
-    """
-    Master class for user defined event handlers. `update` method should be considered as abstract.
-
-    Attributes
-    ----------
-    columns: list
-        After attaching listener the field contains one-word descriptors of the values in upcoming event the order
-        coincides
-    """
     def __init__(self):
+        """
+        Master class for user defined event handlers. `update` method should be considered as abstract.
+
+        Attributes
+        ----------
+        columns: list
+            After attaching listener the field contains one-word descriptors of the values in upcoming event the order
+            coincides
+        """
         self.columns = list()
 
     cdef void cython_internal_update_method(self, event) nogil:
@@ -34,19 +34,19 @@ cdef class EventHandler:
         warn(Warning('You have not implemented update method in your EventHandler, that is called, when event comes!'))
 
 cdef class DefaultHandler(EventHandler):
-    """
-    The class implements one possible event handler, which is considered as default. This class just stores upcoming
-    events in custom deque with thread lock and has methods to get data as list or as pandas.DataFrame.
-
-    Attributes
-    ----------
-    data_len: int
-        The length of internal DequeWithLock object. Default is 100000.
-    columns: list
-        After attaching listener the field contains one-word descriptors of the values in upcoming event the order
-        coincides.
-    """
     def __init__(self, data_len: int=100000):
+        """
+        The class implements one possible event handler, which is considered as default. This class just stores upcoming
+        events in custom deque with thread lock and has methods to get data as list or as pandas.DataFrame.
+
+        Attributes
+        ----------
+        data_len: int
+            The length of internal DequeWithLock object. Default is 100000.
+        columns: list
+            After attaching listener the field contains one-word descriptors of the values in upcoming event the order
+            coincides.
+        """
         super().__init__()
         self.__data = deque_wl(maxlen=data_len)
 

dxfeed/wrappers/endpoint.py

@@ -4,24 +4,24 @@
 
 
 class Endpoint(object):
-    """
-    Class for connection management. After successful creation Instance will be connected to server
-    with provided credentials
-
-    Attributes
-    ----------
-    connection_address: str
-        One of possible connection addresses:
-        
-        - the single address: `host:port` or just `host`
-        - address with credentials: `host:port[username=xxx,password=yyy]`
-        - multiple addresses: `(host1:port1)(host2)(host3:port3[username=xxx,password=yyy])`
-        
-        Default: demo.dxfeed.com:7300
-    connect: bool
-        When True `connect` method  is called during instance creation. Default - True
-    """
     def __init__(self, connection_address: str = 'demo.dxfeed.com:7300', connect: bool = True):
+        """
+        Class for connection management. After successful creation Instance will be connected to server
+        with provided credentials
+
+        Attributes
+        ----------
+        connection_address: str
+            One of possible connection addresses:
+
+            - the single address: `host:port` or just `host`
+            - address with credentials: `host:port[username=xxx,password=yyy]`
+            - multiple addresses: `(host1:port1)(host2)(host3:port3[username=xxx,password=yyy])`
+
+            Default: demo.dxfeed.com:7300
+        connect: bool
+            When True `connect` method  is called during instance creation. Default - True
+        """
         self.__con_address = connection_address
         self.__connection = ConnectionClass()
         if connect:

dxfeed/wrappers/subscription.py

@@ -6,29 +6,29 @@
 
 
 class Subscription(object):
-    """
-    Class for subscription management. Recommended to be created only via create_subscription method in Endpoint class.
-    Also stores incoming events
-
-    Attributes
-    ----------
-    connection: dxfeed.core.DXFeedPy.ConnectionClass
-        Core class written in cython, that handle connection related details on the low level
-    event_type: str
-        One of possible event types: 'Trade', 'Quote', 'Summary', 'Profile', 'Order', 'TimeAndSale', 'Candle',
-        'TradeETH', 'SpreadOrder', 'Greeks', 'TheoPrice', 'Underlying', 'Series', 'Configuration' or ''
-    date_time: str or datetime.datetime
-        If present timed subscription will be created (conflated stream). For sting date format is following:
-        %Y-%m-%d %H:%M:%S.%f. If None - stream subscription will be created (non-conflated). Default - None.
-    exact_format: bool
-        If False no warning will be thrown in case of incomplete date_time parameter. Default - True
-
-    Note
-    ----
-    Some event types (e.g. Candle) support only timed subscription.
-
-    """
     def __init__(self, connection, event_type: str, date_time: Union[str, datetime], exact_format: bool = True):
+        """
+        Class for subscription management. Recommended to be created only via create_subscription method in Endpoint class.
+        Also stores incoming events
+
+        Attributes
+        ----------
+        connection: dxfeed.core.DXFeedPy.ConnectionClass
+            Core class written in cython, that handle connection related details on the low level
+        event_type: str
+            One of possible event types: 'Trade', 'Quote', 'Summary', 'Profile', 'Order', 'TimeAndSale', 'Candle',
+            'TradeETH', 'SpreadOrder', 'Greeks', 'TheoPrice', 'Underlying', 'Series', 'Configuration' or ''
+        date_time: str or datetime.datetime
+            If present timed subscription will be created (conflated stream). For sting date format is following:
+            %Y-%m-%d %H:%M:%S.%f. If None - stream subscription will be created (non-conflated). Default - None.
+        exact_format: bool
+            If False no warning will be thrown in case of incomplete date_time parameter. Default - True
+
+        Note
+        ----
+        Some event types (e.g. Candle) support only timed subscription.
+
+        """
         self.__event_type = event_type
         if date_time is None:
             self.__sub = dxf_create_subscription(cc=connection,