{"id":22509473,"url":"https://github.com/kernel0x/falcon","last_synced_at":"2025-08-03T13:31:29.314Z","repository":{"id":258721806,"uuid":"221905244","full_name":"kernel0x/falcon","owner":"kernel0x","description":"📦 Thread-safe, crypto-protected, multi-level lru caching with a life cycle","archived":false,"fork":false,"pushed_at":"2023-04-24T08:29:41.000Z","size":179,"stargazers_count":8,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-20T10:17:29.542Z","etag":null,"topics":["android","android-library","cache","cachemanager","lru","lru-cache","lrucache"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kernel0x.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2019-11-15T10:55:49.000Z","updated_at":"2024-04-28T05:16:00.000Z","dependencies_parsed_at":"2024-10-20T10:17:43.157Z","dependency_job_id":"ea2f6255-3778-4628-a294-c1a6a1a6d9e7","html_url":"https://github.com/kernel0x/falcon","commit_stats":null,"previous_names":["kernel0x/falcon"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kernel0x%2Ffalcon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kernel0x%2Ffalcon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kernel0x%2Ffalcon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kernel0x%2Ffalcon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kernel0x","download_url":"https://codeload.github.com/kernel0x/falcon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228548402,"owners_count":17935203,"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":["android","android-library","cache","cachemanager","lru","lru-cache","lrucache"],"created_at":"2024-12-07T01:29:12.267Z","updated_at":"2024-12-07T01:29:12.924Z","avatar_url":"https://github.com/kernel0x.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Falcon\nA lightweight and simple library to cache any serializable objects, using the LRU algorithm, two storage levels (files, memory), encryption and life cycle.\n\n## Gradle Dependency\n\nAdd it in your root build.gradle at the end of repositories:\n\n````java\nallprojects {\n  repositories {\n    ...\n    maven { url \"https://jitpack.io\"}\n  }\n}\n````\n\nAdd the dependency:\n\n````java\ndependencies {\n  implementation 'com.github.kernel0x:falcon:1.0.2'\n}\n````\n\n## How to use\n\nCreate an object using the builder.\n\n````java\nCache\u003cObject\u003e cache = new Cache.Builder().build(getContext());\n````\nOR with special type\n\n````java\nCache\u003cCat\u003e cache = new Cache.Builder().build(getContext());\n````\nAvailable methods in the Builder\n\n- **defaultLifetime** *default cache lifetime*\n- **maxSize** *maximum cache size (file and ram)*\n- **caseSensitiveKeys** *key case sensitivity*\n- **autoCleanup** *auto clean timer time*\n- **dualCacheMode** *caching mode*\n- **encryptStrategy** *encryption algorithm*\n\nEverything is simple. Now you can cache something.\nImportant! Cached objects must implement Serializable\n\n### Examples:\n````java\ncache.set(KEY, new Cat());\n````\n````java\ncache.set(KEY, new Cat(), DualCacheMode.ONLY_DISK);\n````\n````java\ncache.set(KEY, new Cat(), DualCacheMode.ONLY_RAM);\n````\n````java\ncache.set(KEY, new Cat(), new Duration(1, TimeUnit.SECONDS));\n````\n\n## Features\n\n* encryption\n* cache location selection (file or memory)\n* LRU, cache extrusion method\n* cache lifetime selection\n* thread safe\n\n## Tests\nIt's totally tested. [Check the tests!](/app/src/test/java/com/kernel/falcon) :wink:\n\n## Releases\nCheckout the [Releases](https://github.com/kernel0x/falcon/releases) tab for all release info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernel0x%2Ffalcon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkernel0x%2Ffalcon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernel0x%2Ffalcon/lists"}