fb303

{
  "aliases": [],
  "alternatives": [
    "gRPC",
    "Cap\u0027n Proto",
    "Protocol Buffers"
  ],
  "build_dependencies": [
    "cmake",
    "fizz",
    "mvfst"
  ],
  "categories": [
    "library",
    "thrift",
    "rpc",
    "networking"
  ],
  "caveats": null,
  "conflicts_with": [],
  "dependencies": [
    "fbthrift",
    "fmt",
    "folly",
    "gflags",
    "glog"
  ],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "Thrift functions for querying information from a service",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:37:32+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "fb303",
  "github_default_branch": "main",
  "github_last_commit_at": "2026-06-20T16:35:56Z",
  "github_readme_excerpt": "# fb303\n\nfb303 is a base [Thrift](https://github.com/facebook/fbthrift) service\nand a common set of functionality for querying stats, options, and\nother information from a service.\n\n## Dependencies\n\nfb303 depends on\n* [folly](https://github.com/facebook/folly)\n* [gflags](https://gflags.github.io/gflags/)\n* [glog](https://github.com/google/glog)\n* [fbthrift](https://github.com/facebook/fbthrift)\n\nAnd all transitive dependencies of the above.\n\n## Using fb303 for your service\n\nYou can have your own thrift service interface extend `fb303_core.BaseService` to\nutilize the fb303 API. Some of the primary interfaces defined by fb303 are:\n* `getStatus()` - Query the state of a running service.\n* `getCounters()` - Get custom statistics about the performance and behavior of\na service.\n* `getExportedValues()` - Get arbitrary string values exported by a service.\nThis can be used to export things such as the build metadata (version info and\nthe source control commit ID it was built from) and other key configuration\ninformation.\n* `getOptions()` / `setOption()` - Get and set configurable service parameters.\n\nC++ service handler implementations can extend `facebook::fb303::BaseService` for\ndefault implementations of the Thrift methods.\n\n## Curious about the name?\n\nWikipedia: http://en.wikipedia.org/wiki/Roland_TB-303\n\nThe TB-303 makes bass lines.\n\nBass is what lies underneath any strong tune.\n\nfb303 is the shared root of all Thrift services.\n\nfb303 \u21d2 FacebookBase303.\n\n## Join the fb303 community\n\nSee the CONTRIBUTING file for how to help out.\n\n## License\n\nfb303 is licensed under Apache 2.0 as found in the LICENSE file.\n\n## Note\n\nfb303 is a dependency of many other projects at Facebook which expose\nThrift interfaces; some which have been open-sourced. Examples include\n[edenfs](https://github.com/facebook/sapling),\n[proxygen](https://github.com/facebook/proxygen), and\n[fboss](https://github.com/facebook/fboss).\n\nThis project has evolved over many years, and parts of it predate\nC++11. ",
  "github_repo": "facebook/fb303",
  "github_stars": 93,
  "github_topics": [],
  "homepage": "https://github.com/facebook/fb303",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 15776,
  "installs_365d": 192386,
  "installs_90d": 43249,
  "keg_only": 0,
  "keg_only_reason": null,
  "last_seen": "2026-06-20T23:34:18+00:00",
  "license": "Apache-2.0",
  "llm_generated_at": "2026-06-20T23:43:50+00:00",
  "llm_model": "claude-haiku-4-5",
  "name": "fb303",
  "oldnames": [],
  "one_liner": "C++ Thrift library providing base service interfaces for querying stats, counters, and metadata from networked services.",
  "optional_dependencies": [],
  "rank_30d": 271,
  "rank_365d": 292,
  "rank_90d": 302,
  "raw_hash": "5c7c9af8f8973548",
  "recommended_dependencies": [],
  "revision": 0,
  "ruby_source_path": "Formula/f/fb303.rb",
  "tap": "homebrew/core",
  "test_dependencies": [
    "cmake",
    "fizz",
    "mvfst"
  ],
  "uses_from_macos": [],
  "version_head": "HEAD",
  "version_stable": "2026.06.15.00",
  "versioned_formulae": [],
  "why_use_this": "fb303 is a foundational library when building Thrift-based services in C++, offering standard interfaces for service health/status queries, performance counters, and configuration management. It\u0027s Facebook\u0027s standard base service layer\u2014if you\u0027re integrating with or extending Thrift services in the Meta/Facebook ecosystem, or want a battle-tested RPC service foundation, this is the canonical choice."
}