CrossCompute Analytics Automation Framework

Automate your Jupyter notebooks and scripts as web-based reports, tools, widgets, dashboards, forms. Use this framework to create your own automations, then serve locally or deploy on your own instance of the CrossCompute Analytics Automation System.

Reports are documents that update when the data changes.
Forms are step-by-step questions that generate a specific web-based report.
Tools are forms that transform input variables into output variables.
Widgets are interactive visualizations that update when the data changes.
Dashboards are widgets in a layout.

Here are some available extensions:

Here are some available views:

link
string
number
password
email
text
markdown
image
radio
checkbox
table
frame
json
pdf
file
map-mapbox (crosscompute-views-map)
map-mapbox-location (crosscompute-views-map)
map-deck-screengrid (crosscompute-views-map)
barcode (crosscompute-views-barcode)

Here are the currently supported configuration options.

Usage

# Upgrade package
pip install crosscompute>=0.9.4 --upgrade

# Initialize configuration
crosscompute

# Serve automation
crosscompute automate.yml

Here are some examples and tutorials:

Development

# Clone repository
git clone https://github.com/crosscompute/crosscompute

# Install with dependencies for tests
cd crosscompute
pip install -e .[test]

# Run tests
pytest --cov=crosscompute --cov-report term-missing:skip-covered -n auto tests

# Build package for PyPI
pip install build
python -m build --sdist --wheel

# Publish package on PyPI
pip install twine --upgrade
python -m twine upload dist/*

Troubleshooting

SyntaxError: Invalid Syntax

If you get the following error, you are running on an older version of Python:

$ crosscompute

    while chunk := f.read(CHUNK_SIZE_IN_BYTES):
                 ^
SyntaxError: invalid syntax

To solve this issue, create a virtual environment using python >= 3.10.

sudo dnf -y install python3.10
# sudo apt -y install python3.10

python3.10 -m venv ~/.virtualenvs/crosscompute
source ~/.virtualenvs/crosscompute/bin/activate

pip install crosscompute>=0.9.4

Acknowledgments

Metadata

Release files for crosscompute 0.9.4.13

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

Source distribution (sdist)

Source distribution for crosscompute 0.9.4.13
File	Size	Uploaded
crosscompute-0.9.4.13.tar.gz	78.6 kB	May 30, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for crosscompute 0.9.4.13
File	Interpreter	ABI	Platform	Reset
crosscompute-0.9.4.13-py3-none-any.whl 96.8 kB May 30, 2024	Python 3	none	any	Details

Total release size: 175.5 kB

Release files / crosscompute-0.9.4.13.tar.gz

Download URL	crosscompute-0.9.4.13.tar.gz
Size	78.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`dc885deccc8fef454617acefd6e49d749fa0b6ae5742d6035ae808ed5311b50d`
BLAKE2b-256 checksum How to use checksums	`99a7299b431585565eaadbba3ce695e28581f901db8234fb73b297f2ba251e63`
Upload date	May 30, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.0 CPython/3.12.3`

Release files / crosscompute-0.9.4.13-py3-none-any.whl

Download URL	crosscompute-0.9.4.13-py3-none-any.whl
Size	96.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`afb1c024f5748014896d77f4fcc0f74c58fddd7290f4eb3efeb3e3ddb9715bcf`
BLAKE2b-256 checksum How to use checksums	`c2fe52a8703be37c6f55b7715f35b4323ddcf841326486aec70f8c7e49860e87`
Upload date	May 30, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.0 CPython/3.12.3`