New range subpackage

src/xlviews/chart/axes.py

@@ -7,10 +7,11 @@
 from xlwings import Range
 from xlwings.constants import AxisType, ChartType, Placement, TickMark
 
-from xlviews.address import reference
-from xlviews.chart.series import Series
 from xlviews.config import rcParams
-from xlviews.style import (
+from xlviews.range.address import reference
+
+from .series import Series
+from .style import (
     get_axis_label,
     get_axis_scale,
     get_ticks,

src/xlviews/plot.py → src/xlviews/chart/plot.py

@@ -12,7 +12,7 @@
 
     from xlviews.chart.series import Series
     from xlviews.group import GroupBy
-    from xlviews.range import RangeCollection
+    from xlviews.range.range_collection import RangeCollection
 
 
 def get_range(

src/xlviews/chart/series.py

@@ -5,17 +5,18 @@
 from xlwings import Range
 from xlwings.constants import LineStyle
 
-from xlviews.address import reference
-from xlviews.range import RangeCollection
-from xlviews.style import get_line_style, get_marker_style
+from xlviews.range.address import reference
+from xlviews.range.range_collection import RangeCollection
 from xlviews.utils import rgb
 
+from .style import get_line_style, get_marker_style
+
 if TYPE_CHECKING:
     from typing import Any
 
     from xlwings import Sheet
 
-    from xlviews.chart.axes import Axes
+    from .axes import Axes
 
 
 class Series:

src/xlviews/chart/style.py

@@ -0,0 +1,231 @@
+"""Set styles for Range."""
+
+from __future__ import annotations
+
+import itertools
+from typing import TYPE_CHECKING
+
+import seaborn as sns
+from xlwings.constants import LineStyle, MarkerStyle, ScaleType
+
+from xlviews.config import rcParams
+from xlviews.range.address import reference
+from xlviews.range.style import set_font_api
+from xlviews.utils import rgb
+
+if TYPE_CHECKING:
+    from xlwings import Range, Sheet
+
+
+def color_palette(n: int) -> list[tuple[int, int, int]]:
+    """Return a list of colors of length n."""
+    palette = sns.color_palette()
+    palette = palette[:n] if n <= len(palette) else sns.husl_palette(n, l=0.5)
+    return [tuple(int(c * 255) for c in p) for p in palette]  # type: ignore
+
+
+MARKER_DICT: dict[str, int] = {
+    "o": MarkerStyle.xlMarkerStyleCircle,
+    "^": MarkerStyle.xlMarkerStyleTriangle,
+    "s": MarkerStyle.xlMarkerStyleSquare,
+    "d": MarkerStyle.xlMarkerStyleDiamond,
+    "+": MarkerStyle.xlMarkerStylePlus,
+    "x": MarkerStyle.xlMarkerStyleX,
+    ".": MarkerStyle.xlMarkerStyleDot,
+    "-": MarkerStyle.xlMarkerStyleDash,
+    "*": MarkerStyle.xlMarkerStyleStar,
+}
+
+LINE_DICT: dict[str, int] = {
+    "-": LineStyle.xlContinuous,
+    "--": LineStyle.xlDash,
+    "-.": LineStyle.xlDashDot,
+    ".": LineStyle.xlDot,
+}
+
+
+def get_marker_style(marker: int | str | None) -> int:
+    if isinstance(marker, int):
+        return marker
+
+    if marker is None:
+        return MarkerStyle.xlMarkerStyleNone
+
+    return MARKER_DICT[marker]
+
+
+def get_line_style(line: int | str | None) -> int:
+    if isinstance(line, int):
+        return line
+
+    if line is None:
+        return LineStyle.xlLineStyleNone
+
+    return LINE_DICT[line]
+
+
+def marker_palette(n: int) -> list[str]:
+    """Return a list of markers of length n."""
+    return list(itertools.islice(itertools.cycle(MARKER_DICT), n))
+
+
+def palette(name: str, n: int) -> list[str] | list[tuple[int, int, int]] | list[None]:
+    if name == "color":
+        return color_palette(n)
+
+    if name == "marker":
+        return marker_palette(n)
+
+    return [None] * n
+
+
+def get_axis_label(axis) -> str | None:  # noqa: ANN001
+    if not axis.HasTitle:
+        return None
+
+    return axis.AxisTitle.Text
+
+
+def set_axis_label(
+    axis,  # noqa: ANN001
+    label: str | tuple[int, int] | Range | None = None,
+    name: str | None = None,
+    size: float | None = None,
+    sheet: Sheet | None = None,
+    **kwargs,
+) -> None:
+    if not label:
+        axis.HasTitle = False
+        return
+
+    axis.HasTitle = True
+    axis_title = axis.AxisTitle
+    axis_title.Text = reference(label, sheet)
+    size = size or rcParams["chart.axis.title.font.size"]
+
+    set_font_api(axis_title, name, size=size, **kwargs)
+
+
+def get_ticks(axis) -> tuple[float, float, float, float]:  # noqa: ANN001
+    return (
+        axis.MinimumScale,
+        axis.MaximumScale,
+        axis.MajorUnit,
+        axis.MinorUnit,
+    )
+
+
+def set_ticks(
+    axis,  # noqa: ANN001
+    *args,
+    min: float | None = None,  # noqa: A002
+    max: float | None = None,  # noqa: A002
+    major: float | None = None,
+    minor: float | None = None,
+    gridlines: bool = True,
+) -> None:
+    args = [*args, None, None, None, None][:4]
+
+    min = min or args[0]  # noqa: A001
+    max = max or args[1]  # noqa: A001
+    major = major or args[2]
+    minor = minor or args[3]
+
+    if min is not None:
+        axis.MinimumScale = min
+
+    if max is not None:
+        axis.MaximumScale = max
+
+    if major is not None:
+        axis.MajorUnit = major
+
+        if gridlines:
+            axis.HasMajorGridlines = True
+        else:
+            axis.HasMajorGridlines = False
+
+    if minor is not None:
+        axis.MinorUnit = minor
+
+        if gridlines:
+            axis.HasMinorGridlines = True
+        else:
+            axis.HasMinorGridlines = False
+
+    if min:
+        axis.CrossesAt = min
+
+
+def set_tick_labels(
+    axis,  # noqa: ANN001
+    name: str | None = None,
+    size: float | None = None,
+    number_format: str | None = None,
+) -> None:
+    size = size or rcParams["chart.axis.ticklabels.font.size"]
+    set_font_api(axis.TickLabels, name, size=size)
+
+    if number_format:
+        axis.TickLabels.NumberFormatLocal = number_format
+
+
+def get_axis_scale(axis) -> str:  # noqa: ANN001
+    if axis.ScaleType == ScaleType.xlScaleLogarithmic:
+        return "log"
+
+    if axis.ScaleType == ScaleType.xlScaleLinear:
+        return "linear"
+
+    raise NotImplementedError
+
+
+def set_axis_scale(axis, scale: str) -> None:  # noqa: ANN001
+    if scale == "log":
+        axis.ScaleType = ScaleType.xlScaleLogarithmic
+        return
+
+    if scale == "linear":
+        axis.ScaleType = ScaleType.xlScaleLinear
+        return
+
+    raise NotImplementedError
+
+
+def set_dimensions(
+    api,  # noqa: ANN001
+    left: float | None = None,
+    top: float | None = None,
+    width: float | None = None,
+    height: float | None = None,
+) -> None:
+    if left is not None:
+        api.Left = left
+
+    if top is not None:
+        api.Top = top
+
+    if width is not None:
+        api.Width = width
+
+    if height is not None:
+        api.Height = height
+
+
+def set_area_format(
+    api,  # noqa: ANN001
+    border: str | int | tuple[int, int, int] | None = None,
+    fill: str | int | tuple[int, int, int] | None = None,
+    alpha: float | None = None,
+) -> None:
+    if border is not None:
+        api.Format.Line.Visible = True
+        api.Format.Line.ForeColor.RGB = rgb(border)
+
+    if fill is not None:
+        api.Format.Fill.Visible = True
+        api.Format.Fill.ForeColor.RGB = rgb(fill)
+
+    if alpha is not None:
+        api.Format.Line.Transparency = alpha
+        api.Format.Fill.Transparency = alpha

src/xlviews/dataframes/dist.py

@@ -9,7 +9,7 @@
 
 from xlviews.config import rcParams
 from xlviews.decorators import turn_off_screen_updating
-from xlviews.style import set_alignment, set_font
+from xlviews.range.style import set_alignment, set_font
 from xlviews.utils import iter_columns
 
 from .sheet import SheetFrame

src/xlviews/dataframes/sheet.py

@@ -15,13 +15,14 @@
 from xlviews.chart.axes import set_first_position
 from xlviews.decorators import turn_off_screen_updating
 from xlviews.element import Bar, Plot, Scatter
-from xlviews.formula import aggregate
 from xlviews.grid import FacetGrid
 from xlviews.group import GroupBy
-from xlviews.range import RangeCollection
-from xlviews.style import set_alignment, set_frame_style, set_wide_column_style
+from xlviews.range.formula import aggregate
+from xlviews.range.range_collection import RangeCollection
+from xlviews.range.style import set_alignment
 
 from . import modify
+from .style import set_frame_style, set_wide_column_style
 from .table import Table
 
 if TYPE_CHECKING:

src/xlviews/dataframes/stats.py

@@ -9,10 +9,10 @@
 
 from xlviews.config import rcParams
 from xlviews.decorators import turn_off_screen_updating
-from xlviews.formula import AGG_FUNCS, aggregate
 from xlviews.group import GroupBy
-from xlviews.range import RangeCollection
-from xlviews.style import set_font, set_number_format
+from xlviews.range.formula import AGG_FUNCS, aggregate
+from xlviews.range.range_collection import RangeCollection
+from xlviews.range.style import set_font, set_number_format
 from xlviews.utils import iter_columns
 
 from .sheet import SheetFrame