Update README
This commit is contained in:
parent
2a8babd0c1
commit
f9e0cfa41e
64
README.md
64
README.md
@ -1,26 +1,27 @@
|
|||||||
Short - simple go url shortner
|
# Short - simple go url shortner
|
||||||
==============================
|
|
||||||
|
|
||||||
[](https://git.thebarrens.nu/wolvie/short/blob/master/LICENSE)
|
[](https://git.thebarrens.nu/wolvie/short/blob/master/LICENSE)
|
||||||
[](https://git.thebarrens.nu/wolvie/short/)
|
[](https://git.thebarrens.nu/wolvie/short/)
|
||||||
Short is a very simple url shortener build in golang using web.go module for storring URLs, the main focus is speed, not data is persisted.
|
Short is a very simple url shortener build in golang using gorilla/mux for url routing and go-cache for storring URLs, the main focus is speed, not data is persisted, but can be dumped and restored.
|
||||||
|
|
||||||
|
## Syntax is
|
||||||
Syntax is:
|
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
Usage of short:
|
Usage of short:
|
||||||
-addr string
|
-addr string
|
||||||
Address to listen for connections (default "localhost:8080")
|
Address to listen for connections (default "localhost")
|
||||||
-domain string
|
-domain string
|
||||||
Domain to write to the URLs (default "localhost")
|
Domain to write to the URLs (default "localhost")
|
||||||
|
-dump string
|
||||||
|
Path to the file to dump the kv db (default "urls.json")
|
||||||
-path string
|
-path string
|
||||||
Path to the base URL (https://localhost/PATH/... remember to append a / at the end
|
Path to the base URL (https://localhost:8080/PATH/... remember to append a / at the end
|
||||||
|
-port string
|
||||||
|
Port to listen for connections (default "8080")
|
||||||
-proto string
|
-proto string
|
||||||
proto to the base URL (HTTPS://localhost/path/... no real https here just to set the url (for like a proxy offloading https (default "https")
|
proto to the base URL (HTTPS://localhost:8080/path/... no real https here just to set the url (for like a proxy offloading https (default "https")
|
||||||
-redis string
|
-v
|
||||||
ip/hostname of the redis server to connect (default "localhost:6379")
|
prints current version
|
||||||
-v prints current version
|
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
@ -32,3 +33,44 @@ To shorten a URL just post on /, you will get a reply with the shortened URL
|
|||||||
curl -X POST -d "url=http://google.com" http://localhost:8080/
|
curl -X POST -d "url=http://google.com" http://localhost:8080/
|
||||||
URL shortened at: https://localhost:8080/9mbIcOwsVP
|
URL shortened at: https://localhost:8080/9mbIcOwsVP
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Dump/Restore endpoints
|
||||||
|
|
||||||
|
URL mapping data can be checked, listed, dumped and restored in the given endpoints:
|
||||||
|
|
||||||
|
Show the number of mapped urls
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ curl http://localhost:8080/v1/count
|
||||||
|
X
|
||||||
|
```
|
||||||
|
|
||||||
|
Dumps the mapped url to json
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ curl http://localhost:8080/v1/dump
|
||||||
|
[...] #json of mapped urls
|
||||||
|
```
|
||||||
|
|
||||||
|
Dump the mapped url to `-dump` file (defaults to ./urls.json)
|
||||||
|
|
||||||
|
```shel
|
||||||
|
$ curl http://localhost:8080/v1/dumpToFile
|
||||||
|
Dump writen to: urls.json
|
||||||
|
```
|
||||||
|
|
||||||
|
Load url mappings from `-dimp` file to in memory db
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ curl http://localhost:8080/v1/fromFile
|
||||||
|
OK
|
||||||
|
```
|
||||||
|
|
||||||
|
Load url mappings from POST data (Assuming json data on save.json file)
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ curl -X POST http://localhost:8080/v1/fromPost \ ✔ 0.59 L
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
--data $(cat save.json )
|
||||||
|
OK
|
||||||
|
```
|
Loading…
x
Reference in New Issue
Block a user