myplotlib 1.7.0__tar.gz → 1.8.1__tar.gz

{myplotlib-1.7.0 → myplotlib-1.8.1}/.gitignore

@@ -40,6 +40,7 @@ share/python-wheels/
 .installed.cfg
 *.egg
 MANIFEST
+temp
 
 # PyInstaller
 #  Usually these files are written by a python script from a template
@@ -169,3 +170,8 @@ cython_debug/
 .direnv
 .envrc
 .claude/
+
+dist/
+
+# LLM
+.agents

{myplotlib-1.7.0 → myplotlib-1.8.1}/LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2024, Hayk Hakobyan
+Copyright (c) 2026, Hayk Hakobyan
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

{myplotlib-1.7.0 → myplotlib-1.8.1}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: myplotlib
-Version: 1.7.0
+Version: 1.8.1
 Summary: `matplotlib` binder with custom styles and routines for fast plotting
 Project-URL: Repository, https://github.com/haykh/myplotlib
 Author-email: Hayk <haykh.astro@gmail.com>
 Maintainer-email: Hayk <haykh.astro@gmail.com>
 License: BSD 3-Clause License
         
-        Copyright (c) 2024, Hayk Hakobyan
+        Copyright (c) 2026, Hayk Hakobyan
         
         Redistribution and use in source and binary forms, with or without
         modification, are permitted provided that the following conditions are met:
@@ -40,15 +40,13 @@ Classifier: Intended Audience :: Education
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Programming Language :: Python :: 3 :: Only
-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: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering :: Visualization
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Requires-Dist: matplotlib>=3.5.0
 Requires-Dist: numba>=0.57.0
 Requires-Dist: numpy
@@ -69,14 +67,17 @@ pip install myplotlib
 ### loading style, fonts & colormaps
 
 ```python
-import myplotlib
 import matplotlib.pyplot as plt
+from myplotlib import register
+
+register()
 
 plt.style.use(STYLE)
 # STYLE can be:
 # - fancy.dark, fancy.light
 # - classic.dark, classic.light
 # - mono.dark, mono.light
+# - guttenberg.dark, guttenberg.light
 # - latex
 
 # you may also combine the styles:
@@ -87,6 +88,8 @@ with plt.style.context(STYLE):
     plt.plot(...)
 ```
 
+> `register()` loads the bundled styles, fonts, and colormaps into Matplotlib. importing `myplotlib` still registers them for backward compatibility, but the explicit call keeps linters from flagging an unused side-effect import.
+
 ### auxiliary plotting functions
 
 ```python
@@ -103,6 +106,16 @@ import myplotlib.tests as mypltest
 mypltest?
 ```
 
+the `guttenberg` styles mimic renaissance-era book illustrations: old-style lettering (P22 Operina Pro, with EB Garamond as fallback for missing glyphs), imperfect hand-drawn lines, and a single-ink line cycle. they pair well with `myplt.hatchedCircle`, which shades circles with engraving-style hatching (optionally only the crescent shadow, as on old drawings of moon phases):
+
+```python
+with plt.style.context("guttenberg.light"):
+    fig, ax = plt.subplots()
+    ax.set_aspect("equal")
+    myplt.hatchedCircle(ax, (0, 0), 1, angle=45, spacing=0.15)
+    myplt.hatchedCircle(ax, (2.5, 0), 1, shade_from=0, shade_depth=0.8)
+```
+
 for more usage examples checkout the `tests/` submodule.
 
 ## requirements
@@ -112,20 +125,6 @@ for more usage examples checkout the `tests/` submodule.
 * `latex` (used for `fancy` and `latex` only)
 * `numba>=0.57.0`
 
-## development
-
-when deploying a new version, there are three necessary steps to take.
-
-1. increase the version string in `myplotlib/__init__.py`.
-2. generate the previews:
-    ```sh
-    python3 previews/export_previews.py
-    ```
-3. build the new tarballs in the `dist` directory:
-    ```sh
-    python -m build --sdist --outdir dist .
-    ```
-
 ## To-do
 
 - [ ] isocontour plotting

{myplotlib-1.7.0 → myplotlib-1.8.1}/README.md

