From a008326dd78c39c25647230bc6263b62307df280 Mon Sep 17 00:00:00 2001 From: Archivist Date: Sat, 11 Aug 2018 16:29:32 +0200 Subject: [PATCH] Updated the README --- README.md | 36 +++++++++++++++++++++++++++++------- 1 file changed, 29 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 40ba337..b21e2f9 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # crystal-scatter -TODO: Write a description here + ## Installation @@ -9,7 +9,8 @@ Add this to your application's `shard.yml`: ```yaml dependencies: crystal-scatter: - github: your-github-user/crystal-scatter + git: https://git.nekoit.xyz/Archivist/sales_backend + version: ~> 0.1.0 ``` ## Usage @@ -18,15 +19,34 @@ dependencies: require "crystal-scatter" ``` -TODO: Write usage instructions here +Create a MetaRing and add services to it, using the weights as a mark of the load the service can handle (example: number of threads each CPU of the servers can handle). -## Development +```crystal +client_ip = "185.124.235.1" + +ring = Crystal::Scatter::MetaRing.new(3) + +ring.add [ + Crystal::Scatter::Daemon (8 , [0,0,0,0,0,0], "https://api01.myservice.com"), + Crystal::Scatter::Daemon (16, [0,0,0,0,1,0], "https://api02.myservice.com"), + Crystal::Scatter::Daemon (12, [1,0,0,0,0,0], "https://api03.myservice.com"), + Crystal::Scatter::Daemon (12, [1,0,0,0,1,0], "https://api04.myservice.com"), + Crystal::Scatter::Daemon (12, [2,0,0,0,0,0], "https://api05.myservice.com") +] + +ring.get_slices_for(client_ip) +# => [ +# "https://api01.myservice.com", +# "https://api03.myservice.com", +# "https://api05.myservice.com" +# ] +``` -TODO: Write development instructions here +The output will provide you information to contact the service in a balanced way. ## Contributing -1. Fork it () +1. [Fork it](https://git.nekoit.xyz/repo/fork/18) 2. Create your feature branch (`git checkout -b my-new-feature`) 3. Commit your changes (`git commit -am 'Add some feature'`) 4. Push to the branch (`git push origin my-new-feature`) @@ -34,4 +54,6 @@ TODO: Write development instructions here ## Contributors -- [your-github-user](https://github.com/your-github-user) Ludovic 'Archivist' Lagouardette - creator, maintainer +- Ludovic 'Archivist' Lagouardette - creator, maintainer + - [Gitea](https://git.nekoit.xyz/Archivist) + - [Github](https://www.github.com/Zenohate)