From dd4e5619c75fcf1a69df5f5bc695a904cbf276e2 Mon Sep 17 00:00:00 2001
From: Leonid Nikitin <i@kor-elf.net>
Date: Sun, 15 Mar 2026 17:47:14 +0500
Subject: [PATCH] Add CIArmy example for fetching and parsing IP blocklist data

---
 examples/ciarmy.go | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 examples/ciarmy.go

diff --git a/examples/ciarmy.go b/examples/ciarmy.go
new file mode 100644
index 0000000..db1c06b
--- /dev/null
+++ b/examples/ciarmy.go
@@ -0,0 +1,29 @@
+package main
+
+import (
+	"fmt"
+
+	"git.kor-elf.net/kor-elf-shield/blocklist"
+	"git.kor-elf.net/kor-elf-shield/blocklist/parser"
+)
+
+/**
+ * An example of how to get a list of IP addresses from a service https://www.ciarmy.com/#list
+ */
+
+func main() {
+	url := "https://www.ciarmy.com/list/ci-badguys.txt"
+	extract := parser.NewDefaultTextExtract(0, " ")
+	pars, err := parser.NewText(extract)
+	if err != nil {
+		panic(err)
+	}
+	// limit 0 - no limit
+	limit := uint(0)
+	config := blocklist.NewConfig(limit)
+	ips, err := blocklist.Get(url, pars, config)
+	if err != nil {
+		panic(err)
+	}
+	fmt.Println(ips)
+}