ggh4x-python 0.3.1.9000__py3-none-any.whl

ggh4x/themes.py

@@ -0,0 +1,31 @@
+"""ggh4x theme-element registration (R source: themes.R).
+
+ggh4x extends ggplot2's theme system with the ``ggh4x.facet.nestline`` element used by
+``facet_nested`` / ``facet_nested_wrap``. (The ``ggh4x.axis.*`` nesting elements belong to
+the deprecated axis guides and are out of scope.) R registers these in ``.onLoad``; the
+Python port registers them at import time of the package.
+"""
+
+from __future__ import annotations
+
+from ggplot2_py.theme_elements import el_def, element_blank, register_theme_elements
+
+__all__ = ["register_ggh4x_theme_elements"]
+
+_REGISTERED = False
+
+
+def register_ggh4x_theme_elements() -> None:
+    """Register ggh4x's theme elements globally (idempotent), mirroring ``ggh4x_theme_elements``.
+
+    Registers ``ggh4x.facet.nestline`` as an ``ElementLine`` inheriting from ``line``, with a
+    blank default — matching ``themes.R``.
+    """
+    global _REGISTERED
+    if _REGISTERED:
+        return
+    register_theme_elements(
+        element_tree={"ggh4x.facet.nestline": el_def("ElementLine", "line")},
+        **{"ggh4x.facet.nestline": element_blank()},
+    )
+    _REGISTERED = True

ggh4x/themes_ggh4x.py

@@ -0,0 +1,67 @@
+"""ggh4x theme-element registration (port of ggh4x ``themes.R``).
+
+ggh4x extends ggplot2's theme system with a handful of extra theme elements.
+The one registered here is ``ggh4x.facet.nestline`` -- an
+:class:`~ggplot2_py.theme_elements.ElementLine` inheriting from the ``line``
+element, used as the parent for the ``nest_line`` argument of
+``facet_nested()`` / ``facet_nested_wrap()``.  It defaults to
+``element_blank()`` (nest lines are off unless a theme/facet turns them on).
+
+R source: ``ggh4x/R/themes.R`` (``ggh4x_theme_elements``).  In R the
+registration happens in ``.onLoad``; this Python port mirrors that by invoking
+:func:`ggh4x_theme_elements` at *module import time* (bottom of this file).
+
+Notes
+-----
+* The element is consumed by the **facet** subsystem (nest lines), not by the
+  strips themselves, but registration lives here to match the R file layout.
+* Registration is idempotent: :func:`register_theme_elements` merges into the
+  global element tree, so re-importing the module is harmless.
+"""
+
+from __future__ import annotations
+
+from ggplot2_py.theme_elements import (
+    ElementLine,
+    el_def,
+    element_blank,
+    register_theme_elements,
+)
+
+__all__ = ["ggh4x_theme_elements"]
+
+
+def ggh4x_theme_elements() -> None:
+    """Register ggh4x's extended theme elements globally.
+
+    Port of R ``ggh4x_theme_elements()`` (``themes.R:30-37``)::
+
+        register_theme_elements(
+          ggh4x.facet.nestline = element_blank(),
+          element_tree = list(
+            ggh4x.facet.nestline = el_def("element_line", "line")
+          )
+        )
+
+    Registers ``ggh4x.facet.nestline`` in the element tree as an
+    :class:`~ggplot2_py.theme_elements.ElementLine` that inherits from the
+    ``line`` element, with an ``element_blank()`` default.
+
+    Returns
+    -------
+    None
+        Mutates the global ggplot2 element tree / default theme in place.
+
+    Notes
+    -----
+    Idempotent -- calling it repeatedly merges the same entry and re-sets the
+    same blank default.
+    """
+    register_theme_elements(
+        element_tree={"ggh4x.facet.nestline": el_def(ElementLine, "line")},
+        **{"ggh4x.facet.nestline": element_blank()},
+    )
+
+
+# R registers in .onLoad; mirror that by registering at import time.
+ggh4x_theme_elements()

