Informatics Matters cross-product protocol buffers
==================================================
.. image:: https://badge.fury.io/py/im-protobuf.svg
:target: https://badge.fury.io/py/im-protobuf
:alt: PyPI package (latest)
.. image:: https://github.com/InformaticsMatters/squonk2-protobuf/actions/workflows/build.yaml/badge.svg
:target: https://github.com/InformaticsMatters/squonk2-protobuf/actions/workflows/build.yaml
:alt: Build
.. image:: https://github.com/InformaticsMatters/squonk2-protobuf/actions/workflows/publish.yaml/badge.svg
:target: https://github.com/InformaticsMatters/squonk2-protobuf/actions/workflows/publish.yaml
:alt: Publish
A library of python bindings for `protocol buffer`_ definitions used by one or
more products in the Informatics Matters product suite.
The protocol buffers are used across multiple components and languages.
At the outset we anticipate supporting Python, and Java. The root
of all packages is ``src/main`` as required by build tools like ``Gradle``.
From there the directory is ``proto/informaticsmatters`` followed by component
directories or a ``common`` directory. An example protocol message
file might be::
src/main/proto/informaticsmatters/protobuf/datamanager/pod_message.proto
When transmitted on a topic-based messaging service the topic is
the lower-case dot-separated message name relative to ``informaticsmatters``
(excluding the ``Message`` suffix), e.g. ``datamanager.pod``.
.. _Protocol Buffer: https://developers.google.com/protocol-buffers/docs/proto3
Installation (Python)
=====================
The protocol buffers are published on `PyPI`_ and can be installed from
there::
pip install im-protobuf
.. _PyPI: https://pypi.org/project/im-protobuf
Once installed you can access the protocol buffers with::
>>> from informaticsmatters.protobuf.datamanager.pod_message_pb2 import PodMessage
>>> pm: PodMessage = PodMessage()
Get in touch
============
- Report bugs, suggest features or view the source code `on GitHub`_.
.. _on GitHub: https://github.com/informaticsmatters/squonk2-protobuf
Raw data
{
"_id": null,
"home_page": "https://github.com/informaticsmatters/squonk2-protobuf",
"name": "im-protobuf",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "protobuf protoc messaging",
"author": "Alan Christie",
"author_email": "achristie@informaticsmatters.com",
"download_url": "https://files.pythonhosted.org/packages/1a/a3/287b71c9ae3b924928773f84a10ee6af45340afe13e933c509088f231f5c/im-protobuf-7.0.0.tar.gz",
"platform": "any",
"description": "Informatics Matters cross-product protocol buffers\n==================================================\n\n.. image:: https://badge.fury.io/py/im-protobuf.svg\n :target: https://badge.fury.io/py/im-protobuf\n :alt: PyPI package (latest)\n\n.. image:: https://github.com/InformaticsMatters/squonk2-protobuf/actions/workflows/build.yaml/badge.svg\n :target: https://github.com/InformaticsMatters/squonk2-protobuf/actions/workflows/build.yaml\n :alt: Build\n\n.. image:: https://github.com/InformaticsMatters/squonk2-protobuf/actions/workflows/publish.yaml/badge.svg\n :target: https://github.com/InformaticsMatters/squonk2-protobuf/actions/workflows/publish.yaml\n :alt: Publish\n\nA library of python bindings for `protocol buffer`_ definitions used by one or\nmore products in the Informatics Matters product suite.\n\nThe protocol buffers are used across multiple components and languages.\nAt the outset we anticipate supporting Python, and Java. The root\nof all packages is ``src/main`` as required by build tools like ``Gradle``.\nFrom there the directory is ``proto/informaticsmatters`` followed by component\ndirectories or a ``common`` directory. An example protocol message\nfile might be::\n\n src/main/proto/informaticsmatters/protobuf/datamanager/pod_message.proto\n\nWhen transmitted on a topic-based messaging service the topic is\nthe lower-case dot-separated message name relative to ``informaticsmatters``\n(excluding the ``Message`` suffix), e.g. ``datamanager.pod``.\n\n.. _Protocol Buffer: https://developers.google.com/protocol-buffers/docs/proto3\n\nInstallation (Python)\n=====================\n\nThe protocol buffers are published on `PyPI`_ and can be installed from\nthere::\n\n pip install im-protobuf\n\n.. _PyPI: https://pypi.org/project/im-protobuf\n\nOnce installed you can access the protocol buffers with::\n\n >>> from informaticsmatters.protobuf.datamanager.pod_message_pb2 import PodMessage\n >>> pm: PodMessage = PodMessage()\n\nGet in touch\n============\n\n- Report bugs, suggest features or view the source code `on GitHub`_.\n\n.. _on GitHub: https://github.com/informaticsmatters/squonk2-protobuf\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Cross-product protocol buffers",
"version": "7.0.0",
"project_urls": {
"Homepage": "https://github.com/informaticsmatters/squonk2-protobuf"
},
"split_keywords": [
"protobuf",
"protoc",
"messaging"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "81150adf795cca14a759b54c63c5947fdacdc7f28c99fdc1bde4841c4523cbca",
"md5": "9b4afa47b8076e506e3c0824594c6d33",
"sha256": "85285fd45a47df980bdf3f0caf393995e41570f93b705531f65fa601496b8583"
},
"downloads": -1,
"filename": "im_protobuf-7.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9b4afa47b8076e506e3c0824594c6d33",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9913,
"upload_time": "2024-03-01T12:40:16",
"upload_time_iso_8601": "2024-03-01T12:40:16.698368Z",
"url": "https://files.pythonhosted.org/packages/81/15/0adf795cca14a759b54c63c5947fdacdc7f28c99fdc1bde4841c4523cbca/im_protobuf-7.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1aa3287b71c9ae3b924928773f84a10ee6af45340afe13e933c509088f231f5c",
"md5": "58b3408857e62f2ba630b2ebc054cd55",
"sha256": "082202125195994dbbe65b6e5e52ac3d611d447b881a3b7f7bf6106352897d45"
},
"downloads": -1,
"filename": "im-protobuf-7.0.0.tar.gz",
"has_sig": false,
"md5_digest": "58b3408857e62f2ba630b2ebc054cd55",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5397,
"upload_time": "2024-03-01T12:40:18",
"upload_time_iso_8601": "2024-03-01T12:40:18.955160Z",
"url": "https://files.pythonhosted.org/packages/1a/a3/287b71c9ae3b924928773f84a10ee6af45340afe13e933c509088f231f5c/im-protobuf-7.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-01 12:40:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "informaticsmatters",
"github_project": "squonk2-protobuf",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "protobuf",
"specs": [
[
"<",
"5.0"
],
[
">=",
"4.25"
]
]
}
],
"lcname": "im-protobuf"
}
JSON
