Dalli ![Tests](https://github.com/petergoldstein/dalli/actions/workflows/tests.yml/badge.svg)
Dalli is a high performance pure Ruby client for accessing memcached servers.
Dalli supports:
- Simple and complex memcached configurations
- Failover between memcached instances
- Fine-grained control of data serialization and compression
- Thread-safe operation (either through use of a connection pool, or by using the Dalli client in threadsafe mode)
- SSL/TLS connections to memcached
- SASL authentication
The name is a variant of Salvador Dali for his famous painting The Persistence of Memory.
![Persistence of Memory](https://upload.wikimedia.org/wikipedia/en/d/dd/The_Persistence_of_Memory.jpg)
Documentation and Information
- User Documentation - The documentation is maintained in the repository's wiki.
- Announcements - Announcements of interest to the Dalli community will be posted here.
- Bug Reports - If you discover a problem with Dalli, please submit a bug report in the tracker.
- Forum - If you have questions about Dalli, please post them here.
- Client API - Ruby documentation for the
Dalli::Client
API
Development
After checking out the repo, run bin/setup
to install dependencies. You can run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
.
Contributing
If you have a fix you wish to provide, please fork the code, fix in your local project and then send a pull request on github. Please ensure that you include a test which verifies your fix and update the changelog with a one sentence description of your fix so you get credit as a contributor.
Appreciation
Dalli would not exist in its current form without the contributions of many people. But special thanks go to several individuals and organizations:
- Mike Perham - for originally authoring the Dalli project and serving as maintainer and primary contributor for many years
- Eric Wong - for help using his kgio library.
- Brian Mitchell - for his remix-stash project which was helpful when implementing and testing the binary protocol support.
- CouchBase - for their sponsorship of the original development
Authors
Copyright
Copyright (c) Mike Perham, Peter M. Goldstein. See LICENSE for details.