Skip to main content

Kedro-Static-Viz

Kedro-Static-Viz creates a static website for your Kedro data pipelines. Kedro static viz is a very small python cli that makes your kedro-viz generated pipeline.json data available to a static appication built with gatsbyjs. The benefit of this is that it it can be built inside of a ci service such as github actions and deployed to a number to static file hosts such as Netlify, Now.sh, github pages, S3. Free options are endless these days. By default the site will be built to the public directory.

Python package

PyPI version

Build public.tar.gz and Deploy example to gh-pages


Example Site

On every push to master in this repo static-viz.kedro.dev is built and deployed.

CLI Usage

kedro static-viz

!Python Usage

The static_viz function is callable from inside your project directory.

from kedro_static_viz import static_viz
static_viz()

Hooks Usage

from kedro_static_viz.hooks import StaticViz

class ProjectContext(KedroContext):
   project_name = "kedro0160"
   project_version = "0.16.1"
   package_name = "kedro0160"
   hooks = [ StaticViz() ]

Installation

How do I install and use Kedro-Static-Viz?

As a Kedro Python plugin

Kedro-Static-Viz is available as a Python plugin named kedro-static-viz.

The following conditions must be true in order to visualise your pipeline:

  • Your project directory must be available to the Kedro-Static-Viz plugin.
  • You must be using a Kedro data pipelines project structure with a complete Data Catalog, nodes and pipeline structure.

To install it:

pip install kedro-static-viz

This will install kedro as a dependency, and add kedro static-viz as an additional CLI command.

To visualise your pipeline, go to your project root directory and install the project-specific dependencies by running:

kedro install

This will install the dependencies specified in requirements.txt in your Kedro environment (see the Kedro documentation for how to set up your Python virtual environment).

Finally, run the following command from the project directory to visualise your pipeline:

kedro static-viz

This command will run kedro_viz.server on http://127.0.0.1:4141/ which cannot be accessed from another machine.

Kedro-Viz has a number of options to customise running the visualisation:

CLI command Description
--port TCP port that viz will listen to. Defaults to 4141.
--browser/--no-browser Whether to open viz interface in the default browser or not.
--load-file Path to load the pipeline JSON file
--pipeline Name of the modular pipeline to visualise. If not set, the default pipeline is visualised.
--env, -e Kedro configuration environment. If not specified, catalog config in local will be used.
--directory Directory to render the static site to
--serve/--no-serve Whether or not to serve the site after creating. Defaults to True.

Contributing

You're Awesome for considering a contribution! Contributions are welcome, please check out the Contributing Guide for more information. Please be a positive member of the community and embrace feedback

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

Waylon Walker - Waylon Walker - Original Author

License

This project is licensed under the MIT License - see the LICENSE file for details

Metadata

Release files for kedro-static-viz 0.4.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kedro-static-viz 0.4.4
File Size Uploaded Provenance Actions
kedro-static-viz-0.4.4.tar.gz 573.7 kB Without provenance Details for kedro-static-viz-0.4.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kedro-static-viz 0.4.4
File Interpreter ABI Platform Actions
kedro_static_viz-0.4.4-py3-none-any.whl Python 3 none any Details for kedro_static_viz-0.4.4-py3-none-any.whl

Total release size: 1.1 MB

Release files / kedro-static-viz-0.4.4.tar.gz

Download URL kedro-static-viz-0.4.4.tar.gz
Size 573.7 kB
Tags Source
SHA-256 checksum
How to use checksums
fa9381c32dc636e5ca14c0cb1578c7877fe67e5caf6341a043b60922be66f347
BLAKE2b-256 checksum
How to use checksums
baae409712f18aa4df85259036a519191063665a54c86e061f27fbaea153eab9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.58.0 CPython/3.7.10

Release files / kedro_static_viz-0.4.4-py3-none-any.whl

Download URL kedro_static_viz-0.4.4-py3-none-any.whl
Size 572.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
41f7e7082950c146a96a60edaa14bcd34ccd0c8cf15f4f064eac979de209ec22
BLAKE2b-256 checksum
How to use checksums
9e491395ce4609d160bb37f7582c6719862b03f5c872d9590e5e6a2244f9e8f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.58.0 CPython/3.7.10

Security for kedro-static-viz 0.4.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page