ggh4x_python-0.3.1.9000.dist-info/METADATA

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: ggh4x-python
+Version: 0.3.1.9000
+Summary: Python port of the R ggh4x package
+Project-URL: Homepage, https://github.com/Bio-Babel/ggh4x-python
+Project-URL: Issues, https://github.com/Bio-Babel/ggh4x-python/issues
+Author-email: Jeffery Liu <jeffliu.lucky@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: ggplot2-python>=4.0.2
+Requires-Dist: gtable-python>=0.3.6
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: patchwork-python>=1.3.2
+Requires-Dist: rgrid-python>=4.5.3
+Requires-Dist: scales-python>=1.4.0
+Requires-Dist: scipy>=1.10
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs; extra == 'docs'
+Requires-Dist: mkdocs-jupyter; extra == 'docs'
+Requires-Dist: mkdocs-material; extra == 'docs'
+Requires-Dist: mkdocstrings[python]; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# ggh4x-python
+
+[![PyPI](https://img.shields.io/pypi/v/ggh4x-python)](https://pypi.org/project/ggh4x-python/)
+
+Python version of the R **ggh4x** package.
+
+## Installation
+
+```bash
+pip install ggh4x-python
+```

ggh4x_python-0.3.1.9000.dist-info/RECORD

@@ -0,0 +1,64 @@
+ggh4x/__init__.py,sha256=Y1fiEI6WfgtjScb2EgubMkBDEpVCfaz9dPr9fOJUMIc,5353
+ggh4x/_aimed_text_grob.py,sha256=XGUYmg8MM9ebIjkaleLnM5V0w1CxMptcaZsi9zpgsWU,14347
+ggh4x/_borrowed_ggplot2.py,sha256=23N4wwWhBJM7sa6o861bg9IBBTQkSF51D1ibi50bX24,8606
+ggh4x/_cli.py,sha256=2Z1AMXE8kV8j8UlXHLpj9koayLpYhColg8GPWtuDkEI,2440
+ggh4x/_datasets.py,sha256=ol3BrpcxVulbNFBpBq-sCFXKHWe57WdkOrSFNgg2o08,2895
+ggh4x/_download.py,sha256=SP0CfMcEieyM-RDmFjD_AvL2e6o27BaGJpcMHPPLGog,3317
+ggh4x/_facet_helpers.py,sha256=fUKce3ojKODOLBjzUDZGugayGDJIKdbwaUmbl5EK8Vw,11121
+ggh4x/_facet_utils.py,sha256=iBSKmdlSDppF49SQbQx080XFGM_nLefSTZD8aeTQt8c,23313
+ggh4x/_gap_grobs.py,sha256=wYHkrzvsMNI0kLwdevc_DFqwNZbg2rsJ_6g2nCjvLs0,19443
+ggh4x/_registry.py,sha256=AzmW8r7vG2Id5N-BZIFZ5t87ch5kFHF7K-nCzeJK89c,262
+ggh4x/_rlang.py,sha256=KcDQuEx1Sgi7IW5YcZJ6C3Y5RAy7bJsrlyl2lHnZ7XA,2273
+ggh4x/_utils.py,sha256=-96sIq3NmqpVOVUNTx_CcoEXbBhze-zKysdp-m8b-Fg,4208
+ggh4x/_vctrs.py,sha256=C7r_YIJIh_04qqJ6yAh-WAqiIJD_VEyzcyPAYlf6jT0,6322
+ggh4x/conveniences.py,sha256=fdcWL5Pc9AMTYg0_PYstoZkOFSU-UwS2Yk-462CQeus,19744
+ggh4x/coord_axes_inside.py,sha256=DNyhPzw4XLRvqfbfMT85TYstBF4QBUvrsMlNIUPWlBg,14212
+ggh4x/element_part_rect.py,sha256=H1GrUuo_2RI1kJww63jYe33qfWkd90j5IIntL02juQU,18167
+ggh4x/facet_grid2.py,sha256=2PUWTsHQtf18-N6AcJzzQxb-szZpxreqtk9NJxKOYWU,35929
+ggh4x/facet_manual.py,sha256=Jf_UL-9GdXwE44vKu45aCze4w4H8XeFwequUbnnVZT8,34060
+ggh4x/facet_nested.py,sha256=p-HAW8oHglFOv9SetQ-lcieB8Zb4VhOz_v-WRNsu9rs,29787
+ggh4x/facet_nested_wrap.py,sha256=BHiALrC2XoEP-uSx3WCMgl-pBh-FAPZ57UfeaIDBNyE,6256
+ggh4x/facet_wrap2.py,sha256=HH2Qw9B9-6acFLWAUDLMH_EcmDJ0P8QAiNYqklkM2T0,30572
+ggh4x/geom_box.py,sha256=qzGkRsTTH7JiNeUP2qCkVxvG1_UeowruWfcFqYOQZMg,18489
+ggh4x/geom_outline_point.py,sha256=wJDhSt1M8EQxjXABImkw1seqyD48ZyX-6OethVd0s90,13441
+ggh4x/geom_pointpath.py,sha256=t5lXX6YS-mO5Uhc9MTDpsodyySDDOg9rhSohGVGiNvc,8599
+ggh4x/geom_polygonraster.py,sha256=kUWUBSAPGzHRK0mn6RAbOhu0mJJCuI-Azs0Eum9u0zA,8014
+ggh4x/geom_rectrug.py,sha256=h3J825FShRZ-F46eZOz71GuMWwywo0qOdgEB_H_orHk,15580
+ggh4x/geom_text_aimed.py,sha256=xG5LCPJJ7mrtL3CDVsEp43GXk1Q2Pzyurk3GsqNFN7c,9449
+ggh4x/guide_stringlegend.py,sha256=ZKYMXgZ2q1vT24lrhwv4HCXhLPM4vXFHIjgCiPOX3DQ,12726
+ggh4x/help_secondary.py,sha256=8khb5tceYw8LdRIzSmd_Uie7wiqa8c0cj1F4TJiwffo,18696
+ggh4x/position_disjoint_ranges.py,sha256=ZZB1ddUcqs8xUu3YleJwK5U3P2Q1vSZzBaBEIAptWl4,8969
+ggh4x/position_lineartrans.py,sha256=XjTpIgRolEZDow6fJz2o2mHBNBOmEGrWvzdxy7LiZbg,8876
+ggh4x/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ggh4x/save.py,sha256=CmacFLPyFkBBIe543I-hQTzgoHIsG4aEiftIN4oXHCc,8562
+ggh4x/stat_difference.py,sha256=kzYOfxYC0ayF4So3giiysX4uD8n5oMXSolOWC6cB2iY,14546
+ggh4x/stat_funxy.py,sha256=J8UzSx5tMBgyMq1T11l2J57jYGcrjoLUUdQAxaZS6pk,13915
+ggh4x/stat_rle.py,sha256=GwGu-FRKakSTsdVwWb-wMzqAO2g5jw0XcEHPCxxLrQI,9927
+ggh4x/stat_rollingkernel.py,sha256=plMooVXH187XgpJX6Oyof_ha8PMvE_902zcT9MrmOVA,12142
+ggh4x/stat_theodensity.py,sha256=lQmAPK5bLUphFJlRgb78cqJg3FsgV1Z0XZH78iJRJYY,22468
+ggh4x/strip_nested.py,sha256=SOJooxzYIoxCPd3DiAcR7ShVgia1dtmzE-EfBjome9c,15454
+ggh4x/strip_split.py,sha256=Hong7sEyQZLUdIc_K1YArcup-l1eR9knkhnDJ0Ro0U0,24323
+ggh4x/strip_tag.py,sha256=cUC5jtMrYGMfcWCbYJeDEO9gNaBEsF4w9gPM6q5pe4k,22766
+ggh4x/strip_themed.py,sha256=Yxss2DJSLbz-B61Ufk0AQB-e3Vo5QzvHF2gGTniIivw,9350
+ggh4x/strip_vanilla.py,sha256=6zwTTmUZLOmi7qqW70qkHqDkq6kWnhbT5t5SrpOjNHw,49716
+ggh4x/themes.py,sha256=3Swd7_ttaj4Au9lEkFNcTNDX-l1q7h_EuiLn1-MJsKo,1115
+ggh4x/themes_ggh4x.py,sha256=Egk-lt4IE3SJRrzlJPRZG2-RJQCeVrFZNMVYRE3_LE4,2271
+ggh4x/multiscale/__init__.py,sha256=5FSxe4kljjS4BLwpVICoAhsZPysLcrpgi1Q5VsQCeCs,1831
+ggh4x/multiscale/_multiscale_add.py,sha256=p91h4E4jRYHj-J4x0merpL8BI5gwh90pnwzVanzomY4,8436
+ggh4x/multiscale/scale_listed.py,sha256=6EEmFnOBLtSRz0k2huNNfM7AGjkKOJqnJXnLh_E6NE0,6477
+ggh4x/multiscale/scale_manual.py,sha256=0Ea8pIBcmV08RpnDnu1-4_mqAyajEEPGwc-mIGleYGg,17418
+ggh4x/multiscale/scale_multi.py,sha256=iT1F8YcWHiqS1Tb7TIMS5K2XaHPR3ZHf5d2ijLqDxXg,13799
+ggh4x/panel_scales/__init__.py,sha256=TatdWJ33rWcETtCJkmP39z-4eyU8Uipyn3BIRhD2G_k,1999
+ggh4x/panel_scales/at_panel.py,sha256=WKv9985uVdbIovr0QIDkVC4IPHnIqvAhyMXUaDH4rGs,3644
+ggh4x/panel_scales/facetted_pos_scales.py,sha256=6pK3BqABaAK8JqegLftx1BHkMtEhbeUJoj2aMyuViUw,21997
+ggh4x/panel_scales/force_panelsize.py,sha256=Q6T56ZntUMFX179VyewoekLcit_o96_U2awv0xRedXo,15204
+ggh4x/panel_scales/scale_facet.py,sha256=6IrmUMDE16uN_J6CUu7NwfehCOMUvnfjqdkW--Q9SVY,7194
+ggh4x/resources/faithful.csv,sha256=LanvZyMat1QtLsPlp0Go1TrakqJBAxlc59H5uONqmG0,2275
+ggh4x/resources/iris.csv,sha256=1EDa3tGGNMHaLwXmsaMDhfKsps04RVsx0mPhZXJgESo,4026
+ggh4x/resources/mtcars.csv,sha256=Q5ujNcPSjdDBhx91vf-zidWjsjz3AydVZnABQMlSOuU,1783
+ggh4x/resources/pressure.csv,sha256=ZgsBAvBiLG-tltSQp7QohOzCesENOXEMUz874MymAps,183
+ggh4x/resources/volcano.csv,sha256=OqjcDHc-bIN4h46r-AONCxBEDIb_Cuy6Q_BhDMJbSvo,20810
+ggh4x_python-0.3.1.9000.dist-info/METADATA,sha256=kcGJvRj7D54W986wLT1ptacKG2BlMpXmd4NB9qn0XxM,1219
+ggh4x_python-0.3.1.9000.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+ggh4x_python-0.3.1.9000.dist-info/licenses/LICENSE,sha256=E0GJjw07cYRmJYj_8UZKbhevWQ-Swd3nVR6qBddvz9c,39
+ggh4x_python-0.3.1.9000.dist-info/RECORD,,

ggh4x_python-0.3.1.9000.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

ggh4x_python-0.3.1.9000.dist-info/licenses/LICENSE

@@ -0,0 +1,3 @@
+# MIT
+
+See DESCRIPTION from R package.