{"id":18832542,"url":"https://github.com/jiisanda/pandas-pouch","last_synced_at":"2026-01-30T20:03:25.618Z","repository":{"id":226668367,"uuid":"769274443","full_name":"jiisanda/pandas-pouch","owner":"jiisanda","description":"🐼🐼A Distributed Caching Service in Rust 🦀🦀","archived":false,"fork":false,"pushed_at":"2024-10-25T16:06:36.000Z","size":229,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-12T21:54:48.987Z","etag":null,"topics":["cache","distributed","distributed-systems","github-actions","grpc","pandas-pouch","postgresql","rust","tokio","tonic"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jiisanda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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,"zenodo":null}},"created_at":"2024-03-08T17:47:51.000Z","updated_at":"2024-10-05T21:56:04.000Z","dependencies_parsed_at":"2024-03-31T11:28:07.967Z","dependency_job_id":"f013c39a-15f5-49fc-8b7b-4e1320821a09","html_url":"https://github.com/jiisanda/pandas-pouch","commit_stats":null,"previous_names":["jiisanda/pandas-pouch"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jiisanda/pandas-pouch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiisanda%2Fpandas-pouch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiisanda%2Fpandas-pouch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiisanda%2Fpandas-pouch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiisanda%2Fpandas-pouch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jiisanda","download_url":"https://codeload.github.com/jiisanda/pandas-pouch/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiisanda%2Fpandas-pouch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28918235,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T19:10:10.838Z","status":"ssl_error","status_checked_at":"2026-01-30T19:06:40.573Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","distributed","distributed-systems","github-actions","grpc","pandas-pouch","postgresql","rust","tokio","tonic"],"created_at":"2024-11-08T01:58:08.542Z","updated_at":"2026-01-30T20:03:25.604Z","avatar_url":"https://github.com/jiisanda.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"![banner](static/banner.png)\r\n\r\n# 🐼 pandas-pouch 🐼\r\n\r\nA Distributed Caching Service with Rust 🦀🦀.\r\n\r\n\r\n## Progress\r\n\r\n- ✅ Basic Cache\r\n- ✅ LRU Cache\r\n- ✅ Database Setup\r\n- ✅ API Integration\r\n- ✅ Docker Setup\r\n- 🟡 Consistent Hashing\r\n- 🟡 Distributed Cache - Dedicated cache cluster\r\n\r\n## Pre-requisites\r\n\r\n- [Rust](https://www.rust-lang.org/tools/install)\r\n- [Docker](https://docs.docker.com/get-docker/)\r\n- gRPC\r\n  - [grpcurl](https://github.com/fullstorydev/grpcurl)\r\n\r\n## How can pandas-pouch be used with current features?\r\n\r\n### Configuration\r\n\r\nCreate a `config` directory. And add `default.toml` file with the following configuration.\r\nSample default.toml file is provided in the `config` directory [config/sample_default.toml](config/sample_default.toml). Also add a `.env` file with the \r\nconfiguration in [config/.env.sample](config/.env.sample) file.\r\n\r\n### Running the Service\r\n\r\n1. Clone the repository and navigate to the project directory.\r\n\r\n```bash\r\ngit clone https://github.com/jiisanda/pandas-pouch.git\r\ncd pandas-pouch\r\n```\r\n\r\n2. Start the service using `docker-compose`.\r\n\r\n```bash\r\ndocker-compose build\r\ndocker-compose up\r\n```\r\n\r\n### Interacting with the Service\r\n\r\nYou can use `grpcurl` to interact with the service. Install `grpcurl` using the installation guide in the [grpcurl repository](https://github.com/fullstorydev/grpcurl)\r\n\r\nRun the following command to interact with the service.\r\n\r\n1. Put operation\r\n```bash\r\ngrpcurl -plaintext -proto proto/pandas_pouch.proto -d '{\"key\": \"key2\", \"value\": \"value2\"}' 0.0.0.0:50051 pandas_pouch.PandasPouchCacheService/Put\r\n```\r\n\r\n2. Get Operation\r\n```bash\r\ngrpcurl -plaintext -proto proto/pandas_pouch.proto -d '{\"key\": \"key2\"}' 0.0.0.0:50051 pandas_pouch.PandasPouchCacheService/Get\r\n```\r\n\r\n3. PrintAll Operation\r\n```bash\r\ngrpcurl -plaintext -proto proto/pandas_pouch.proto 0.0.0.0:50051 pandas_pouch.PandasPouchCacheService/PrintAll\r\n```\r\n\r\n### pandas-pouch as a crate\r\n\r\nTo use pandas-pouch as a crate, add the following to your `Cargo.toml` file.\r\n\r\n```toml\r\n[dependencies]\r\npandas-pouch = { git = \"https://github.com/jiisanda/pandas-pouch.git\" }\r\n```\r\n\r\nUsing it in code:\r\n```rust\r\nuse pandas_pouch::Client;\r\n\r\n#[tokio::main]\r\nasync fn main() -\u003e Result\u003c(), Box\u003cdyn std::error::Error\u003e\u003e {\r\n  let mut client = Client::new(\"http://localhost:50051\").await?;\r\n  \r\n  // put a value\r\n  client.put(\"key1\".to_string(), \"value1\".to_string()).await?;\r\n  \r\n  // get a value\r\n  let value = client.get(\"key1\".to_string()).await?;\r\n  println!(\"Value: {:?}\", value);\r\n  \r\n  Ok(())\r\n}\r\n```\r\n\r\n## License\r\n\r\nThis project is licensed under the [MIT License](LICENSE).\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjiisanda%2Fpandas-pouch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjiisanda%2Fpandas-pouch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjiisanda%2Fpandas-pouch/lists"}