feat: codeql

Reviewed-on: #23
Co-authored-by: Timo Behrendt <t.behrendt@t00n.de>
Co-committed-by: Timo Behrendt <t.behrendt@t00n.de>

.gitea/workflows/cd.yaml

@@ -4,10 +4,48 @@ on:
   push:
     branches:
       - main
-  pull_request:
+
+env:
+  DOCKER_REGISTRY: gitea.t000-n.de
 
 jobs:
-  build:
+  test:
+    name: test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+          check-latest: true
+      - name: Create cache key
+        uses: https://gitea.com/actions/go-hashfiles@v0.0.1
+        id: hash-go
+        with:
+          patterns: |
+            go.mod
+            go.sum
+      - name: cache go
+        id: cache-go
+        uses: actions/cache@v4
+        with:
+          path: |
+            /go_path
+            /go_cache
+          key: go_path-${{ steps.hash-go.outputs.hash }}
+          restore-keys: |-
+            go_cache-${{ steps.hash-go.outputs.hash }}
+      - name: build
+        run: make build
+      - name: test
+        run: make test
+
+  build_and_push:
+    name: Build and push
+    needs:
+      - test
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -22,14 +60,14 @@ jobs:
       - name: Login to Registry
         uses: docker/login-action@v2
         with:
-          registry: ${{ secrets.DOCKER_REGISTRY }}
+          registry: ${{ env.DOCKER_REGISTRY }}
           username: ${{ secrets.REGISTRY_USER }}
           password: ${{ secrets.REGISTRY_PASSWORD }}
 
       - name: Get Metadata
         id: meta
         run: |
-          echo REPO_NAME=$(echo ${GITHUB_REPOSITORY} | awk -F"/" '{print $2}') >> $GITHUB_OUTPUT
+          echo REPO_NAME=$(echo ${GITHUB_REPOSITORY} | awk -F"/" '{print $2}' | tr '[:upper:]' '[:lower:]') >> $GITHUB_OUTPUT
           echo REPO_VERSION=$(git describe --tags --always | sed 's/^v//') >> $GITHUB_OUTPUT
 
       - name: Build and push
@@ -40,7 +78,7 @@ jobs:
           platforms: |
             linux/amd64
             linux/arm64
-          push: false
+          push: true
           tags: |
-            ${{ secrets.DOCKER_REGISTRY }}/t.behrendt/${{ steps.meta.outputs.REPO_NAME }}:${{ steps.meta.outputs.REPO_VERSION }}
+            ${{ env.DOCKER_REGISTRY }}/t.behrendt/${{ steps.meta.outputs.REPO_NAME }}:${{ steps.meta.outputs.REPO_VERSION }}
-            ${{ secrets.DOCKER_REGISTRY }}/t.behrendt/${{ steps.meta.outputs.REPO_NAME }}:latest
+            ${{ env.DOCKER_REGISTRY }}/t.behrendt/${{ steps.meta.outputs.REPO_NAME }}:latest

.gitea/workflows/ci.yaml

@@ -1,9 +1,6 @@
 name: CI
 on:
   pull_request:
-  push:
-    branches:
-      - main
 
 env:
   GOPATH: /go_path
@@ -11,7 +8,7 @@ env:
   RUNNER_TOOL_CACHE: /toolcache
 
 jobs:
-  testing:
+  test:
     name: test
     runs-on: ubuntu-latest
     steps:
@@ -43,3 +40,5 @@ jobs:
         run: make build
       - name: test
         run: make test
+      - name: check:format
+        run: make check-format

.gitea/workflows/codeql.yaml

@@ -0,0 +1,23 @@
+name: CodeQL Analysis
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  codeql-analysis:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: "go"
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v3

.gitignore

@@ -22,3 +22,4 @@
 go.work
 
 .vscode
+config.yaml

Dockerfile

@@ -1,21 +1,13 @@
-FROM golang:1.21-alpine
+FROM golang:1.23-alpine
 
-# Set the Current Working Directory inside the container
 WORKDIR /app
 
-# Copy go mod and sum files
 COPY go.mod go.sum ./
 
-# Download all dependencies. Dependencies will be cached if the go.mod and go.sum files are not changed
 RUN go mod download
 
-# Copy the source from the current directory to the Working Directory inside the container
 COPY . .
 
-# Build the Go app
 RUN go build -o main .
 
-
-# Command to run the executable
-
 CMD ["./main"]

Makefile

@@ -6,3 +6,18 @@ build:
 
 lint:
 	golint ./...
+
+run:
+	make build
+	./realdyndns
+
+format:
+	gofmt -w .
+
+check-format:
+	@OUTPUT=$$(gofmt -l .); \
+	if [ -n "$$OUTPUT" ]; then \
+		echo "Formatter failed for:"; \
+		echo "$$OUTPUT"; \
+		exit 1; \
+	fi

README.md

@@ -1,10 +1,12 @@
 # realDynDNS
+
 RealDynDNS aims to be a replacement to "classical" dynDNS solutions that offer a subdomain. Instead realDynDns actually changes your DNS entries.
 
 This service requires your DNS provider to expose an API that allows your DNS entries to be changed.
 A service that provides your current external IP is also required.
 
 ## Configuration
+
 The configuration is done via a YAML file called `config.yaml`. The following example shows the configuration for a domain with two subdomains.
 
 Configuration of the IP provider and the DNS provider is mandatory.
@@ -23,33 +25,86 @@ dns_provider:
   config:
     api_key: <your-api-key>
     base_url: https://api.hosting.ionos.com/dns
+notification_provider:
+  type: gotify
+  config:
+    url: <your-gotify-host>
+    token: <your-token>
+    priority: 0
 domains:
   - tld: example.com
     subdomains:
       - "@"
       - www
 check_interval: 0 0 0/6 * * * *
