1
0
mirror of https://github.com/nxshock/zkv.git synced 2024-11-27 11:21:02 +05:00

Add README with small amount of documentation

This commit is contained in:
nxshock 2022-12-02 21:37:56 +05:00
parent db25842429
commit b5043e1319

55
README.md Normal file
View File

@ -0,0 +1,55 @@
# zkv
Simple key-value store for single-user applications.
## Pros
* Simple file structure
* Internal compression
* Threadsafe operations through `sync.RWMutex`
## Cons
* Index stored in memory (`map[key hash (28 bytes)]file offset (int64)`)
* Need to read the whole file on store open to create file index
* No way to recover disk space from deleted records
* Write/Delete operations block Read and each other operations
## Usage
Create or open existing file:
```go
db, err := Open("path to file")
```
Data operations:
```go
// Write data
err = db.Set(key, value) // key and value can be any of type
// Read data
var value ValueType
err = db.Get(key)
// Delete data
err = db.Delete(key)
```
## File structure
Record is `encoding/gob` structure:
| Field | Description | Size |
| ---------- | ---------------------------------- | -------- |
| Type | Record type | uint8 |
| KeyHash | Key hash | 28 bytes |
| ValueBytes | Value gob-encoded bytes | variable |
File is log stuctured list of commands:
| Field | Description | Size |
| -------| ------------------------ | -------- |
| Length | Record body bytes length | int64 |
| Body | Gob-encoded record | variable |