Skip to main content

Protoc wrapper for compilation into any language

Project description

All-in-one Protocol Buffers compilation tool

Supported languages:

Python, JavaScript, C++, Rust, Java, Go, ObjectiveC, PHP, Ruby, C#

TODO:

Kotlin, Haskell, Perl, Lua, Swift etc.

Supported OS:

Ubuntu 22.04

Supported architectures:

x86_64

Getting started

  1. Build prepared docker image
  2. alias DOCKER_RUN='docker run --rm -v [output dir]:/data/output -v [output doc dir]:/data/doc -v [input protos dir]:/data/protos protoc-polyglot-x64:1.54.3'
  3. DOCKER_RUN [command]

List of commands:

  • List available languages and services:
    cli.py list
  • Compile a service:
    [language]/cli.py protoc [name]
  • Compile all services:
    [language]/cli.py protoc

Examples:

alias DOCKER_RUN='docker run --rm -v $(pwd)/output:/data/output -v $(pwd)/doc:/data/doc -v $(pwd)/samples:/data/protos -v $(pwd)/tests:/data/tests protoc-polyglot-x64:1.54.3'

  • DOCKER_RUN cli.py list
  • DOCKER_RUN python/cli.py protoc bookclub
  • DOCKER_RUN js/cli.py protoc
  • DOCKER_RUN cli.py doc

Contribution

We love that you are interested in helping us with the development of the protoc-polyglot project. To make the process of contributing as simple as possible we have created a couple of guidelines on how to contribute.

Issue tracking and solving

We track every issue in YouTrack. Before solving any bug, make sure it's reported in YouTrack and not already solved.

Make sure to solve only one issue at a time.

Fork & Pull Request

  1. Create a fork of this repository
  2. Clone your fork to your computer
  3. Create a new branch in the forked repository from the base branch dev with a meaningful name
  4. Solve the issue
  5. Push your changes to the Fork repository.
  6. Create a Pull Request from your branch to the dev branch ( GitHub documentation about Pull Requests: https://help.github.com/articles/using-pull-requests)

The Pull Request should have a meaningful title, information about the changes you have made, and a link to the issue in YouTrack.

Do not add unnecessary files, and make sure not to push any sensitive personal information.

Protoc-polyglot team - protoc-polyglot@proton.me

protoc-polyglot python protoc

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

protoc_polyglot-0.0.1.post28.tar.gz (2.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

protoc_polyglot-0.0.1.post28-py3-none-any.whl (2.5 kB view details)

Uploaded Python 3

File details

Details for the file protoc_polyglot-0.0.1.post28.tar.gz.

File metadata

  • Download URL: protoc_polyglot-0.0.1.post28.tar.gz
  • Upload date:
  • Size: 2.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.10.10

File hashes

Hashes for protoc_polyglot-0.0.1.post28.tar.gz
Algorithm Hash digest
SHA256 900ce34471c66b9dd2ed93cce50a6f3202c1e55932e9e85a364c3dd9a23d9c6d
MD5 a523da8171be66ef9e2de56505c3f522
BLAKE2b-256 d717b5e1d5a318e9f48643d9080af761c70616ba0db654e96293150df2b4fccc

See more details on using hashes here.

File details

Details for the file protoc_polyglot-0.0.1.post28-py3-none-any.whl.

File metadata

File hashes

Hashes for protoc_polyglot-0.0.1.post28-py3-none-any.whl
Algorithm Hash digest
SHA256 21252ca4045d25b344ed6fca914f2d9836be74cc6921651e950426bced246b98
MD5 7374c5dd9a0386abe29bea33f2fa29f1
BLAKE2b-256 185abd16677690722d013d306bcecc80de86298771e54a90fadfa82ab364bd45

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page