Refactor: make rc_ultraplot and rc_matplotlib internal

docs/basics.py

@@ -477,7 +477,7 @@
 # <https://matplotlib.org/stable/tutorials/introductory/customizing.html>`__ and
 # :ref:`ultraplot settings <ug_rcUltraPlot>`. The matplotlib-specific settings are
 # stored in :func:`~ultraplot.config.rc_matplotlib` (our name for :data:`~matplotlib.rcParams`) and
-# the UltraPlot-specific settings are stored in :class:`~ultraplot.config.rc_ultraplot`.
+# the UltraPlot-specific settings are stored in :class:`~ultraplot.config.rc.rc_ultraplot`.
 # UltraPlot also includes a :rcraw:`style` setting that can be used to
 # switch between `matplotlib stylesheets
 # <https://matplotlib.org/stable/gallery/style_sheets/style_sheets_reference.html>`__.

docs/configuration.rst

@@ -14,10 +14,10 @@ A dictionary-like object named :obj:`~ultraplot.config.rc`, belonging to the
 :class:`~ultraplot.config.Configurator` class, is created when you import UltraPlot.
 This is your one-stop shop for working with
 `matplotlib settings <ug_rcmpl_>`_
-stored in :obj:`~ultraplot.config.rc_matplotlib`
+stored in :obj:`~ultraplot.config.rc.rc_matplotlib`
 (our name for the :obj:`~matplotlib.rcParams` dictionary)
 and :ref:`ultraplot settings <ug_rcUltraPlot>`
-stored in :obj:`~ultraplot.config.rc_ultraplot`.
+stored in :obj:`~ultraplot.config.rc.rc_ultraplot`.
 
 To change global settings on-the-fly, simply update :obj:`~ultraplot.config.rc`
 using either dot notation or as you would any other dictionary:
@@ -73,7 +73,7 @@ Matplotlib settings
 
 Matplotlib settings are natively stored in the :obj:`~matplotlib.rcParams`
 dictionary. UltraPlot makes this dictionary available in the top-level namespace as
-:obj:`~ultraplot.config.rc_matplotlib`. All matplotlib settings can also be changed with
+:obj:`~ultraplot.config.rc.rc_matplotlib`. All matplotlib settings can also be changed with
 :obj:`~ultraplot.config.rc`. Details on the matplotlib settings can be found on
 `this page <ug_rcmpl_>`_.
 
@@ -82,9 +82,9 @@ dictionary. UltraPlot makes this dictionary available in the top-level namespace
 UltraPlot settings
 ----------------
 
-UltraPlot settings are natively stored in the :obj:`~ultraplot.config.rc_ultraplot` dictionary.
+UltraPlot settings are natively stored in the :obj:`~ultraplot.config.rc.rc_ultraplot` dictionary.
 They should almost always be changed with :obj:`~ultraplot.config.rc` rather than
-:obj:`~ultraplot.config.rc_ultraplot` to ensure that :ref:`meta-settings <ug_rcmeta>` are
+:obj:`~ultraplot.config.rc.rc_ultraplot` to ensure that :ref:`meta-settings <ug_rcmeta>` are
 synced. These settings are not found in :obj:`~matplotlib.rcParams` -- they either
 control UltraPlot-managed features (e.g., a-b-c labels and geographic gridlines)
 or they represent existing matplotlib settings with more clear or succinct names.
@@ -119,7 +119,7 @@ Meta-settings
 Some UltraPlot settings may be more accurately described as "meta-settings",
 as they change several matplotlib and UltraPlot settings at once (note that settings
 are only synced when they are changed on the :obj:`~ultraplot.config.rc` object rather than
-the :obj:`~ultraplot.config.rc_UltraPlot` and :obj:`~ultraplot.config.rc_matplotlib` dictionaries).
+the :obj:`~ultraplot.config.rc.rc_ultraplot` and :obj:`~ultraplot.config.rc.rc_matplotlib` dictionaries).
 Here's a broad overview of the "meta-settings":
 
 * Setting :rcraw:`font.small` (or, equivalently, :rcraw:`fontsmall`) changes

docs/why.rst

@@ -815,8 +815,8 @@ Acceptable units include inches, centimeters, millimeters,
 pixels, `points <https://en.wikipedia.org/wiki/Point_(typography)>`__, and `picas
 <https://en.wikipedia.org/wiki/Pica_(typography)>`__ (a table of acceptable
 units is found :ref:`here <units_table>`). Note the :func:`~ultraplot.utils.units` engine
-also translates rc settings assigned to :func:`~ultraplot.config.rc_matplotlib` and
-:obj:`~ultraplot.config.rc_UltraPlot`, e.g. :rcraw:`subplots.refwidth`,
+also translates rc settings assigned to :func:`~ultraplot.config.rc.rc_matplotlib` and
+:obj:`~ultraplot.config.rc.rc_ultraplot`, e.g. :rcraw:`subplots.refwidth`,
 :rcraw:`legend.columnspacing`, and :rcraw:`axes.labelpad`.
 
 Links
@@ -848,8 +848,8 @@ Changes
 -------
 
 In UltraPlot, you can use the :obj:`~ultraplot.config.rc` object to change both native
-matplotlib settings (found in :obj:`~ultraplot.config.rc_matplotlib`) and added UltraPlot
-settings (found in :obj:`~ultraplot.config.rc_UltraPlot`). Assigned settings are always
+matplotlib settings (found in :obj:`~ultraplot.config.rc.rc_matplotlib`) and added UltraPlot
+settings (found in :obj:`~ultraplot.config.rc.rc_ultraplot`). Assigned settings are always
 validated, and "meta" settings like ``meta.edgecolor``, ``meta.linewidth``, and
 ``font.smallsize`` can be used to update many settings all at once. Settings can
 be changed with ``uplt.rc.key = value``, ``uplt.rc[key] = value``,

ultraplot/__init__.py

@@ -98,18 +98,9 @@
 
 # Validate color names now that colors are registered
 # NOTE: This updates all settings with 'color' in name (harmless if it's not a color)
-from .config import rc_ultraplot, rc_matplotlib
-
 rcsetup.VALIDATE_REGISTERED_COLORS = True
-for _src in (rc_ultraplot, rc_matplotlib):
-    for _key in _src:  # loop through unsynced properties
-        if "color" not in _key:
-            continue
-        try:
-            _src[_key] = _src[_key]
-        except ValueError as err:
-            warnings._warn_ultraplot(f"Invalid user rc file setting: {err}")
-            _src[_key] = "black"  # fill value
+rc.sync()  # triggers validation
+
 from .colors import _cmap_database as colormaps
 from .utils import check_for_update