{"id":28252,"library":"spounge-proto-py","title":"Spounge Proto Python","description":"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).","status":"active","version":"0.2.9","language":"python","source_language":"en","source_url":"https://github.com/spoungeai/spounge-proto","tags":["protobuf","grpc","spounge","microservices"],"install":[{"cmd":"pip install spounge-proto-py","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required to use generated protobuf classes","package":"protobuf","optional":false},{"reason":"Required for gRPC stubs if used","package":"grpcio","optional":true}],"imports":[{"note":"Top-level package contains submodules like user.v1, device.v1, etc.","symbol":"spounge_proto","correct":"import spounge_proto"}],"quickstart":{"code":"import spounge_proto.user.v1.user_pb2 as user_pb2\nuser = user_pb2.User(id='123', name='Alice')\nprint(user)","lang":"python","description":"Minimal example creating a User protobuf message."},"warnings":[{"fix":"Pin dependency to exact minor version: spounge-proto-py==0.2.9","message":"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.","severity":"breaking","affected_versions":"all 0.2.x"},{"fix":"Always use the package name exactly as in the proto declaration, converted to underscores. Example: 'import spounge_proto.user.v1.user_pb2'.","message":"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.","severity":"gotcha","affected_versions":"all"},{"fix":"Use underscores: 'import spounge_proto' not 'import spounge-proto'.","message":"Older releases used 'spounge-proto-py' with hyphens; import statements require underscores. Do not use hyphens in import.","severity":"deprecated","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Install the package: pip install spounge-proto-py. Import with underscores: import spounge_proto","cause":"Package not installed or wrong import name (hyphen vs underscore).","error":"ImportError: No module named 'spounge_proto'"},{"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'","cause":"Typo in submodule path or proto file not included in this version.","error":"ModuleNotFoundError: No module named 'spounge_proto.user'"},{"fix":"Use: import spounge_proto.user.v1.user_pb2 or from spounge_proto.user.v1 import user_pb2","cause":"Top-level import without importing submodule explicitly.","error":"AttributeError: module 'spounge_proto' has no attribute 'user'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}