adds example (closes #23)

.github/workflows/build-test.yml

@@ -21,6 +21,5 @@ jobs:
       - name: Test
         run: go test ./...
 
-      # Todo: create example folder
-      # - name: Build
-      #   run: go build .
+      - name: Build
+        run: go build examples/main.go

README.md

@@ -1,4 +1,13 @@
 # networkpolicy
+
+[![License](https://img.shields.io/github/license/projectdiscovery/networkpolicy)](LICENSE.md)
+![Go version](https://img.shields.io/github/go-mod/go-version/projectdiscovery/networkpolicy?filename=go.mod)
+[![Release](https://img.shields.io/github/release/projectdiscovery/networkpolicy)](https://github.com/projectdiscovery/networkpolicy/releases/)
+[![Checks](https://github.com/projectdiscovery/networkpolicy/actions/workflows/build-test.yml/badge.svg)](https://github.com/projectdiscovery/networkpolicy/actions/workflows/build-test.yml)
+[![GoDoc](https://pkg.go.dev/badge/projectdiscovery/networkpolicy)](https://pkg.go.dev/github.com/projectdiscovery/networkpolicy)
+
+
+
 The package acts as an embeddable configurable container handling allow/deny verdicts over a series of conditions including
 - IPs
 - CIDRs

examples/main.go

@@ -0,0 +1,49 @@
+package main
+
+import (
+	"errors"
+	"log"
+	"net/http"
+	"net/http/httputil"
+
+	"github.com/projectdiscovery/networkpolicy"
+)
+
+func main() {
+	var npOptions networkpolicy.Options
+	// deny connections to localhost
+	npOptions.DenyList = append(npOptions.DenyList, "127.0.0.0/8")
+
+	np, err := networkpolicy.New(npOptions)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	customRedirectHandler := func(req *http.Request, via []*http.Request) error {
+		// if at least one address is valid we follow the redirect
+		if _, ok := np.ValidateHost(req.Host); ok {
+			return nil
+		}
+		return errors.New("redirected to a forbidden target")
+	}
+
+	client := &http.Client{
+		CheckRedirect: customRedirectHandler,
+	}
+	req, err := http.NewRequest(http.MethodGet, "https://projectdiscovery.io", nil)
+	if err != nil {
+		log.Fatal(err)
+	}
+	resp, err := client.Do(req)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	bin, err := httputil.DumpResponse(resp, true)
+
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	log.Println(string(bin))
+}