Broken Python Examples

[Cambyst]

Bug Report

Hi, new to Perspective and it looks awesome. However it seems that a change in Perspective python import causing all examples and docs to be outdated.

Steps to Reproduce:

1. Run any of the server.py under the python-* examples

Expected Result:

Expected the server.py to run

Actual Result:

ImportError: cannot import name 'Table' from 'perspective'

Environment:

Python 3.10
perspective-python 2.0.1 (installed via pip)

Additional Context:

Could it be caused by the following ?

2cf241f

[timkpaine]

Can you provide a stack trace of the error

[Cambyst]

Hi @timkpaine , thanks for checking! Here is an example for python-tornado, but same apply to all examples (including the one in python docs):

[texodus]

@Cambyst It looks like you're on a mac, what is your OSX version and CPU (x85 or arm64)?

@timkpaine wants the errors from your installation log, not the import statement.

[Cambyst]

Hey @texodus , I am on macOS 13.4 with an Apple M1 (arm64).

Attached is install log and also first import log on a clean python env. It seems to confirm your intuition that it is due to the CPU architecture.
first_import.txt
install_log.txt

[texodus]

You're not installing perspective-python 2.0.1 as you say in your report - you're installing 2.3.0 as printed in your install_log.txt. This version has a regression in arm64 build, you can downgrade to 2.2.1 (or 2.0.1 incidentally), or wait until 2.3.1.

[Cambyst]

Thank you @texodus , you are right that on the clean env, it installed 2.3 and that downgrading to 2.2.1 helped a little (not sure why pip-show print 2.0.1 originally but nevermind). However on launch it is still throwing an exception (I have run "yarn install", although this was not explicitely documented):

[timkpaine]

looks like you’re trying to run the examples from master, but you installed perspective 2.2.1. You’ll need to run the examples as of perspective 2.2.1

[Cambyst]

Apologies for my lack of knowledge around Yarn/Javascript, but it seems that none of the "/dist/cdn" script referenced in the html files are also not installed by Yarn. Example if python-tornado/index.html:

perspective/examples/python-tornado/index.html

Line 15 in 46809f3

<script type="module" src="http://localhost:8080/node_modules/@finos/perspective-viewer/dist/cdn/perspective-viewer.js"></script>

[timkpaine]

these are served locally from the build JS assets. yarn build_js to build them, the examples are designed to be run from a locally built developer installation (or you can also easily adapt them to a public CDN like jsdelivr)

[Cambyst]

Works like a charm now, thank you very much for your time @timkpaine @texodus , much appreciated !