opencode-pyneruntime 6.6.4__py3-none-any.whl

pynecore/lib/table.py

@@ -0,0 +1,290 @@
+from ..core.module_property import module_property
+from ..types.base import next_vid
+from ..types.table import Table
+from ..types.na import NA
+from ..lib import (color as _color, position as _position, size as _size, text as _text, font as _font)
+
+_registry: list[Table] = []
+
+
+def new(position: _position.Position, columns: int, rows: int, bgcolor: _color.Color = None,
+        frame_color: _color.Color = None, frame_width: int = 0, border_color: _color.Color = None,
+        border_width: int = 0, force_overlay: bool = False) -> Table:
+    """
+    Creates a new table object.
+
+    :param position: Position of the table. Possible values are: position.top_left, position.top_center,
+                     position.top_right, position.middle_left, position.middle_center, position.middle_right,
+                     position.bottom_left, position.bottom_center, position.bottom_right
+    :param columns: The number of columns in the table
+    :param rows: The number of rows in the table
+    :param bgcolor: The background color of the table. Optional. The default is no color
+    :param frame_color: The color of the outer frame of the table. Optional. The default is no color
+    :param frame_width: The width of the outer frame of the table. Optional. The default is 0
+    :param border_color: The color of the borders of the cells (excluding the outer frame). Optional.
+                         The default is no color
+    :param border_width: The width of the borders of the cells (excluding the outer frame). Optional. The default is 0
+    :param force_overlay: If true, the drawing will display on the main chart pane, even when the
+                          script occupies a separate pane. Optional. The default is false
+    :return: A table object
+    """
+    table = Table(
+        position=position,
+        columns=columns,
+        rows=rows,
+        bgcolor=bgcolor,
+        frame_color=frame_color,
+        frame_width=frame_width,
+        border_color=border_color,
+        border_width=border_width,
+        force_overlay=force_overlay
+    )
+    table.vid = next_vid()
+    _registry.append(table)
+    return table
+
+
+# noinspection PyShadowingBuiltins
+@module_property
+def all() -> list[Table]:
+    """
+    Returns an array filled with all the current tables drawn by the script.
+
+    :return: Array of all table objects
+    """
+    return _registry
+
+
+# noinspection PyShadowingBuiltins
+def delete(table_id: Table) -> None:
+    """
+    Deletes a table object.
+
+    :param table_id: A table object
+    """
+    if isinstance(table_id, NA):
+        return
+    try:
+        _registry.remove(table_id)
+    except ValueError:
+        pass
+
+
+def cell(table_id: Table, column: int, row: int, text: str = "", width: int | float = 0,
+         height: int | float = 0, text_color: _color.Color = _color.black,
+         text_halign: _text.AlignEnum = _text.align_center, text_valign: _text.AlignEnum = _text.align_center,
+         text_size: int | str = _size.normal, bgcolor: _color.Color = None, tooltip: str = "",
+         text_font_family: _font.FontFamilyEnum = _font.family_default,
+         text_formatting: _text.FormatEnum = _text.format_none) -> None:
+    """
+    Defines a cell in the table and sets its attributes.
+
+    :param table_id: A table object
+    :param column: The index of the cell's column. Numbering starts at 0
+    :param row: The index of the cell's row. Numbering starts at 0
+    :param text: The text to be displayed inside the cell. Optional. The default is empty string
+    :param width: The width of the cell as a % of the indicator's visual space. Optional. By default,
+                  auto-adjusts the width based on the text inside the cell. Value 0 has the same effect
+    :param height: The height of the cell as a % of the indicator's visual space. Optional. By default,
+                   auto-adjusts the height based on the text inside of the cell. Value 0 has the same effect
+    :param text_color: The color of the text. Optional. The default is color.black
+    :param text_halign: The horizontal alignment of the cell's text. Optional. The default value is text.align_center
+    :param text_valign: The vertical alignment of the cell's text. Optional. The default value is text.align_center
+    :param text_size: Size of the object. The size can be any positive integer, or one of the size.*
+                      built-in constant strings. The default value is size.normal or 14
+    :param bgcolor: The background color of the text. Optional. The default is no color
+    :param tooltip: The tooltip to be displayed inside the cell. Optional
+    :param text_font_family: The font family of the text. Optional. The default value is font.family_default
+    :param text_formatting: The formatting of the displayed text. Optional. The default is text.format_none
+    """
+    if isinstance(table_id, NA):
+        return
+
+    # Create or get the cell
+    cell_obj = table_id.get_cell(column, row)
+
+    # Set all the cell properties
+    cell_obj.text = text
+    cell_obj.width = width
+    cell_obj.height = height
+    cell_obj.text_color = text_color
+    cell_obj.text_halign = text_halign
+    cell_obj.text_valign = text_valign
+    cell_obj.text_size = text_size
+    cell_obj.bgcolor = bgcolor
+    cell_obj.tooltip = tooltip
+    cell_obj.text_font_family = text_font_family
+    cell_obj.text_formatting = text_formatting
+
+
+def clear(table_id: Table, start_column: int, start_row: int, end_column: int = None,
+          end_row: int = None) -> None:
+    """
+    Removes a cell or a sequence of cells from the table.
+
+    :param table_id: A table object
+    :param start_column: The index of the column of the first cell to delete. Numbering starts at 0
+    :param start_row: The index of the row of the first cell to delete. Numbering starts at 0
+    :param end_column: The index of the column of the last cell to delete. Optional. The default is
+                       the argument used for start_column
+    :param end_row: The index of the row of the last cell to delete. Optional. The default is the
+                    argument used for start_row
+    """
+    if isinstance(table_id, NA):
+        return
+    if end_column is None:
+        end_column = start_column
+    if end_row is None:
+        end_row = start_row
+
+    # Clear the specified range of cells
+    table_id.clear_cells(start_column, start_row, end_column, end_row)
+
+
+def merge_cells(table_id: Table, start_column: int, start_row: int, end_column: int, end_row: int) -> None:
+    """
+    Merges a sequence of cells in the table into one cell.
+
+    :param table_id: A table object
+    :param start_column: The index of the column of the first cell to merge. Numbering starts at 0
+    :param start_row: The index of the row of the first cell to merge. Numbering starts at 0
+    :param end_column: The index of the column of the last cell to merge. Numbering starts at 0
+    :param end_row: The index of the row of the last cell to merge. Numbering starts at 0
+    """
+    if isinstance(table_id, NA):
+        return
+
+    # Merge the specified range of cells
+    table_id.merge_cells(start_column, start_row, end_column, end_row)
+
+
+# Cell setter functions
+def cell_set_bgcolor(table_id: Table, column: int, row: int, bgcolor: _color.Color) -> None:
+    """Sets the background color of the cell."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.bgcolor = bgcolor
+
+
+def cell_set_height(table_id: Table, column: int, row: int, height: int | float) -> None:
+    """Sets the height of cell."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.height = height
+
+
+def cell_set_text(table_id: Table, column: int, row: int, text: str) -> None:
+    """Sets the text in the specified cell."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.text = text
+
+
+def cell_set_text_color(table_id: Table, column: int, row: int, text_color: _color.Color) -> None:
+    """Sets the color of the text inside the cell."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.text_color = text_color
+
+
+def cell_set_text_font_family(table_id: Table, column: int, row: int, text_font_family: _font.FontFamilyEnum) -> None:
+    """Sets the font family of the text inside the cell."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.text_font_family = text_font_family
+
+
+def cell_set_text_formatting(table_id: Table, column: int, row: int, text_formatting: _text.FormatEnum) -> None:
+    """Sets the formatting attributes the drawing applies to displayed text."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.text_formatting = text_formatting
+
+
+def cell_set_text_halign(table_id: Table, column: int, row: int, text_halign: _text.AlignEnum) -> None:
+    """Sets the horizontal alignment of the cell's text."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.text_halign = text_halign
+
+
+def cell_set_text_size(table_id: Table, column: int, row: int, text_size: int | str) -> None:
+    """Sets the size of the cell's text."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.text_size = text_size
+
+
+def cell_set_text_valign(table_id: Table, column: int, row: int, text_valign: _text.AlignEnum) -> None:
+    """Sets the vertical alignment of a cell's text."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.text_valign = text_valign
+
+
+def cell_set_tooltip(table_id: Table, column: int, row: int, tooltip: str) -> None:
+    """Sets the tooltip in the specified cell."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.tooltip = tooltip
+
+
+def cell_set_width(table_id: Table, column: int, row: int, width: int | float) -> None:
+    """Sets the width of the cell."""
+    if isinstance(table_id, NA):
+        return
+    cell_obj = table_id.get_cell(column, row)
+    cell_obj.width = width
+
+
+# Table setter functions
+def set_bgcolor(table_id: Table, bgcolor: _color.Color) -> None:
+    """Sets the background color of a table."""
+    if isinstance(table_id, NA):
+        return
+    table_id.bgcolor = bgcolor
+
+
+def set_border_color(table_id: Table, border_color: _color.Color) -> None:
+    """Sets the color of the borders (excluding the outer frame) of the table's cells."""
+    if isinstance(table_id, NA):
+        return
+    table_id.border_color = border_color
+
+
+def set_border_width(table_id: Table, border_width: int) -> None:
+    """Sets the width of the borders (excluding the outer frame) of the table's cells."""
+    if isinstance(table_id, NA):
+        return
+    table_id.border_width = border_width
+
+
+def set_frame_color(table_id: Table, frame_color: _color.Color) -> None:
+    """Sets the color of the outer frame of a table."""
+    if isinstance(table_id, NA):
+        return
+    table_id.frame_color = frame_color
+
+
+def set_frame_width(table_id: Table, frame_width: int) -> None:
+    """Sets the width of the outer frame of a table."""
+    if isinstance(table_id, NA):
+        return
+    table_id.frame_width = frame_width
+
+
+def set_position(table_id: Table, position: _position.Position) -> None:
+    """Sets the position of a table."""
+    if isinstance(table_id, NA):
+        return
+    table_id.position = position

