quink 0.1.0__tar.gz

quink-0.1.0/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: quink
+Version: 0.1.0
+Summary: dark-research aesthetic for Python
+Author: Lorenzo Santarsieri
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: scipy==1.15.3
+Requires-Dist: numpy==2.2.6
+Requires-Dist: matplotlib==3.10.8
+
+# quink
+
+<p align="center">
+<img src="https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python">
+<img src="https://img.shields.io/badge/NumPy-013243?style=for-the-badge&logo=numpy&logoColor=white" alt="NumPy">
+<img src="https://img.shields.io/badge/SciPy-8CAAE6?style=for-the-badge&logo=scipy&logoColor=white" alt="SciPy">
+<img src="https://img.shields.io/badge/Matplotlib-ffffff?style=for-the-badge&logo=plotly&logoColor=black" alt="Matplotlib">
+</p>
+
+<p align="center">
+  <i>
+    quink is a specialized Python visualization library designed for quantitative research. It bridges the gap between raw financial data and publication-ready charts, providing a "dark-research" aesthetic out of the box.
+  </i>
+</p>
+
+### 📦 Installation (PyPI Package)
+------------
+Install the package from **PyPI**:
+
+```bash
+pip install quink
+```
+
+### 🪪 License
+------------
+MIT © 2025 — Developed with ❤️ by Lorenzo Santarsieri

quink-0.1.0/README.md

@@ -0,0 +1,26 @@
+# quink
+
+<p align="center">
+<img src="https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python">
+<img src="https://img.shields.io/badge/NumPy-013243?style=for-the-badge&logo=numpy&logoColor=white" alt="NumPy">
+<img src="https://img.shields.io/badge/SciPy-8CAAE6?style=for-the-badge&logo=scipy&logoColor=white" alt="SciPy">
+<img src="https://img.shields.io/badge/Matplotlib-ffffff?style=for-the-badge&logo=plotly&logoColor=black" alt="Matplotlib">
+</p>
+
+<p align="center">
+  <i>
+    quink is a specialized Python visualization library designed for quantitative research. It bridges the gap between raw financial data and publication-ready charts, providing a "dark-research" aesthetic out of the box.
+  </i>
+</p>
+
+### 📦 Installation (PyPI Package)
+------------
+Install the package from **PyPI**:
+
+```bash
+pip install quink
+```
+
+### 🪪 License
+------------
+MIT © 2025 — Developed with ❤️ by Lorenzo Santarsieri

quink-0.1.0/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "quink"
+version = "0.1.0"
+description = "dark-research aesthetic for Python"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Lorenzo Santarsieri" }]
+requires-python = ">=3.10"
+dependencies = [
+    "scipy==1.15.3",
+    "numpy==2.2.6",
+    "matplotlib==3.10.8"
+]
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"

quink-0.1.0/quink/__init__.py

@@ -0,0 +1,7 @@
+from .render import (
+    qq_plot
+)
+
+from .core import (
+    quink_setup
+)

quink-0.1.0/quink/config.py

@@ -0,0 +1,12 @@
+# Palette "Dark Research"
+QUINK_COLORS = {
+    "bg_figure": "#0E0D0D",
+    "bg_axes": "#0C0C0C",
+    "dark_green": "#1B5E63",
+    "fancy_pink": "#E5A4C2",
+}
+
+PLOT_DEFAULTS = {
+    "figsize": (8, 6),
+    "dpi": 100,
+}

quink-0.1.0/quink/core.py

@@ -0,0 +1,31 @@
+# quink/viz/core.py
+import matplotlib.pyplot as plt
+from .config import QUINK_COLORS
+
+def apply_quink_theme():
+    """Apply dark research style"""
+    plt.style.use("dark_background")
+    plt.rcParams.update({
+        'figure.facecolor': QUINK_COLORS["bg_figure"],
+        'axes.facecolor': QUINK_COLORS["bg_axes"],
+    })
+
+
+def quink_setup(figsize=(8, 6), **kwargs):
+    """
+    Create a standard baseline for plots
+    """
+    apply_quink_theme()
+    
+    fig, ax = plt.subplots(
+        figsize=figsize,
+        **kwargs
+    )
+
+    ax.grid(
+        linestyle=":",
+        zorder=0,
+        alpha=0.3
+    )
+    
+    return fig, ax

