apparmor.d/pkg/paths/README.md
2024-04-28 00:30:59 +01:00

51 lines
1.3 KiB
Markdown

## paths: a golang library to simplify handling of paths
This library aims to simplify handling of the most common operations with paths.
For example code that looked like this:
```go
buildPath := getPathFromSomewhere() // returns string
if buildPath != "" {
cachePath, err := filepath.Abs(filepath.Join(buildPath, "cache"))
...
}
```
can be transformed to:
```go
buildPath := getPathFromSomewhere() // returns *paths.Path
if buildPath != nil {
cachePath, err := buildPath.Join("cache").Abs()
...
}
```
most operations that usually requires a bit of convoluted system calls are now simplified, for example to check if a path is a directory:
```go
buildPath := "/path/to/somewhere"
srcPath := filepath.Join(buildPath, "src")
if info, err := os.Stat(srcPath); err == nil && !info.IsDir() {
os.MkdirAll(srcPath)
}
```
using this library can be done this way:
```go
buildPath := paths.New("/path/to/somewhere")
srcPath := buildPath.Join("src")
if !srcPath.IsDir() {
scrPath.MkdirAll()
}
```
## Security
If you think you found a vulnerability or other security-related bug in this project, please read our
[security policy](https://github.com/arduino/go-paths-helper/security/policy) and report the bug to our Security Team 🛡️
Thank you!
e-mail contact: security@arduino.cc