pynecore/lib/text.py

@@ -0,0 +1,17 @@
+from ..types.text import AlignEnum, FormatEnum, WrapEnum
+
+# Text alignment constants
+align_left = AlignEnum('left')
+align_center = AlignEnum('center')
+align_right = AlignEnum('right')
+align_top = AlignEnum('top')
+align_bottom = AlignEnum('bottom')
+
+# Text format constants
+format_bold = FormatEnum('bold')
+format_italic = FormatEnum('italic')
+format_none = FormatEnum('none')
+
+# Text wrap constants
+wrap_auto = WrapEnum('auto')
+wrap_none = WrapEnum('none')

pynecore/lib/ticker.py

@@ -0,0 +1,207 @@
+"""
+Pine Script ``ticker.*`` namespace - ticker identifier construction.
+"""
+from . import syminfo
+
+__all__ = [
+    'heikinashi',
+    'inherit',
+    'kagi',
+    'linebreak',
+    'modify',
+    'new',
+    'pointfigure',
+    'renko',
+    'standard',
+]
+
+# Internal separator embedded in a ticker identifier by the chart-type helpers
+# (currently only ``heikinashi``). ``\x1f`` (ASCII Unit Separator) can never
+# appear in a real ticker identifier, so a marked ticker never collides with a
+# genuine symbol and never compares equal to the chart symbol — which keeps a
+# Heikin Ashi request out of the same-context inline fast path and routes it to
+# a subprocess that applies the chart-type transform per bar.
+# ``_split_chart_type`` strips the marker back to the base symbol wherever the
+# ticker is resolved to data.
+_CHART_TYPE_SEP = '\x1f'
+
+
+def _split_chart_type(tickerid: str) -> 'tuple[str, str | None]':
+    """
+    Split a chart-type-marked ticker identifier into its base symbol and type.
+
+    Internal helper (not a Pine builtin): the security machinery calls it to
+    strip the marker added by :func:`heikinashi` before resolving data.
+
+    :param tickerid: A ticker identifier, optionally carrying a chart-type marker
+                     produced by :func:`heikinashi`
+    :return: ``(base_symbol, chart_type)``; ``chart_type`` is ``None`` for a plain
+             ticker identifier (no marker)
+    """
+    s = str(tickerid)
+    idx = s.find(_CHART_TYPE_SEP)
+    if idx < 0:
+        return s, None
+    return s[:idx], s[idx + len(_CHART_TYPE_SEP):]
+
+
+# noinspection PyUnusedLocal
+def new(prefix: str, ticker: str, session: str | None = None,
+        adjustment: str | None = None, backadjustment: str | None = None,
+        settlement_as_close: str | None = None) -> str:
+    """
+    Create a ticker identifier from an exchange prefix and a ticker name.
+
+    The ``session``, ``adjustment``, ``backadjustment`` and ``settlement_as_close``
+    parameters are accepted for Pine compatibility but do not alter the identifier:
+    PyneCore's data layer does not provide per-request session or adjustment variants
+    of a feed.
+
+    :param prefix: Exchange prefix (e.g. ``"BINANCE"``)
+    :param ticker: Ticker name (e.g. ``"BTCUSDT"``); a full identifier
+                   (``"BINANCE:BTCUSDT"``) is used as-is
+    :param session: Session type, ignored (see above)
+    :param adjustment: Price adjustment type, ignored (see above)
+    :param backadjustment: Continuous contract back-adjustment, ignored (see above)
+    :param settlement_as_close: Settlement-as-close setting, ignored (see above)
+    :return: The ticker identifier (``"PREFIX:TICKER"``)
+    """
+    ticker = str(ticker)
+    if ':' in ticker:
+        return ticker
+    return f"{prefix}:{ticker}"
+
+
+# noinspection PyUnusedLocal
+def modify(tickerid: str, session: str | None = None, adjustment: str | None = None,
+           backadjustment: str | None = None, settlement_as_close: str | None = None) -> str:
+    """
+    Create a copy of a ticker identifier with modified session/adjustment settings.
+
+    The settings are accepted for Pine compatibility but do not alter the identifier:
+    PyneCore's data layer does not provide per-request session or adjustment variants
+    of a feed.
+
+    :param tickerid: The ticker identifier to modify
+    :param session: Session type, ignored (see above)
+    :param adjustment: Price adjustment type, ignored (see above)
+    :param backadjustment: Continuous contract back-adjustment, ignored (see above)
+    :param settlement_as_close: Settlement-as-close setting, ignored (see above)
+    :return: The ticker identifier
+    """
+    return str(tickerid)
+
+
+def standard(symbol: str | None = None) -> str:
+    """
+    Return the ticker identifier of the standard chart type for a symbol.
+
+    PyneCore feeds carry no synthetic chart-type modifiers, so the standard form is
+    the identifier itself.
+
+    :param symbol: The ticker identifier; if None, the chart's symbol is used
+    :return: The standard-chart ticker identifier
+    """
+    if symbol is None:
+        return str(syminfo.tickerid)
+    return str(symbol)
+
+
+def inherit(from_tickerid: str, symbol: str) -> str:
+    """
+    Create a ticker identifier for ``symbol`` inheriting the parameters of
+    ``from_tickerid``.
+
+    PyneCore feeds carry no chart-type or adjustment modifiers to inherit, so only the
+    exchange prefix is taken over when ``symbol`` has none.
+
+    :param from_tickerid: The ticker identifier to inherit parameters from
+    :param symbol: The symbol to build the new identifier for
+    :return: The ticker identifier
+    """
+    symbol = str(symbol)
+    if ':' in symbol:
+        return symbol
+    from_tickerid = str(from_tickerid)
+    if ':' in from_tickerid:
+        return f"{from_tickerid.split(':', 1)[0]}:{symbol}"
+    return symbol
+
+
+def heikinashi(symbol: str) -> str:
+    """
+    Create a ticker identifier for requesting Heikin Ashi bar values.
+
+    The returned identifier carries an internal chart-type marker (see
+    :data:`_CHART_TYPE_SEP`). When passed to ``request.security()``, the security
+    child transforms each bar to Heikin Ashi before the script reads it; every
+    other consumer strips the marker back to the base symbol via
+    :func:`_split_chart_type`.
+
+    Works in both backtest and live mode. ``request.security_lower_tf()`` with a
+    chart type is not supported (it would need per-intrabar transformation).
+
+    :param symbol: The ticker identifier
+    :return: The base ticker identifier with the Heikin Ashi chart-type marker
+    """
+    return f"{symbol}{_CHART_TYPE_SEP}heikinashi"
+
+
+# noinspection PyUnusedLocal
+def renko(symbol: str, style: str | None = None, param: float | None = None,
+          request_wicks: bool = False, source: str | None = None) -> str:
+    """
+    Create a ticker identifier for requesting Renko bar values.
+
+    :param symbol: The ticker identifier
+    :param style: Renko box size style
+    :param param: Value of the selected style
+    :param request_wicks: Whether wick values are reflected
+    :param source: The price source
+    :raises NotImplementedError: PyneCore has no synthetic chart-type data feeds
+    """
+    raise NotImplementedError("ticker.renko() is not supported: "
+                              "PyneCore has no synthetic chart-type data feeds")
+
+
+# noinspection PyUnusedLocal
+def pointfigure(symbol: str, source: str | None = None, style: str | None = None,
+                param: float | None = None, reversal: int | None = None) -> str:
+    """
+    Create a ticker identifier for requesting Point & Figure values.
+
+    :param symbol: The ticker identifier
+    :param source: The price source
+    :param style: Point & Figure box size style
+    :param param: Value of the selected style
+    :param reversal: The reversal amount
+    :raises NotImplementedError: PyneCore has no synthetic chart-type data feeds
+    """
+    raise NotImplementedError("ticker.pointfigure() is not supported: "
+                              "PyneCore has no synthetic chart-type data feeds")
+
+
+# noinspection PyUnusedLocal
+def kagi(symbol: str, reversal: float) -> str:
+    """
+    Create a ticker identifier for requesting Kagi values.
+
+    :param symbol: The ticker identifier
+    :param reversal: The reversal amount
+    :raises NotImplementedError: PyneCore has no synthetic chart-type data feeds
+    """
+    raise NotImplementedError("ticker.kagi() is not supported: "
+                              "PyneCore has no synthetic chart-type data feeds")
+
+
+# noinspection PyUnusedLocal
+def linebreak(symbol: str, number_of_lines: int) -> str:
+    """
+    Create a ticker identifier for requesting Line Break values.
+
+    :param symbol: The ticker identifier
+    :param number_of_lines: The number of lines
+    :raises NotImplementedError: PyneCore has no synthetic chart-type data feeds
+    """
+    raise NotImplementedError("ticker.linebreak() is not supported: "
+                              "PyneCore has no synthetic chart-type data feeds")