perspective-python 3.0.0rc3__tar.gz → 3.0.1__tar.gz

{perspective_python-3.0.0rc3 → perspective_python-3.0.1}/Cargo.lock

@@ -1783,7 +1783,7 @@ checksum = "e3148f5046208a5d56bcfc03053e3ca6334e51da8dfb19b6cdc8b306fae3283e"
 
 [[package]]
 name = "perspective"
-version = "3.0.0-rc.3"
+version = "3.0.1"
 dependencies = [
  "async-lock",
  "axum",
@@ -1823,7 +1823,7 @@ dependencies = [
 
 [[package]]
 name = "perspective-client"
-version = "3.0.0-rc.3"
+version = "3.0.1"
 dependencies = [
  "async-lock",
  "futures",
@@ -1845,7 +1845,7 @@ dependencies = [
 
 [[package]]
 name = "perspective-js"
-version = "3.0.0-rc.3"
+version = "3.0.1"
 dependencies = [
  "anyhow",
  "base64 0.13.1",
@@ -1874,7 +1874,7 @@ dependencies = [
 
 [[package]]
 name = "perspective-lint"
-version = "3.0.0-rc.3"
+version = "3.0.1"
 dependencies = [
  "glob",
  "yew-fmt",
@@ -1882,7 +1882,7 @@ dependencies = [
 
 [[package]]
 name = "perspective-python"
-version = "3.0.0-rc.3"
+version = "3.0.1"
 dependencies = [
  "async-lock",
  "cmake",
@@ -1902,21 +1902,23 @@ dependencies = [
 
 [[package]]
 name = "perspective-server"
-version = "3.0.0-rc.3"
+version = "3.0.1"
 dependencies = [
  "async-lock",
+ "base64 0.22.1",
  "cmake",
  "cxx",
  "cxx-build",
  "futures",
  "num_cpus",
  "perspective-client",
+ "regex",
  "tracing",
 ]
 
 [[package]]
 name = "perspective-viewer"
-version = "3.0.0-rc.3"
+version = "3.0.1"
 dependencies = [
  "anyhow",
  "async-lock",

{perspective_python-3.0.0rc3 → perspective_python-3.0.1}/PKG-INFO

@@ -1,8 +1,20 @@
 Metadata-Version: 2.3
 Name: perspective-python
-Version: 3.0.0rc3
+Version: 3.0.1
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Framework :: Jupyter :: JupyterLab
+Classifier: Framework :: Jupyter :: JupyterLab :: 3
+Classifier: Framework :: Jupyter :: JupyterLab :: Extensions
+Classifier: Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt
+Requires-Dist: jinja2 >=2.0, <4
+Requires-Dist: ipywidgets >=7.5.1, <9
 Summary: A data visualization and analytics component, especially well-suited for large and/or streaming datasets.
 Home-Page: https://perspective.finos.org
 Author: Andrew Stein <steinlink@gmail.com>

{perspective_python-3.0.0rc3/rust/perspective-python → perspective_python-3.0.1}/perspective/__init__.py

@@ -10,7 +10,7 @@
 #  ┃ of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ┃
 #  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
 
-__version__ = "3.0.0-rc.3"
+__version__ = "3.0.1"
 __all__ = [
     "_jupyter_labextension_paths",
     "PerspectiveError",
@@ -20,14 +20,16 @@ __all__ = [
     "ProxySession",
     "Table",
     "View",
+    "Server",
+    "Client",
 ]
 
 from .perspective import (
-    PySyncClient,
+    Client as PySyncClient,
     PerspectiveError,
     Table,
     View,
-    PySyncProxySession as ProxySession,
+    ProxySession,
 )
 
 from .widget import PerspectiveWidget

{perspective_python-3.0.0rc3 → perspective_python-3.0.1}/pyproject.toml

@@ -19,13 +19,25 @@ name = "perspective-python"
 requires-python = ">=3.9"
 dynamic = ["version"]
 classifiers = [
+    "Development Status :: 5 - Production/Stable",
     "Programming Language :: Rust",
     "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Framework :: Jupyter :: JupyterLab",
+    "Framework :: Jupyter :: JupyterLab :: 3",
+    "Framework :: Jupyter :: JupyterLab :: Extensions",
+    # "Framework :: Jupyter :: JupyterLab :: Extensions :: Mime Renderers",
+    "Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt",
 ]
+dependencies = ["Jinja2>=2.0,<4", "ipywidgets>=7.5.1,<9"]
 
 [tool.maturin]
 module-name = "perspective"
-data = "perspective_python-3.0.0rc3.data"
+data = "perspective_python-3.0.1.data"
 features = ["pyo3/extension-module"]
 include = [
     { path = "perspective/*libpsp.so", format = "wheel" },

{perspective_python-3.0.0rc3 → perspective_python-3.0.1}/rust/perspective-client/Cargo.toml

@@ -12,7 +12,7 @@
 
 [package]
 name = "perspective-client"
-version = "3.0.0-rc.3"
+version = "3.0.1"
 authors = ["Andrew Stein <steinlink@gmail.com>"]
 edition = "2021"
 description = "A data visualization and analytics component, especially well-suited for large and/or streaming datasets."

{perspective_python-3.0.0rc3 → perspective_python-3.0.1}/rust/perspective-client/build.rs

@@ -18,7 +18,7 @@ fn prost_build() -> Result<()> {
     // `perspective-python`.
     println!(
         "cargo::metadata=DOCS_PATH={}/docs/",
-        env!("CARGO_MANIFEST_DIR")
+        std::env::var("CARGO_MANIFEST_DIR").unwrap()
     );
 
     // This source file is included at `publish` time, but not `sbuild` time

{perspective_python-3.0.0rc3 → perspective_python-3.0.1}/rust/perspective-client/docs/client.md

@@ -4,6 +4,10 @@ transport like a WebSocket.
 
 <div class="javascript">
 
+<div class="warning">
+The examples in this module are in JavaScript. See <a href="https://docs.rs/crate/perspective/latest"><code>perspective</code></a> docs for the Rust API.
+</div>
+
 The browser and node.js libraries both support the `websocket(url)` constructor,
 which connects to a remote `perspective_server::Server` instance over a
 WebSocket transport.
@@ -40,6 +44,10 @@ import { default as client } from "@finos/perspective";
 </div>
 <div class="python">
 
+<div class="warning">
+The examples in this module are in Python. See <a href="https://docs.rs/crate/perspective/latest"><code>perspective</code></a> docs for the Rust API.
+</div>
+
 # Python Examples
 
 Create a `perspective_server::Server` and a local, synchronous [`Client`]

perspective_python-3.0.1/rust/perspective-client/docs/table/get_num_views.md

@@ -0,0 +1,3 @@
+The number of views associated to this table. Note that this may be more than
+what is visible on a screen. As views are created to manage various internal
+state of the application.

perspective_python-3.0.1/rust/perspective-client/docs/table/replace.md

@@ -0,0 +1,39 @@
+Replace all rows in this [`Table`] with the input data, coerced to this
+[`Table`]'s existing [`Schema`], notifying any derived [`View`] and
+[`View::on_update`] callbacks.
+
+Calling [`Table::replace`] is an easy way to replace _all_ the data in a
+[`Table`] without losing any derived [`View`] instances or [`View::on_update`]
+callbacks. [`Table::replace`] does _not_ infer data types like [`Client::table`]
+does, rather it _coerces_ input data to the `Schema` like [`Table::update`]. If
+you need a [`Table`] with a different `Schema`, you must create a new one.
+
+<div class="javascript">
+
+# JavaScript Examples
+
+```javascript
+await table.replace("x,y\n1,2");
+```
+
+</div>
+<div class="python">
+
+# Python Examples
+
+```python
+table.replace("x,y\n1,2")
+```
+
+</div>
+<div class="rust">
+
+# Examples
+
+```rust
+let data = UpdateData::Csv("x,y\n1,2".into());
+let opts = UpdateOptions::default();
+table.replace(data, opts).await?;
+```
+
+</div>

perspective_python-3.0.1/rust/perspective-client/docs/table/update.md

@@ -0,0 +1,44 @@
+Updates the rows of this table and any derived [`View`] instances.
+
+Calling [`Table::update`] will trigger the [`View::on_update`] callbacks
+register to derived [`View`], and the call itself will not resolve until _all_
+derived [`View`]'s are notified.
+
+When updating a [`Table`] with an `index`, [`Table::update`] supports partial
+updates, by omitting columns from the update data.
+
+# Arguments
+
+-   `input` - The input data for this [`Table`]. The schema of a [`Table`] is
+    immutable after creation, so this method cannot be called with a schema.
+-   `options` - Options for this update step - see [`UpdateOptions`].
+
+<div class="javascript">
+
+# JavaScript Examples
+
+```javascript
+await table.update("x,y\n1,2");
+```
+
+</div>
+<div class="python">
+
+# Python Examples
+
+```python
+table.update("x,y\n1,2")
+```
+
+</div>
+<div class="rust">
+
+# Examples
+
+```rust
+let data = UpdateData::Csv("x,y\n1,2".into());
+let opts = UpdateOptions::default();
+table.update(data, opts).await?;
+```
+
+</div>

perspective_python-3.0.1/rust/perspective-client/docs/table/view.md

@@ -0,0 +1,53 @@
+Create a new [`View`] from this table with a specified [`ViewConfigUpdate`].
+
+See [`View`] struct.
+
+<div class="javascript">
+
+# JavaScript Examples
+
+```javascript
+const view = await table.view({
+    columns: ["Sales"],
+    aggregates: { Sales: "sum" },
+    group_by: ["Region", "Country"],
+    filter: [["Category", "in", ["Furniture", "Technology"]]],
+});
+```
+
+</div>
+<div class="python">
+
+# Python Examples
+
+```python
+view = table.view(
+  columns=["Sales"],
+  aggregates={"Sales": "sum"},
+  group_by=["Region", "Country"],
+  filter=[["Category", "in", ["Furniture", "Technology"]]]
+)
+```
+
+</div>
+<div class="rust">
+
+# Examples
+
+```rust
+use crate::config::*;
+let view = table
+    .view(Some(ViewConfigUpdate {
+        columns: Some(vec![Some("Sales".into())]),
+        aggregates: Some(HashMap::from_iter(vec![("Sales".into(), "sum".into())])),
+        group_by: Some(vec!["Region".into(), "Country".into()]),
+        filter: Some(vec![Filter::new("Category", "in", &[
+            "Furniture",
+            "Technology",
+        ])]),
+        ..ViewConfigUpdate::default()
+    }))
+    .await?;
+```
+
+</div>

{perspective_python-3.0.0rc3 → perspective_python-3.0.1}/rust/perspective-client/docs/table.md

@@ -12,3 +12,14 @@ The schema of a [`Table`] is _immutable after creation_, which means the column
 names and data types cannot be changed after the [`Table`] has been created.
 Columns cannot be added or deleted after creation either, but a [`View`] can be
 used to select an arbitrary set of columns from the [`Table`].
+
+<div class="javascript">
+<div class="warning">
+The examples in this module are in JavaScript. See <a href="https://docs.rs/crate/perspective/latest"><code>perspective</code></a> docs for the Rust API.
+</div>
+</div>
+<div class="python">
+<div class="warning">
+The examples in this module are in Python. See <a href="https://docs.rs/crate/perspective/latest"><code>perspective</code></a> docs for the Rust API.
+</div>
+</div>

{perspective_python-3.0.0rc3 → perspective_python-3.0.1}/rust/perspective-client/docs/view/on_delete.md

@@ -1,9 +1,13 @@
 Register a callback with this [`View`]. Whenever the [`View`] is deleted, this
 callback will be invoked.
 
-# Example
+<div class="javascript">
+
+# JavaScript Examples
 
 ```javascript
 // attach an `on_delete` callback
 view.on_delete(() => console.log("Deleted!"));
 ```
+
+</div>

{perspective_python-3.0.0rc3 → perspective_python-3.0.1}/rust/perspective-client/docs/view/on_update.md

@@ -12,7 +12,9 @@ which is the new data that was updated for each cell or each row.
     `OnUpdateOptions { mode: Some(OnUpdateMode::Row) }`, then `delta` is an
     Arrow of the updated rows. Otherwise `delta` will be [`Option::None`].
 
-# Examples
+<div class="javascript">
+
+# JavaScript Examples
 
 ```javascript
 // Attach an `on_update` callback
@@ -23,3 +25,5 @@ view.on_update((updated) => console.log(updated.port_id));
 // `on_update` with row deltas
 view.on_update((updated) => console.log(updated.delta), { mode: "row" });
 ```
+
+</div>

perspective_python-3.0.1/rust/perspective-client/docs/view/remove_update.md

@@ -0,0 +1,40 @@
+Unregister a previously registered update callback with this [`View`].
+
+# Arguments
+
+-   `id` - A callback `id` as returned by a recipricol call to
+    [`View::on_update`].
+
+<div class="javascript">
+
+# JavaScript Examples
+
+```javascript
+const callback = () => console.log("Updated!");
+const id = await view.on_update(callback);
+await view.remove_update(id);
+```
+
+</div>
+<div class="python">
+
+# Python Examples
+
+```python
+callback = lambda x: print(x)
+cid = await view.on_update(callback)
+await view.remove_update(cid)
+```
+
+</div>
+<div class="rust">
+
+# Examples
+
+```rust
+let callback = |_| async { print!("Updated!") };
+let cid = view.on_update(callback, OnUpdateOptions::default()).await?;
+view.remove_update(cid).await?;
+```
+
+</div>