protobuf 2.5.0+ for python 3
C++ Java Python Protocol Buffer Makefile M4 Other
Permalink
Failed to load latest commit information.
benchmarks Add benchmarks for writing to a FileOutputStream. Patch from Evan Jones. Nov 3, 2009
editors Fix issue/333. skip any escaped characters in quotes. Jul 13, 2012
examples Close resources properly for java tests and examples. Jun 7, 2011
java Bump version number to 2.5.2 Sep 21, 2016
m4 Fix corner case in acx_pthread.m4 to work with -nostdlib, patch from … Jan 13, 2011
more_tests Add makefile for extended tests to be run before release. Jan 12, 2010
python Bump version number to 2.5.2 Sep 21, 2016
src Down-integrate pending changes from internal repository after previou… Jun 16, 2014
vsprojects Define macros on more targets to make gtest work for vs2012 Dec 5, 2012
CHANGES.txt Bump version number to 2.5.2 Sep 21, 2016
CONTRIBUTORS.txt Update contributors. Jan 24, 2011
COPYING.txt Added clarification to license that generated code is owned by the ow… Sep 30, 2008
INSTALL.txt Initial checkin. Jul 10, 2008
Makefile.am Merge from tags/2.5.0rc1 to trunk Dec 4, 2012
README.txt Note in README that protobuf 3.x.x supports Python 3 Sep 21, 2016
autogen.sh Fix missing redirect flag for curl Sep 21, 2016
configure.ac Bump version number to 2.5.2 Sep 21, 2016
generate_descriptor_proto.sh Massive roll-up of changes. See CHANGES.txt. Dec 18, 2009
post_process_dist.sh Submit script used to post-process dist files. Dec 5, 2008
protobuf-lite.pc.in Allow dependents to use pkg-config to figure out what flags to pass t… Aug 3, 2009
protobuf.pc.in -lz in protobuf.pc belongs in Libs.private, not Libs Jul 3, 2012

README.txt

Google protobuf 3.x.x supports Python 3 natively



Fork Notes
==========
This fork brings Python 3 support to Google Protocol Buffers.
It's diverged version and versioning is incompatible with the official one.

The fork should be considered deprecated once Google provide compatibility
with Python 3 in the official repository.

Most changes are based on the patch posted by Kirill Bogdanov (https://groups.google.com/d/msg/protobuf/Qalty-PenDA/dC6jPMjYvq4J). Excluding all win32 related changes from the patch, since they are irrelevant for our goal.

The fork is independent from https://github.com/openx/python3-protobuf which is based on 2.4.1

Unlike the official repository, I'm glad to accept and release any bugfixes that are stuck due to
annoying release policy used by Google.


Protocol Buffers - Google's data interchange format
Copyright 2008 Google Inc.
http://code.google.com/apis/protocolbuffers/

C++ Installation - Unix
=======================

To build and install the C++ Protocol Buffer runtime and the Protocol
Buffer compiler (protoc) execute the following:

  $ ./autogen.sh
  $ ./configure
  $ make
  $ make check
  $ make install

If "make check" fails, you can still install, but it is likely that
some features of this library will not work correctly on your system.
Proceed at your own risk.

"make install" may require superuser privileges.

For advanced usage information on configure and make, see INSTALL.txt.

** Hint on install location **

  By default, the package will be installed to /usr/local.  However,
  on many platforms, /usr/local/lib is not part of LD_LIBRARY_PATH.
  You can add it, but it may be easier to just install to /usr
  instead.  To do this, invoke configure as follows:

    ./configure --prefix=/usr

  If you already built the package with a different prefix, make sure
  to run "make clean" before building again.

** Compiling dependent packages **

  To compile a package that uses Protocol Buffers, you need to pass
  various flags to your compiler and linker.  As of version 2.2.0,
  Protocol Buffers integrates with pkg-config to manage this.  If you
  have pkg-config installed, then you can invoke it to get a list of
  flags like so:

    pkg-config --cflags protobuf         # print compiler flags
    pkg-config --libs protobuf           # print linker flags
    pkg-config --cflags --libs protobuf  # print both

  For example:

    c++ my_program.cc my_proto.pb.cc `pkg-config --cflags --libs protobuf`

  Note that packages written prior to the 2.2.0 release of Protocol
  Buffers may not yet integrate with pkg-config to get flags, and may
  not pass the correct set of flags to correctly link against
  libprotobuf.  If the package in question uses autoconf, you can
  often fix the problem by invoking its configure script like:

    configure CXXFLAGS="$(pkg-config --cflags protobuf)" \
              LIBS="$(pkg-config --libs protobuf)"

  This will force it to use the correct flags.

  If you are writing an autoconf-based package that uses Protocol
  Buffers, you should probably use the PKG_CHECK_MODULES macro in your
  configure script like:

    PKG_CHECK_MODULES([protobuf], [protobuf])

  See the pkg-config man page for more info.

  If you only want protobuf-lite, substitute "protobuf-lite" in place
  of "protobuf" in these examples.

** Note for cross-compiling **

  The makefiles normally invoke the protoc executable that they just
  built in order to build tests.  When cross-compiling, the protoc
  executable may not be executable on the host machine.  In this case,
  you must build a copy of protoc for the host machine first, then use
  the --with-protoc option to tell configure to use it instead.  For
  example:

    ./configure --with-protoc=protoc

  This will use the installed protoc (found in your $PATH) instead of
  trying to execute the one built during the build process.  You can
  also use an executable that hasn't been installed.  For example, if
  you built the protobuf package for your host machine in ../host,
  you might do:

    ./configure --with-protoc=../host/src/protoc

  Either way, you must make sure that the protoc executable you use
  has the same version as the protobuf source code you are trying to
  use it with.

** Note for Solaris users **

  Solaris 10 x86 has a bug that will make linking fail, complaining
  about libstdc++.la being invalid.  We have included a work-around
  in this package.  To use the work-around, run configure as follows:

    ./configure LDFLAGS=-L$PWD/src/solaris

  See src/solaris/libstdc++.la for more info on this bug.

** Note for HP C++ Tru64 users **

  To compile invoke configure as follows:

    ./configure CXXFLAGS="-O -std ansi -ieee -D__USE_STD_IOSTREAM"

  Also, you will need to use gmake instead of make.

C++ Installation - Windows
==========================

If you are using Microsoft Visual C++, see vsprojects/readme.txt.

If you are using Cygwin or MinGW, follow the Unix installation
instructions, above.

Binary Compatibility Warning
============================

Due to the nature of C++, it is unlikely that any two versions of the
Protocol Buffers C++ runtime libraries will have compatible ABIs.
That is, if you linked an executable against an older version of
libprotobuf, it is unlikely to work with a newer version without
re-compiling.  This problem, when it occurs, will normally be detected
immediately on startup of your app.  Still, you may want to consider
using static linkage.  You can configure this package to install
static libraries only using:

  ./configure --disable-shared

Java and Python Installation
============================

The Java and Python runtime libraries for Protocol Buffers are located
in the java and python directories.  See the README file in each
directory for more information on how to compile and install them.
Note that both of them require you to first install the Protocol
Buffer compiler (protoc), which is part of the C++ package.

Usage
=====

The complete documentation for Protocol Buffers is available via the
web at:

  http://code.google.com/apis/protocolbuffers/