Book Image

Protocol Buffers Handbook

By : Clément Jean
Book Image

Protocol Buffers Handbook

By: Clément Jean

Overview of this book

Explore how Protocol Buffers (Protobuf) serialize structured data and provides a language-neutral, platform-neutral, and extensible solution. With this guide to mastering Protobuf, you'll build your skills to effectively serialize, transmit, and manage data across diverse platforms and languages. This book will help you enter the world of Protocol Buffers by unraveling the intricate nuances of Protobuf syntax and showing you how to define complex data structures. As you progress, you’ll learn schema evolution, ensuring seamless compatibility as your projects evolve. The book also covers advanced topics such as custom options and plugins, allowing you to tailor validation processes to your specific requirements. You’ll understand how to automate project builds using cutting-edge tools such as Buf and Bazel, streamlining your development workflow. With hands-on projects in Go and Python programming, you’ll learn how to practically apply Protobuf concepts. Later chapters will show you how to integrate data interchange capabilities across different programming languages, enabling efficient collaboration and system interoperability. By the end of this book, you’ll have a solid understanding of Protobuf internals, enabling you to discern when and how to use and redefine your approach to data serialization.
Table of Contents (13 chapters)

Adding entries

In this section, let us focus on adding a Person or a Company contact to AddressBook. We will start with the business logic and then we will link the business logic to the CLI part of our application.

The business logic

We will first write all the code related to the addition of contact. We will have two functions: add_person and add_company. Both functions are similar, however, they both receive different information as parameters. Let us first talk about the similarities between these two functions.

The first similarity is that both functions take db as a parameter. So, we have the following:

def add_person(db: IO[bytes], ...):
  #...
def add_company(db: IO[bytes], ...):
  #...

Next, both functions will use read_from_db to get the potentially already existing serialized data, and then write_to_db to save the newly updated data. Both functions will contain the following beginning and ending:

book = read_from_db(db)
if book.contacts...