README.txt 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
  1. Protocol Buffers - Google's data interchange format
  2. Copyright 2008 Google Inc.
  3. This directory contains the Python Protocol Buffers runtime library.
  4. Installation
  5. ============
  6. 1) Make sure you have Python 2.4 or newer. If in doubt, run:
  7. $ python -V
  8. 2) If you do not have setuptools installed, note that it will be
  9. downloaded and installed automatically as soon as you run setup.py.
  10. If you would rather install it manually, you may do so by following
  11. the instructions on this page:
  12. http://peak.telecommunity.com/DevCenter/EasyInstall#installation-instructions
  13. 3) Build the C++ code, or install a binary distribution of protoc. If
  14. you install a binary distribution, make sure that it is the same
  15. version as this package. If in doubt, run:
  16. $ protoc --version
  17. 4) Run the tests:
  18. $ python setup.py test
  19. If some tests fail, this library may not work correctly on your
  20. system. Continue at your own risk.
  21. Please note that there is a known problem with some versions of
  22. Python on Cygwin which causes the tests to fail after printing the
  23. error: "sem_init: Resource temporarily unavailable". This appears
  24. to be a bug either in Cygwin or in Python:
  25. http://www.cygwin.com/ml/cygwin/2005-07/msg01378.html
  26. We do not know if or when it might me fixed. We also do not know
  27. how likely it is that this bug will affect users in practice.
  28. 5) Install:
  29. $ python setup.py install
  30. This step may require superuser privileges.
  31. Usage
  32. =====
  33. The complete documentation for Protocol Buffers is available via the
  34. web at:
  35. http://code.google.com/apis/protocolbuffers/