Spounge Proto Python

0.2.9 verified Sat May 09 auth: no python

Generated protobuf Python packages for Spounge AI ecosystem microservices. Current version is 0.2.9. Released as needed, follows TypeScript proto versioning (2.2.0).

pip install spounge-proto-py

Common errors

error ImportError: No module named 'spounge_proto' ↓

cause Package not installed or wrong import name (hyphen vs underscore).

fix

Install the package: pip install spounge-proto-py. Import with underscores: import spounge_proto

error ModuleNotFoundError: No module named 'spounge_proto.user' ↓

cause Typo in submodule path or proto file not included in this version.

fix

Check the available submodules by listing what is inside the spounge_proto package: pip show spounge-proto-py; then import with exact path, e.g., 'from spounge_proto.user.v1 import user_pb2'

error AttributeError: module 'spounge_proto' has no attribute 'user' ↓

cause Top-level import without importing submodule explicitly.

fix

Use: import spounge_proto.user.v1.user_pb2 or from spounge_proto.user.v1 import user_pb2

Warnings

breaking The Python package version is 0.2.x while the TypeScript package is 2.x. Breaking changes in Python may be introduced with minor bumps. Always check release notes. ↓

fix Pin dependency to exact minor version: spounge-proto-py==0.2.9

gotcha Import paths are generated from proto file structure. Proto packages like 'user.v1' become 'spounge_proto/user/v1/'. Messing up the path leads to ImportError. ↓

fix Always use the package name exactly as in the proto declaration, converted to underscores. Example: 'import spounge_proto.user.v1.user_pb2'.

deprecated Older releases used 'spounge-proto-py' with hyphens; import statements require underscores. Do not use hyphens in import. ↓

fix Use underscores: 'import spounge_proto' not 'import spounge-proto'.

Imports

spounge_proto
```
import spounge_proto
```
Top-level package contains submodules like user.v1, device.v1, etc.

Quickstart

Minimal example creating a User protobuf message.

import spounge_proto.user.v1.user_pb2 as user_pb2
user = user_pb2.User(id='123', name='Alice')
print(user)