+mode: Scheduled
+log_level: info
 ```
 
+The config file is expected to be in the same directory as the binary and called `config.yaml`. For the OCR image, the root directory is `/app`.
+
 ## DNS Providers
+
 The DNS provider abstracts the API of your DNS provider. Currently the following providers are supported:
 
 ### IONOS
+
 IONOS requires two configuration parameters. You can get your API key [here](https://developer.hosting.ionos.com/docs/getstarted).
+
 ```yaml
 api_key: <your-api-key>
 base_url: https://api.hosting.ionos.com/dns
 ```
 
 ## External IP Providers
+
 The external IP provider is used to get your current external IP. Currently the following providers are supported:
 
 ### Plain
+
 Any provider that returns your IP as plain text can be used. The following configuration is required:
+
 ```yaml
 url: <your-providers-URL>
 ```
 
 Examples for providers are:
+
 - https://ifconfig.me
 - https://api.ipify.org
+
+## Notification Providers
+
+The notification provider is used to send notifications whena IP address changes and a DNS record is updated.
+
+### Console
+
+The console notification provider is used to print the notification to the console. This is the default notification provider.
+
+### Gotify
+
+The Gotify notification provider is used to send notifications to a Gotify server.
+
+```yaml
+url: <your-gotify-host>
+token: <your-token>
+priority: 0
+```
+
+The priority must be between 0 and 4.
+
+## Mode Selection
+
+Two modes are available:
+
+### RunOnce
+
+The RunOnce mode is used to run the application once and exit. This is useful when providing your own external scheduler, like cron.
+
+Set the `mode` to `RunOnce`.
+
+### Scheduled
+
+The Scheduled mode is used to run the application in a scheduled interval.
+
+Set the `mode` to `Scheduled` and provide a cron expression for the `check_interval`.

config.example.yaml

@@ -2,15 +2,23 @@
 ip_provider:
   type: plain
   config:
-    url: https://ifconfig.me 
+    url: https://api.ipify.org
 dns_provider:
   type: ionos
   config:
     api_key: <your-api-key>
     base_url: https://api.hosting.ionos.com/dns
+notification_provider:
+  type: gotify
+  config:
+    url: <your-gotify-host>
+    token: <your-token>
+    priority: 0
 domains:
   - tld: example.com
     subdomains:
       - "@"
       - www
 check_interval: 0 0 0/6 * * * *
+mode: Scheduled
+log_level: info

go.mod

@@ -1,15 +1,15 @@
 module realdnydns
 
-go 1.20
+go 1.23
 
 require (
-	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/go-co-op/gocron v1.37.0
-	github.com/go-co-op/gocron v1.31.2 // indirect
+	gopkg.in/yaml.v3 v3.0.1
-	github.com/pmezard/go-difflib v1.0.0 // indirect
+)
-	github.com/robfig/cron/v3 v3.0.1 // indirect
+
-	github.com/stretchr/objx v0.5.0 // indirect
+require (
-	github.com/stretchr/testify v1.8.4 // indirect
+	github.com/google/uuid v1.6.0 // indirect
-	go.uber.org/atomic v1.9.0 // indirect
+	github.com/robfig/cron/v3 v3.0.1 // indirect
-	gopkg.in/yaml.v2 v2.4.0 // indirect
+	github.com/stretchr/testify v1.8.4 // indirect
-	gopkg.in/yaml.v3 v3.0.1 // indirect
+	go.uber.org/atomic v1.11.0 // indirect
 )

go.sum

@@ -2,13 +2,18 @@ github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ3
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/go-co-op/gocron v1.31.2 h1:tAUW64bxYc5QlzEy2t30TnHX2+uInNDajKXxWi4SACA=
+github.com/go-co-op/gocron v1.37.0 h1:ZYDJGtQ4OMhTLKOKMIch+/CY70Brbb1dGdooLEhh7b0=
-github.com/go-co-op/gocron v1.31.2/go.mod h1:39f6KNSGVOU1LO/ZOoZfcSxwlsJDQOKSu8erN0SH48Y=
+github.com/go-co-op/gocron v1.37.0/go.mod h1:3L/n6BkO7ABj+TrfSVXLRzsP26zmikL4ISkLQ0O8iNY=
+github.com/google/uuid v1.4.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo=
 github.com/kr/pretty v0.2.1/go.mod h1:ipq/a2n7PKx3OHsz4KJII5eveXtPO4qwEXGdVfWzfnI=
+github.com/kr/pretty v0.3.0 h1:WgNl7dwNpEZ6jJ9k1snq4pZsg7DOEN8hP9Xw0Tsjwk0=
 github.com/kr/pretty v0.3.0/go.mod h1:640gp4NfQd8pI5XOwp5fnNeVWj67G7CFk/SaSQn7NBk=
 github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
 github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
 github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
 github.com/pkg/diff v0.0.0-20210226163009-20ebb0f2a09e/go.mod h1:pJLUxLENpZxwdsKMEsNbx1VGcRFpLqf3715MtcvvzbA=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
@@ -16,10 +21,10 @@ github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZN
 github.com/robfig/cron/v3 v3.0.1 h1:WdRxkvbJztn8LMz/QEvLN5sBU+xKpSqwwUO1Pjr4qDs=
 github.com/robfig/cron/v3 v3.0.1/go.mod h1:eQICP3HwyT7UooqI/z+Ov+PtYAWygg1TEWWzGIFLtro=
 github.com/rogpeppe/go-internal v1.6.1/go.mod h1:xXDCJY+GAPziupqXw64V24skbSoqbTEfhy4qGm1nDQc=
+github.com/rogpeppe/go-internal v1.8.1 h1:geMPLpDpQOgVyCg5z5GoRwLHepNdb71NXb67XFkP+Eg=
 github.com/rogpeppe/go-internal v1.8.1/go.mod h1:JeRgkft04UBgHMgCIwADu4Pn6Mtm5d4nPKWu0nJ5d+o=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
-github.com/stretchr/objx v0.5.0 h1:1zr/of2m5FGMsad5YfcqgdqdWrIhu+EBEJRhR1U7z/c=
 github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
@@ -27,14 +32,14 @@ github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO
 github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
 github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk=
 github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
-go.uber.org/atomic v1.9.0 h1:ECmE8Bn/WFTYwEW/bpKD3M8VtR/zQVbavAoalC1PYyE=
 go.uber.org/atomic v1.9.0/go.mod h1:fEN4uk6kAWBTFdckzkM89CLk9XfWZrxpCo0nPH17wJc=
+go.uber.org/atomic v1.11.0 h1:ZvwS0R+56ePWxUNi+Atn9dWONBPp/AUETXlHW0DxSjE=
+go.uber.org/atomic v1.11.0/go.mod h1:LUxbIzbOniOlMKjJjyPfpl4v+PKK2cNJn91OQbhoJI0=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
 gopkg.in/errgo.v2 v2.1.0/go.mod h1:hNsd1EY+bozCKY1Ytp96fpM3vjJbqLJn88ws8XvfDNI=
-gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=
-gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
 gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

main.go

@@ -2,71 +2,141 @@ package main
 
 import (
 	"fmt"
-	"realdnydns/pkg/changeDetector"
+	"log/slog"
+	"os"
+	"strings"
+
 	"realdnydns/pkg/config"
 	"realdnydns/pkg/dnsProvider"
 	ionos "realdnydns/pkg/dnsProvider/ionos"
 	"realdnydns/pkg/externalIpProvider"
 	plainExternalIpProvider "realdnydns/pkg/externalIpProvider/plain"
-	"time"
+	"realdnydns/pkg/notificationProvider"
-
+	notificationProviderConsole "realdnydns/pkg/notificationProvider/console"
-	"github.com/go-co-op/gocron"
+	gotify "realdnydns/pkg/notificationProvider/gotify"
+	"realdnydns/pkg/realDynDns"
 )
 
 func main() {
+	logger := slog.New(slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
+		Level: slog.LevelInfo,
+	}))
+
 	configClient := config.Config{}
 	err := configClient.Load("config.yaml")
 	if err != nil {
+		logger.Error("Failed to load config file", slog.String("error", err.Error()))
 		panic(err)
 	}
 
+	if configClient.LogLevel != "" {
+		logger = slog.New(slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
+			Level: slog.Level(config.LogLevelMap[strings.ToLower(configClient.LogLevel)]),
+		}))
+	}
+
 	var externalIpProvider externalIpProvider.ExternalIpProvider
 	switch configClient.ExternalIPProvider.Type {
 	case "plain":
+		logger.Info("Using plain external IP provider", slog.String("external_ip_provider", "plain"))
+
 		var plainConfig plainExternalIpProvider.PlainExternalIpProviderConfig
 		err := configClient.ExternalIPProvider.ProviderConfig.Decode(&plainConfig)
 		if err != nil {
+			logger.Error("Failed to create config",
+				slog.String("external_ip_provider", "plain"),
+				slog.String("error", err.Error()),
+			)
 			panic(err)
 		}
 
 		externalIpProvider, err = plainExternalIpProvider.New(plainConfig)
+		if err != nil {
+			logger.Error("Failed to create plain external IP provider",
+				slog.String("external_ip_provider", "plain"),
+				slog.String("error", err.Error()),
+			)
+			panic(err)
+		}
 	default:
+		logger.Error("Unknown external IP provider", slog.String("external_ip_provider", configClient.ExternalIPProvider.Type))
 		panic(fmt.Errorf("unknown external IP provider: %s", configClient.ExternalIPProvider.Type))
 	}
 
 	var dnsProvider dnsProvider.DNSProvider
 	switch configClient.DNSProvider.Type {
 	case "ionos":
+		logger.Info("Using IONOS DNS provider", slog.String("dns_provider", "ionos"))
+
 		var ionosConfig ionos.IONOSConfig
 		err := configClient.DNSProvider.ProviderConfig.Decode(&ionosConfig)
 		if err != nil {
+			logger.Error("Failed to create IONOS DNS provider",
+				slog.String("dns_provider", "ionos"),
+				slog.String("error", err.Error()),
+			)
 			panic(err)
 		}
+
 		dnsProvider, err = ionos.NewIonos(&ionosConfig)
 		if err != nil {
+			logger.Error("Failed to create IONOS DNS provider",
+				slog.String("dns_provider", "ionos"),
+				slog.String("error", err.Error()),
+			)
 			panic(err)
 		}
 	default:
+		logger.Error("Unknown DNS provider", slog.String("dns_provider", configClient.DNSProvider.Type))
 		panic(fmt.Errorf("unknown DNS provider: %s", configClient.DNSProvider.Type))
 	}
 
-	changeDetector := changeDetector.New(externalIpProvider, dnsProvider, configClient.Domains)
+	var notificationProvider notificationProvider.NotificationProvider
+	switch configClient.NotificationProvider.Type {
+	case "gotify":
+		logger.Info("Using Gotify notification provider", slog.String("notification_provider", "gotify"))
 
-	s := gocron.NewScheduler(time.UTC)
+		var gotifyConfig gotify.NotificationProviderImplGotifyConfig
-	s.SingletonMode()
+		err := configClient.NotificationProvider.ProviderConfig.Decode(&gotifyConfig)
-	job, err := s.CronWithSeconds(configClient.CheckInterval).DoWithJobDetails(func(in string, job gocron.Job) {
-		numberChanged, err := changeDetector.DetectAndApplyChanges()
-		if err != nil {
-			panic(err)
-		}
-		fmt.Printf("Number of changes: %d\n", numberChanged)
-		fmt.Println("Next run:", job.NextRun())
-	})
 		if err != nil {
 			panic(err)
 		}
 
-	fmt.Println("Starting scheduler")
+		notificationProvider, err = gotify.New(gotifyConfig)
-	fmt.Println("Next run:", job.NextRun())
+		if err != nil {
-	s.StartBlocking()
+			logger.Error("Failed to create Gotify notification provider",
+				slog.String("notification_provider", "gotify"),
+				slog.String("error", err.Error()),
+			)
+			panic(err)
+		}
+	default:
+		logger.Info("Using console notification provider", slog.String("notification_provider", "console"))
+
+		notificationProvider = notificationProviderConsole.New()
+	}
+
+	rdd := realDynDns.New(externalIpProvider, dnsProvider, notificationProvider, configClient.Domains, logger.With(slog.String("service", "realDynDns")))
+
+	switch configClient.Mode {
+	case config.ScheduledMode:
+		logger.Info("Running in scheduled mode", slog.String("interval", configClient.CheckInterval))
+
+		schedule, job, err := rdd.RunWithSchedule(configClient.CheckInterval)
+		if err != nil {
+			logger.Error("Failed to create scheduler", slog.String("error", err.Error()))
+			panic(err)
+		}
+
+		logger.Info("Next run:", slog.String("time", job.NextRun().String()))
+		schedule.StartBlocking()
+	case config.RunOnceMode:
+		logger.Info("Running in run once mode")
+
+		_, err := rdd.RunOnce()
+		if err != nil {
+			logger.Error("Failed to run once", slog.String("error", err.Error()))
+			panic(err)
+		}
+	}
 }

pkg/changeDetector/changeDetector.go

@@ -1,53 +0,0 @@
-package changeDetector
-
-import (
-	"realdnydns/pkg/config"
-	"realdnydns/pkg/dnsProvider"
-	"realdnydns/pkg/externalIpProvider"
-)
-
-type ChangeDetector struct {
-	externalIpProvider externalIpProvider.ExternalIpProvider
-	dnsProvider        dnsProvider.DNSProvider
-	domains            []config.DomainConfig
-}
-
-func New(
-	externalIpProvider externalIpProvider.ExternalIpProvider,
-	dnsProvider dnsProvider.DNSProvider,
-	domains []config.DomainConfig,
-) ChangeDetector {
-	return ChangeDetector{
-		externalIpProvider: externalIpProvider,
-		dnsProvider:        dnsProvider,
-		domains:            domains,
-	}
-}
-
-func (c *ChangeDetector) DetectAndApplyChanges() (int, error) {
-	externalIp, err := c.externalIpProvider.GetExternalIp()
-	if err != nil {
-		return 0, err
-	}
-
-	var numberUpdated int
-
-	for _, domain := range c.domains {
-		for _, subdomain := range domain.Subdomains {
-			currentRecord, err := c.dnsProvider.GetRecord(domain.TLD, subdomain)
-			if err != nil {
-				return numberUpdated, err
-			}
-
-			if currentRecord.IP != externalIp.String() {
-				_, err = c.dnsProvider.UpdateRecord(domain.TLD, subdomain, externalIp, currentRecord.TTL, currentRecord.Prio, currentRecord.Disabled)
-				numberUpdated++
-				if err != nil {
-					return numberUpdated, err
-				}
-			}
-		}
-	}
-
-	return numberUpdated, nil
-}

pkg/config/__mocks__/testLoadCanFindFile.yaml

@@ -1,16 +1,15 @@
----
 ip_provider:
   type: plain
   config:
-    url: https://ifconfig.me
+    url: https://example.com
 dns_provider:
   type: ionos
   config:
-    api_key: exampleAPIKey
+    api_key: exampleapikey
     base_url: https://example.com
 domains:
   - tld: example.com
     subdomains:
       - "@"
-      - www
+check_interval: 0 0 * * * *
-check_interval: 0 0 0/6 * * * *
+mode: RunOnce

pkg/config/__mocks__/testLoadInvalidMode.yaml

@@ -0,0 +1,2 @@
+mode: "InvalidMode"
+check_interval: "5m"

pkg/config/__mocks__/testLoadInvalidYAML.yaml

@@ -0,0 +1,3 @@
+mode: "Scheduled"
+check_interval: "5m"
+- invalid_content

pkg/config/__mocks__/testLoadMissingCheckInterval.yaml

@@ -0,0 +1,3 @@
+mode: "Scheduled"
+ip_provider:
+  type: "plain"

pkg/config/config.go

@@ -1,23 +1,47 @@
 package config
 
 import (
+	"errors"
+	"fmt"
+	"log/slog"
 	"os"
+	"strings"
 
 	"gopkg.in/yaml.v3"
 )
 
+type Config struct {
+	Mode                 string                     `yaml:"mode"`
+	ExternalIPProvider   ExternalIpProviderConfig   `yaml:"ip_provider"`
+	DNSProvider          DNSProviderConfig          `yaml:"dns_provider"`
+	NotificationProvider NotificationProviderConfig `yaml:"notification_provider,omitempty"`
+	Domains              []DomainConfig             `yaml:"domains"`
+	CheckInterval        string                     `yaml:"check_interval"`
+	LogLevel             string                     `yaml:"log_level"`
+}
+
+const (
+	RunOnceMode   = "RunOnce"
+	ScheduledMode = "Scheduled"
+)
+
+var LogLevelMap = map[string]slog.Level{
+	"debug": slog.LevelDebug,
+	"info":  slog.LevelInfo,
+	"warn":  slog.LevelWarn,
+	"error": slog.LevelError,
+}
+
+func isValidLogLevel(level string) bool {
+	_, ok := LogLevelMap[strings.ToLower(level)]
+	return ok
+}
+
 type DomainConfig struct {
 	TLD        string   `yaml:"tld"`
 	Subdomains []string `yaml:"subdomains"`
 }
 
-type Config struct {
-	ExternalIPProvider ExternalIpProviderConfig `yaml:"ip_provider"`
-	DNSProvider        DNSProviderConfig        `yaml:"dns_provider"`
-	Domains            []DomainConfig           `yaml:"domains"`
-	CheckInterval      string                   `yaml:"check_interval"`
-}
-
 type ExternalIpProviderConfig struct {
 	Type           string    `yaml:"type"`
 	ProviderConfig yaml.Node `yaml:"config"`
@@ -28,16 +52,40 @@ type DNSProviderConfig struct {
 	ProviderConfig yaml.Node `yaml:"config"`
 }
 
+type NotificationProviderConfig struct {
+	Type           string    `yaml:"type"`
+	ProviderConfig yaml.Node `yaml:"config"`
+}
+
 func (c *Config) Load(filePath string) error {
-	err := yaml.Unmarshal([]byte(filePath), c)
-	if err != nil {
 	inputConfig, err := os.ReadFile(filePath)
 	if err != nil {
-			return err
+		return fmt.Errorf("failed to read config file: %w", err)
 	}
 
-		return yaml.Unmarshal(inputConfig, c)
+	if err := yaml.Unmarshal(inputConfig, c); err != nil {
+		return fmt.Errorf("failed to unmarshal config file: %w", err)
 	}
 
-	return err
+	if err := c.validate(); err != nil {
+		return fmt.Errorf("failed to validate config: %w", err)
+	}
+
+	return nil
+}
+
+func (c *Config) validate() error {
+	if c.Mode != RunOnceMode && c.Mode != ScheduledMode {
+		return errors.New("mode must be one of 'RunOnce' or 'Scheduled'")
+	}
+
+	if c.Mode == ScheduledMode && c.CheckInterval == "" {
+		return errors.New("check interval must be set when mode is 'Scheduled'")
+	}
+
+	if c.LogLevel != "" && !isValidLogLevel(c.LogLevel) {
+		return fmt.Errorf("log level must be one of 'debug', 'info', 'warn', 'error', but got %s", c.LogLevel)
+	}
+
+	return nil
 }

pkg/config/config_test.go

@@ -1,65 +1,52 @@
 package config
 
 import (
+	"fmt"
 	"testing"
 )
 
+func testFactoryFileRelatedError(fileName string, expectedErrorText string) func(t *testing.T) {
+	return func(t *testing.T) {
+		c := Config{}
+		err := c.Load(fmt.Sprintf("./__mocks__/%s", fileName))
+
+		want := err != nil && err.Error() == expectedErrorText
+
+		if !want {
+			t.Fatalf("Expected error message %s, but got %s", expectedErrorText, err.Error())
+		}
+	}
+}
+
 func TestLoad(t *testing.T) {
 	t.Run("Can find file", testLoadCanFindFile())
-	t.Run("Cannot find file", testLoadCannotFindFile())
+	t.Run("Cannot find file", testFactoryFileRelatedError(
-	t.Run("Unmarshals from direct input", testLoadUnmarshalsFromDirectInput())
+		"nonexistent.yaml",
+		"failed to read config file: open ./__mocks__/nonexistent.yaml: no such file or directory",
+	))
+	t.Run("Missing CheckInterval in Scheduled mode", testFactoryFileRelatedError(
+		"testLoadMissingCheckInterval.yaml",
+		"failed to validate config: check interval must be set when mode is 'Scheduled'",
+	))
+	t.Run("Invalid mode", testFactoryFileRelatedError(
+		"testLoadInvalidMode.yaml",
+		"failed to validate config: mode must be one of 'RunOnce' or 'Scheduled'",
+	))
+	t.Run("Invalid YAML", testFactoryFileRelatedError(
+		"testLoadInvalidYAML.yaml",
+		"failed to unmarshal config file: yaml: line 2: did not find expected key",
+	))
 }
 
 func testLoadCanFindFile() func(t *testing.T) {
 	return func(t *testing.T) {
-
 		c := Config{}
 		err := c.Load("./__mocks__/testLoadCanFindFile.yaml")
 
-		want := c.DNSProvider.Type == "ionos" && c.ExternalIPProvider.Type == "plain"
+		want := err == nil && c.DNSProvider.Type == "ionos" && c.ExternalIPProvider.Type == "plain" && c.Mode == "RunOnce"
 
 		if !want || err != nil {
-			t.Fatalf("DnsProviderName couldn't be properly loaded or unmarshaled, Load() = %v, want %v", err, want)
+			t.Fatalf("Failed to load config file, expected no errors but got: %s", err)
-		}
-	}
-}
-
-func testLoadCannotFindFile() func(t *testing.T) {
-	return func(t *testing.T) {
-		c := Config{}
-		err := c.Load("nonexistent.yaml")
-		want := err != nil
-
-		if !want {
-			t.Fatalf("Config didn't throw an error")
-		}
-	}
-}
-
-func testLoadUnmarshalsFromDirectInput() func(t *testing.T) {
-	return func(t *testing.T) {
-		c := Config{}
-		err := c.Load(`---
-ip_provider:
-  type: plain
-  config:
-    url: https://ifconfig.me
-dns_provider:
-  type: ionos
-  config:
-    api_key: exampleAPIKey
-    base_url: https://example.com
-domains:
-  - tld: example.com
-    subdomains:
-      - "@"
-      - www
-check_interval: 0 0 0/6 * * * *`)
-
-		want := c.DNSProvider.Type == "ionos" && c.ExternalIPProvider.Type == "plain"
-
-		if !want || err != nil {
-			t.Fatalf("DnsProviderName couldn't be properly loaded or unmarshaled, Load() = %v, want %v", err, want)
 		}
 	}
 }

pkg/dnsProvider/ionos/api/ionosAPI.go

@@ -7,6 +7,7 @@ import (
 	"io"
 	"net"
 	"net/http"
+	"net/url"
 	"realdnydns/model/common"
 )
 
@@ -18,7 +19,7 @@ type IonosAPI interface {
 	SetARecord(tld string, subdomain string, ip net.IP, ttl int, prio int, disabled bool) (*common.ARecord, error)
 	GetZoneId(tld string) (string, error)
 	GetRecordId(zoneId string, tld string, subdomain string, recordType string) (string, error)
-	HttpCall(method string, url string, body io.Reader) (*http.Response, error)
+	HttpCall(method string, url string, body io.Reader, queryParams map[string]string) (*http.Response, error)
 }
 
 type IonosAPIImpl struct {
@@ -76,19 +77,29 @@ func New(APIKey string, BaseURL string) IonosAPI {
 	}
 }
 
-func (i *IonosAPIImpl) HttpCall(method string, url string, body io.Reader) (*http.Response, error) {
+func (i *IonosAPIImpl) HttpCall(method string, path string, body io.Reader, queryParams map[string]string) (*http.Response, error) {
-	req, err := http.NewRequest(method, i.BaseURL+url, body)
+	requestUrl, _ := url.Parse(i.BaseURL + path)
+
+	query := requestUrl.Query()
+	for key, value := range queryParams {
+		query.Add(key, value)
+	}
+	requestUrl.RawQuery = query.Encode()
+
+	req, err := http.NewRequest(method, requestUrl.String(), body)
 	if err != nil {
 		return nil, err
 	}
 
 	req.Header.Add("X-API-Key", i.APIKey)
+	req.Header.Add("Content-Type", "application/json")
+	req.Header.Add("Accept", "application/json")
 
 	return i.HTTPClient.Do(req)
 }
 
 func (i *IonosAPIImpl) GetZoneId(tld string) (string, error) {
-	res, err := i.HttpCall("GET", "/v1/zones", nil)
+	res, err := i.HttpCall("GET", "/v1/zones", nil, nil)
 	if err != nil {
 		return "", err
 	}
@@ -109,7 +120,14 @@ func (i *IonosAPIImpl) GetZoneId(tld string) (string, error) {
 }
 
 func (i *IonosAPIImpl) GetRecordId(zoneId string, tld string, subdomain string, recordType string) (string, error) {
-	res, err := i.HttpCall("GET", "/v1/zones/"+zoneId, nil)
+	var domain string
+	if subdomain == "@" || subdomain == "" {
+		domain = tld
+	} else {
+		domain = subdomain + "." + tld
+	}
+
+	res, err := i.HttpCall("GET", "/v1/zones/"+zoneId, nil, map[string]string{"recordName": domain, "recordType": recordType})
 	if err != nil {
 		return "", err
 	}
@@ -120,13 +138,6 @@ func (i *IonosAPIImpl) GetRecordId(zoneId string, tld string, subdomain string,
 	zone := ZoneResponse{}
 	json.Unmarshal(responseBody, &zone)
 
-	var domain string
-	if subdomain != "" {
-		domain = subdomain + "." + tld
-	} else {
-		domain = tld
-	}
-
 	for _, record := range zone.Records {
 		if record.Type == recordType && record.Name == domain {
 			return record.Id, nil
@@ -157,18 +168,18 @@ func (i *IonosAPIImpl) SetARecord(tld string, subdomain string, ip net.IP, ttl i
 		return nil, err
 	}
 
-	res, err := i.HttpCall("PUT", "/v1/zones/"+zoneId+"/records/"+recordId, bytes.NewReader(changeRecordRequest))
+	res, err := i.HttpCall("PUT", "/v1/zones/"+zoneId+"/records/"+recordId, bytes.NewReader(changeRecordRequest), nil)
 	if err != nil {
 		return nil, err
 	}
 
+	responseBody := make([]byte, res.ContentLength)
+	res.Body.Read(responseBody)
+
 	if res.StatusCode != 200 {
 		return nil, errors.New("error updating record")
 	}
 
-	responseBody := make([]byte, res.ContentLength)
-	res.Body.Read(responseBody)
-
 	changeRecord := ChangeRecord{}
 	json.Unmarshal(responseBody, &changeRecord)
 
@@ -192,7 +203,7 @@ func (ionos *IonosAPIImpl) GetARecord(tld string, subdomain string) (*common.ARe
 		return nil, err
 	}
 
-	res, err := ionos.HttpCall("GET", "/v1/zones/"+zoneId+"/records/"+recordId, nil)
+	res, err := ionos.HttpCall("GET", "/v1/zones/"+zoneId+"/records/"+recordId, nil, nil)
 	if err != nil {
 		return nil, err
 	}

pkg/dnsProvider/ionos/api/ionosAPI_test.go

@@ -76,7 +76,8 @@ func utilMockServerImpl() func(w http.ResponseWriter, r *http.Request) {
 		if r.Method == "GET" {
 			if r.RequestURI == "/v1/zones" {
 				response = zonesResponseJson
-			} else if r.RequestURI == "/v1/zones/1234567890" {
+			} else if r.RequestURI == "/v1/zones/1234567890?recordName=example.com&recordType=A" ||
+				r.RequestURI == "/v1/zones/1234567890?recordName=sub.example.com&recordType=A" {
 				response = zoneResponseJson
 			} else if r.RequestURI == "/v1/zones/1234567890/records/abcdefghij" {
 				response = recordResponseSubJson
@@ -106,7 +107,7 @@ func TestHttpCall(t *testing.T) {
 
 func testHttpCallGet(api IonosAPI) func(t *testing.T) {
 	return func(t *testing.T) {
-		res, err := api.HttpCall("GET", "/v1/zones", nil)
+		res, err := api.HttpCall("GET", "/v1/zones", nil, nil)
 
 		if err != nil {
 			t.Fatalf("HttpCall() returned unexpected error: %v", err)
@@ -120,7 +121,7 @@ func testHttpCallGet(api IonosAPI) func(t *testing.T) {
 
 func testHttpCallPut(api IonosAPI) func(t *testing.T) {
 	return func(t *testing.T) {
-		res, err := api.HttpCall("PUT", "/v1/zones/1234567890/records/abcdefghij", nil)
+		res, err := api.HttpCall("PUT", "/v1/zones/1234567890/records/abcdefghij", nil, nil)
 
 		if err != nil {
 			t.Fatalf("HttpCall() returned unexpected error: %v", err)
@@ -141,7 +142,7 @@ func testHttpCallNonExistingEndpoint() func(t *testing.T) {
 
 		api := New("dummyKey", mockServer.URL)
 
-		res, err := api.HttpCall("GET", "/v1/nonExistingEndpoint", nil)
+		res, err := api.HttpCall("GET", "/v1/nonExistingEndpoint", nil, nil)
 
 		if err != nil {
 			t.Fatalf("HttpCall() returned unexpected error: %v", err)

pkg/dnsProvider/ionos/ionos_test.go

@@ -82,7 +82,7 @@ func (m *MockIonosAPI) GetZoneId(tld string) (string, error) {
 	return m.GetZoneIdFunc(tld)
 }
 
-func (m *MockIonosAPI) HttpCall(method string, url string, body io.Reader) (*http.Response, error) {
+func (m *MockIonosAPI) HttpCall(method string, url string, body io.Reader, queryParams map[string]string) (*http.Response, error) {
 	return m.HttpCallFunc(method, url, body)
 }
 

pkg/notificationProvider/console/console.go

@@ -0,0 +1,16 @@
+package notificationProviderConsole
+
+import (
+	"fmt"
+)
+
+type NotificationProviderImplConsole struct{}
+
+func New() *NotificationProviderImplConsole {
+	return &NotificationProviderImplConsole{}
+}
+
+func (p *NotificationProviderImplConsole) SendNotification(title string, message string) error {
+	fmt.Printf("%s: %s\n", title, message)
+	return nil
+}

pkg/notificationProvider/gotify/gotify.go

@@ -0,0 +1,89 @@
+package notificationProviderGotify
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"net/url"
+)
+
+type NotificationProviderImplGotifyConfig struct {
+	Url      string `yaml:"url"`
+	Token    string `yaml:"token"`
+	Priority int    `yaml:"priority"`
+}
+
+type NotificationProviderImplGotify struct {
+	Url        url.URL
+	Token      string
+	Priority   int
+	HTTPClient *http.Client
+}
+
+func New(config NotificationProviderImplGotifyConfig) (*NotificationProviderImplGotify, error) {
+	if config.Url == "" {
+		return nil, fmt.Errorf("url is required")
+	}
+
+	url, err := url.Parse(config.Url)
+	if err != nil {
+		return nil, err
+	}
+
+	if config.Token == "" {
+		return nil, fmt.Errorf("token is required")
+	}
+
+	if config.Priority < 0 || config.Priority > 4 {
+		return nil, fmt.Errorf("priority must be between 0 and 4")
+	}
+
+	return &NotificationProviderImplGotify{
+		*url,
+		config.Token,
+		config.Priority,
+		&http.Client{},
+	}, nil
+}
+
+func (p *NotificationProviderImplGotify) SendNotification(title string, message string) error {
+	type GotifyMessage struct {
+		Message  string `json:"message"`
+		Title    string `json:"title"`
+		Priority int    `json:"priority"`
+	}
+
+	messageJson, err := json.Marshal(GotifyMessage{
+		message,
+		title,
+		p.Priority,
+	})
+	if err != nil {
+		return err
+	}
+
+	messageUrl := p.Url
+	messageUrl = *messageUrl.JoinPath("message")
+	queryParams := messageUrl.Query()
+	queryParams.Add("token", p.Token)
+	messageUrl.RawQuery = queryParams.Encode()
+
+	req, err := http.NewRequest("POST", messageUrl.String(), bytes.NewBuffer(messageJson))
+	if err != nil {
+		return err
+	}
+
+	req.Header.Set("Content-Type", "application/json")
+
+	res, err := p.HTTPClient.Do(req)
+	if err != nil {
+		return err
+	}
+
+	if res.StatusCode != 200 {
+		return fmt.Errorf("unexpected status code: %d", res.StatusCode)
+	}
+
+	return nil
+}

pkg/notificationProvider/gotify/gotify_test.go

@@ -0,0 +1,81 @@
+package notificationProviderGotify_test
+
+import (
+	"net/http"
+	"net/http/httptest"
+	"testing"
+
+	gotify "realdnydns/pkg/notificationProvider/gotify"
+)
+
+func TestNew(t *testing.T) {
+	t.Run("URL is required", testNewEmptyUrl())
+	t.Run("Token is required", testNewEmptyToken())
+	t.Run("Priority must be between 0 and 4", testNewInvalidPriority())
+	t.Run("Sends POST request to url", testNewSendsPostRequest())
+}
+
+func testNewEmptyUrl() func(t *testing.T) {
+	return func(t *testing.T) {
+		_, err := gotify.New(gotify.NotificationProviderImplGotifyConfig{
+			Token:    "1234",
+			Priority: 1,
+		})
+
+		if err.Error() != "url is required" {
+			t.Errorf("Expected error 'url is required', got %v", err)
+		}
+	}
+}
+
+func testNewEmptyToken() func(t *testing.T) {
+	return func(t *testing.T) {
+		_, err := gotify.New(gotify.NotificationProviderImplGotifyConfig{
+			Url:      "http://localhost:1234",
+			Priority: 0,
+		})
+
+		if err.Error() != "token is required" {
+			t.Errorf("Expected error 'token is required', got %v", err)
+		}
+	}
+}
+
+func testNewInvalidPriority() func(t *testing.T) {
+	return func(t *testing.T) {
+		_, err := gotify.New(gotify.NotificationProviderImplGotifyConfig{
+			Url:      "http://localhost:1234",
+			Token:    "token",
+			Priority: 5,
+		})
+
+		if err.Error() != "priority must be between 0 and 4" {
+			t.Errorf("Expected error 'priority must be between 0 and 4', got %v", err)
+		}
+	}
+}
+
+func testNewSendsPostRequest() func(t *testing.T) {
+	return func(t *testing.T) {
+		mockServer := httptest.NewServer(http.HandlerFunc(
+			func(w http.ResponseWriter, r *http.Request) {
+				w.WriteHeader(200)
+			},
+		))
+		defer mockServer.Close()
+
+		provider, err := gotify.New(gotify.NotificationProviderImplGotifyConfig{
+			Url:      mockServer.URL,
+			Token:    "1234",
+			Priority: 0,
+		})
+		if err != nil {
+			t.Fatalf("New() returned unexpected error: %v", err)
+		}
+
+		err = provider.SendNotification("title", "message")
+		if err != nil {
+			t.Fatalf("SendNotification() returned unexpected error: %v", err)
+		}
+	}
+}

pkg/notificationProvider/notificationProvider.go

@@ -0,0 +1,5 @@
+package notificationProvider
+
+type NotificationProvider interface {
+	SendNotification(title string, message string) error
+}

pkg/realDynDns/realDynDns.go

@@ -0,0 +1,152 @@
+package realDynDns
+
+import (
+	"fmt"
+	"log/slog"
+	"sync"
+	"time"
+
+	"realdnydns/pkg/config"
+	"realdnydns/pkg/dnsProvider"
+	"realdnydns/pkg/externalIpProvider"
+	"realdnydns/pkg/notificationProvider"
+
+	"github.com/go-co-op/gocron"
+)
+
+type ChangeDetector struct {
+	externalIpProvider   externalIpProvider.ExternalIpProvider
+	dnsProvider          dnsProvider.DNSProvider
+	notificationProvider notificationProvider.NotificationProvider
+	domains              []config.DomainConfig
+	logger               *slog.Logger
+}
+
+func New(
+	externalIpProvider externalIpProvider.ExternalIpProvider,
+	dnsProvider dnsProvider.DNSProvider,
+	notificationProvider notificationProvider.NotificationProvider,
+	domains []config.DomainConfig,
+	logger *slog.Logger,
+) ChangeDetector {
+	return ChangeDetector{
+		externalIpProvider:   externalIpProvider,
+		dnsProvider:          dnsProvider,
+		notificationProvider: notificationProvider,
+		domains:              domains,
+		logger:               logger,
+	}
+}
+
+func (c *ChangeDetector) RunWithSchedule(checkInterval string) (*gocron.Scheduler, *gocron.Job, error) {
+	s := gocron.NewScheduler(time.UTC)
+	s.SingletonMode()
+	s.CronWithSeconds(checkInterval)
+
+	job, err := s.DoWithJobDetails(func(job gocron.Job) {
+		numberChanged, err := c.detectAndApplyChanges()
+		if err != nil {
+			panic(err)
+		}
+		fmt.Printf("Number of changes: %d\n", numberChanged)
+		fmt.Println("Next run:", job.NextRun())
+	})
+	if err != nil {
+		return nil, nil, err
+	}
+
+	return s, job, nil
+}
+
+func (c *ChangeDetector) RunOnce() (int, error) {
+	return c.detectAndApplyChanges()
+}
+
+func (c *ChangeDetector) detectAndApplyChanges() (int, error) {
+	c.logger.Info("Detecting and applying changes")
+
+	externalIp, err := c.externalIpProvider.GetExternalIp()
+	if err != nil {
+		c.logger.Error("Failed to retrieve external IP", slog.String("error", err.Error()))
+		return 0, err
+	}
+
+	var wg sync.WaitGroup
+
+	numberUpdatedChannel := make(chan int)
+
+	for _, domain := range c.domains {
+		for _, subdomain := range domain.Subdomains {
+			wg.Add(1)
+
+			go func(domain config.DomainConfig, subdomain string) {
+				defer wg.Done()
+
+				c.logger.Info("Checking record",
+					slog.String("tld", domain.TLD),
+					slog.String("subdomain", subdomain),
+				)
+				currentRecord, err := c.dnsProvider.GetRecord(domain.TLD, subdomain)
+				if err != nil {
+					c.logger.Error("Failed to retrieve record",
+						slog.String("error", err.Error()),
+						slog.String("tld", domain.TLD),
+						slog.String("subdomain", subdomain),
+					)
+					return
+				}
+
+				if currentRecord.IP != externalIp.String() {
+					c.logger.Info("Record has changed",
+						slog.String("tld", domain.TLD),
+						slog.String("subdomain", subdomain),
+						slog.String("current_ip", currentRecord.IP),
+						slog.String("external_ip", externalIp.String()),
+					)
+
+					err = c.notificationProvider.SendNotification(
+						fmt.Sprintf("Update %s.%s", subdomain, domain.TLD),
+						fmt.Sprintf("The IP of %s has changed from %s to %s", domain.TLD, currentRecord.IP, externalIp.String()),
+					)
+					if err != nil {
+						c.logger.Warn("Failed to send notification",
+							slog.String("error", err.Error()),
+						)
+						return
+					}
+
+					c.logger.Info("Updating record",
+						slog.String("tld", domain.TLD),
+						slog.String("subdomain", subdomain),
+						slog.String("current_ip", currentRecord.IP),
+						slog.String("external_ip", externalIp.String()),
+					)
+					_, err = c.dnsProvider.UpdateRecord(domain.TLD, subdomain, externalIp, currentRecord.TTL, currentRecord.Prio, currentRecord.Disabled)
+					if err != nil {
+						c.logger.Error("Failed to update record",
+							slog.String("error", err.Error()),
+							slog.String("tld", domain.TLD),
+							slog.String("subdomain", subdomain),
+						)
+						return
+					}
+
+					numberUpdatedChannel <- 1
+				}
+			}(domain, subdomain)
+		}
+	}
+
+	go func() {
+		wg.Wait()
+		close(numberUpdatedChannel)
+	}()
+
+	numberUpdated := 0
+	for v := range numberUpdatedChannel {
+		numberUpdated += v
+	}
+
+	c.logger.Info("Run completed", slog.Int("number_of_changes", numberUpdated))
+	return numberUpdated, nil
+}

pkg/realDynDns/realDynDns_test.go

@@ -1,6 +1,7 @@
-package changeDetector
+package realDynDns
 
 import (
+	"log/slog"
 	"net"
 	"realdnydns/model/common"
 	"realdnydns/pkg/config"
@@ -43,6 +44,14 @@ func (m *MockDNSProviderImpl) UpdateRecord(tld string, subdomain string, ip net.
 	}, nil
 }
 
+type MockedNotificationProvider struct{}
+
+type MockedNotificationProviderImpl struct{}
+
+func (m *MockedNotificationProviderImpl) SendNotification(title string, message string) error {
+	return nil
+}
+
 func TestDetectAndApplyChanges(t *testing.T) {
 	t.Run("with changes", testDetectAndApplyChangesWithChanges())
 	t.Run("without changes", testDetectAndApplyChangesWithoutChanges())
@@ -55,7 +64,8 @@ func testDetectAndApplyChangesWithChanges() func(t *testing.T) {
 		}, &MockDNSProviderImpl{
 			GetRecordIpResponse:    "127.0.0.2",
 			UpdateRecordIpResponse: "127.0.0.1",
-		}, []config.DomainConfig{
+		}, &MockedNotificationProviderImpl{},
+			[]config.DomainConfig{
 				{
 					TLD: "example.com",
 					Subdomains: []string{
@@ -63,9 +73,11 @@ func testDetectAndApplyChangesWithChanges() func(t *testing.T) {
 						"@",
 					},
 				},
-		})
+			},
+			slog.Default(),
+		)
 
-		numberUpdated, err := changeDetector.DetectAndApplyChanges()
+		numberUpdated, err := changeDetector.RunOnce()
 		if err != nil {
 			t.Errorf("expected no error, got %v", err)
 		}
@@ -83,7 +95,8 @@ func testDetectAndApplyChangesWithoutChanges() func(t *testing.T) {
 		}, &MockDNSProviderImpl{
 			GetRecordIpResponse:    "127.0.0.1",
 			UpdateRecordIpResponse: "127.0.0.1",
-		}, []config.DomainConfig{
+		}, &MockedNotificationProviderImpl{},
+			[]config.DomainConfig{
 				{
 					TLD: "example.com",
 					Subdomains: []string{
@@ -91,9 +104,11 @@ func testDetectAndApplyChangesWithoutChanges() func(t *testing.T) {
 						"@",
 					},
 				},
-		})
+			},
+			slog.Default(),
+		)
 
-		numberUpdated, err := changeDetector.DetectAndApplyChanges()
+		numberUpdated, err := changeDetector.RunOnce()
 		if err != nil {
 			t.Errorf("expected no error, got %v", err)
 		}