{"id":16543204,"url":"https://github.com/codemation/easycaching","last_synced_at":"2026-02-03T22:34:48.695Z","repository":{"id":49162916,"uuid":"354153237","full_name":"codemation/easycaching","owner":"codemation","description":"Shared, persistent, and smart caching ","archived":false,"fork":false,"pushed_at":"2021-06-28T09:50:29.000Z","size":91,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-27T20:14:09.814Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/codemation.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}},"created_at":"2021-04-02T23:04:55.000Z","updated_at":"2022-06-25T04:39:03.000Z","dependencies_parsed_at":"2022-07-24T21:02:05.138Z","dependency_job_id":null,"html_url":"https://github.com/codemation/easycaching","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codemation/easycaching","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codemation%2Feasycaching","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codemation%2Feasycaching/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codemation%2Feasycaching/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codemation%2Feasycaching/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codemation","download_url":"https://codeload.github.com/codemation/easycaching/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codemation%2Feasycaching/sbom","scorecard":{"id":296743,"data":{"date":"2025-08-11","repo":{"name":"github.com/codemation/easycaching","commit":"0b613885fcc8814889c1aec1ddc15b48d982cbda"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Code-Review","score":0,"reason":"Found 0/12 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/main.yaml:1","Warn: no topLevel permission defined: .github/workflows/package.yaml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yaml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/codemation/easycaching/main.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yaml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/codemation/easycaching/main.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/package.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/codemation/easycaching/package.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/package.yaml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/codemation/easycaching/package.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/package.yaml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/codemation/easycaching/package.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/package.yaml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/codemation/easycaching/package.yaml/main?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/main.yaml:24","Warn: pipCommand not pinned by hash: .github/workflows/main.yaml:25","Warn: pipCommand not pinned by hash: .github/workflows/main.yaml:26","Warn: pipCommand not pinned by hash: .github/workflows/package.yaml:25","Warn: pipCommand not pinned by hash: .github/workflows/package.yaml:26","Warn: pipCommand not pinned by hash: .github/workflows/package.yaml:27","Warn: pipCommand not pinned by hash: .github/workflows/package.yaml:45","Warn: pipCommand not pinned by hash: .github/workflows/package.yaml:53","Info:   0 out of   6 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   8 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":5,"reason":"5 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2018-55 / GHSA-32pc-xphx-q4f6","Warn: Project is vulnerable to: GHSA-hc5x-x2vx-497g","Warn: Project is vulnerable to: GHSA-w3h3-4rj7-4ph4","Warn: Project is vulnerable to: GHSA-2jv5-9r88-3w3p","Warn: Project is vulnerable to: GHSA-59g5-xgcq-4qw3"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 7 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T19:44:09.884Z","repository_id":49162916,"created_at":"2025-08-17T19:44:09.884Z","updated_at":"2025-08-17T19:44:09.884Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29060578,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T22:28:58.191Z","status":"ssl_error","status_checked_at":"2026-02-03T22:28:56.515Z","response_time":96,"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":[],"created_at":"2024-10-11T18:59:38.429Z","updated_at":"2026-02-03T22:34:48.678Z","avatar_url":"https://github.com/codemation.png","language":"Python","readme":"![](docs/images/logo.png)\n\n#\n\nShared, persistent, and smart caching \n\n[![Documentation Status](https://readthedocs.org/projects/easycache/badge/?version=latest)](https://easycache.readthedocs.io/en/latest/?badge=latest)\n [![PyPI version](https://badge.fury.io/py/easycaching.svg)](https://badge.fury.io/py/easycaching)\n [![Test EasyCaching](https://github.com/codemation/easycaching/actions/workflows/main.yaml/badge.svg)](https://github.com/codemation/easycaching/actions/workflows/main.yaml)\n\n\u003ch2\u003eDocumentation\u003c/h1\u003e \n\n[https://easycache.readthedocs.io/en/latest/](https://easycache.readthedocs.io/en/latest/)\n\n## What is it?\neasycaching provides a single shared interface for storing and retreiving data from memory among many processes(forks) of an application.\n\n## Features\n- fast and shared access to data\n- persistent cache backed by a database\n- auto-forking\n- python syntax \n\n## Get Started\n```bash\npip install easycaching\n```\n\n## Cache Usage\n\n```python\nimport asyncio\nfrom easycaching import EasyCacheManager\n\nasync def main():\n    # create EasyCache instance\n    cache = await EasyCacheManager.create(\n        'test'\n    )\n\n    test = await cache.create_cache('test')\n\n    # set\n    await test.set('foo', 'bar')\n\n\n    # get\n    cached_value = await test.get('foo')\n\n    # boolean\n    exists = await test.contains('foo')\n\n    # iterate over cache items\n    async for cache_item in test:\n        print(cache_item)\n    \n    # delete\n    await test.delete('foo')\n\n    # clear all cache\n    await test.clear()\n\n    # access via manager\n    await cache.cache['test'].set('first', 'worst')\n    await cache.cache['test'].set('second', 'best')\n    await cache.cache['test'].set('third', 'treasure chest')\n\n    # safely exit\n    await cache.close()\n\nasyncio.run(main())\n\n```\n\n## Queue Usage\n\n```python\nimport asyncio\nfrom easycaching import EasyCacheManager\n\nasync def main():\n    # create EasyCache instance\n    cache = await EasyCacheManager.create(\n        'test'\n    )\n\n    test_queue = await cache.create_queue('test')\n\n    # add items to queue\n    await test_queue.put('first')\n    await test_queue.put('second')\n    await test_queue.put('third')\n\n    # grab items from queue\n    result = await test_queue.get()\n\n    await test_queue.get() # second\n    await test_queue.get() # third\n    result = await test_queue.get() # empty\n    {'warning': 'queue empty'}\n\n    # empty a queue\n    await test_queue.clear()\n\n    # accessing via manager\n\n    await cache.queues['test'].put('fourth')\n    await cache.queues['test'].put('fifth') \n\n    # safely exit\n    await cache.close()\n\n```\n\n\n## FastAPI Usage - Cache\n\n```python\n# basic.py\nfrom fastapi import FastAPI\nfrom easycaching import EasyCacheManager\n\napp = FastAPI()\n\n@app.on_event('startup')\nasync def start_cache():\n    app.cache = await EasyCacheManager.create(\n        'test'\n    )\n    # create cache instance\n    await app.cache.create_cache('test')\n\n\n@app.get('/cache')\nasync def view_cache(key: str):\n    return {\n        key:  await app.cache.cache['test'][key]\n    }\n\n@app.post('/cache')\nasync def set_cache(key: str, value: str):\n    return await app.cache.cache['test'].set(\n        key, \n        {'json': value}\n    )\n    \n```\n```bash\nuvicorn --host 0.0.0.0 --port 8230 basic:app --workers=5\n```\n\n## FastAPI Usage - Queue\n\n```python\n#basic.py\nfrom fastapi import FastAPI\nfrom easycaching import EasyCache\n\napp = FastAPI()\n\n@app.on_event('startup')\nasync def start_cache():\n    app.cache = await EasyCacheManager.create(\n        'test'\n    )\n    await app.cache.create_queue('test')\n\n@app.post('/queue')\nasync def create_queue(name: str):\n    queue = await app.cache.create_queue(name)\n    return f\"queue {name} created\"\n\n@app.post('/queue/{queue}')\nasync def add_to_queue(queue: str, data: dict):\n    return await cache.queues[queue].put(data)\n\n@app.get('/queue/{queue}')\nasync def pull_from_queue(queue: str):\n    return await cache.queues[queue].get()\n```\n\n```bash\nuvicorn --host 0.0.0.0 --port 8220 --workers 5 basic:app\n```\n\n\n\n## Under the Hood\neasycaching utilizes the smart caching of [aiopyql](https://github.com/codemation/aiopyql) to provide cache acesss, cache storage, and perhaps most importantly updates and invalidation.\n\nData access sharing is made possible via proxy methods using [easyrpc](https://github.com/codemation/easyrpc). A cache background task is created \u0026 managed by gunicorn which main application workers access via proxies. \n\n![](docs/images/easycaching-arch.png\n)\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodemation%2Feasycaching","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodemation%2Feasycaching","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodemation%2Feasycaching/lists"}