All notable changes to the PyGraphistry are documented in this file. The PyGraphistry client and other Graphistry components are tracked in the main Graphistry major release history documentation.

The changelog format is based on Keep a Changelog. This project adheres to Semantic Versioning and all PyGraphistry-specific breaking changes are explictly noted here.

• compute_igraph()
• layout_igraph()
• scene_settings()

• from_igraph uses g._node instead of 'name' in more cases

• g.from_igraph(ig) will use IDs (ex: strings) for src/dst values instead of igraph indexes

Major version bump due to breaking igraph change

• igraph handlers: graphistry.from_igraph, g.from_igraph, g.to_igraph
• docs: README.md examples of using new igraph methods

• Deprecation warnings in old igraph methods: g.graph(ig), igraph2pandas, pandas2igraph
• Internal igraph handlers upgraded to use new igraph methods

• network2igraph and igraph2pandas renamed output node ID column to _n_implicit (constants.NODE)

• Expose symbols for .chain() predicates as top-level: previous ast export was incorrect

Major version bump due to large dependency increases for kitchen-sink installs and overall sizeable new feature

• Use buildkit with pip install caching for test dockerfiles
• Graph AI branch: Autoencoding via dirty_cat and sentence_transformers (g.featurize())
• Graph AI branch: UMAP via umap_learn (g.umap())
• Graph AI branch: GNNs via DGL (g.build_dgl_graph())
• g.reset_caches() to clear upload and compute caches (last 100)
• Central setup_logger()
• Official Python 3.10 support

• Logging: Refactor to setup_logger(__name__)

• hypergraph: use default logger instead of DEBUG