@@ -13,14 +13,17 @@ pip install myplotlib
 ### loading style, fonts & colormaps
 
 ```python
-import myplotlib
 import matplotlib.pyplot as plt
+from myplotlib import register
+
+register()
 
 plt.style.use(STYLE)
 # STYLE can be:
 # - fancy.dark, fancy.light
 # - classic.dark, classic.light
 # - mono.dark, mono.light
+# - guttenberg.dark, guttenberg.light
 # - latex
 
 # you may also combine the styles:
@@ -31,6 +34,8 @@ with plt.style.context(STYLE):
     plt.plot(...)
 ```
 
+> `register()` loads the bundled styles, fonts, and colormaps into Matplotlib. importing `myplotlib` still registers them for backward compatibility, but the explicit call keeps linters from flagging an unused side-effect import.
+
 ### auxiliary plotting functions
 
 ```python
@@ -47,6 +52,16 @@ import myplotlib.tests as mypltest
 mypltest?
 ```
 
+the `guttenberg` styles mimic renaissance-era book illustrations: old-style lettering (P22 Operina Pro, with EB Garamond as fallback for missing glyphs), imperfect hand-drawn lines, and a single-ink line cycle. they pair well with `myplt.hatchedCircle`, which shades circles with engraving-style hatching (optionally only the crescent shadow, as on old drawings of moon phases):
+
+```python
+with plt.style.context("guttenberg.light"):
+    fig, ax = plt.subplots()
+    ax.set_aspect("equal")
+    myplt.hatchedCircle(ax, (0, 0), 1, angle=45, spacing=0.15)
+    myplt.hatchedCircle(ax, (2.5, 0), 1, shade_from=0, shade_depth=0.8)
+```
+
 for more usage examples checkout the `tests/` submodule.
 
 ## requirements
@@ -56,20 +71,6 @@ for more usage examples checkout the `tests/` submodule.
 * `latex` (used for `fancy` and `latex` only)
 * `numba>=0.57.0`
 
-## development
-
-when deploying a new version, there are three necessary steps to take.
-
-1. increase the version string in `myplotlib/__init__.py`.
-2. generate the previews:
-    ```sh
-    python3 previews/export_previews.py
-    ```
-3. build the new tarballs in the `dist` directory:
-    ```sh
-    python -m build --sdist --outdir dist .
-    ```
-
 ## To-do
 
 - [ ] isocontour plotting

myplotlib-1.8.1/myplotlib/__init__.py

