BlueGit

timfa bluegit

Files

bluegit / internal / backupserver / protocol / compat.go

compat.go

compat.go 3.3 KiB Download Raw
1package protocol
2
3import (
4 "net/http"
5 "strconv"
6 "strings"
7)
8
9// Compatibiliteit tussen BlueGit en bluegit-backup (gelijk aan
10// internal/backup/compat.go in BlueGit).
11//
12// Elke kant heeft een protocolversie (wat hij zelf spreekt) en een
13// minimumversie (de oudste versie van de andere kant die hij nog
14// ondersteunt). Ze passen als elk de minimumversie van de ander haalt. Een
15// kant die geen protocol meldt, spreekt protocol 1 (BlueGit vóór de
16// protocolversie en bluegit-backup v0.1.0).
17//
18// Strings, zodat een test-build ze met -ldflags -X kan overschrijven; de
19// integratietests zetten ze direct (de backup server draait in het
20// testproces).
21var (
22 ProtocolVersion = "1"
23 MinBlueGitProtocol = "1"
24)
25
26// Koppen met de protocolversie.
27const (
28 HeaderBlueGitProtocol = "X-BlueGit-Protocol"
29 HeaderBlueGitMinProtocol = "X-BlueGit-Min-Protocol"
30 HeaderBlueGitVersion = "X-BlueGit-Version"
31 HeaderBackupProtocol = "X-Backup-Protocol"
32 HeaderBackupMinProtocol = "X-Backup-Min-Protocol"
33 HeaderBackupVersion = "X-Backup-Version"
34)
35
36// Uitkomsten van Compat.
37const (
38 CompatOK = "ok"
39 CompatBlueGitTooOld = "bluegit_too_old"
40 CompatBackupTooOld = "backup_too_old"
41)
42
43func atoiMin1(s string) int {
44 n, err := strconv.Atoi(strings.TrimSpace(s))
45 if err != nil || n < 1 {
46 return 1
47 }
48 return n
49}
50
51// Protocol is de protocolversie van deze backup server.
52func Protocol() int { return atoiMin1(ProtocolVersion) }
53
54// MinProtocol is de oudste protocolversie van BlueGit die deze backup
55// server ondersteunt.
56func MinProtocol() int {
57 if m := atoiMin1(MinBlueGitProtocol); m <= Protocol() {
58 return m
59 }
60 return Protocol()
61}
62
63// Compat vergelijkt BlueGit (protocol, minimum voor de backup server) met
64// een backup server (protocol, minimum voor BlueGit).
65func Compat(bluegit, bluegitMin, backup, backupMin int) string {
66 switch {
67 case backup < bluegitMin:
68 return CompatBackupTooOld
69 case bluegit < backupMin:
70 return CompatBlueGitTooOld
71 }
72 return CompatOK
73}
74
75// Peer is wat BlueGit over zijn protocol zegt.
76type Peer struct {
77 Protocol int `json:"protocol"`
78 MinProtocol int `json:"min_protocol"`
79 Version string `json:"version,omitempty"`
80}
81
82// Compat beoordeelt deze backup server tegen BlueGit p.
83func (p Peer) Compat() string {
84 return Compat(atoiMin1(strconv.Itoa(p.Protocol)), atoiMin1(strconv.Itoa(p.MinProtocol)), Protocol(), MinProtocol())
85}
86
87// BlueGitFromHeader leest de X-BlueGit-koppen. ok is false zonder
88// protocolkop; p is dan protocol 1.
89func BlueGitFromHeader(h http.Header) (Peer, bool) {
90 p := Peer{Protocol: 1, MinProtocol: 1}
91 raw := h.Get(HeaderBlueGitProtocol)
92 if raw == "" {
93 return p, false
94 }
95 p.Protocol = atoiMin1(raw)
96 if m := h.Get(HeaderBlueGitMinProtocol); m != "" {
97 p.MinProtocol = atoiMin1(m)
98 }
99 p.Version = cleanVersion(h.Get(HeaderBlueGitVersion))
100 return p, true
101}
102
103func cleanVersion(v string) string {
104 out := make([]rune, 0, len(v))
105 for _, r := range strings.TrimSpace(v) {
106 if r > ' ' && r < 0x7f && r != '<' && r != '>' && r != '"' {
107 out = append(out, r)
108 }
109 if len(out) == 40 {
110 break
111 }
112 }
113 return string(out)
114}
115
116// SetOwnHeaders zet de X-Backup-koppen.
117func SetOwnHeaders(h http.Header, version string) {
118 h.Set(HeaderBackupProtocol, strconv.Itoa(Protocol()))
119 h.Set(HeaderBackupMinProtocol, strconv.Itoa(MinProtocol()))
120 h.Set(HeaderBackupVersion, version)
121}