plotlibs 0.3.0__py3-none-any.whl

plotlibs-0.3.0.dist-info/METADATA

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: plotlibs
+Version: 0.3.0
+Summary: plotlibs — fast, beautiful, matplotlib-compatible plotting with DataFrames, SQL, EDA and ML/DL visuals (numpy + Pillow only)
+Author: salim-studio
+License: MIT
+Project-URL: Homepage, https://github.com/salim-studio/plotlibs
+Project-URL: Repository, https://github.com/salim-studio/plotlibs
+Project-URL: Issues, https://github.com/salim-studio/plotlibs/issues
+Project-URL: Documentation, https://github.com/salim-studio/plotlibs#readme
+Project-URL: Changelog, https://github.com/salim-studio/plotlibs/blob/main/CHANGELOG.md
+Keywords: plotting,matplotlib,visualization,dataframe,sql,eda,machine-learning,deep-learning,pandas
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+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: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Database
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: pillow
+Provides-Extra: data
+Requires-Dist: pandas>=1.5; extra == "data"
+Requires-Dist: pyarrow>=10; extra == "data"
+Provides-Extra: db
+Requires-Dist: sqlalchemy>=2.0; extra == "db"
+Requires-Dist: duckdb>=0.8; extra == "db"
+Provides-Extra: ml
+Requires-Dist: scikit-learn>=1.0; extra == "ml"
+Requires-Dist: pandas>=1.5; extra == "ml"
+Provides-Extra: all
+Requires-Dist: pandas>=1.5; extra == "all"
+Requires-Dist: pyarrow>=10; extra == "all"
+Requires-Dist: sqlalchemy>=2.0; extra == "all"
+Requires-Dist: duckdb>=0.8; extra == "all"
+Requires-Dist: scikit-learn>=1.0; extra == "all"
+Requires-Dist: matplotlib>=3.5; extra == "all"
+Provides-Extra: dev
+Requires-Dist: matplotlib; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pandas; extra == "dev"
+Requires-Dist: scikit-learn; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="assets/banner.svg" alt="plotlibs banner" width="100%"/>
+</p>
+
+<p align="center">
+  <img src="assets/logo.svg" alt="plotlibs logo" width="96"/>
+</p>
+
+<h1 align="center">plotlibs</h1>
+<p align="center"><b>Fast, beautiful Python plotting for everyone.</b></p>
+
+<p align="center">
+  <a href="https://github.com/salim-studio/plotlibs"><img src="https://img.shields.io/badge/github-salim--studio%2Fplotlibs-0F172A?logo=github" alt="GitHub"/></a>
+  <img src="https://img.shields.io/badge/version-0.3.0-4F46E5" alt="version"/>
+  <img src="https://img.shields.io/badge/speed-~4x_vs_matplotlib-06B6D4" alt="speed"/>
+  <img src="https://img.shields.io/badge/deps-numpy_%2B_pillow_only-A3E635" alt="deps"/>
+  <img src="https://img.shields.io/badge/license-MIT-FACC15" alt="license"/>
+  <img src="https://img.shields.io/badge/python-%3E%3D3.9-3776AB?logo=python&logoColor=white" alt="python"/>
+</p>
+
+> **Renamed:** `plotlib` → **`plotlibs`**.
+> Old code keeps working via a shim (`import plotlib`), but please migrate to `import plotlibs`.
+> New home: **https://github.com/salim-studio/plotlibs**
+
+```python
+import plotlibs as pl
+
+pl.plot([1, 2, 3], [1, 4, 9], label="x²")
+pl.xlabel("x"); pl.ylabel("y"); pl.legend()
+pl.savefig("out.png")  # or pl.show()
+```
+
+## Why plotlibs?
+
+| Audience | One-liner value |
+|---|---|
+| Developers | Matplotlib-compatible API, only `numpy + pillow`, ~4x faster on big data |
+| Data analysts | `pl.load_csv` → `pl.quick_eda(df)` → `boxplot / kde / heatmap / countplot` |
+| Databases | `pl.db_connect("sales.db")` + `pl.read_sql(...)` + `plot_from_sql(...)` (sqlite / SQLAlchemy / DuckDB) |
+| Machine learning | `plot_confusion_matrix`, `plot_roc`, `plot_pr`, `feature_importance`, `residuals`, `elbow` |
+| Deep learning | `plot_history`, `plot_images`, `plot_clusters_2d` |
+
+## Install
+
+```bash
+pip install plotlibs                    # minimal: numpy + pillow
+pip install "plotlibs[all]"             # pandas + sqlalchemy + duckdb + sklearn + matplotlib
+pip install -e ".[dev]"                 # contributors
+```
+
+## 30-second tour
+
+```python
+import plotlibs as pl
+
+# 1) EDA in one line
+df = pl.load_csv("sales.csv")
+print(pl.describe(df))
+pl.quick_eda(df)
+
+# 2) Stats plots (all matplotlib-style signatures)
+pl.boxplot([[1, 2, 3], [2, 3, 4]], labels=["A", "B"])
+pl.violinplot([[1, 2, 3], [2, 3, 4]])
+pl.kde(df["sales"])
+pl.heatmap([[1, 0.8], [0.8, 1]], annot=True)
+pl.corr(df, annot=True)
+pl.countplot(["Cairo", "Oran", "Cairo"])
+pl.area([1, 2, 3], [1, 1, 1], [2, 2, 2], labels=["a", "b"])
+pl.hist2d([1, 2, 2, 3], [1, 1, 2, 2])
+pl.stem([1, 2, 3], [2, 1, 3])
+```
+
+```python
+# 3) SQL -> plot
+conn = pl.db_connect("sales.db")   # or ":memory:", "sqlite:///x.db", "duckdb://shop.ddb"
+pl.to_sql(df, "sales", conn)
+print(pl.db.list_tables(conn))
+df2 = pl.read_sql("SELECT region, SUM(amount) FROM sales GROUP BY region", conn)
+pl.db.plot_from_sql("SELECT qty, amount FROM sales LIMIT 500", conn, kind="scatter")
+```
+
+```python
+# 4) ML / DL
+pl.plot_history({"loss": [0.9, 0.5, 0.3], "val_loss": [1.0, 0.6, 0.4]})
+pl.plot_confusion_matrix(y_true, y_pred, normalize=True)
+pl.plot_roc(y_true, y_score, label="xgb")
+pl.plot_feature_importance(["age", "salary", "city"], [0.5, 0.3, 0.2])
+pl.plot_images(mnist_images)
+```
+
+## Visual identity
+
+Brand: **midnight ink `#0F172A` + indigo `#4F46E5` + cyan `#06B6D4`**, highlights lime `#A3E635` / amber `#FACC15`, background paper `#F8FAFC`. Logo: rounded-square gradient with a white line chart. See [`assets/`](assets/) and [`BRANDING.md`](BRANDING.md).
+
+Signature theme:
+
+```python
+import plotlibs as pl
+pl.style.use("plotlibs")        # light signature
+pl.style.use("plotlibs-dark")   # dark signature
+print(pl.style.available())
+```
+
+| Token | Hex | Use |
+|---|---|---|
+| primary | `#4F46E5` | lines, logo start, links |
+| accent | `#06B6D4` | second series, banner end |
+| ink | `#0F172A` | text, dark backgrounds |
+| paper | `#F8FAFC` | page background |
+| lime | `#A3E635` | highlight dots |
+| amber | `#FACC15` | highlight dots |
+
+## Matplotlib compatibility
+
+| matplotlib | plotlibs 0.3.0 |
+|---|---|
+| `plot / scatter / bar / hist / imshow / pie / fill_between / step / errorbar` | ✅ same signature |
+| `boxplot / violinplot / hist2d / stem / stackplot` | ✅ |
+| `xlabel / ylabel / title / legend / grid / xlim / ylim / savefig / show / subplots` | ✅ |
+| `style.use / rcParams` | ✅ + `plotlibs`, `plotlibs-dark`, `seaborn`, `plotly`, `publication` |
+
+## Why faster?
+
+1. **Min-max decimation** — lines over 2000 points are bucketed (min+max preserved), `O(n)` in numpy.
+2. **Pillow rasterizer** — direct C-level drawing, no heavy layout engine.
+3. **Vectorized pipeline** — data→pixel in one pass, numpy ticks/limits.
+4. **No heavy objects** — artists are plain dicts, render is deferred.
+
+Benchmark (`n=200k`, `benchmarks/bench.py`):
+
+```
+plotlibs   : ~370 ms/plot
+matplotlib : ~1560 ms/plot
+speedup    : ~4.2x faster
+```
+
+## Project layout
+
+```
+plotlibs/              # repo root (package name == repo name)
+  plotlibs/            # real package
+    __init__.py  pyplot.py  figure.py  colors.py  fast.py  style.py
+    data.py  db.py  eda.py  ml.py
+    backends/renderer.py
+  plotlib/             # deprecated shim (renamed alias)
+  assets/              # logo.svg, banner.svg
+  tests/  benchmarks/  examples/
+```
+
+## Migration from `plotlib`
+
+```diff
+- import plotlib as pl
++ import plotlibs as pl
+```
+
+`import plotlib` still works in 0.3.x (emits `DeprecationWarning`) and will be removed in 1.0.
+
+## Roadmap
+
+- [x] 0.3.0 — Rename to **plotlibs**, English docs, brand identity (this release)
+- [ ] 0.4.0 — Interactive HTML export (`pl.save_html`), dashboards, RTL/Arabic labels
+- [ ] 0.5.0 — Geo + time-series + sklearn/HF pipeline helpers
+- Suggest ideas: open an issue with `[idea]` at https://github.com/salim-studio/plotlibs/issues
+
+## Contributing
+
+```bash
+python -m pytest tests -q
+python examples/demo.py
+python examples/demo_fame.py
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

plotlibs-0.3.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+plotlib/__init__.py,sha256=EFAwfG_lumznKzYwePPX6wO0z9uAMo0TiaJtvrY0mDs,1243
+plotlibs/__init__.py,sha256=ESCxFS_JPMOGWJqhrGcC1K7im7HrCWbcFzrIGf0ivaQ,2950
+plotlibs/colors.py,sha256=bPSk__BeiaMNBLeuy1LD3FGBsIAMB00CBAYDIrLKLKE,3737
+plotlibs/data.py,sha256=hXAw6TOK6UY8u5Qdc5eklUVJ2l7Ss5_oaaLtu2qTz4k,6866
+plotlibs/db.py,sha256=N2z0FW6YViF5skmJ3PWFEm6xLcrodXzEfwpx6h6pCDI,7045
+plotlibs/eda.py,sha256=ZV0cFKh4A6QQOHC-pfeORpUOYtJdNMpK8-BgUl1OuKE,5555
+plotlibs/fast.py,sha256=yXXqoEo9wHsPFULkod2RArlCakQ1PAIFW5FQOB_TzDc,6723
+plotlibs/figure.py,sha256=z-KqkYdNeekFn3kQ1-JfhtzFI33vELMoMKBEa8KZru4,24306
+plotlibs/ml.py,sha256=cW3ak7sZnmz33tFx_5Q-GHBH6Mm_q-l5lAuomjZHIZ8,7686
+plotlibs/pyplot.py,sha256=4BxtADF2PI1E20_K8AY_D_c0Afq85ITPtm7thZiWmbE,5245
+plotlibs/style.py,sha256=MNzgU6Av3m0QOQI9LVbdmoo1uVFJ-APvLnUYzyLbKnQ,3238
+plotlibs/backends/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plotlibs/backends/renderer.py,sha256=diwqODGaj8mRlJEtkMIfe5DeP14xK3tx4VbkwLG5qSs,24699
+plotlibs-0.3.0.dist-info/licenses/LICENSE,sha256=hDYVKKPqNhSZ9rd347j-lmHJTI0g35WOPTYMp8SMh9Q,1069
+plotlibs-0.3.0.dist-info/METADATA,sha256=ZFmdFiUpl0ZBiOfNQH2bD79CN5cxtYNasqY3GKnyqOc,8482
+plotlibs-0.3.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+plotlibs-0.3.0.dist-info/top_level.txt,sha256=mBt47aND0JWkSkbP6-oSXSsyg3TL_GXhahCgx5Hfq7E,17
+plotlibs-0.3.0.dist-info/RECORD,,

plotlibs-0.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

plotlibs-0.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 salim-studio
+
+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.

plotlibs-0.3.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+plotlib
+plotlibs