Multithreaded In-Memory Cache Server.
Available commands:
- set: Sets a value for a new or existing key
- get Retrieves the value of a single key
- mget Retrieves the value of one or more keys
- del Removes an item from the cache
- quit Quit client session
- ping Responds "pong"
You can build the project running make. The binaries will then be available at bin/mimcas-server and bin/mimcas-cli.
Dependencies:
go>= v1.17make
Command make run does the same but it will also start the server.
- Option 1: Docker:
docker run -p 20000:20000 pablogcaldito/mimcas-server:v0.1.0 [ARGUMENTS] - Option 2: Download and run binary: download from releases page and run
./mimcas-server [ARGUMENTS] - Option 3: Build from source:
make && ./bin/mimcas-server [ARGUMENTS].
None of them are required. The available flags are:
-port: Port to use for listening for incoming connections. By default it will be20000.-maxmemory: Maximum number of bytes available to use. Items will be evicted following LRU policy when that limit is crossed. By default there is no limit.
The only client for now is the CLI one. It will available when building the source code as well.
- Option 1: Docker:
docker run --network host -it pablogcaldito/mimcas-cli:v0.1.0 mimcas-cli [ARGUMENTS] - Option 2: Download and run binary: download from releases page and run
./mimcas-cli [ARGUMENTS] - Option 3: Build from source:
make && ./bin/mimcas-cli [ARGUMENTS].
None of them are required. The available flags are:
-host: Host to use when opening a connection. By default it will belocalhost.-port: Port to use when opening a connection. By default it will be20000.
>> get a
NULL
>> set a 2
OK
>> get a
OK
2
>> set b 3
OK
>> mget a b
OK
2
OK
3
>> del a
OK
>> get a
NULL
>> quit
This project is licensed under the Apache License Version 2.0
Pull requests are welcomed and encouraged. For questions, feature requests and bug reports, please open an issue.
There is also a TODO file containing work planned to do and also issues on GitHub.