onetick-py 1.164.0__py3-none-any.whl → 1.166.0__py3-none-any.whl

onetick/py/_version.py

@@ -1,2 +1,2 @@
 # This file was generated automatically. DO NOT CHANGE.
-VERSION = '1.164.0'
+VERSION = '1.166.0'

onetick/py/aggregations/_docs.py

@@ -522,6 +522,17 @@ _size_max_fractional_digits_doc = param_doc(
     annotation=int,
     default=0,
 )
+_include_market_order_ticks_doc = param_doc(
+    name='include_market_order_ticks',
+    desc="""
+    If set, market order ticks (they have price NaN) are included into the order book,
+    and are at the order book's top level.
+
+        Default is False.
+    """,
+    annotation=bool,
+    default=None,
+)
 _query_fun_doc = param_doc(
     name='query_fun',
     desc="""

onetick/py/aggregations/order_book.py

@@ -36,7 +36,8 @@ from ._docs import (_running_doc,
                     _book_delimiters_doc,
                     _max_initialization_days_doc,
                     _state_key_max_inactivity_sec_doc,
-                    _size_max_fractional_digits_doc)
+                    _size_max_fractional_digits_doc,
+                    _include_market_order_ticks_doc)
 
 
 OB_SNAPSHOT_DOC_PARAMS = [
@@ -47,7 +48,8 @@ OB_SNAPSHOT_DOC_PARAMS = [
     _book_uncross_method_doc, _dq_events_that_clear_book_doc, _identify_source_doc,
     _show_full_detail_doc, _show_only_changes_doc, _book_delimiters_doc,
     _max_initialization_days_doc, _state_key_max_inactivity_sec_doc,
-    _size_max_fractional_digits_doc
+    _size_max_fractional_digits_doc,
+    _include_market_order_ticks_doc,
 ]
 OB_SNAPSHOT_WIDE_DOC_PARAMS = [
     _running_doc,
@@ -57,7 +59,8 @@ OB_SNAPSHOT_WIDE_DOC_PARAMS = [
     _book_uncross_method_doc, _dq_events_that_clear_book_doc,
     _book_delimiters_doc,
     _max_initialization_days_doc, _state_key_max_inactivity_sec_doc,
-    _size_max_fractional_digits_doc
+    _size_max_fractional_digits_doc,
+    _include_market_order_ticks_doc,
 ]
 OB_SNAPSHOT_FLAT_DOC_PARAMS = [
     _running_doc,
@@ -67,7 +70,8 @@ OB_SNAPSHOT_FLAT_DOC_PARAMS = [
     _book_uncross_method_doc, _dq_events_that_clear_book_doc,
     _show_full_detail_doc,
     _max_initialization_days_doc, _state_key_max_inactivity_sec_doc,
-    _size_max_fractional_digits_doc
+    _size_max_fractional_digits_doc,
+    _include_market_order_ticks_doc,
 ]
 OB_SUMMARY_DOC_PARAMS = [
     _running_doc,
@@ -75,7 +79,8 @@ OB_SUMMARY_DOC_PARAMS = [
     _bucket_end_condition_doc, _end_condition_per_group_doc, _group_by_doc, _groups_to_display_doc,
     _side_doc, _max_levels_doc, _min_levels_doc, _max_depth_shares_doc, _max_depth_for_price_doc,
     _book_uncross_method_doc, _dq_events_that_clear_book_doc, _max_initialization_days_doc,
-    _state_key_max_inactivity_sec_doc, _size_max_fractional_digits_doc
+    _state_key_max_inactivity_sec_doc, _size_max_fractional_digits_doc,
+    _include_market_order_ticks_doc,
 ]
 
 OB_SIZE_DOC_PARAMS = [
@@ -177,6 +182,7 @@ class ObSnapshot(_OrderBookAggregation):
         'book_delimiters': 'BOOK_DELIMITERS',
         'state_key_max_inactivity_sec': 'STATE_KEY_MAX_INACTIVITY_SEC',
         'size_max_fractional_digits': 'SIZE_MAX_FRACTIONAL_DIGITS',
+        'include_market_order_ticks': 'INCLUDE_MARKET_ORDER_TICKS',
     })
     FIELDS_DEFAULT = dict(_OrderBookAggregation.FIELDS_DEFAULT, **{
         'identify_source': False,
@@ -185,6 +191,7 @@ class ObSnapshot(_OrderBookAggregation):
         'book_delimiters': None,
         'state_key_max_inactivity_sec': None,
         'size_max_fractional_digits': 0,
+        'include_market_order_ticks': None,
     })
 
     def __init__(self,
@@ -195,6 +202,7 @@ class ObSnapshot(_OrderBookAggregation):
                  book_delimiters: Optional[Literal['D']] = None,
                  state_key_max_inactivity_sec: Optional[int] = None,
                  size_max_fractional_digits: int = 0,
+                 include_market_order_ticks: Optional[bool] = None,
                  **kwargs):
         self.identify_source = identify_source
         self.show_full_detail = show_full_detail
@@ -202,11 +210,22 @@ class ObSnapshot(_OrderBookAggregation):
         self.book_delimiters = book_delimiters
         self.state_key_max_inactivity_sec = state_key_max_inactivity_sec
         self.size_max_fractional_digits = size_max_fractional_digits
+        self.include_market_order_ticks = include_market_order_ticks
         # we don't want to set hard limit on the output of order book aggregations
         if self.show_full_detail:
             kwargs['all_fields'] = True
         super().__init__(*args, **kwargs)
 
+    def _param_validation(self):
+        super()._param_validation()
+        if self.include_market_order_ticks is not None:
+            if 'include_market_order_ticks' not in self.EP.Parameters.list_parameters():
+                raise ValueError("Parameter 'include_market_order_ticks' is not supported on this OneTick API version")
+            otp.compatibility.is_include_market_order_ticks_supported(
+                throw_warning=True,
+                feature_name="parameter 'include_market_order_ticks'",
+            )
+
     def _get_output_schema(self, src: 'Source', name: Optional[str] = None) -> dict:
         schema = {
             'PRICE': float,
@@ -284,11 +303,13 @@ class ObSummary(_OrderBookAggregation):
         'min_levels': 'MIN_LEVELS',
         'state_key_max_inactivity_sec': 'STATE_KEY_MAX_INACTIVITY_SEC',
         'size_max_fractional_digits': 'SIZE_MAX_FRACTIONAL_DIGITS',
+        'include_market_order_ticks': 'INCLUDE_MARKET_ORDER_TICKS',
     })
     FIELDS_DEFAULT = dict(_OrderBookAggregation.FIELDS_DEFAULT, **{
         'min_levels': None,
         'state_key_max_inactivity_sec': None,
         'size_max_fractional_digits': 0,
+        'include_market_order_ticks': None,
     })
 
     def __init__(self,
@@ -296,6 +317,7 @@ class ObSummary(_OrderBookAggregation):
                  min_levels: Optional[int] = None,
                  state_key_max_inactivity_sec: Optional[int] = None,
                  size_max_fractional_digits: int = 0,
+                 include_market_order_ticks: Optional[bool] = None,
                  **kwargs):
         if is_supported_otq_ob_summary():
             self.EP = otq.ObSummary
@@ -305,8 +327,19 @@ class ObSummary(_OrderBookAggregation):
         self.min_levels = min_levels
         self.state_key_max_inactivity_sec = state_key_max_inactivity_sec
         self.size_max_fractional_digits = size_max_fractional_digits
+        self.include_market_order_ticks = include_market_order_ticks
         super().__init__(*args, **kwargs)
 
+    def _param_validation(self):
+        super()._param_validation()
+        if self.include_market_order_ticks is not None:
+            if 'include_market_order_ticks' not in self.EP.Parameters.list_parameters():
+                raise ValueError("Parameter 'include_market_order_ticks' is not supported on this OneTick API version")
+            otp.compatibility.is_include_market_order_ticks_supported(
+                throw_warning=True,
+                feature_name="parameter 'include_market_order_ticks'",
+            )
+
     def _get_output_schema(self, src: 'Source', name: Optional[str] = None) -> dict:
         schema = {
             'BID_SIZE': int,

onetick/py/compatibility.py

@@ -750,3 +750,11 @@ def is_ilike_supported():
     # 20250423: Implemented 0035413: Add support of ILIKE in SQL
     return _is_min_build_or_version(None, None,
                                     20250510120000)
+
+
+def is_include_market_order_ticks_supported(**kwargs):
+    # Implemented 0031478: OB_SNAPSHOT... and OB_SUMMARY EPs
+    # should support parameter INCLUDE_MARKET_ORDER_TICKS (false by default)
+    return _is_min_build_or_version(1.25, 20241229055942,
+                                    20240812120000, min_update_number=2,
+                                    **kwargs)

onetick/py/core/source.py

@@ -24,7 +24,7 @@ from onetick.py.core._source.tmp_otq import TmpOtq
 from onetick.py.core.column import _Column
 from onetick.py.core.column_operations.base import _Operation, OnetickParameter
 from onetick.py.core.query_inspector import get_query_parameter_list
-from onetick.py.utils import adaptive, adaptive_to_default, default
+from onetick.py.utils import adaptive, adaptive_to_default, default, render_otq
 
 
 def _is_dict_required(symbols):
@@ -939,6 +939,76 @@ class Source:
         kwargs.setdefault('verbose', True)
         self.to_graph().render(**kwargs)
 
+    def render_otq(
+        self,
+        image_path: Optional[str] = None,
+        output_format: Optional[str] = None,
+        load_external_otqs: bool = True,
+        view: bool = False,
+        line_limit: Optional[Tuple[int, int]] = (10, 30),
+        parse_eval_from_params: bool = False,
+        debug: bool = False,
+        **kwargs,
+    ):
+        """
+        Render current :py:class:`~onetick.py.Source` graph.
+
+        Parameters
+        ----------
+        image_path: str, None
+            Path for generated image. If omitted, image will be saved in a temp dir
+        output_format: str, None
+            `Graphviz` rendering format. Default: `png`.
+            If `image_path` contains one of next extensions, `output_format` will be set automatically:
+            `png`, `svg`, `dot`.
+        load_external_otqs: bool
+            If set to `True` (default) dependencies from external .otq files (not listed in ``path`` param)
+            will be loaded automatically.
+        view: bool
+            Defines should generated image be shown after render.
+        line_limit: Tuple[int, int], None
+            Limit for maximum number of lines and length of some EP parameters strings.
+            First param is limit of lines, second - limit of characters in each line.
+            If set to None limit disabled.
+            If one of tuple values set to zero the corresponding limit disabled.
+        parse_eval_from_params: bool
+            Enable parsing and printing `eval` sub-queries from EP parameters.
+        debug: bool
+            Allow to print stdout or stderr from `Graphviz` render.
+        kwargs:
+            Additional arguments to be passed to :py:meth:`onetick.py.Source.to_otq` method (except
+            ``file_name``, ``file_suffix`` and ``query_name`` parameters)
+
+        Returns
+        -------
+        Path to rendered image
+
+        See also
+        --------
+        :py:func:`render_otq <onetick.py.utils.render_otq>`
+
+        Examples
+        --------
+
+        >>> data = otp.DataSource(db='US_COMP', tick_type='TRD', symbols='AAA')  # doctest: +SKIP
+        >>> data1, data2 = data[(data['PRICE'] > 50)]  # doctest: +SKIP
+        >>> data = otp.merge([data1, data2])  # doctest: +SKIP
+        >>> data.render_otq('./path/to/image.png')  # doctest: +SKIP
+
+        .. image:: ../../static/testing/images/render_otq_3.png
+        """
+
+        if {'file_name', 'file_suffix', 'query_name'} & kwargs.keys():
+            raise ValueError(
+                'It\'s not allowed to pass parameters `file_name`, `file_suffix` and `query_name` as `kwargs` '
+                'in `render_otq` method.'
+            )
+
+        otq_path = self.to_otq(**kwargs)
+        return render_otq(
+            otq_path, image_path, output_format, load_external_otqs, view, line_limit, parse_eval_from_params, debug,
+        )
+
     def copy(self, ep=None, columns=None, deep=False) -> 'Source':
         """
         Build an object with copied calculation graph.

onetick/py/db/_inspection.py

@@ -1,5 +1,5 @@
 import warnings
-from typing import Dict, List, Union, Iterable, Tuple, Optional, Any, Literal
+from typing import Union, Iterable, Tuple, Optional, Any, Literal
 from datetime import date as dt_date, datetime, timedelta
 
 import pandas as pd
@@ -502,7 +502,7 @@ class DB:
             return last_date
         return date
 
-    def tick_types(self, date=None, timezone=None) -> List[str]:
+    def tick_types(self, date=None, timezone=None) -> list[str]:
         """
         Returns list of tick types for the ``date``.
 
@@ -527,7 +527,7 @@ class DB:
         date = self.last_date if date is None else date
         if timezone is None:
             timezone = configuration.config.tz
-        time_params: Dict[str, Any] = {}
+        time_params: dict[str, Any] = {}
 
         if date is not None:
             time_params['start'], time_params['end'] = self._fit_date_in_acl(date, timezone=timezone)
@@ -551,7 +551,7 @@ class DB:
         min_date = min(obj[0] for obj in self._locator_date_ranges)
         return _datetime2date(min_date)
 
-    def schema(self, date=None, tick_type=None, timezone=None, check_index_file=utils.adaptive) -> Dict[str, type]:
+    def schema(self, date=None, tick_type=None, timezone=None, check_index_file=utils.adaptive) -> dict[str, type]:
         """
         Gets the schema of the database.
 
@@ -696,7 +696,7 @@ class DB:
 
         return schema
 
-    def symbols(self, date=None, timezone=None, tick_type=None, pattern='.*') -> List[str]:
+    def symbols(self, date=None, timezone=None, tick_type=None, pattern='.*') -> list[str]:
         """
         Finds a list of available symbols in the database
 
@@ -907,7 +907,7 @@ class DB:
         return df
 
 
-def databases(context=utils.default, derived=False) -> Dict[str, DB]:
+def databases(context=utils.default, derived=False, readable_only: bool = True) -> dict[str, DB]:
     """
     Gets all available databases in the ``context``
 
@@ -918,13 +918,18 @@ def databases(context=utils.default, derived=False) -> Dict[str, DB]:
         If not set then default :py:attr:`context<onetick.py.configuration.Config.context>` is used.
         See :ref:`guide about switching contexts <switching contexts>` for examples.
     derived: bool, dict
-        If False then derived databases are not returned.
-        If dict then its items used as parameters to :py:func:`~onetick.py.derived_databases`
-        If True then default parameters for :py:func:`~onetick.py.derived_databases` are used.
+        If False (default) then derived databases are not returned.
+        Otherwise derived databases names are added to the result after the non-derived databases.
+        If set to dict then its items used as parameters to :py:func:`~onetick.py.derived_databases`.
+        If set to True then default parameters for :py:func:`~onetick.py.derived_databases` are used.
+    readable_only: bool
+        If set to True (default), then return only the databases with read-access for the current user.
+        Otherwise return all databases visible from the current process.
 
     See also
     --------
     | **SHOW_DB_LIST** OneTick event processor
+    | **ACCESS_INFO** OneTick event processor
     | :py:func:`derived_databases`
 
     Returns
@@ -933,7 +938,18 @@ def databases(context=utils.default, derived=False) -> Dict[str, DB]:
         Dict where keys are database names and values are :class:`DB <onetick.py.db._inspection.DB>` objects
         with ``context`` specified.
     """
-    dbs = otp.run(otq.ShowDbList().tick_type("ANY"),
+    if readable_only:
+        node = (
+            otq.AccessInfo(info_type='DATABASES', show_for_all_users=False, deep_scan=True).tick_type('ANY')
+            >> otq.Passthrough('DB_NAME,READ_ACCESS')
+            >> otq.WhereClause(where='READ_ACCESS = 1')
+        )
+    else:
+        node = (
+            otq.ShowDbList().tick_type('ANY')
+            >> otq.Passthrough('DATABASE_NAME')
+        )
+    dbs = otp.run(node,
                   symbols='LOCAL::',
                   # start and end times don't matter for this query, use some constants
                   start=db_constants.DEFAULT_START_DATE,
@@ -944,7 +960,7 @@ def databases(context=utils.default, derived=False) -> Dict[str, DB]:
     if len(dbs) == 0:
         return {}
 
-    db_list = list(dbs['DATABASE_NAME'])
+    db_list = list(dbs['DB_NAME'] if readable_only else dbs['DATABASE_NAME'])
     db_dict = {db_name: DB(db_name, context=context) for db_name in db_list}
     if derived:
         kwargs = derived if isinstance(derived, dict) else {}
@@ -961,7 +977,7 @@ def derived_databases(
     selection_criteria='all',
     db=None,
     db_discovery_scope='query_host_only',
-) -> Dict[str, DB]:
+) -> dict[str, DB]:
     """
     Gets available derived databases.
 

onetick/py/misc.py

@@ -404,19 +404,20 @@ def get_symbology_mapping(dest_symbology, src_symbology=None, symbol=None, times
             Time  A SYMBOLOGY_MAPPING
     0 2022-01-03  1              9706
 
-    Override source symbology, symbol and symbol date:
+    Override source symbology, symbol and symbol date
+    (Also note that parameters can be set from columns):
 
-    >>> data = otp.Tick(A=1, db=None)
-    >>> data['SYMBOLOGY_MAPPING'] = otp.get_symbology_mapping('OID', 'TDEQ', 'MSFT', otp.dt(2022, 1, 3))
+    >>> data = otp.Tick(A=1, db=None, SYMBOL='MSFT')
+    >>> data['SYMBOLOGY_MAPPING'] = otp.get_symbology_mapping('OID', 'TDEQ', data['SYMBOL'], otp.dt(2022, 1, 3))
     >>> otp.run(data, symbols='US_COMP::AAPL',  # doctest: +SKIP
     ...         date=otp.dt(2022, 1, 3))
             Time  A SYMBOLOGY_MAPPING
     0 2022-01-03  1            109037
     """
     params_correct = (
-        all([src_symbology, symbol, timestamp])
-        or all([src_symbology, symbol])
-        or not any([src_symbology, symbol, timestamp])
+        all(v is not None for v in [src_symbology, symbol, timestamp])
+        or all(v is not None for v in [src_symbology, symbol])
+        or not any(v is not None for v in [src_symbology, symbol, timestamp])
     )
     if not params_correct:
         raise ValueError("Parameters 'src_symbology' and 'symbol' or"

onetick/py/session.py

@@ -1115,8 +1115,6 @@ class Session:
             # TODO: rollback, but need to wait BDS-91
             raise
 
-        Session._instance = self
-
         # force reload cfg/locator/acl, because it is not reloaded after each time session if re-created
         if os.getenv('OTP_WEBAPI_TEST_MODE'):
             utils.reload_config(None, config_type='MAIN_CONFIG')
@@ -1125,6 +1123,11 @@ class Session:
 
         self._ts_dbs = {}
 
+        # PY-1352: this line must be the last
+        # in case we get exception anywhere before, we shouldn't set Session class variable,
+        # because it will affect the creation of all the future Session objects
+        Session._instance = self
+
     def use(self, *items):
         """
         Makes DB or TS available inside the session.

onetick/py/utils/render.py

@@ -20,6 +20,7 @@ EPS_WITH_QUERIES = {
     "modify_state_var_from_query": (1, "otq_query"),
     "create_cache": (1, "otq_file_path"),
     "read_cache": (4, "create_cache_query"),
+    "generic_aggregation": (0, "query_name"),
 }
 
 IF_ELSE_EPS = {
@@ -341,7 +342,10 @@ def _parse_function_params(func_params: str) -> Tuple[list, dict]:
 
 
 def _parse_function(expression: str) -> Tuple[Optional[str], list, dict]:
-    m = re.search(r"^(\w*)\s*\(([\s\S]*)\)\s*$", expression)
+    # EP_NAME(PARAM_NAME=PARAM_VALUE,...)
+    # [a-zA-Z_:] is EP_NAME, can contain letters, underscore and colon
+    # [\s\S] is any symbol including newline (because . doesn't include newline by default)
+    m = re.search(r"^([a-zA-Z_:]*)\s*\(([\s\S]*)\)\s*$", expression)
 
     if not m:
         return None, [], {}
@@ -500,20 +504,24 @@ def _build_query_tree(query: Query):
             node.labels["OUT"] = node.config["NESTED_OUTPUT"]
 
         if "SOURCE_DESCRIPTION" in node.config:
-            description = node.config["SOURCE_DESCRIPTION"].strip().split(" ")
-            if len(description) > 1:
-                desc_node = description[0].split(".")[0]
-                labels = description[1].split(".")
-
-                if labels and desc_node in query.nodes:
-                    if labels[0]:
-                        query.nodes[desc_node].labels["IN"] = labels[0]
-
-                    if labels[1]:
-                        query.nodes[desc_node].labels["OUT"] = labels[1]
+            descriptions = node.config["SOURCE_DESCRIPTION"]
+            if isinstance(descriptions, str):
+                descriptions = [descriptions]
+            for description in descriptions:
+                description = description.strip().split(" ")
+                if len(description) > 1:
+                    desc_node = description[0].split(".")[0]
+                    labels = description[1].split(".")
+
+                    if labels and desc_node in query.nodes:
+                        if labels[0]:
+                            query.nodes[desc_node].labels["IN"] = labels[0]
+
+                        if labels[1]:
+                            query.nodes[desc_node].labels["OUT"] = labels[1]
 
         if "SINK_DESCRIPTION" in node.config:
-            description_path = node.config["SOURCE_DESCRIPTION"].strip().split(".")
+            description_path = node.config["SINK_DESCRIPTION"].strip().split(".")
             if len(description_path) > 1:
                 desc_node = description_path[0]
                 label = description_path[-1]
@@ -526,7 +534,7 @@ def _build_query_tree(query: Query):
         if "SINK" in node.config:
             sink_nodes = [(sink, True) for sink in node.config["SINK"].strip().split()]
             if sink_nodes:
-                leaves.remove(node_id)
+                leaves.discard(node_id)
 
             nodes += sink_nodes
             del node.config["SINK"]
@@ -534,7 +542,7 @@ def _build_query_tree(query: Query):
         if "SOURCE" in node.config:
             source_nodes = [(sink, False) for sink in node.config["SOURCE"].strip().split()]
             if source_nodes:
-                roots.remove(node_id)
+                roots.discard(node_id)
 
             nodes += source_nodes
             del node.config["SOURCE"]
@@ -545,10 +553,10 @@ def _build_query_tree(query: Query):
             source_node_id = source_node_path[0]
 
             if not is_sink_node and source_node_id in leaves:
-                leaves.remove(source_node_id)
+                leaves.discard(source_node_id)
 
             if is_sink_node and source_node_id in roots:
-                roots.remove(source_node_id)
+                roots.discard(source_node_id)
 
             if source_node_id not in query.nodes:
                 raise RuntimeError(f"Malformed otq file passed: node {source_node_id} not found in {query.name}")
@@ -689,21 +697,25 @@ def read_otq(path: str, parse_eval_from_params: bool = False) -> Optional[Graph]
     return graph
 
 
-def filter_nodes(ep: Any, param, value, line_limit: Optional[Tuple[int, int]] = None):
-    if line_limit is not None and (line_limit[0] < 0 or line_limit[1] < 0):
+def truncate_param_value(ep: Any, param, value, line_limit: Optional[Tuple[int, int]] = None):
+    if line_limit is None:
+        return value
+
+    height, width = line_limit
+    if height < 0 or width < 0:
         raise ValueError("line_limit values should not be negative")
 
-    if isinstance(ep, EP) and line_limit is not None and (
+    if isinstance(ep, EP) and (
         ep.name == "PER_TICK_SCRIPT" and param.lower() == "script" or
         ep.name == "CSV_FILE_LISTING" and param.lower() == "file_contents"
     ):
         lines = [
-            line if len(line) <= line_limit[1] or not line_limit[1] else line[:line_limit[1]] + "..."
+            line if len(line) <= width or not width else line[:width] + "..."
             for line in value.split("\n")
         ]
 
-        if line_limit[0] and len(lines) > line_limit[0]:
-            lines = lines[:line_limit[0]] + ["..."]
+        if height and len(lines) > height:
+            lines = lines[:height] + ["..."]
 
         return "\n".join(lines)
 
@@ -790,11 +802,13 @@ def build_node(graphs: GraphStorage, node: Node, line_limit: Optional[Tuple[int,
                 attrs["sides"] = "LR"
 
             if isinstance(v, NestedQuery):
-                param_value = html.escape(v.raw_string)
+                param_value = v.raw_string
             else:
-                param_value = html.escape(v).replace("\t", "&nbsp;" * 4)
+                param_value = v
 
-            param_lines = filter_nodes(node.ep, k, param_value, line_limit).split("\n")
+            param_value = truncate_param_value(node.ep, k, param_value, line_limit)
+            param_value = html.escape(param_value).replace("\t", "&nbsp;" * 4)
+            param_lines = param_value.split("\n")
 
             if k:
                 if len(param_lines) == 1:
@@ -1018,10 +1032,10 @@ def render_otq(
         `Graphviz` rendering format. Default: `png`.
         If `image_path` contains one of next extensions, `output_format` will be set automatically: `png`, `svg`, `dot`.
     load_external_otqs: bool
-        If set to `True` (default) dependencies from external .otq files (not listed in `path` param)
+        If set to `True` (default) dependencies from external .otq files (not listed in ``path`` param)
         will be loaded automatically.
     view: bool
-        Defines should generated image be showed after render.
+        Defines should generated image be shown after render.
     line_limit: Tuple[int, int], None
         Limit for maximum number of lines and length of some EP parameters strings.
         First param is limit of lines, second - limit of characters in each line.
@@ -1030,7 +1044,11 @@ def render_otq(
     parse_eval_from_params: bool
         Enable parsing and printing `eval` sub-queries from EP parameters.
     debug: bool
-        Allow to print stdout or stderr from `Grapthviz` render.
+        Allow to print stdout or stderr from `Graphviz` render.
+
+    Returns
+    -------
+    Path to rendered image
 
     Examples
     --------
@@ -1039,10 +1057,14 @@ def render_otq(
 
     >>> otp.utils.render_otq("./test.otq")  # doctest: +SKIP
 
+    .. image:: ../../static/testing/images/render_otq_1.png
+
     Render multiple files:
 
     >>> otp.utils.render_otq(["./first.otq", "./second.otq"])  # doctest: +SKIP
 
+    .. image:: ../../static/testing/images/render_otq_2.png
+
     Render specific queries from multiple files:
 
     >>> otp.utils.render_otq(["./first.otq", "./second.otq::some_query"])  # doctest: +SKIP

{onetick_py-1.164.0.dist-info → onetick_py-1.166.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: onetick-py
-Version: 1.164.0
+Version: 1.166.0
 Summary: Python package that allows you to work with OneTick
 Author-email: solutions <solutions@onetick.com>
 License-Expression: MIT
@@ -8,14 +8,14 @@ Project-URL: Documentation, https://docs.pip.distribution.sol.onetick.com
 Project-URL: OneTick, https://onetick.com/
 Classifier: Topic :: Database :: Front-Ends
 Classifier: Topic :: Scientific/Engineering
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Operating System :: OS Independent
 Classifier: Environment :: Console
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pandas==1.1.5; python_version == "3.6"

{onetick_py-1.164.0.dist-info → onetick_py-1.166.0.dist-info}/RECORD

@@ -13,33 +13,33 @@ onetick/lib/__init__.py,sha256=Rp7CIDoA4E6LIm1f2mNvl_5b_n-0U3suA3FmBXbmKoU,114
 onetick/lib/instance.py,sha256=Fn3yoowjBtImAhR6n-f-Ti5J1q-RdDI-EGLpZvNwTi4,4773
 onetick/py/__init__.py,sha256=j2WBnhu01i8VdOYkn9BGc-7JeAqXQoCFjVfXFZCSz-4,10950
 onetick/py/_stack_info.py,sha256=PHZOkW_fK7Fbl4YEj5CaYK9L6vh4j-bUU7_cSYOWZ30,2546
-onetick/py/_version.py,sha256=zjgr4M5gwRkWf0RQLyS0a1qtBpaS54yljxj-HWo9Z8M,76
+onetick/py/_version.py,sha256=T7ZvgZ7oLmgBxuEhhoUnyBO9HmAIkrC8X-53r0gdo00,76
 onetick/py/backports.py,sha256=mR00mxe7E7UgBljf-Wa93Mo6lpi-C4Op561uhPUoEt8,815
 onetick/py/cache.py,sha256=f9WwFFCTqCP3eaA4V57tNPjCBHNPzU8ZvH81IuUsBE8,12756
-onetick/py/compatibility.py,sha256=KUBRyt_VayU7UnssXe2q_jOQoqCA4-HwIvUSDl9Xn1M,29696
+onetick/py/compatibility.py,sha256=99UHDi58IZSLl9XcWjJTZerAsHGp_zV6zqfwRl2yDTY,30068
 onetick/py/configuration.py,sha256=Cb_tH3F2vKMF27mFtd5TwXxhUA5Axmxp2TR3OKFfmQ0,27497
 onetick/py/functions.py,sha256=LyLQ7NTNFzKfkR3A5RazS3tOtVqORe1BPrg6B4AAuLM,97689
 onetick/py/license.py,sha256=50dsFrE-NKsPOdkAoyxHr44bH8DzFCr_6TabX0JH6tQ,6140
 onetick/py/log.py,sha256=Els2drZcVjJrD6kvbwgFGEpg6jAacoUEtyN6rCaauuk,2723
 onetick/py/math.py,sha256=Jx-wFggEydBnwgFRsPvFC6bcTCr3bK6WS7_lQ3_a0OU,21061
-onetick/py/misc.py,sha256=9t4lHe7fFNVxIFEheOmL7i31WLNgo6Yk-Rbvr__wImo,12663
+onetick/py/misc.py,sha256=rTM-_Xo_gIr3b9celmWSGa37OACbwvnLhANzWfTF5Ok,12811
 onetick/py/otq.py,sha256=AM24XPw5OdI7SwRgzEPBgOyodF523Zo9SBE7f0XY6HA,7747
 onetick/py/pyomd_mock.py,sha256=A7IIUraN9yCsPhvnHXQUZrmwFjlh7vofSnYm4G7bdsc,2006
 onetick/py/run.py,sha256=xPmArKwvMw5sEbCjmtc7ORFigZrNN3DUDM9f2YYamj4,37554
 onetick/py/servers.py,sha256=h6l0X55kcnpI25bZcYaBpPAAGBZjqk9mt1SQe4xZrh0,6840
-onetick/py/session.py,sha256=kN3gAi4ASjlrF_tBtXpcsZkSfl7rV4vUq75ajgTCmZ0,49372
+onetick/py/session.py,sha256=AqoS7BFN_Sz3JU2CAaZm0Bro8CmUy6VjmoDjwOU1wYM,49591
 onetick/py/sql.py,sha256=kJ0732bZ0OGF8x3VzcOUs38zEGsxcd1nZOSN75VKXhA,2993
 onetick/py/state.py,sha256=1fL0zgqm-mKi-1KkUc3OvqV6IstDxHEDxlHBIQI-4UM,10134
 onetick/py/types.py,sha256=OfBTkKNQ7KrNceRXNPUJ36HyA-4sMUf_9T0TSYy-5Fc,64662
 onetick/py/aggregations/__init__.py,sha256=02WnTc9ocTp34OkGyXRHY2QAZi_QjDMHClE5tvx6Gtk,736
 onetick/py/aggregations/_base.py,sha256=YQWlFYlq_QvGwTIaNGuyoU8rQsYfx-Yd-lNNq4R_o6o,25702
-onetick/py/aggregations/_docs.py,sha256=4SlFjyjLxEZmJVQb9DBmme7sjM1gkLsIJ0cfNwHICio,34494
+onetick/py/aggregations/_docs.py,sha256=7pz6XIhRuP_1vuOYO9UfTlzl6zGD2_jwbPMfJPOX-M8,34798
 onetick/py/aggregations/compute.py,sha256=GJpR8AWlEmfNsnl-L2oJPuY5rFb6PC-VwLZnnRGtCys,11854
 onetick/py/aggregations/functions.py,sha256=crwjUb4H7-h66aSY50RwSCcR_OE4vF9mF0gVLaXiXiQ,80798
 onetick/py/aggregations/generic.py,sha256=7mWRRAPS-t-e_umQc2T3GPPuW1Pia7mKhgjaVB2sSBM,3896
 onetick/py/aggregations/high_low.py,sha256=B7_Y6KhJjIqJthK0msW0JRkTpxINpnKPuSQjQa2QyZs,2508
 onetick/py/aggregations/num_distinct.py,sha256=s-VrU92kBKnJ6LIAGq2-j-t8amnolIF2EHkEt78A7_s,2830
-onetick/py/aggregations/order_book.py,sha256=6uz4OHHN3_th1o8Yw2jT-72BUrkeGDSjVFtEpBE9rEY,16900
+onetick/py/aggregations/order_book.py,sha256=-QVtxh_VlzC0-jvZ5Lb6enQBW35Zc0O5uVLid129wc0,18657
 onetick/py/aggregations/other.py,sha256=wCXrb3BCUJy5e39i35V2tslp0bVR2-8Fa8E1lf45hO4,39410
 onetick/py/callback/__init__.py,sha256=lF6u1jDy0dv-2qBvonqmSaQAU7dWQAuq5FWyR5LzvLI,108
 onetick/py/callback/callback.py,sha256=i8yVsbceqhVxNTcXU2ie0-nBRyC0nS2LVDFFtqfCMlw,8618
@@ -54,7 +54,7 @@ onetick/py/core/lambda_object.py,sha256=ayob_2c2XYSG7vFsqp-2b9FSPD-3TFReLbx3de3t
 onetick/py/core/multi_output_source.py,sha256=i9mxtM3yIF30hsVZ-6XttU407VmHklCdPjNDabgB374,7769
 onetick/py/core/per_tick_script.py,sha256=thuNKR4T6v5vxADLaX4ldTAHo_Yvt5HCHGIrNMEK6z8,83237
 onetick/py/core/query_inspector.py,sha256=Jwnw7qUVvjvaT63mQ5PkUSy8x36knoxWrNll3aXuLZw,16440
-onetick/py/core/source.py,sha256=1Yce_XKyhYAJ-jvVJPhJez2wynw7GXiWp7eFy1Kp6O4,61141
+onetick/py/core/source.py,sha256=AX4DUK1frV_FUCG5sywsn42xYX7Y2sYC7vMCOq6TeRg,63998
 onetick/py/core/_internal/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 onetick/py/core/_internal/_manually_bound_value.py,sha256=a4JF63g9MtXsIwpDqm_PCLBH51_SaG1-T6jWV5-IJ1k,191
 onetick/py/core/_internal/_nodes_history.py,sha256=fCpJ4FWFDzM-bmi-YyCHmNYuFM-CL_lE2bXySOi-TPY,7194
@@ -103,7 +103,7 @@ onetick/py/core/column_operations/accessors/dt_accessor.py,sha256=RvgIuCXs3nMXTN
 onetick/py/core/column_operations/accessors/float_accessor.py,sha256=6di5Pw0nLwKEqnzQImzQ9ORv45xGm-uevFGCg-FZz4w,5541
 onetick/py/core/column_operations/accessors/str_accessor.py,sha256=EBncqEOx421PQvRPd3pTQInWBKN2ttpy1ltXIJI-V-U,55510
 onetick/py/db/__init__.py,sha256=-TKRO0suXTR-mLAppYt-Vegu9HQn7LU_JcObXpS3N9M,61
-onetick/py/db/_inspection.py,sha256=1-aqESopM9cultH4ka9us0imYlQti3ZN6TuLow4UM34,43797
+onetick/py/db/_inspection.py,sha256=6GAqs27xFyPyjTKodOSywcbz6tfFms6raXUAcPSKpW4,44591
 onetick/py/db/db.py,sha256=nlkwQ0cDo2T7am4stNbbP_5NVDWD-nOIcoWYFVzr-_w,55920
 onetick/py/db/utils.py,sha256=gt-KmbGgcp1tH81LH-cLO08n2Hx8GaBPbvfEN22mgLg,2309
 onetick/py/docs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -139,14 +139,14 @@ onetick/py/utils/helpers.py,sha256=XY2PaMUSzFNIpiuiAY_gPQ0TnYTmfoPAGNAFh_6aB14,2
 onetick/py/utils/locator.py,sha256=YUOXU0yh0ZZZOJpJniAq9WNn0_u3X_M5q2tEwt1cp_4,2887
 onetick/py/utils/perf.py,sha256=g0r-9YUc2mx9Lj4PjG6Fk1keO3m9nC3t2cpHx3M-AeQ,19299
 onetick/py/utils/query.py,sha256=b60JmfJDx3mpP74rTQC3qnlCb6t4fYFEauVaH9ulwL8,1330
-onetick/py/utils/render.py,sha256=bWHJc1IYpTXhjTv62zaFLKNFAS9SXNSQNbrqrQoQjbE,37599
+onetick/py/utils/render.py,sha256=9SBKfKsHCrdF-FOZFGon7TalzXydCdPHINouRUwHMKM,38289
 onetick/py/utils/script.py,sha256=Y8NujEo2_5QaP6KDnLKJiKQ7SmMjw8_dv8sYL9rHDCE,11184
 onetick/py/utils/temp.py,sha256=j-BC155dE46k0zfKTTs26KTF0CK6WA1hO2GD54iunyM,17380
 onetick/py/utils/types.py,sha256=_tYf66r9JVgjtiCJfxIxrg_BQEjHkjlnck_i86dBYEY,3606
 onetick/py/utils/tz.py,sha256=QXclESLGU8YXysUT9DXkcBqLWWO47Bb_tanFUzYpPZI,2800
-onetick_py-1.164.0.dist-info/licenses/LICENSE,sha256=Yhu7lKNFS0fsaN-jSattEMRtCOPueP58Eu5BPH8ZGjM,1075
-onetick_py-1.164.0.dist-info/METADATA,sha256=PA8baIlYbmXmIb8fAj7tRv-7sZEfBtF4jkff0bWC_ZI,7959
-onetick_py-1.164.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-onetick_py-1.164.0.dist-info/entry_points.txt,sha256=QmK_tFswIN-SQRmtnTSBEi8GvT0TVq-66IzXXZIsV3U,81
-onetick_py-1.164.0.dist-info/top_level.txt,sha256=Na1jSJmVMyYGOndaswt554QKIUwQjcYh6th2ATsmw0U,23
-onetick_py-1.164.0.dist-info/RECORD,,
+onetick_py-1.166.0.dist-info/licenses/LICENSE,sha256=Yhu7lKNFS0fsaN-jSattEMRtCOPueP58Eu5BPH8ZGjM,1075
+onetick_py-1.166.0.dist-info/METADATA,sha256=9XNNTuV5nIuI__DkAo55-tf9ffox-brTrXioDP7_DIA,7960
+onetick_py-1.166.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+onetick_py-1.166.0.dist-info/entry_points.txt,sha256=QmK_tFswIN-SQRmtnTSBEi8GvT0TVq-66IzXXZIsV3U,81
+onetick_py-1.166.0.dist-info/top_level.txt,sha256=Na1jSJmVMyYGOndaswt554QKIUwQjcYh6th2ATsmw0U,23
+onetick_py-1.166.0.dist-info/RECORD,,