@@ -0,0 +1,189 @@
+"""Register bundled Matplotlib styles, colormaps, and fonts.
+
+Importing `myplotlib` adds package assets to Matplotlib's style library,
+colormap registry, and font manager.
+"""
+
+__version__ = "1.8.1"
+
+
+import warnings
+from pathlib import Path
+from typing import Literal, Sequence, cast
+import matplotlib.pyplot as plt
+from matplotlib import font_manager, rc_params_from_file
+import matplotlib.colors as mcolors
+
+
+def __RGBToPyCmap(rgbdata):
+    """Convert RGB samples into a Matplotlib segmented colormap dictionary.
+
+    Args
+    ----
+    rgbdata : NDArray
+        Array of RGB samples with shape `(n, 3)` and values on `[0, 1]`.
+
+    Returns
+    -------
+    dict[Literal['red', 'green', 'blue', 'alpha'], Sequence[tuple[float, ...]]]
+        Segmented colormap channel data accepted by `LinearSegmentedColormap`.
+    """
+    import numpy as np
+
+    nsteps = rgbdata.shape[0]
+    stepaxis = np.linspace(0, 1, nsteps)
+    rdata = []
+    gdata = []
+    bdata = []
+    for istep in range(nsteps):
+        r = rgbdata[istep, 0]
+        g = rgbdata[istep, 1]
+        b = rgbdata[istep, 2]
+        rdata.append((stepaxis[istep], r, r))
+        gdata.append((stepaxis[istep], g, g))
+        bdata.append((stepaxis[istep], b, b))
+    mpl_data = {
+        "red": rdata,
+        "green": gdata,
+        "blue": bdata,
+    }
+    return cast(
+        dict[
+            Literal["red", "green", "blue", "alpha"],
+            Sequence[tuple[float, ...]],
+        ],
+        mpl_data,
+    )
+
+
+CUSTOM_CMAPS = []
+
+
+def __InstallCmapFromCSV(csv):
+    """Register a CSV colormap and its reversed variant.
+
+    Args
+    ----
+    csv : str | Path
+        Path to a comma-separated RGB colormap file.
+
+    Returns
+    -------
+    None
+        The colormap is registered with Matplotlib in place.
+    """
+    global CUSTOM_CMAPS
+    import os
+    import numpy as np
+    import matplotlib as mpl
+
+    cmap = os.path.splitext(os.path.basename(csv))[0]
+    if cmap not in CUSTOM_CMAPS:
+        CUSTOM_CMAPS.append(cmap)
+    cmap_data = np.loadtxt(csv, delimiter=",")
+    if cmap not in mpl.colormaps.keys():
+        mpl_data = __RGBToPyCmap(cmap_data)
+        mpl.colormaps.register(
+            cmap=mcolors.LinearSegmentedColormap(cmap, mpl_data, cmap_data.shape[0])
+        )
+    cmap = f"{cmap}_r"
+    if cmap not in mpl.colormaps.keys():
+        mpl_data_r = __RGBToPyCmap(cmap_data[::-1, :])
+        mpl.colormaps.register(
+            cmap=mcolors.LinearSegmentedColormap(cmap, mpl_data_r, cmap_data.shape[0])
+        )
+
+
+def __RegisterStyles(styles_path):
+    """Register bundled Matplotlib style files.
+
+    Args
+    ----
+    styles_path : str | Path
+        Directory containing `.mplstyle` files.
+
+    Returns
+    -------
+    None
+        Style files are registered in Matplotlib in place.
+    """
+    for path in Path(styles_path).rglob("*.mplstyle"):
+        with warnings.catch_warnings(record=True):
+            plt.style.library[path.stem] = rc_params_from_file(
+                path, use_default_template=False
+            )
+    plt.style.available[:] = sorted(
+        name for name in plt.style.library if not name.startswith("_")
+    )
+
+
+def __RegisterColormaps(cmap_dir):
+    """Register bundled CSV colormaps.
+
+    Args
+    ----
+    cmap_dir : str | Path
+        Directory containing CSV colormap files.
+
+    Returns
+    -------
+    list[str]
+        Names of colormap files found in `cmap_dir`.
+    """
+    cmap_paths = [path for path in sorted(Path(cmap_dir).iterdir()) if path.is_file()]
+    for path in cmap_paths:
+        __InstallCmapFromCSV(path)
+    return [path.name for path in cmap_paths]
+
+
+def __RegisterFonts(font_dir):
+    """Register bundled font files.
+
+    Args
+    ----
+    font_dir : str | Path
+        Directory containing font files.
+
+    Returns
+    -------
+    list[str]
+        Font files found by Matplotlib and registered with its font manager.
+    """
+    font_files = font_manager.findSystemFonts(fontpaths=[str(font_dir)])
+    for font_file in font_files:
+        font_manager.fontManager.addfont(font_file)
+    return font_files
+
+
+myplotlib_path = str(Path(__file__).resolve().parent)
+styles_path = str(Path(myplotlib_path) / "assets")
+
+CMAP_DIR = str(Path(myplotlib_path) / "assets" / "colormaps")
+CMAPS = []
+
+FONT_DIR = str(Path(myplotlib_path) / "assets" / "fonts")
+font_files = []
+
+_ASSETS_REGISTERED = False
+
+
+def register():
+    """Register bundled Matplotlib assets.
+
+    Returns
+    -------
+    None
+        Styles, colormaps, and fonts are registered with Matplotlib in place.
+    """
+    global CMAPS, font_files, _ASSETS_REGISTERED
+
+    if _ASSETS_REGISTERED:
+        return
+
+    __RegisterStyles(styles_path)
+    CMAPS = __RegisterColormaps(CMAP_DIR)
+    font_files = __RegisterFonts(FONT_DIR)
+    _ASSETS_REGISTERED = True
+
+
+register()

{myplotlib-1.7.0 → myplotlib-1.8.1}/myplotlib/assets/classic.dark.mplstyle

@@ -26,9 +26,6 @@ legend.frameon: False
 savefig.bbox: tight
 savefig.pad_inches: 0.05
 
