This release is a pre-release and may not be stable for production use.
vention-sim-grpc-py-sdk
Generated Python gRPC clients for the Vention simulation protos (physics/** and
vention/simulation/** under proto/), published from this repo.
Install
pip install vention-sim-grpc-py-sdk
This also installs vention-grpc-py-sdk,
which ships the vention.robots, vention.io_modules, vention.machine_motion,
vention.motors, vention.vision, and google.type messages the simulation protos embed.
Use
import grpc
from vention.robots.v1.joint_trajectory_point_pb2 import JointTrajectoryPoint
from vention_sim import SIMULATION_SHA, VENTION_PROTOS_SHA, __version__
from vention_sim.simulation.v1.sim_robot_driver_commands_pb2 import StartTrajectoryRequest
from vention_sim.simulation.v4.scene.scene_management_service_pb2_grpc import SceneManagementServiceStub
channel = grpc.insecure_channel("localhost:50055")
scene = SceneManagementServiceStub(channel)
request = StartTrajectoryRequest(points=[JointTrajectoryPoint()])
print(f"built from simulation@{SIMULATION_SHA} and vention-protos@{VENTION_PROTOS_SHA}")
Import root
The modules live under vention_sim: a proto at vention/simulation/v1/x.proto is
vention_sim.simulation.v1.x_pb2, and one at physics/v3/x.proto is
vention_sim.physics.v3.x_pb2. Only the Python import path differs from protoc's default.
The proto packages (vention.simulation.*, physics.*), file names, gRPC method paths and
Any type URLs are unchanged, so a vention-grpc-py-sdk message drops straight into a
simulation request and reflection sees the same types as every other language.
protoc would otherwise place the stubs at vention.simulation.*, inside the vention
package that vention-grpc-py-sdk owns. Two distributions sharing a regular package only
work while both unpack into the same site-packages; editable installs and any layout with
more than one root on sys.path lose one of them. Giving this package its own import root
removes the shared directory, so it works in every layout and never depends on how
vention-grpc-py-sdk is laid out.
One package per proto source
The simulation protos import vention-protos files, and both packages have to coexist in
one environment. Python leaves no good way to ship two copies of the same generated module:
two distributions writing the same path overwrite each other in site-packages, and protobuf
registers every message in a process-global pool that rejects duplicates. So this package
ships only the simulation-owned stubs and takes the shared ones from vention-grpc-py-sdk,
the same way grpcio-status takes google.rpc from googleapis-common-protos.
The dependency is vention-grpc-py-sdk>=<release>, the release generated from the
vention-protos commit pinned in proto/package.json
(config.protos.tag). The stubs need every proto that commit ships, and later releases keep
them, so a lower bound is enough. It also lets a project pin a newer release, or the
<next release>.devN build an open vention-protos-clients PR publishes, next to this
package. Older releases and dev builds still conflict, since they may predate protos the
stubs import.
Versions
Releases publish on every push to main that touches proto/** or python-sdk/**, as the
next patch after the latest release on PyPI. Pull requests touching those paths, and manual runs
of the workflow on any other branch, publish a X.Y.Z.dev<build id> build (PRs get the install
command as a comment). Once a release exists, pip only installs a dev build when its version
is spelled out.
vention_sim._source records what a wheel was built from: SIMULATION_SHA (the PR head for
dev builds), VENTION_PROTOS_SHA, VENTION_GRPC_PY_SDK_VERSION, and __version__.
Contributing
Nothing in python-sdk/src is committed; CI regenerates it from proto/ before publishing.
To reproduce the CI build locally:
npm ci # buf comes from the proto workspace
python3 -m venv .venv && source .venv/bin/activate
python python-sdk/scripts/ci_python_package.py
The script exports the vendored vention-protos at the pinned commit (SSH access to
VentionCo/vention-protos required) and fails if that overwrote the sim-owned protos,
generates the stubs with buf.gen.yaml, moves them under vention_sim and
rewrites their imports and module names to match, resolves the matching vention-grpc-py-sdk
release from PyPI, builds the wheel, installs it together with that release, and runs
check_installed_wheel.py: the wheel requires at least
the SDK release whose PROTOS_SHA equals the pin, every generated module imports, every generated
message class belongs to its vention_sim module and pickles, a sim message keeps its proto
package, file name, method path and Any type URL, and a vention-grpc-py-sdk message embeds
into a sim request. Both import orders are then tried in fresh interpreters.
hatch_build.py turns the resolved SDK release into the dependency's lower bound at build time.
publish-python-sdk.yml runs the same script
and uploads with the org's PyPI token.
1 maintainer
Metadata
1 maintainer
Release files for vention-sim-grpc-py-sdk 0.1.9.dev3674827611901
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vention_sim_grpc_py_sdk-0.1.9.dev3674827611901.tar.gz | 72.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vention_sim_grpc_py_sdk-0.1.9.dev3674827611901-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 237.6 kB
Release files / vention_sim_grpc_py_sdk-0.1.9.dev3674827611901.tar.gz
| Download URL | vention_sim_grpc_py_sdk-0.1.9.dev3674827611901.tar.gz |
|---|---|
| Size | 72.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
141469233c98656b5fb47f2f6a2beabb8131f082a06bc85920c7f8fe697770d1
|
|
BLAKE2b-256 checksum How to use checksums |
b2aa80e65461ab4f3ee7065083c78d03800a7ea2b508d0abdf4c81df08459f17
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / vention_sim_grpc_py_sdk-0.1.9.dev3674827611901-py3-none-any.whl
| Download URL | vention_sim_grpc_py_sdk-0.1.9.dev3674827611901-py3-none-any.whl |
|---|---|
| Size | 164.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
53b446436908c037192a57c958322e30c0f23279534e37e836d44c01773e1a2a
|
|
BLAKE2b-256 checksum How to use checksums |
3ef2bd5e50426790bec0a400206edfd9b4e258f75e5a646c47edb49c1026073b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
