https://github.com/0xopenbytes/c
📦 Micro Composition using Transformations and Cache
https://github.com/0xopenbytes/c
cache swift transformations transformers
Last synced: 11 months ago
JSON representation
📦 Micro Composition using Transformations and Cache
- Host: GitHub
- URL: https://github.com/0xopenbytes/c
- Owner: 0xOpenBytes
- Created: 2022-02-23T23:59:01.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-03-06T23:45:37.000Z (over 3 years ago)
- Last Synced: 2025-07-16T07:13:38.259Z (11 months ago)
- Topics: cache, swift, transformations, transformers
- Language: Swift
- Homepage: https://0xopenbytes.github.io/c/
- Size: 34.2 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
c
Micro Composition
## What is `c`?
`c` is a simple composition framework. You have the ability to create transformations that are either unidirectional or bidirectional. There is also a cache that values can be set and resolved.
## Where can `c` be used?
`c` can be used anywhere to create transformations or interact with the cache.
## Examples
### BiDirectionalTransformation of String and Int
```swift
let transformer = c.transformer(
from: { string in Int(string) },
to: { int in "\(String(describing: int))" }
)
let string = transformer.to(3)
let int = transformer.from("3")
try t.assert(transformer.to(int), isEqualTo: string)
```
### Cache
```swift
let cache = c.Cache()
cache.set(value: Double.pi, forKey: "🥧")
let pi: Double = cache.get("🥧") ?? 0
try t.assert(pi, isEqualTo: .pi)
let resolvedValue: Double = try cache.resolve("🥧")
try t.assert(resolvedValue, isEqualTo: .pi)
cache.remove("🥧")
let nilValue: Double? = cache.get("🥧")
try t.assert(isNil: nilValue)
```
### Cache
```swift
enum CacheKey: Hashable { ... }
let cache = c.Cache()
cache.set(value: Double.pi, forKey: CacheKey.piKey)
let pi: Double = cache.get(.piKey) ?? 0
try t.assert(pi, isEqualTo: .pi)
let resolvedValue: Double = try cache.resolve(.piKey)
try t.assert(resolvedValue, isEqualTo: .pi)
cache.remove(.piKey)
let nilValue: Double? = cache.get(.piKey)
try t.assert(isNil: nilValue)
```
### JSON
```swift
enum MockJSONKey: String, Hashable {
case name, number, bool, invalid_key
}
struct MockJSON: Codable {
var name: String
var number: Int
var bool: Bool
}
let jsonData: Data = try! JSONEncoder().encode(MockJSON(name: "Twitch", number: 5, bool: false))
let json: c.JSON = .init(data: jsonData)
XCTAssertEqual(try! json.resolve(.name), "Twitch")
XCTAssertEqual(try! json.resolve(.number), 5)
XCTAssertEqual(try! json.resolve(.bool), false)
let invalid_key: Bool? = json.get(.invalid_key)
XCTAssertNil(json.get(.invalid_key))
XCTAssertNil(invalid_key)
json.set(value: "Leif", forKey: .name)
XCTAssertEqual(try! json.resolve(.name), "Leif")
```
### Global Cache
```swift
let someCache: Cache = ...
// Set the value of a Cache with any hashable key
c.set(value: someCache, forKey: "someCache")
// Get an optional Cache using any hashable key
let anotherCache: Cache? = c.get(0)
// Require that a Cache exist using a `.get` with a force unwrap
let requiredCache: Cache = try c.resolve(0)
let keyedCache: KeyedCache = try c.resolve(...)
```