File: sync.go

package info (click to toggle)
gitlab-shell 14.35.0%2Bds1-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 23,652 kB
  • sloc: ruby: 1,129; makefile: 583; sql: 391; sh: 384
file content (87 lines) | stat: -rw-r--r-- 2,334 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
package safe

import (
	"fmt"
	"os"
	"path/filepath"
)

type file interface {
	Sync() error
	Close() error
}

// Syncer implements helper methods for fsyncing files and directories.
type Syncer struct {
	// open is used by the Sync* functions to open files for syncing. By default, Syncer opens
	// files via the `os` package as usual. This is parametrized only so we can test the correct
	// calls were made as we don't have good way to test the fsyncing otherwise.
	open func(string) (file, error)
}

// NewSyncer returns a new Syncer.
func NewSyncer() Syncer {
	return Syncer{
		open: func(path string) (file, error) {
			return os.Open(path)
		},
	}
}

// Sync opens the file/directory at the given path and syncs it. Syncing a directory syncs just
// the directory itself, not the children. If the children need to be synced as well, use SyncRecursive.
func (s Syncer) Sync(path string) error {
	f, err := s.open(path)
	if err != nil {
		return fmt.Errorf("open: %w", err)
	}
	defer func() { _ = f.Close() }()

	if err := f.Sync(); err != nil {
		return fmt.Errorf("sync: %w", err)
	}

	if err := f.Close(); err != nil {
		return fmt.Errorf("close: %w", err)
	}

	return nil
}

// SyncParent syncs the parent directory of the given path. The path is cleaned prior to determining
// the parent
func (s Syncer) SyncParent(path string) error {
	return s.Sync(filepath.Dir(filepath.Clean(path)))
}

// SyncRecursive walks the file tree rooted at path and fsyncing the root and the children.
func (s Syncer) SyncRecursive(path string) error {
	return filepath.WalkDir(path, func(path string, _ os.DirEntry, err error) error {
		if err != nil {
			return err
		}

		return s.Sync(path)
	})
}

// SyncHierarchy walks the hierarchy from <rootPath>/<relativePath> up to the
// rootPath and syncs everything on the way. If the path points to a directory,
// it only syncs from the directory and upwards, not the contents of the directory.
func (s Syncer) SyncHierarchy(rootPath, relativePath string) error {
	// Traverse the directory hierarchy all the way up to root and fsync them.
	currentPath := filepath.Join(rootPath, relativePath)
	for {
		if err := s.Sync(currentPath); err != nil {
			return fmt.Errorf("sync: %w", err)
		}

		if currentPath == rootPath {
			break
		}

		currentPath = filepath.Dir(currentPath)
	}

	return nil
}