-#axes.labelweight  : normal
-axes.labelsize: 16
-
 grid.alpha: 0.2
 
 # tex
@@ -36,7 +33,6 @@ text.usetex: False
 
 # fonts
 font.weight: 500
-font.size: 16
 
 font.serif: AVHershey Complex 
 font.sans-serif: AVHershey Duplex 

{myplotlib-1.7.0 → myplotlib-1.8.1}/myplotlib/assets/classic.light.mplstyle

@@ -26,9 +26,6 @@ legend.frameon: False
 savefig.bbox: tight
 savefig.pad_inches: 0.05
 
-#axes.labelweight  : normal
-axes.labelsize: 14
-
 grid.alpha: 0.2
 
 # tex
@@ -36,7 +33,6 @@ text.usetex: False
 
 # fonts
 font.weight: 500
-font.size: 16
 
 font.serif: AVHershey Complex 
 font.sans-serif: AVHershey Duplex 

{myplotlib-1.7.0 → myplotlib-1.8.1}/myplotlib/assets/fancy.dark.mplstyle

@@ -8,14 +8,11 @@ xtick.direction: out
 ytick.direction: out
 grid.alpha: 0.2
 
-axes.labelsize: 16
-
 # tex
 text.usetex: True
 text.latex.preamble: \usepackage{amsmath,bm,xcolor,ebgaramond-maths}
 
 #fonts
-font.size: 14
 
 font.serif: EB Garamond
 font.sans-serif: EB Garamond

{myplotlib-1.7.0 → myplotlib-1.8.1}/myplotlib/assets/fancy.light.mplstyle

@@ -7,14 +7,11 @@ xtick.direction: out
 ytick.direction: out
 grid.alpha: 0.2
 
-axes.labelsize: 16
-
 # tex
 text.usetex: True
 text.latex.preamble: \usepackage{amsmath,bm,xcolor,ebgaramond-maths}
 
 #fonts
-font.size: 14
 
 font.serif: EB Garamond
 font.sans-serif: EB Garamond

myplotlib-1.8.1/myplotlib/assets/fonts/P22OperinaPro/License.txt

@@ -0,0 +1,37 @@
+
+
+-------------------------------------------------------------------------------------------------------
+
+	FREE FONTS : http://www.OnlineWebFonts.Com      
+
+-------------------------------------------------------------------------------------------------------
+
+	You must credit the author
+	Copy this link on your web
+
+	<div>Fonts made from <a href="http://www.onlinewebfonts.com">Web Fonts</a> is licensed by CC BY 4.0</div>
+
+	    OR
+
+	<a href="http://www.onlinewebfonts.com">Web Fonts</a>
+
+
+=======================================================================================================
+
+	OnlineWebFonts.Com features an amazing collection of free fonts,
+	premium fonts and free dingbats. With over 8,000,00 freeware fonts, 
+	you've come to the best place to download fonts! 
+
+
+=======================================================================================================
+
+
+	OnlineWebFonts.Com Some fonts provided are trial versions of full versions and may not allow embedding 
+	unless a commercial license is purchased or may contain a limited character set. 
+	Please review any files included with your download, 
+	which will usually include information on the usage and licenses of the fonts. 
+	If no information is provided, 
+	please use at your own discretion or contact the author directly. 
+
+
+=======================================================================================================

myplotlib-1.8.1/myplotlib/assets/guttenberg.dark.mplstyle

