Release notes for v2.31.24

Highlights

• Core:
  • graph-app-kit: Setup for Tinkerpop Gremlin / AWS Neptune and RAPIDS
  • legend: Auto-enables if nodes have property 'type' 
  • label styling: Labels now default to 7 semi-transparent background ones
  • fail fast: Several methods around upload and page load now fail fast vs. tolerate, providing more predictability such as when uploading invalid configurations
• API:
  • Page branding & style: Customize page properties, logo, background, & blending
  • Complex encodings: REST and Python APIs for advanced colors, icons, and sizes
  • PyGraphistry auth: username/password auto-refreshes JWT token by default
  • PyGraphistry Neo4j 4: Native support for neo4j.time and neo4j.spatial types
• Infrastructure: Print version in browser console on start
• Administration:
• Documentation:
  • PyGraphistry: Started publishing CHANGELOG.md
• Fixes & Tweaks! 
  • Non-first pivot template URL parameters 
  • Null column handling
  • Repeated graph.html URL parameters
  • Faster graph load: In general and in the presence of invalid encodings
  • Empty graphs: Edges are no longer required

Graphistry Versions

Server	2.31.24
JS React+Vanilla	3.7.1
Python PyGraphistry client	0.11.7 -> 0.13.0

Third-Party Versions

BlazingSQL	0.14
Caddy	1.0.3
CUDA (In-Docker)	10.0
Django	3.0
Docker (CE)	19.03.2
Docker Compose	1.24.1
Elasticsearch node driver	14.2.2
Gremlinpython	3.4.8
Jupyter	1.0.0
Neo4j-python-driver	4.1.0
NodeJS	14.1
Pandas	0.25.3
Postgres	12.3
Python	3.7.7
Neo4j node driver	4.1.1
Notebook	6.1.1
RAPIDS	0.14.1
Arrow	0.15.0
Splunk node SDK	1.9.0
Tornado	5.1.1

Summary

New Features

• Complex encodings:
  • via REST API: `node_encodings: { complex: { default: { pointColorEncoding: ... } }}`
  • via PyGraphistry (api=3): `g.encode_point_color('my_column', ...)`
• Custom page properties:
  • via REST API: `metadata: { page: { ?title: str, ?favicon: str } }`
  • via URL API: pageTitle, favicon
  • via PyGraphistry: addStyle(page={ ?title: str, ?favicon: str })
• Custom logo: 
  • via REST API:
    `metadata: { logo: {
        url, ?autoInvert = true | false, ?position='top' | 'bottom',
        ?dimensions: { ?maxWidth: int, ?maxHeight: int },
        ?crop: { ?top: int, ?left: int, ?right: int, ?bottom: int }, //requires dimensions
        ?padding: { ?top: int, ?left: int, ?right: int, ?bottom: int },
        ?style: { ?brightness: number, ?contrast: number, ?grayscale: number, ?hueRotate: int, ?opacity: number, ?saturate: number, }
    }}`
  • via url API: logoUrl, logoAutoInvert, logoPosition, logoMaxHeight, logoMaxWidth, logoCropTop, logoCropLeft, logoCropBottom, logoCropRight, logoPaddingTop, logoPaddingLeft, logoPaddingBottom, logoPaddingRight, logoBrightness, logoContrast, logoGrayscale, logoHueRotate, logoOpacity, logoSaturate
  • via PyGraphistry (api=3): addStyle(logo={...})
• Custom background: 
  • via REST API:
    `metadata: { bg: {
        ?color,
        ?image: { ?url: str, ?width: str | int, ?height: ?str | int, ?blendMode: str },
        ?gradient { kind: 'linear' | 'radial', ?position: int | str, stops: [ ['rgba(int,int,int, float)', 'x%']* ] }
    }}`
  • via URL API: bgImageBlendMode, bgImageUrl, bgImageWidth, bgImageHeight, bgGradientKind, bgGradientPosition, bgGradientStops, fgBlendMode
  • via PyGraphistry: addStyle(bg={...})
• Custom foreground:
  • via REST API: `metadata: { fg: { blendMode: str } }`
  • via URL API: `fgBlendMode`
  • via PyGraphistry: addStyle(fg={'blendMode': str})
        

Docs

• PyGraphistry now includes a CHANGELOG.md
• API docs for complex encodings,  page properties, logo, background, and foreground

Fixes & Tweaks 

• Template URL parameters
  • Skip excess quoting on non-data-entry pivots
  • Support custom params for non-consecutive pivots (was unreliable when used for more than the typical case of the first pivot)
• Core
  • Null columns: Work around RAPIDS bug for supporting columns that are a mix of None types and empty strings
  • Faster page load: In general, and when configured encodings are invalid
  • Fail fast: Several methods around upload and page load now fail fast vs. tolerate, providing more predictability such as when uploading invalid configurations
  • Crash: Prevent crash on page resize before first mouseover
• Graph URL repeated parameters
  • Switched to first-instance-wins (vs non-deterministic / crash) for previously undefined behavior of URLs like 'graph.html?play=1000&play=2000` 

Administration

Migration

No breaking changes; upgrade as usual