[FEA] better url settings docs

[lmeyerov]

Is your feature request related to a problem? Please describe.

A pygraphistry user couldn't find, with decent effort, how to set edge opacity to 0.1

ChatGPT hallucinated the wrong answer too, and took much cajoling to find: https://chat.openai.com/share/c22a10cf-b0c3-40d8-96ab-715d8b549da9

pyg docs should have been easier here, and in a way github/docs scrapers could have picked up

Right now, .settings() doesn't say what valid url_params={...} can be (

pygraphistry/graphistry/PlotterBase.py

Line 1182 in e74123e

def settings(self, height=None, url_params={}, render=None):

), particularly wrt https://hub.graphistry.com/docs/api/1/rest/url/#urloptions

Describe the solution you'd like

• help(g.settings) would have pointed out the url_params={...} options from

  pygraphistry/graphistry/PlotterBase.py

  Line 1182 in e74123e

  def settings(self, height=None, url_params={}, render=None):

• overall pygraphistry docstrs would have this => search engines / LLMs, so probably inline somehow, vs outside link
• demo notebook of most features: https://github.com/graphistry/pygraphistry/tree/master/demos/more_examples/graphistry_features
  • basically a python analogue of https://hub.graphistry.com/static/js-docs/index.html?path=/docs/graphistry-react-style--empty

As part of the impl, maybe an idea is creating an openai / pydantic out of this, so it is machine processed? https://github.com/graphistry/graphistry/blob/eab8648d4ee9c9f3535baeb1aa5ac0904e6a3294/apps/core/viz/server/clientParamSafelist.js#L141 ?