path-security 0.2.0

Comprehensive path validation and sanitization library with 85%+ attack vector coverage
Documentation 
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
88

package main

import (
	"fmt"
)

func main() {
	fmt.Println("Testing Go bindings for Path Security:")
	fmt.Println()

	// Create PathSecurity instance
	ps := NewPathSecurity()

	// Test ValidatePath
	validPath := "/usr/local/bin/app"
	invalidPath := "../../../etc/passwd"

	fmt.Printf("Validating \"%s\": ", validPath)
	result, err := ps.ValidatePath(validPath)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
	} else {
		fmt.Printf("Result: %s\n", result)
	}

	fmt.Printf("Validating \"%s\": ", invalidPath)
	result, err = ps.ValidatePath(invalidPath)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
	} else {
		fmt.Printf("Result: %s\n", result)
	}

	// Test DetectTraversal
	fmt.Printf("\nDetecting traversal in \"%s\": ", invalidPath)
	hasTraversal, err := ps.DetectTraversal(invalidPath)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
	} else {
		fmt.Printf("%t\n", hasTraversal)
	}

	fmt.Printf("Detecting traversal in \"%s\": ", validPath)
	hasTraversal, err = ps.DetectTraversal(validPath)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
	} else {
		fmt.Printf("%t\n", hasTraversal)
	}

	// Test SanitizePath
	dirtyPath := "/var/www/html/../app/config.json"
	fmt.Printf("\nSanitizing \"%s\": ", dirtyPath)
	sanitized, err := ps.SanitizePath(dirtyPath)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
	} else {
		fmt.Printf("\"%s\"\n", sanitized)
	}

	// Test with safe path
	safePath := "/home/user/documents/file.txt"
	fmt.Printf("Sanitizing \"%s\": ", safePath)
	sanitized, err = ps.SanitizePath(safePath)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
	} else {
		fmt.Printf("\"%s\"\n", sanitized)
	}

	// Test with complex traversal
	complexPath := "/app/../../etc/passwd"
	fmt.Printf("\nDetecting traversal in \"%s\": ", complexPath)
	hasTraversal, err = ps.DetectTraversal(complexPath)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
	} else {
		fmt.Printf("%t\n", hasTraversal)
	}

	fmt.Printf("Sanitizing \"%s\": ", complexPath)
	sanitized, err = ps.SanitizePath(complexPath)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
	} else {
		fmt.Printf("\"%s\"\n", sanitized)
	}
}