easy-viz 0.1.0__tar.gz

easy_viz-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arian Mokhtariha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

easy_viz-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: easy-viz
+Version: 0.1.0
+Summary: The Metabase / Power BI of Python at the code level: query result in, finished Plotly figure out.
+Keywords: plotly,visualization,charts,sql,analytics,dataframe
+Author: Arian Mokhtariha
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Framework :: Jupyter
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Typing :: Typed
+Requires-Dist: plotly>=7.1
+Requires-Dist: narwhals>=2.8
+Requires-Dist: numpy>=2.1
+Requires-Dist: scipy>=1.14.1
+Requires-Dist: kaleido>=1.5 ; extra == 'export'
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/arianmokhtariha/easy-viz
+Project-URL: Repository, https://github.com/arianmokhtariha/easy-viz
+Project-URL: Changelog, https://github.com/arianmokhtariha/easy-viz/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/arianmokhtariha/easy-viz/issues
+Provides-Extra: export
+Description-Content-Type: text/markdown
+
+# easy-viz
+
+[![CI](https://github.com/arianmokhtariha/easy-viz/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/arianmokhtariha/easy-viz/actions/workflows/ci.yml)
+
+The Metabase / Power BI of Python, at the code level: a query result goes in, a
+finished Plotly figure comes out.
+
+Run your SQL (or anything else), pass the table straight to an easy-viz function, and
+get a finished chart. Every feature of the chart is a typed, documented parameter, so a
+plot goes from a one-line default to an advanced chart by changing arguments, not by
+writing plotting code. Every function returns a plain Plotly figure, so anything the
+parameters don't cover can still be done with Plotly.
+
+> **Status:** alpha, under active development. The API may still change between
+> 0.x releases; the [changelog](https://github.com/arianmokhtariha/easy-viz/blob/main/CHANGELOG.md)
+> lists every change.
+
+## Install
+```
+pip install easy-viz
+```
+For PNG, SVG and PDF export with `ev.save()`, add the `export` extra (it needs
+Chrome; `plotly_get_chrome` installs it):
+```
+pip install "easy-viz[export]"
+```
+Python 3.13 or newer.
+
+The [gallery](https://github.com/arianmokhtariha/easy-viz/tree/main/gallery) shows
+every function on a fictional retailer's data, starting from a SQL query each time.
+
+## Development
+```
+uv sync --all-extras --all-groups
+uv run pytest
+```
+What easy-viz is for: [`docs/product.md`](https://github.com/arianmokhtariha/easy-viz/blob/main/docs/product.md).
+How it's organised, and why: [`docs/`](https://github.com/arianmokhtariha/easy-viz/tree/main/docs).
+<!-- Links are absolute because this file is also the PyPI project page, where
+relative links break. -->
+

easy_viz-0.1.0/README.md

@@ -0,0 +1,41 @@
+# easy-viz
+
+[![CI](https://github.com/arianmokhtariha/easy-viz/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/arianmokhtariha/easy-viz/actions/workflows/ci.yml)
+
+The Metabase / Power BI of Python, at the code level: a query result goes in, a
+finished Plotly figure comes out.
+
+Run your SQL (or anything else), pass the table straight to an easy-viz function, and
+get a finished chart. Every feature of the chart is a typed, documented parameter, so a
+plot goes from a one-line default to an advanced chart by changing arguments, not by
+writing plotting code. Every function returns a plain Plotly figure, so anything the
+parameters don't cover can still be done with Plotly.
+
+> **Status:** alpha, under active development. The API may still change between
+> 0.x releases; the [changelog](https://github.com/arianmokhtariha/easy-viz/blob/main/CHANGELOG.md)
+> lists every change.
+
+## Install
+```
+pip install easy-viz
+```
+For PNG, SVG and PDF export with `ev.save()`, add the `export` extra (it needs
+Chrome; `plotly_get_chrome` installs it):
+```
+pip install "easy-viz[export]"
+```
+Python 3.13 or newer.
+
+The [gallery](https://github.com/arianmokhtariha/easy-viz/tree/main/gallery) shows
+every function on a fictional retailer's data, starting from a SQL query each time.
+
+## Development
+```
+uv sync --all-extras --all-groups
+uv run pytest
+```
+What easy-viz is for: [`docs/product.md`](https://github.com/arianmokhtariha/easy-viz/blob/main/docs/product.md).
+How it's organised, and why: [`docs/`](https://github.com/arianmokhtariha/easy-viz/tree/main/docs).
+<!-- Links are absolute because this file is also the PyPI project page, where
+relative links break. -->
+

easy_viz-0.1.0/pyproject.toml

@@ -0,0 +1,130 @@
+[project]
+name = "easy-viz"
+version = "0.1.0"
+description = "The Metabase / Power BI of Python at the code level: query result in, finished Plotly figure out."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.13"
+keywords = [
+    "plotly",
+    "visualization",
+    "charts",
+    "sql",
+    "analytics",
+    "dataframe",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Framework :: Jupyter",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Topic :: Scientific/Engineering :: Visualization",
+    "Typing :: Typed",
+]
+dependencies = [
+    "plotly>=7.1",
+    "narwhals>=2.8",
+    "numpy>=2.1",
+    "scipy>=1.14.1",
+]
+
+[[project.authors]]
+name = "Arian Mokhtariha"
+
+[project.urls]
+Homepage = "https://github.com/arianmokhtariha/easy-viz"
+Repository = "https://github.com/arianmokhtariha/easy-viz"
+Changelog = "https://github.com/arianmokhtariha/easy-viz/blob/main/CHANGELOG.md"
+Issues = "https://github.com/arianmokhtariha/easy-viz/issues"
+
+[project.optional-dependencies]
+export = ["kaleido>=1.5"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9",
+    "pytest-cov",
+    "syrupy>=6",
+    "ruff>=0.17",
+    "mypy>=2.4",
+    "scipy-stubs",
+    "pandas>=2.2",
+    "polars>=1.0",
+    "pyarrow>=17",
+    "kaleido>=1.5",
+    "ipykernel",
+    "nbformat>=4.2",
+    "nbmake",
+    "nbclient>=0.10",
+    "duckdb>=1.5 ; python_full_version < '3.15'",
+]
+docs = [
+    "sphinx",
+    "pydata-sphinx-theme",
+    "numpydoc",
+    "myst-nb>=1.4",
+]
+
+[build-system]
+requires = ["uv_build>=0.13,<0.14"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+source-exclude = [
+    "**/CLAUDE.md",
+    "**/CLAUDE.local.md",
+    ".claude/**",
+]
+
+[tool.ruff]
+line-length = 88
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "N",
+    "UP",
+    "B",
+    "SIM",
+    "NPY",
+    "D",
+    "ANN",
+    "TID",
+    "RUF",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D"]
+"examples/**" = ["D"]
+"gallery/_template.ipynb" = ["F401"]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+warn_unreachable = true
+
+[[tool.mypy.overrides]]
+module = ["plotly.*"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = [
+    "--strict-markers",
+    "-ra",
+]
+markers = ["export: needs Chrome for kaleido static export"]

easy_viz-0.1.0/pyproject.toml.orig

@@ -0,0 +1,113 @@
+[project]
+name = "easy-viz"
+version = "0.1.0"
+description = "The Metabase / Power BI of Python at the code level: query result in, finished Plotly figure out."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.13"
+authors = [{ name = "Arian Mokhtariha" }]
+keywords = ["plotly", "visualization", "charts", "sql", "analytics", "dataframe"]
+# The Python versions match the CI matrix (tests/test_packaging.py checks it). No
+# license classifier: the SPDX `license` field above replaces it (PEP 639).
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Framework :: Jupyter",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Topic :: Scientific/Engineering :: Visualization",
+    "Typing :: Typed",
+]
+# Lower bounds only, never upper caps: easy-viz must fit into users' existing
+# environments without forcing them to up- or downgrade anything.
+dependencies = [
+    "plotly>=7.1",     # rendering core
+    "narwhals>=2.8",   # accepts pandas / polars / pyarrow / ... without depending on them;
+                       # 2.8 is the first that reads DuckDB 1.5 query results
+    "numpy>=2.1",      # numeric work; 2.1 is the first with Python 3.13 wheels
+    "scipy>=1.14.1",   # statistics (KDE, regression, clustering, distributions);
+                       # 1.14.1 is the first with Python 3.13 wheels
+]
+
+[project.urls]
+Homepage = "https://github.com/arianmokhtariha/easy-viz"
+Repository = "https://github.com/arianmokhtariha/easy-viz"
+Changelog = "https://github.com/arianmokhtariha/easy-viz/blob/main/CHANGELOG.md"
+Issues = "https://github.com/arianmokhtariha/easy-viz/issues"
+
+[project.optional-dependencies]
+export = ["kaleido>=1.5"]   # static PNG/SVG/PDF export; needs Chrome (plotly_get_chrome)
+
+[dependency-groups]
+dev = [
+    "pytest>=9",
+    "pytest-cov",          # test coverage report
+    "syrupy>=6",           # snapshot tests of figure output
+    "ruff>=0.17",          # lint + format
+    "mypy>=2.4",           # type checking
+    "scipy-stubs",         # type information for scipy
+    "pandas>=2.2",         # test inputs: easy-viz must work with every dataframe library
+    "polars>=1.0",
+    "pyarrow>=17",
+    "kaleido>=1.5",        # export tests and rendering figures for visual review
+    "ipykernel",           # use the project's .venv as a notebook kernel
+    "nbformat>=4.2",       # Plotly needs it to display figures in notebooks
+    "nbmake",              # runs the gallery notebooks as tests
+    "nbclient>=0.10",      # executes the gallery notebooks (scripts/build_gallery.py)
+    # The gallery notebooks query the showcase data with SQL. DuckDB has no Python
+    # 3.15 wheel yet, so the gallery builds and runs on 3.13/3.14 until it does.
+    "duckdb>=1.5 ; python_full_version < '3.15'",
+]
+docs = [
+    "sphinx",
+    "pydata-sphinx-theme",
+    "numpydoc",
+    "myst-nb>=1.4",        # renders Markdown docs and the gallery notebooks
+]
+
+[build-system]
+requires = ["uv_build>=0.13,<0.14"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+# Agent guides and agent definitions are tracked but are not part of the library.
+source-exclude = ["**/CLAUDE.md", "**/CLAUDE.local.md", ".claude/**"]
+
+[tool.ruff]
+line-length = 88
+
+[tool.ruff.lint]
+# E/W/F: errors, I: import order, N: naming, UP: modern syntax, B: likely bugs,
+# SIM: simplifications, NPY: numpy, D: docstrings, ANN: type annotations,
+# TID: import rules, RUF: ruff extras
+select = ["E", "W", "F", "I", "N", "UP", "B", "SIM", "NPY", "D", "ANN", "TID", "RUF"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"   # absolute imports only
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D"]
+"examples/**" = ["D"]
+# Its placeholder cells are comments, so `ev` stays unused until a notebook fills them.
+"gallery/_template.ipynb" = ["F401"]
+
+[tool.mypy]
+python_version = "3.13"   # the supported minimum: flags 3.14/3.15-only features
+strict = true
+warn_unreachable = true
+
+[[tool.mypy.overrides]]
+module = ["plotly.*"]      # Plotly ships no type information
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = ["--strict-markers", "-ra"]
+markers = ["export: needs Chrome for kaleido static export"]

easy_viz-0.1.0/src/easy_viz/__init__.py

@@ -0,0 +1,21 @@
+"""easy-viz: analytical plots in one call."""
+
+from easy_viz._warnings import EasyVizWarning
+from easy_viz.config import get_config, set_config
+from easy_viz.export import save, save_many
+from easy_viz.plots.comparison import bar_plot
+from easy_viz.plots.timeseries import line_plot
+from easy_viz.theme import Theme, get_theme, set_theme
+
+__all__ = [
+    "EasyVizWarning",
+    "Theme",
+    "bar_plot",
+    "get_config",
+    "get_theme",
+    "line_plot",
+    "save",
+    "save_many",
+    "set_config",
+    "set_theme",
+]