commit all archived files
This commit is contained in:
parent
df7107a020
commit
3e8600a09e
59
README.md
Normal file
59
README.md
Normal file
@ -0,0 +1,59 @@
|
||||
# tagserver
|
||||
|
||||
![](https://img.shields.io/badge/written%20in-golang-blue)
|
||||
|
||||
An in-memory key-value store with HTTP interface.
|
||||
|
||||
This is a quick-and-dirty key-value store accessible over HTTP.
|
||||
|
||||
- Both keys and values must be representable as a string.
|
||||
- Keys are split into two parts in order to optimise first-level list queries.
|
||||
- The underlying structure allows concurrent read queries, but a write will temporarily lock the storage against reads.
|
||||
- The data is asynchronously persisted to disk; after every write, a timestamp is sent to a background writer thread. If the writer's last write started before this timestamp, a new write action will be initiated.
|
||||
- Binaries are provided for win64, but the code is cross-platform Golang and should compile cleanly on other platforms.
|
||||
|
||||
## Daemon
|
||||
|
||||
|
||||
```
|
||||
Usage of tagserver:
|
||||
-bindaddr string
|
||||
Bind address, can be blank
|
||||
-datafile string
|
||||
Persistence storage file (default "tagserver.json")
|
||||
-debug
|
||||
Display debug log on stdout
|
||||
-port int
|
||||
Port for web server (default 8080)
|
||||
|
||||
```
|
||||
|
||||
|
||||
## API
|
||||
|
||||
- GET `/get/KEY_FIRST/KEY_SECOND`
|
||||
- GET `/get/KEY_FIRST`
|
||||
- POST `/set/KEY_FIRST/KEY_SECOND`
|
||||
|
||||
## Example Usage
|
||||
|
||||
|
||||
```
|
||||
$ curl -X POST -d "thevalue" http://HOST/set/KEY_FIRST/KEY_SECOND
|
||||
OK
|
||||
$ curl http://HOST/get/KEY_FIRST/KEY_SECOND
|
||||
thevalue
|
||||
$ curl http://HOST/get/KEY_FIRST/
|
||||
{"KEY_SECOND":"thevalue"}
|
||||
$ curl http://HOST/get/KEY_FIRST/KEY_NOT_YET_SET
|
||||
404 Not Found
|
||||
|
||||
```
|
||||
|
||||
|
||||
## Changelog
|
||||
|
||||
2015-10-08: r04
|
||||
- Initial public release
|
||||
- [⬇️ tagserver-r04.7z](dist-archive/tagserver-r04.7z) *(1.43 MiB)*
|
||||
|
BIN
dist-archive/tagserver-r04.7z
Normal file
BIN
dist-archive/tagserver-r04.7z
Normal file
Binary file not shown.
BIN
doc/screenshot.png
Normal file
BIN
doc/screenshot.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 16 KiB |
Reference in New Issue
Block a user