{"id":13635073,"url":"https://github.com/helsing-ai/buffrs","last_synced_at":"2025-04-14T08:57:04.807Z","repository":{"id":175226859,"uuid":"653205139","full_name":"helsing-ai/buffrs","owner":"helsing-ai","description":"Modern protobuf package management","archived":false,"fork":false,"pushed_at":"2025-01-10T14:11:10.000Z","size":1890,"stargazers_count":249,"open_issues_count":48,"forks_count":13,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-04-07T02:08:19.547Z","etag":null,"topics":["distribution","package-manager","protobuf","protocol-buffers","registry"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/buffrs","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/helsing-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-13T15:43:56.000Z","updated_at":"2025-04-04T13:51:10.000Z","dependencies_parsed_at":"2023-10-12T20:17:27.988Z","dependency_job_id":"f661cc93-d519-4762-97ca-f12f47b1afb2","html_url":"https://github.com/helsing-ai/buffrs","commit_stats":null,"previous_names":["helsing-ai/buffrs"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helsing-ai%2Fbuffrs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helsing-ai%2Fbuffrs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helsing-ai%2Fbuffrs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helsing-ai%2Fbuffrs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/helsing-ai","download_url":"https://codeload.github.com/helsing-ai/buffrs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248852116,"owners_count":21171839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["distribution","package-manager","protobuf","protocol-buffers","registry"],"created_at":"2024-08-02T00:00:40.374Z","updated_at":"2025-04-14T08:57:04.788Z","avatar_url":"https://github.com/helsing-ai.png","language":"Rust","readme":"\u003c!-- markdownlint-disable-next-line --\u003e\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://github.com/helsing-ai/buffrs/assets/37018485/76c51445-b5a6-4f4e-a39c-7de7e31a0613\" onerror=\"this.style.display='none'\" /\u003e\n\u003cbr/\u003e\n\n# Buffrs\n\n**Modern protobuf package management**\n\n[![Helsing](https://img.shields.io/badge/helsing-open%20source-black.svg)](https://helsing.ai)\n[![Buffrs Crate](https://img.shields.io/crates/v/buffrs.svg)](https://crates.io/crates/buffrs)\n[![Buffrs Book](https://img.shields.io/badge/book-latest-blueviolet.svg)](https://helsing-ai.github.io/buffrs)\n[![Buffrs Docs](https://img.shields.io/badge/docs-latest-blue.svg)](https://docs.rs/buffrs)\n![Nix Flake](https://img.shields.io/github/actions/workflow/status/helsing-ai/buffrs/nix.yml?logo=nixos\u0026label=flake)\n\n\u003c/div\u003e\n\n## Quickstart\n\n```bash,ignore\n$ cargo install buffrs\n$ buffrs login\n$ buffrs init --api\n$ buffrs add \u003cdependency\u003e\n$ buffrs install\n```\n\nUseful resources:\n\n- [The Buffrs Book](https://helsing-ai.github.io/buffrs)\n- [Crate Documentation](https://docs.rs/buffrs)\n- [Announcement Post](https://blog.helsing.ai/buffrs-a-package-manager-for-protocol-buffers-1-2-aaf7c00153d2)\n- `buffrs help`\n\n## Synopsis\n\n```text,ignore\nModern protobuf package management\n\nUsage: buffrs \u003cCOMMAND\u003e\n\nCommands:\n  init       Initializes a buffrs setup\n  new        Creates a new buffrs package in the current directory\n  lint       Check rule violations for this package\n  add        Adds dependencies to a manifest file\n  remove     Removes dependencies from a manifest file\n  package    Exports the current package into a distributable tgz archive\n  publish    Packages and uploads this api to the registry\n  install    Installs dependencies\n  uninstall  Uninstalls dependencies\n  list       Lists all protobuf files managed by Buffrs to stdout\n  login      Logs you in for a registry\n  logout     Logs you out from a registry\n  lock       Lockfile related commands\n  help       Print this message or the help of the given subcommand(s)\n\nOptions:\n  -h, --help     Print help\n  -V, --version  Print version\n```\n\n## Motivation\n\nProtocol buffers are agreeably a great way to define fully typed,\nlanguage-independent API schemas with strong backward compatibility guarantees.\nThey offer a neat experience for API consumers through generated bindings. *The\nbiggest problem associated with Protocol Buffers is their distribution.*\n\n- How do you consume the raw protobuf files of one project reliably in another\n  one?\n- How do you prevent transitive dependencies?\n- How do you publish to a unified registry with package format across\n  languages?\n\nOne obvious way is to generate code bindings in the repository containing the\nProtocol Buffers and publish the generated bindings, but this is associated\nwith problems such as language lock-in. You need to proactively publish\nbindings for any possible language your API consumers may use. Also, in\nstrongly typed languages like Rust, it is hard to extend the behavior of\ngenerated code in consuming projects due to _the orphan rule_. Summing up: this\napproach works somehow but hurts frequently.\n\nThis is where Buffrs comes in: Buffrs solves this by defining a strict,\npackage-based distribution mechanism and treats Protocol Buffers as a\nfirst-class citizen.\n\n*This allows you to publish Buffrs packages to a registry and properly depend\non them in other projects.*\n\n\n## Roadmap\n\n- [x] Support project manifests and dependency declaration\n- [x] Support package distribution via Artifactory\n- [x] Support tonic as code generation backend\n- [x] Support protoc as code generation backend\n- [ ] Implement `buffrs-registry`, a self-hostable, S3-based registry.\n- [ ] Supply tooling around Protocol Buffers, such as bindgen, linting, validation and\n  formatting.\n","funding_links":[],"categories":["Applications","Protocol Buffers","package-manager"],"sub_categories":["Package Managers"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelsing-ai%2Fbuffrs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelsing-ai%2Fbuffrs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelsing-ai%2Fbuffrs/lists"}