{"id":13670854,"url":"https://github.com/facebook/CacheLib","last_synced_at":"2025-04-27T13:33:10.655Z","repository":{"id":37257982,"uuid":"223490876","full_name":"facebook/CacheLib","owner":"facebook","description":"Pluggable in-process caching engine to build and scale high performance services","archived":false,"fork":false,"pushed_at":"2025-04-26T16:35:51.000Z","size":26936,"stargazers_count":1303,"open_issues_count":34,"forks_count":277,"subscribers_count":52,"default_branch":"main","last_synced_at":"2025-04-26T17:32:44.007Z","etag":null,"topics":["cache","cache-engine","concurrency","cpp","performance","ssd"],"latest_commit_sha":null,"homepage":"https://www.cachelib.org","language":"C++","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/facebook.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null}},"created_at":"2019-11-22T21:39:48.000Z","updated_at":"2025-04-26T16:35:54.000Z","dependencies_parsed_at":"2024-06-13T19:32:07.200Z","dependency_job_id":"dc108577-19fa-4daf-bc89-74e86feaa9ba","html_url":"https://github.com/facebook/CacheLib","commit_stats":{"total_commits":5894,"total_committers":130,"mean_commits":45.33846153846154,"dds":"0.44893111638954875","last_synced_commit":"0ca68346c7f224df2a7a885f75e85ea5fc7e4e1c"},"previous_names":[],"tags_count":167,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook%2FCacheLib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook%2FCacheLib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook%2FCacheLib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook%2FCacheLib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/facebook","download_url":"https://codeload.github.com/facebook/CacheLib/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251145747,"owners_count":21543095,"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":["cache","cache-engine","concurrency","cpp","performance","ssd"],"created_at":"2024-08-02T09:00:50.807Z","updated_at":"2025-04-27T13:33:05.630Z","avatar_url":"https://github.com/facebook.png","language":"C++","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=\"500\" height=\"140\" alt=\"CacheLib\" src=\"website/static/img/CacheLib-Logo-Large-transp.png\"\u003e\n\u003c/p\u003e\n\n# CacheLib\n\nPluggable caching engine to build and scale high performance cache services. See\n[www.cachelib.org](https://cachelib.org) for documentation and more information.\n\n\n## What is CacheLib ?\n\nCacheLib is a C++ library providing in-process high performance caching\nmechanism. CacheLib provides a thread safe API to build high throughput,\nlow overhead caching services, with built-in ability to leverage\nDRAM and SSD caching transparently.\n\n\n## Performance benchmarking\n\nCacheLib provides a standalone executable `CacheBench` that can be used to\nevaluate the performance of heuristics and caching hardware platforms against\nproduction workloads. Additionally `CacheBench` enables stress testing\nimplementation and design changes to CacheLib to catch correctness and\nperformance issues.\n\nSee [CacheBench](https://cachelib.org/docs/Cache_Library_User_Guides/Cachebench_Overview) for usage details\nand examples.\n\n## Versioning\nCacheLib has one single version number `facebook::cachelib::kCachelibVersion` that can be located at [CacheVersion.h](https://github.com/facebook/CacheLib/blob/main/cachelib/allocator/CacheVersion.h#L31). This version number must be incremented when incompatible changes are introduced. A change is incompatible if it could cause a complication failure due to removing public API or requires dropping the cache. Details about the compatibility information when the version number increases can be found in the [changelog](https://github.com/facebook/CacheLib/blob/main/CHANGELOG.md).\n\n\n## Building and installation\n\nCacheLib provides a build script which prepares and installs all\ndependencies and prerequisites, then builds CacheLib.\nThe build script has been tested to work on CentOS 8,\nUbuntu 18.04, and Debian 10.\n\n```sh\ngit clone https://github.com/facebook/CacheLib\ncd CacheLib\n./contrib/build.sh -d -j -v\n\n# The resulting library and executables:\n./opt/cachelib/bin/cachebench --help\n```\n\nRe-running `./contrib/build.sh` will update CacheLib and its dependencies\nto their latest versions and rebuild them.\n\nSee [build](https://cachelib.org/docs/installation/) for more details about\nthe building and installation process.\n\n\n## Contributing\n\nWe'd love to have your help in making CacheLib better. If you're interested,\nplease read our [guide to contributing](CONTRIBUTING.md)\n\n\n\n## License\n\nCacheLib is *apache* licensed, as found in the [LICENSE](LICENSE) file.\n\n\n\n## Reporting and Fixing Security Issues\n\nPlease do not open GitHub issues or pull requests - this makes the problem\nimmediately visible to everyone, including malicious actors. Security issues in\nCacheLib can be safely reported via Facebook's Whitehat Bug Bounty program:\n\nhttps://www.facebook.com/whitehat\n\nFacebook's security team will triage your report and determine whether or not is\nit eligible for a bounty under our program.\n\n\n## Build status\n\nClicking on a badge will show you the recent builds for that OS. If your target OS's build is failing, you may check out the latest [release](https://github.com/facebook/CacheLib/releases). If the release is too stale for you, you may wish to check recent issues and PRs for known workarounds.\n\n- [![CentOS 9](https://github.com/facebook/cachelib/actions/workflows/build-cachelib-centos-9.yml/badge.svg?event=schedule)](https://github.com/facebook/cachelib/actions/workflows/build-cachelib-centos-9.yml?query=event%3Aschedule)\n- [![Rocky Linux 9](https://github.com/facebook/cachelib/actions/workflows/build-cachelib-rockylinux-9.yml/badge.svg?event=schedule)](https://github.com/facebook/cachelib/actions/workflows/build-cachelib-rockylinux-9.yml?query=event%3Aschedule)\n- [![Ubuntu 22](https://github.com/facebook/cachelib/actions/workflows/build-cachelib-ubuntu-22.yml/badge.svg?event=schedule)](https://github.com/facebook/cachelib/actions/workflows/build-cachelib-ubuntu-22.yml?query=event%3Aschedule)\n","funding_links":[],"categories":["C++"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacebook%2FCacheLib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffacebook%2FCacheLib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacebook%2FCacheLib/lists"}