charite-plot 0.1.0__tar.gz → 0.1.1__tar.gz

{charite_plot-0.1.0 → charite_plot-0.1.1}/.gitignore

@@ -1,3 +1,4 @@
+dist
 examples/**
 !examples/*.py
 site

charite_plot-0.1.1/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] - 2026-06-13
+
+### Fixed
+
+- README images now use absolute raw GitHub URLs so they render correctly on PyPI.
+- Corrected PyPI project URLs (homepage, docs, repository, bug tracker).
+
+## [0.1.0] - 2026-06-12
+
+### Added
+
+- Initial release.
+- Matplotlib theme (`mpl_themes.theme_charite`) with `apply_theme()` and `using()` context manager.
+- Altair/Vega-Lite theme (`altair_themes.theme_charite`) with `register()` and `enable()`.
+- 10 built-in colour palettes: `primary`, `secondary`, `mono`, `light`, `versus`, `nineties`, `brickhouse`, `sunrise`, `berryseason`, `goldelse`.
+- 27 Charité corporate identity colour constants in `colors.py`.
+- `make_palette()` for subsampling and interpolating palettes.
+- Font fallback chain: Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans → sans-serif.
+- MkDocs Material documentation with API reference.
+- MIT License.

{charite_plot-0.1.0 → charite_plot-0.1.1}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: charite-plot
-Version: 0.1.0
+Version: 0.1.1
 Summary: Matplotlib and Altair themes for Charité – Universitätsmedizin Berlin
-Project-URL: Homepage, https://github.com/pedramramezani/charite-plot
-Project-URL: Documentation, https://pedramramezani.github.io/charite-plot
-Project-URL: Repository, https://github.com/pedramramezani/charite-plot
-Project-URL: Bug Tracker, https://github.com/pedramramezani/charite-plot/issues
-Author-email: Pedram Ramezani <pedramramezani.pr@gmail.com>
+Project-URL: Homepage, https://github.com/pedramezani/charite-plot
+Project-URL: Documentation, https://pedramezani.github.io/charite-plot
+Project-URL: Repository, https://github.com/pedramezani/charite-plot
+Project-URL: Bug Tracker, https://github.com/pedramezani/charite-plot/issues
+Project-URL: Changelog, https://github.com/pedramezani/charite-plot/blob/main/CHANGELOG.md
+Author-email: Pedram Ramezani <me@pedramramezani.de>
 License: # MIT License
         
         Copyright 2026 Pedram Ramezani
@@ -19,14 +20,19 @@ License: # MIT License
 License-File: LICENSE.md
 Keywords: altair,charite,matplotlib,theme,visualization
 Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Matplotlib
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 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
+Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Requires-Dist: cycler
 Requires-Dist: matplotlib>=3.5
@@ -57,13 +63,13 @@ pip install "charite-plot[altair]"         # with Altair support
 Visualize your data with `theme_charite()` to match the Charité corporate style.
 
 <p align="center">
-<img src="docs/assets/theme_example.png" width="80%"/>
+<img src="https://raw.githubusercontent.com/pedramezani/charite-plot/main/docs/assets/theme_example.png" width="80%"/>
 </p>
 
 Preview the available colour palettes.
 
 <p align="center">
-<img src="docs/assets/palette_preview.png" width="80%"/>
+<img src="https://raw.githubusercontent.com/pedramezani/charite-plot/main/docs/assets/palette_preview.png" width="80%"/>
 </p>
 
 ## Quick start
@@ -126,11 +132,9 @@ enable(palette="berryseason", font_size=13)
 
 The fallback chain follows the official Charité brand guidelines:
 
-**Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans**
+**Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans → sans-serif**
 
-> **Ersatzschrift „Calibri"** — Falls die Hausschrift aus technischen Gründen nicht verwendet werden kann, ersetzt die Systemschriftart „Calibri" die Hausschrift. Dies ist beispielsweise bei der E-Mail-Korrespondenz der Fall.
-
-`DejaVu Sans` ships with Matplotlib and is always available as the final fallback. To override the preferred font:
+`DejaVu Sans` ships with Matplotlib and is always available as the penultimate fallback; `sans-serif` lets the browser or system choose if nothing else matches (important for Altair/Vega-Lite). To override the preferred font:
 
 ```python
 apply_theme(theme_charite(font="Arial"))

{charite_plot-0.1.0 → charite_plot-0.1.1}/README.md

@@ -14,13 +14,13 @@ pip install "charite-plot[altair]"         # with Altair support
 Visualize your data with `theme_charite()` to match the Charité corporate style.
 
 <p align="center">
-<img src="docs/assets/theme_example.png" width="80%"/>
+<img src="https://raw.githubusercontent.com/pedramezani/charite-plot/main/docs/assets/theme_example.png" width="80%"/>
 </p>
 
 Preview the available colour palettes.
 
 <p align="center">
-<img src="docs/assets/palette_preview.png" width="80%"/>
+<img src="https://raw.githubusercontent.com/pedramezani/charite-plot/main/docs/assets/palette_preview.png" width="80%"/>
 </p>
 
 ## Quick start
@@ -83,11 +83,9 @@ enable(palette="berryseason", font_size=13)
 
 The fallback chain follows the official Charité brand guidelines:
 
-**Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans**
+**Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans → sans-serif**
 
-> **Ersatzschrift „Calibri"** — Falls die Hausschrift aus technischen Gründen nicht verwendet werden kann, ersetzt die Systemschriftart „Calibri" die Hausschrift. Dies ist beispielsweise bei der E-Mail-Korrespondenz der Fall.
-
-`DejaVu Sans` ships with Matplotlib and is always available as the final fallback. To override the preferred font:
+`DejaVu Sans` ships with Matplotlib and is always available as the penultimate fallback; `sans-serif` lets the browser or system choose if nothing else matches (important for Altair/Vega-Lite). To override the preferred font:
 
 ```python
 apply_theme(theme_charite(font="Arial"))

{charite_plot-0.1.0 → charite_plot-0.1.1}/charite_plot/__init__.py

@@ -26,5 +26,5 @@ from .palettes import PALETTES, make_palette  # noqa: F401
 from . import mpl_themes  # noqa: F401
 from . import altair_themes  # noqa: F401
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 __author__ = "Pedram Ramezani"

{charite_plot-0.1.0 → charite_plot-0.1.1}/charite_plot/altair_themes.py

@@ -41,7 +41,7 @@ def theme_charite(
     Parameters
     ----------
     font:
-        Preferred font. Falls back through Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans.
+        Preferred font. Falls back through Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans → sans-serif.
     font_size:
         Base font size in pixels.
     grid:

{charite_plot-0.1.0 → charite_plot-0.1.1}/charite_plot/fonts.py

@@ -2,7 +2,7 @@
 
 import warnings
 
-FONT_STACK = ["Charité Text Office", "Charit? Text Office", "Calibri", "DejaVu Sans"]
+FONT_STACK = ["Charité Text Office", "Charit? Text Office", "Calibri", "DejaVu Sans", "sans-serif"]
 
 
 def _available_fonts() -> set[str]:
@@ -19,7 +19,7 @@ def check_font(font: str) -> bool:
         return True
     warnings.warn(
         f"Font '{font}' is not installed on this system. "
-        "Using the fallback chain: Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans.",
+        "Using the fallback chain: Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans → sans-serif.",
         UserWarning,
         stacklevel=3,
     )

{charite_plot-0.1.0 → charite_plot-0.1.1}/charite_plot/mpl_themes.py

@@ -22,7 +22,7 @@ def theme_charite(
     ----------
     font:
         Preferred font family. Falls back through Charité Text Office →
-        Charit? Text Office → Calibri → DejaVu Sans if the requested font is not installed.
+        Charit? Text Office → Calibri → DejaVu Sans → sans-serif if the requested font is not installed.
     font_size:
         Base font size in points. Defaults to 10 for screen; use 8 for print.
     thickness:

{charite_plot-0.1.0 → charite_plot-0.1.1}/docs/altair.md

@@ -42,7 +42,7 @@ alt.theme.enable("charite")   # enable later
 
 | Parameter | Type | Default | Description |
 |-----------|------|---------|-------------|
-| `font` | `str | None` | `None` | Preferred font. CSS fallback: Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans. |
+| `font` | `str | None` | `None` | Preferred font. CSS fallback: Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans → sans-serif. |
 | `font_size` | `int` | `12` | Base font size in pixels. |
 | `grid` | `bool` | `False` | Show axis grid lines. |
 | `palette` | `str | list[str]` | `"primary"` | Named palette or list of hex strings for the categorical color range. |

{charite_plot-0.1.0 → charite_plot-0.1.1}/docs/index.md

@@ -59,4 +59,4 @@ chart = alt.Chart(df).mark_bar().encode(...)
 
 - **Single source of truth** — colors are defined once in `colors.py` and imported by every other module.
 - **No side effects on import** — theme functions return plain dicts; you opt in with `apply_theme()`, `using()`, or `enable()`.
-- **Font fallback** — if Charité Text Office is not installed, the theme cascades to Charit? Text Office, then Calibri and DejaVu Sans automatically, following the official brand guidelines.
+- **Font fallback** — if Charité Text Office is not installed, the theme cascades to Charit? Text Office, then Calibri, DejaVu Sans, and finally sans-serif automatically, following the official brand guidelines.

{charite_plot-0.1.0 → charite_plot-0.1.1}/docs/installation.md

@@ -27,9 +27,10 @@ pip install "charite-plot[docs]"        # mkdocs-material + mkdocstrings
 
 charite-plot works out of the box with any system. The font fallback chain is:
 
-**Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans**
+**Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans → sans-serif**
 
-- `DejaVu Sans` ships with Matplotlib and is always available as the final fallback.
+- `sans-serif` is the final fallback, letting the browser or system choose a suitable font — this is particularly important for Altair/Vega-Lite charts.
+- `DejaVu Sans` ships with Matplotlib and is always available as the penultimate fallback.
 - `Calibri` is pre-installed on Windows and macOS (via Microsoft Office) and serves as the official replacement font, as defined in the Charité brand guidelines.
 - `Charité Text Office` must be installed manually — it is available to Charité employees via the Markenportal. On some systems the `é` is not decoded correctly and the font is registered as `Charit? Text Office`; both names are tried automatically.
 

{charite_plot-0.1.0 → charite_plot-0.1.1}/docs/matplotlib.md

@@ -52,7 +52,7 @@ mpl.rcParams.update(params)
 
 | Parameter | Type | Default | Description |
 |-----------|------|---------|-------------|
-| `font` | `str | None` | `None` | Preferred font. Falls back through Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans. |
+| `font` | `str | None` | `None` | Preferred font. Falls back through Charité Text Office → Charit? Text Office → Calibri → DejaVu Sans → sans-serif. |
 | `font_size` | `float` | `10` | Base font size in points. Use `8` for print/journal figures. |
 | `thickness` | `float` | `0.5` | Axis line and tick width. |
 | `grid` | `bool` | `False` | Show major grid lines. |

{charite_plot-0.1.0 → charite_plot-0.1.1}/mkdocs.yml

@@ -1,7 +1,7 @@
 site_name: charite-plot
 site_description: Matplotlib and Altair themes for Charité – Universitätsmedizin Berlin
 site_author: Pedram Ramezani
-repo_url: https://github.com/pedramramezani/charite-plot
+repo_url: https://github.com/pedramezani/charite-plot
 repo_name: charite-plot
 
 theme:

{charite_plot-0.1.0 → charite_plot-0.1.1}/pyproject.toml

@@ -8,7 +8,7 @@ dynamic = ["version"]
 description = "Matplotlib and Altair themes for Charité – Universitätsmedizin Berlin"
 readme = "README.md"
 authors = [
-    { name = "Pedram Ramezani", email = "pedramramezani.pr@gmail.com" },
+    { name = "Pedram Ramezani", email = "me@pedramramezani.de" },
 ]
 license = { file = "LICENSE.md" }
 requires-python = ">=3.9"
@@ -17,12 +17,17 @@ classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Science/Research",
     "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Scientific/Engineering :: Visualization",
+    "Framework :: Matplotlib",
+    "Typing :: Typed",
 ]
 dependencies = [
     "matplotlib>=3.5",
@@ -30,10 +35,11 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage      = "https://github.com/pedramramezani/charite-plot"
-Documentation = "https://pedramramezani.github.io/charite-plot"
-Repository    = "https://github.com/pedramramezani/charite-plot"
-"Bug Tracker" = "https://github.com/pedramramezani/charite-plot/issues"
+Homepage      = "https://github.com/pedramezani/charite-plot"
+Documentation = "https://pedramezani.github.io/charite-plot"
+Repository    = "https://github.com/pedramezani/charite-plot"
+"Bug Tracker" = "https://github.com/pedramezani/charite-plot/issues"
+Changelog     = "https://github.com/pedramezani/charite-plot/blob/main/CHANGELOG.md"
 
 [project.optional-dependencies]
 altair = ["altair>=5.5", "vega-datasets"]