update changelog, comment, docs

Hide the inherttited members for mixins

Author: exrhizo

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to the PyGraphistry are documented in this file. The PyGraph
 The changelog format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) and all PyGraphistry-specific breaking changes are explictly noted here.
 
+## Dev
+
+### Breaking
+* Plottable is now a Protocol
+* py.typed added, type checking active on PyGraphistry!
+
 ## [0.38.0 - 2025-06-17]
 
 ### Changed

docs/source/api/ai.rst

@@ -58,5 +58,4 @@ HeterographEmbedModuleMixin
 .. automodule:: graphistry.embed_utils
     :members:
     :undoc-members:
-    :inherited-members:
     :show-inheritance:

docs/source/api/compute.rst

@@ -6,7 +6,6 @@ ComputeMixin module
 .. automodule:: graphistry.compute.ComputeMixin
    :members:
    :undoc-members:
-   :inherited-members:
    :show-inheritance:
 
 Collapse

docs/source/api/layout/index.rst

@@ -38,5 +38,4 @@ LayoutsMixin
 .. automodule:: graphistry.layouts.LayoutsMixin
    :members:
    :undoc-members:
-   :inherited-members:
    :show-inheritance:

docs/source/api/plotter.rst

@@ -26,3 +26,12 @@ PlotterBase Class
    :undoc-members:
    :inherited-members:
    :show-inheritance:
+
+
+Plottable Interface
+----------------------
+.. automodule:: graphistry.Plottable
+   :members:
+   :undoc-members:
+   :inherited-members:
+   :show-inheritance:

docs/source/api/plugins/compute/cugraph.rst

@@ -9,7 +9,6 @@ cuGraph is a GPU-accelerated graph library that leverages the Nvidia RAPIDS ecos
 .. automodule:: graphistry.plugins.cugraph
    :members:
    :undoc-members:
-   :inherited-members:
    :show-inheritance:
 
 .. rubric:: Constants

docs/source/api/plugins/compute/graphviz.rst

@@ -9,7 +9,6 @@ graphviz is a popular graph visualization library that PyGraphistry can interfac
 .. automodule:: graphistry.plugins.graphviz
    :members:
    :undoc-members:
-   :inherited-members:
    :show-inheritance:
 
 .. rubric:: Constants

docs/source/api/plugins/compute/igraph.rst

@@ -9,7 +9,6 @@ igraph is a popular graph library that PyGraphistry can interface with. This all
 .. automodule:: graphistry.plugins.igraph
    :members:
    :undoc-members:
-   :inherited-members:
    :show-inheritance:
 
 .. rubric:: Constants

docs/source/api/plugins/db/cosmos.rst

@@ -10,5 +10,4 @@ Azure Cosmos DB supports Gremlin graph queries
 .. autoclass:: graphistry.gremlin.CosmosMixin
    :members:
    :undoc-members:
-   :inherited-members:
    :show-inheritance:

docs/source/api/plugins/db/gremlin.rst

@@ -12,5 +12,4 @@ As an open source technology, multiple databases support it.
 .. autoclass:: graphistry.gremlin.GremlinMixin
    :members:
    :undoc-members:
-   :inherited-members:
    :show-inheritance:

docs/source/api/plugins/db/neptune.rst

@@ -10,5 +10,4 @@ Amazon Neptune is a managed graph database by Amazon. It supports OpenCypher, RD
 .. autoclass:: graphistry.gremlin.NeptuneMixin
    :members:
    :undoc-members:
-   :inherited-members:
    :show-inheritance:

graphistry/feature_utils.py

@@ -2811,7 +2811,8 @@ def featurize_or_get_nodes_dataframe_if_X_is_None(
 
         if reuse_if_existing and res._node_features is not None:
             logger.info('-Reusing Existing Node Featurization')
-            # NOTE: Wasn't sure if " res._node_target is not None" ought to have been a condition for this code path
+            # NOTE: Perhaps for these df.empty stubs, we need len(y.index) == len(X.index)
+            #       even if no columns, downstream code could be confused on shape mismatch
             node_target = res._node_target if res._node_target is not None else pd.DataFrame()
             return res._node_features, node_target, res