https://github.com/iamlongalong/imagine

imagine is a file based app system
https://github.com/iamlongalong/imagine

Last synced: 8 days ago
JSON representation

imagine is a file based app system

• Host: GitHub
• URL: https://github.com/iamlongalong/imagine
• Owner: iamlongalong
• License: apache-2.0
• Created: 2023-03-04T16:44:01.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2023-11-02T06:51:33.000Z (about 1 year ago)
• Last Synced: 2023-11-02T07:33:23.761Z (about 1 year ago)
• Language: Go
• Size: 72.3 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# imagine

imagine is a diskmap implementation

for some case, we has map which got a large number of members, and then lack of RAM happens……

for the purpose of saving shortage RAM resource, we designed this diskmap project. Just like its name, we use cheap disk storage for the most records in a map, and high-performance, expensive ram for cache.

# usage

you can use it as : 

```golang

ctx := context.Background()

dmaps, err := NewDmaps(DmapsOption{Dir: "testdata"})

if err != nil {

  log.Println(err)

  return

}

defer dmaps.Close(ctx)

m := dmaps.MustGetMap(ctx, "users")

m.Set(ctx, "longalong", []byte("i am longalong, nice to meet you ~"))

v, err := m.Get(ctx, "longalong")

if err != nil {

  log.Println(err)

  return

}

log.Println(v)

```

# TODOs

- [x] ~~add valuer registry~~ [2023-03-26]

- [x] ~~memmap save to diskmap~~ [2023-03-26]

- [ ] implement merger

- [ ] wal for recover

- [x] ~~force valuer type (bind valuer with map namespace)~~ [2023-03-26]

- [ ] generate valuer with pb/~~gob/json~~/msgpack

- [ ] implement compresser

- [ ] valuer with wasm

- [ ] use pb for internal struct marshaller (using json and gob now)

- [ ] add server implement

- [ ] add server client

- [ ] implement listener

- [ ] support package db and index

- [ ] use mmap for disk cache

- [ ] dmap cache with ttl

- [ ] benchmark and more tests

- [ ] examples and documents

- [ ] optimize the index file structure (data file also)

- [ ] with relations define in model (like join query)

- [ ] UI viewer for monitoring

- [ ] add remote storage map

- [ ] add primary and standby structure

- [ ] add cluster structure

- [ ] with crdt support

# other

这个项目的一些前置信息可以参考 [我的一次内部分享](https://blog.longalong.cn/posts/23_03_28_15_01_a_record_of_sharing_of_database.html)