PyBlox
NetsBlox is a block-based programming environment which has a focus on distributed computing and internet connectivity. One of the core features of NetsBlox are remote procedure calls (RPCs), which connect to the NetsBlox server and provide access to online resources such as databases, GoogleMaps, online translation, wireless robotics, mobile phone sensors/control, and more.
PyBlox is an interface for accessing all NetsBlox services from within python. You can import this package in any python program that has internet access and begin calling RPCs and sending/receiving messages!
For more information about NetsBlox and the available services, see the official NetsBlox Documentation.
Example Usage
Here's a short example to see how you can access the MaunaLoaCO2Data service from python.
import netsblox
nb = netsblox.Client() # create a client to access NetsBlox
data = nb.mauna_loa_co2_data.get_co2_trend(2000, 2010)
print(data)
Graphical Environment
PyBlox, while useful on its own for accessing NetsBlox services, has a side goal of helping transition students from block-based languages like NetsBlox and Snap! into textual languages like python. Because of this, PyBlox comes with a power graphical environment that supports most of the same features as NetsBlox/Snap!, as well as an IDE for creating python projects in a way that is still structured like a NetsBlox/Snap! project in both appearnance and concurrency model (closest approximation).
These features are only activated when explicitly called, leaving the default behavior as a normal python package for accessing NetsBlox services.
To launch the IDE, you can simply run PyBlox (netsblox) as a module:
python -m netsblox
Installation
PyBlox is available as a pip package called netsblox (keep in mind that PyBlox is a python3 package, so you may need to use pip3 if your pip still points to the python2 version).
pip install netsblox
If you run into installation issues with the nb2pb dependency, follow the instruction here.
It is possible that there is not a wheel build for your platform and/or python version, which means that it must be compiled from source.
This requires installing cargo, after which you can reattempt installing netsblox.
If this solves your problem, feel free to submit an issue including your operating system and processor architecture.
The following additional setup is required, depending on your operating system.
Windows
No additional install dependencies
Mac
brew install python-tk
Linux
sudo apt install python3-pil python3-pil.imagetk
sudo apt install idle3
Structured Data
Due to the limited type primitives in Snap!, one NetsBlox typing convention is "structured data", which is really just a list of lists (pairs) denoting (unique string) keys and values.
In the python interface, this is replaced by dict for both input and return value.
The python interface will automatically convert input dict values into lists of lists, and convert lists of lists return values into dict (where appropriate).
Note that this conversion is only performed by the static service wrappers like Client.chart.default_options(), and not for the dynamic invocation method: Client.call('Chart', 'defaultOptions').
Naming Conventions
The python names for services, functions, and input parameters are identical to those in the official NetsBlox documentation, except that they are converted into snake case to by more pythonic. Of course, any modern editor will have some form of intellisense built in, so in practice this is a non-issue.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file netsblox-0.5.5.tar.gz.
File metadata
- Download URL: netsblox-0.5.5.tar.gz
- Upload date:
- Size: 1.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.8.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
03b8037e8951f49a5c64e95f686b0493843588016862735394e49a1be6bc8a9a
|
|
| MD5 |
4b01187e6475497ef845682d8cae2e09
|
|
| BLAKE2b-256 |
e8ecefb4fa314b945d23d9d99086d7364d5879cc41b685493a90c070a827614f
|
File details
Details for the file netsblox-0.5.5-py3-none-any.whl.
File metadata
- Download URL: netsblox-0.5.5-py3-none-any.whl
- Upload date:
- Size: 1.7 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.8.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f59d4cad3151f85690214a8e83651e499cb3ca3038c5cd47424e35ce69741357
|
|
| MD5 |
fc2d25cc15aa1ecb7dcd2b210899441f
|
|
| BLAKE2b-256 |
e5e61f0bbcd043cc8f3bcd264215b16e20dbb2cd31a2d09ba87647e8711d611d
|