• `g.collapse(node='root_id', column='some_col', attribute='some_val')

• Avoid runtime import exn when on GPU-less systems with cudf/dask_cudf installed

• Docs: readme.md digest of compute methods

• Docs: get_degree() -> get_degrees() (graphistry#330)
• Upload memoization handles column renames (graphistry#326)

• g.edges() now takes an optional 4th named parameter edge ID

Code that looks like g.edges(some_fn, None, None, some_arg) should now be like g.edges(some_fn, None, None, None, some_arg)

• Similar new optional edge ID parameter in g.bind()

• g.hop() now takes optional return_as_wave_front=False, primarily for internal use by chain()

• g.chain([...]) with graphistry.ast.{n, e_forward, e_reverse, e_undirected}

• Node dictionary-based filtering: g.filter_nodes_by_dict({"some": "value", "another": 2})
• Edge dictionary-based filtering: g.filter_edges_by_dict({"some": "value", "another": 2})
• Hops support edge filtering: g.hop(hops=2, edge_match={"type": "transaction"})
• Hops support pre-node filtering: g.hop(hops=2, source_node_match={"type": "account"})
• Hops support post-node filtering: g.hop(hops=2, destination_node_match={"type": "wallet"})
• Hops defaults to full graph if no initial nodes specified: g.hop(hops=2, edge_match={"type": "transaction"})

• Horizontal and radial axis using .encode_axis(rows=[...])

• Docs: Work around sphinx-doc/sphinx#10291

• Better implementation of .tree_layout(...) using Sugiyama; good for small/medium DAGs
• Layout rotation method .rotate(degree)
• Compute method .hops(nodes, hops, to_fixed_point, direction)

• Infra: test-cpu-local-minimum.sh accepts params

• Docs: Point color encodings

• Unpin Networkx

• Docs: Removed deprecated api=1, api=2 registration calls (#280 by @pradkrish)
• Docs: Fixed bug in honeypot nb (#279 by @pradkrish)
• Tests: Networkx test version sniffing

• Databricks notebook connector (PR)
• Databricks notebook + dashboard example (PR, ipynb)

• Docs: umap_learn tutorial notebook

• Docs: Sharing control demos/more_examples/graphistry_features/sharing_tutorial.ipynb

• Feature: global graphistry.privacy() and compositional Plotter.privacy()
• Docs: How to use privacy()

• Docs: Start removing deprecated 1.0 API docs

• Fix: NetworkX 2.5+ support - accept minor version tags

• Fix: igraph .plot() arrow coercion syntax error (graphistry#257)
• Fix: Lint duplicate import warning

• CI: Treat lint warnings as CI failures

• Infra: Add CI stage that installs and tests with minimal core deps (graphistry#254)

• Fix: Core tests pass with minimal install dependencies (graphistry#253, graphistry#254)

• Feature: Compute methods materialize_nodes, get_degrees, drop_nodes, get_topological_levels
• Feature: Layout methods tree_layout, layout_settings
• Docs: New compute and layout methods

• Feature: g.fetch_edges() for neptune/gremlin edge attributes

• Fix: g.fetch_nodes() for neptune/gremlin node attrbutes

• Docs: demos/demos_databases_apis/neptune/neptune_tutorial.ipynb

• Docs: Updated demos/for_analysis.ipynb to api=3

• Fix: Gremlin (Neptune) connector deduplicates nodes/edges

• Feature: Gremlin connector (GraphSONSerializersV2d0)
• Feature: Cosmos connector
• Feature: Neptune connector
• Feature: Chained composition operators:
  • g.pipe((lambda g, a1, ...: g2), a1, ...)
  • g.edges((lambda g, a1, ...: df), None, None, a1, ...)
  • g.nodes((lambda g, a1, ...: df), None, a1, ...)
• Feature: plotter::infer_labels: Guess node label names when not set, instead of defaulting to node_id. Runs during plots.
• Infra: Jupyter notebook: cd docker && docker-compose build jupyter && docker-compose up jupyter
• Docs: Neptune, Cosmos, chained composition

• Refactor: Split out PlotterBase, interface Plottable

• Fix: Plotter has hypergraph()

• Docs: security.md

• Hypergraphs - detect and handle mismatching types across partitions

• Infra: Speedup testing containers via incrementalization and docker settings
• Infra: Update testing container base builds

• Feature: Hypergraphs in dask, dask_cudf modes. Mixed nan support. (graphistry#225)
• Feature: Dask/dask_cuda frames can be passed in, which will be .computed(), memoized, and converted to arrow (graphistry#225)
• Infra: Test env var controls - WITH_LINT=1, WITH_TYPECHECK=1, WITH_BUILD=1 (graphistry#225)
• Docs: Inline hypergraph examples (graphistry#225)

• CI: Disable seccomp during test (docker perf) (graphistry#225)

• Feature: cudf mode for hypergraph (graphistry#224)
• Feature: pandas mode for hypergraph uses all-vectorized operations (graphistry#224)
• Infra: Engine class for picking dataframe engine - pandas/cudf/dask/dask_cudf (graphistry#224)
• CI: mypy type checking (graphistry#222)
• CI: GPU test harness (graphistry#223)

• Hypergraph: Uses new pandas/cudf implementations (graphistry#224)

• Infra: Issue templates for bugs and feature requests

• Docs: Overhaul Sphinx docs - Update, clean all warnings, add to CI, reject commits that fail
• Docs: Setup.py (pypi) now includes full README.md
• Docs: Added ARCHITECTURE, CONTRIBUTE, and expanded DEVELOP
• Garden: DRY for CI + local dev via shared bin/ scripts
• Docker: Downgrade local dev 3.7 -> 3.6 to more quickly catch minimum version errors
• CI: Now tests building docs (fail on warnings), pypi wheels distro, and neo4j connector

• Changes in setup.py extras_require: 'all' installs more

• Docs: ARCHITECTURE.md and CONTRIBUTE.md

• Quieted memoization fail warning
• CI: Removed TravisCI in favor of GHA
• CD: GHA now handles PyPI publish on tag push
• Docs: Readme install clarifies Python 3.6+
• Docs: Update DEVELOP.md dev flow

• Friendlier error message for calling .cypher(...) without setting BOLT auth/driver (graphistry#204)
• CI: Run containerized neo4j connector tests
• Infrastructure: Set Python 3.9 support metadata

• Memoization: When memoize hashes throw exceptions, emit warning and fallback to unmemoized (b7a25c74e)

• Friendlier error message for api=1, 2 server non-json responses (graphistry#187)
• CI: Moved to GitHub Actions for CI + optional manual publish
• CI: Added Python 3.9 to test matrix
• Infrastructure: Upgraded Versioneer to 0.19
• Infrastructure: Fewer warnings and enforce flake8 CI checks

• None known; many small changes to fix warnings so version bump out of caution

• File API: Enable via .plot(as_files=True). By default, auto-skips file re-uploads (disable via .plot(memoize=False)) for tables with same hash as those already uploaded in the same session. Use with .register(api=3) clients on Graphistry 2.34+ servers. More details at (graphistry#195) .
• Dev: More docs and logging as part of graphistry#195
• Auth service account docs in README.md (12.2.2020)

• Examples for icons, badges, and new node/edge bindings
• graph-app-kit links
• Slack link

• Python test matrix: Removed 3.9
• Propagate misformatted etl1/2 server errors

• Warnings: Standardizing on Python's warnings.warn

• Neo4j: Improve handling of empty query results (graphistry#178)

• Icons: Add new as_text, blend_mode, border, and style options (Graphistry 2.32+)
• Badges: Add new badge encodings (Graphistry 2.32.+)
• Python 3.8, 3.9 in test matrix
• New binding shortcuts g.nodes(df, col) and g.nodes(df, src_col, dst_col)

• Python 2.7: Removed future (Python 2.7 has already been EOL so not breaking)
• Redid ipython detection
• Imports: Refactoring for more expected style
• Testing: Fixed most warnings in preperation for treating them as errors
• Testing: Integration tests against self-contained neo4j instance

• Chainable methods .addStyle() and .style() in api=3 for controlling foreground, background, logo, and page metadata. Requires Graphistry 2.31.10+ 08eddb8
• Chainable methods .encode_[point|edge]_[color|icon|size]() for more powerful complex encodings, and underlying generic handler __encode(). Requires Graphistry 2.31.10+ f370ca8
• More usage examples in README.md

• Split ArrowLoader::*encoding*methods to *binding* vs. *encoding* ones to more precisely reflect the protocol. Not considered breaking as an internal method.

• Neo4j 4 temporal and spatial type support - #172
• CHANGELOG.md

• Removed deprecated docker test harness in favor of docker/ - #172