@@ -0,0 +1,61 @@
+# guttenberg.dark: renaissance-era book illustration style
+# pale ink on dark paper, imperfect hand-drawn lines, old-style lettering
+
+# ink & paper
+figure.facecolor: 14100c
+axes.facecolor: 14100c
+savefig.facecolor: 14100c
+text.color: e8e1d2
+axes.edgecolor: e8e1d2
+axes.labelcolor: e8e1d2
+xtick.color: e8e1d2
+ytick.color: e8e1d2
+
+# single-ink cycle: fresh & faded ink, then engraving line styles
+axes.prop_cycle: cycler('linestyle', ['-', '--', ':', '-.']) * cycler('color', ['e8e1d2', '8d8477'])
+
+# the hand of the engraver: (scale, length, randomness)
+path.sketch: (1.5, 200, 2)
+
+lines.linewidth: 1.4
+lines.solid_capstyle: round
+lines.dash_capstyle: round
+
+axes.linewidth: 1.0
+axes.grid: False
+axes.axisbelow: True
+axes.spines.top: False
+axes.spines.right: False
+axes.unicode_minus: False
+
+xtick.direction: out
+ytick.direction: out
+
+legend.frameon: False
+
+# continuous tone rendered as ink wash
+image.cmap: binary_r
+
+# fonts: p22 operina pro throughout, eb garamond as per-glyph fallback
+# note: the concrete family list must be in font.family itself -- a generic alias
+# (e.g. `serif`) resolves to a single font and disables the per-glyph fallback
+text.usetex: False
+font.family: P22OperinaProPatched, EB Garamond
+font.style: normal
+font.weight: normal
+font.serif: P22OperinaProPatched, EB Garamond
+font.sans-serif: P22OperinaProPatched, EB Garamond
+font.monospace: P22OperinaProPatched, EB Garamond
+axes.titleweight: normal
+figure.titleweight: normal
+
+# mathtext does not support eb garamond as a custom per-glyph fallback
+mathtext.fontset: custom
+mathtext.fallback: None
+mathtext.default: it
+mathtext.rm: P22OperinaProPatched:style=normal:weight=normal
+mathtext.it: P22OperinaProPatched:style=normal:weight=normal
+mathtext.bf: P22OperinaProPatched:style=normal:weight=normal
+mathtext.sf: P22OperinaProPatched:style=normal:weight=normal
+mathtext.tt: P22OperinaProPatched:style=normal:weight=normal
+mathtext.cal: P22OperinaProPatched:style=normal:weight=normal

myplotlib-1.8.1/myplotlib/assets/guttenberg.light.mplstyle

@@ -0,0 +1,58 @@
+# guttenberg.light: renaissance-era book illustration style
+# black ink on paper, imperfect hand-drawn lines, old-style lettering
+
+# ink & paper
+figure.facecolor: ffffff
+axes.facecolor: ffffff
+savefig.facecolor: ffffff
+text.color: 191411
+axes.edgecolor: 191411
+axes.labelcolor: 191411
+xtick.color: 191411
+ytick.color: 191411
+
+# single-ink cycle: fresh & faded ink, then engraving line styles
+axes.prop_cycle: cycler('linestyle', ['-', '--', ':', '-.']) * cycler('color', ['191411', '6f645a'])
+
+# the hand of the engraver: (scale, length, randomness)
+path.sketch: (1.5, 200, 2)
+
+lines.linewidth: 1.4
+lines.solid_capstyle: round
+lines.dash_capstyle: round
+
+axes.linewidth: 1.0
+axes.grid: False
+axes.axisbelow: True
+axes.spines.top: False
+axes.spines.right: False
+axes.unicode_minus: False
+
+xtick.direction: out
+ytick.direction: out
+
+legend.frameon: False
+
+# continuous tone rendered as ink wash
+image.cmap: binary
+
+text.usetex: False
+font.family: P22OperinaProPatched, EB Garamond
+font.style: normal
+font.weight: normal
+font.serif: P22OperinaProPatched, EB Garamond
+font.sans-serif: P22OperinaProPatched, EB Garamond
+font.monospace: P22OperinaProPatched, EB Garamond
+axes.titleweight: normal
+figure.titleweight: normal
+
+# mathtext does not support eb garamond as a custom per-glyph fallback
+mathtext.fontset: custom
+mathtext.fallback: None
+mathtext.default: it
+mathtext.rm: P22OperinaProPatched:style=normal:weight=normal
+mathtext.it: P22OperinaProPatched:style=normal:weight=normal
+mathtext.bf: P22OperinaProPatched:style=normal:weight=normal
+mathtext.sf: P22OperinaProPatched:style=normal:weight=normal
+mathtext.tt: P22OperinaProPatched:style=normal:weight=normal
+mathtext.cal: P22OperinaProPatched:style=normal:weight=normal

myplotlib-1.8.1/myplotlib/assets/latex.mplstyle

@@ -0,0 +1,5 @@
+text.usetex: True
+text.latex.preamble: \usepackage{amsmath,bm,xcolor}
+
+# render all text with the serif (computer modern roman) family, as in a latex document
+font.family: serif