https://github.com/blockkwork/failover

go library that allows you to add multiple urls and send a request to the active one
https://github.com/blockkwork/failover

Last synced: about 2 months ago
JSON representation

go library that allows you to add multiple urls and send a request to the active one

• Host: GitHub
• URL: https://github.com/blockkwork/failover
• Owner: blockkwork
• Created: 2024-08-10T17:54:00.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-08-10T18:20:03.000Z (5 months ago)
• Last Synced: 2024-08-11T19:14:06.293Z (5 months ago)
• Language: Go
• Size: 7.81 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# failover

go library that allows you to add multiple urls and send a request to the active one

## 💡 Info

**How it works?** failover saves your url and checks for availability every n seconds. if the url is unavailable, it saves and checks to wait for availability.

**Request function:** Request uses round robin algorithm to select the url

## 🚀 Usage

```go

func main() {

	f := failover.New(checkConn,

		failover.OptCheckUrlDelay(30),

		failover.OptMaxAttempts(10),

		failover.OptCheckUrlBeforeAdding(true),

		failover.OptReqOnErr(failover.ReqOnErrRemoveAndReconnect),

	)

	// first way to add url

	f.AddUrl(f.MustParseURL("https://google.com"))

	f.AddUrl(f.MustParseURL("https://fjxiofujosidfujs.com"))

	f.AddUrl(f.MustParseURL("https://fbi.gov"))

	// second way to add url

	f.AddUrls(f.MustParseURL("https://youtube.com"), f.MustParseURL("https://spotify.com"), f.MustParseURL("https://github.com"))

	fmt.Println(f.Request(requestFunc))

	fmt.Println(f.Request(requestFunc, failover.OptReqOnErr(failover.ReqOnErrIgnore))) // local option (only in this function) to ignore error

}

func checkConn(url *url.URL) error {

	resp, err := http.Get(url.String())

	if err != nil {

		return err

	}

	if resp.StatusCode != http.StatusOK {

		return fmt.Errorf("unexpected status code: %d", resp.StatusCode)

	}

	return nil

}

func requestFunc(url *url.URL) error {

	fmt.Println("Request:", url.String())

	_, err := http.Get(url.String())

	if err != nil {

		return err

	}

	return nil

}

```