quink-0.1.0/quink/render.py

@@ -0,0 +1,82 @@
+from typing import Optional, Tuple
+from .config import QUINK_COLORS
+import matplotlib.pyplot as plt
+from .core import quink_setup
+from scipy import stats
+import numpy as np
+
+
+def qq_plot(
+    y: np.ndarray,
+    dist: str = "normal",
+    df: Optional[float] = None,
+    figsize: Tuple[int, int] = (6, 5),
+    scatter_color: str = "#1B5E63",
+    line_color: str = "#E5A4C2",
+    xlabel: Optional[str] = None,
+    ylabel: Optional[str] = None,
+    title: Optional[str] = None,
+    show: bool = True,
+    dpi: int =100,
+) -> plt.Figure | None:
+    """
+    Generate a QQ plot against a theoretical distribution.
+    """
+    y = np.asarray(y)
+    y = np.sort(y)
+    n = len(y)
+
+    probs = (np.arange(1, n + 1) - 0.5) / n
+
+    if dist == "normal":
+        theoretical_q = stats.norm.ppf(probs)
+        default_title = "QQ Plot vs Normal"
+
+    elif dist == "t":
+        if df is None:
+            raise ValueError("df must be provided for t distribution.")
+        theoretical_q = stats.t.ppf(probs, df=df)
+        default_title = f"QQ Plot vs t (df={df})"
+
+    else:
+        raise ValueError("dist must be 'normal' or 't'.")
+
+    fig, ax = quink_setup(figsize=figsize, dpi=dpi)
+
+    ax.plot(
+        theoretical_q,
+        theoretical_q,
+        color=QUINK_COLORS["fancy_pink"],
+        zorder=3,
+    )
+
+    ax.scatter(
+        theoretical_q,
+        y,
+        color=QUINK_COLORS["dark_green"],
+        linewidths=0.3,
+        alpha=0.6,
+        zorder=4,
+    )
+
+    ax.set_xlabel(
+        xlabel if xlabel is not None
+        else "Theoretical Quantiles"
+    )
+
+    ax.set_ylabel(
+        ylabel if ylabel is not None
+        else "Empirical Quantiles"
+    )
+
+    ax.set_title(
+        title if title is not None
+        else default_title
+    )
+
+    if show:
+        plt.show()
+        return None
+
+    plt.close(fig)
+    return fig

quink-0.1.0/quink.egg-info/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: quink
+Version: 0.1.0
+Summary: dark-research aesthetic for Python
+Author: Lorenzo Santarsieri
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: scipy==1.15.3
+Requires-Dist: numpy==2.2.6
+Requires-Dist: matplotlib==3.10.8
+
+# quink
+
+<p align="center">
+<img src="https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python">
+<img src="https://img.shields.io/badge/NumPy-013243?style=for-the-badge&logo=numpy&logoColor=white" alt="NumPy">
+<img src="https://img.shields.io/badge/SciPy-8CAAE6?style=for-the-badge&logo=scipy&logoColor=white" alt="SciPy">
+<img src="https://img.shields.io/badge/Matplotlib-ffffff?style=for-the-badge&logo=plotly&logoColor=black" alt="Matplotlib">
+</p>
+
+<p align="center">
+  <i>
+    quink is a specialized Python visualization library designed for quantitative research. It bridges the gap between raw financial data and publication-ready charts, providing a "dark-research" aesthetic out of the box.
+  </i>
+</p>
+
+### 📦 Installation (PyPI Package)
+------------
+Install the package from **PyPI**:
+
+```bash
+pip install quink
+```
+
+### 🪪 License
+------------
+MIT © 2025 — Developed with ❤️ by Lorenzo Santarsieri

quink-0.1.0/quink.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+quink/__init__.py
+quink/config.py
+quink/core.py
+quink/render.py
+quink.egg-info/PKG-INFO
+quink.egg-info/SOURCES.txt
+quink.egg-info/dependency_links.txt
+quink.egg-info/requires.txt
+quink.egg-info/top_level.txt

quink-0.1.0/quink.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

quink-0.1.0/quink.egg-info/requires.txt

@@ -0,0 +1,3 @@
+scipy==1.15.3
+numpy==2.2.6
+matplotlib==3.10.8

quink-0.1.0/quink.egg-info/top_level.txt

@@ -0,0 +1 @@
+quink

quink-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+