Metadata-Version: 2.4
Name: ggrepel-python
Version: 0.9.8.9999
Summary: Python port of the R ggrepel package: non-overlapping text/label layout for ggplot2_py (tracks R ggrepel 0.9.8.9999)
Keywords: ggrepel,ggplot2,label-layout,text-repel,R-port,visualization
Author-Email: Jeffery Liu <jeffliu.lucky@gmail.com>
License-Expression: GPL-3.0-or-later
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: C++
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Typing :: Typed
Project-URL: Homepage, https://github.com/Bio-Babel/ggrepel-python
Project-URL: Repository, https://github.com/Bio-Babel/ggrepel-python
Project-URL: Issues, https://github.com/Bio-Babel/ggrepel-python/issues
Project-URL: Documentation, https://github.com/Bio-Babel/ggrepel-python#readme
Requires-Python: >=3.10
Requires-Dist: numpy>=1.24
Requires-Dist: pandas>=2.0
Requires-Dist: ggplot2-python>=4.0.2
Requires-Dist: scales-python>=1.4.0
Requires-Dist: rgrid-python>=4.5.3
Requires-Dist: gtable-python>=0.3.6
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs; extra == "docs"
Requires-Dist: mkdocstrings[python]; extra == "docs"
Requires-Dist: mkdocs-material; extra == "docs"
Requires-Dist: mkdocs-jupyter; extra == "docs"
Description-Content-Type: text/markdown

# ggrepel_py

Python port of the R **ggrepel** package (tracks R ggrepel 0.9.8.9999).

## Installation

```bash
pip install ggrepel-python
```

## Tutorials

- [Getting Started](tutorials/ggrepel.ipynb) — `geom_text_repel()` / `geom_label_repel()` basics, mirrors R's `vignettes/ggrepel.Rmd`
- [Examples (vol. 1)](tutorials/examples_v1.ipynb) — additional scenarios from the R reference
- [Examples (vol. 2)](tutorials/examples_v2.ipynb) — hiding labels, always-show overlaps, disabling point/panel-edge repulsion, nudging, segment styling, curves, arrows


## Documentation

```bash
pip install -e ".[docs]"
mkdocs serve
```
