1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

diff --git a/.woodpecker.yml b/.woodpecker.yml
index 72e6341bb53bc67e052700c2a37851c4408fc8ef..dad4769e323d35f7a2dbb7c30fadb69481458462 100644
--- a/.woodpecker.yml
+++ b/.woodpecker.yml
@@ -17,9 +17,6 @@     image: golang:1.17
     commands:
       - GOOS="windows" go build ./cmd/spectre
       - GOOS="linux" go build ./cmd/spectre
-    when:
-      event: [ push, tag ]
-      branch: main
 
   release-main:
     image: jolheiser/drone-gitea-main:latest

 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

diff --git a/cmd/spectre/README.md b/cmd/spectre/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..683bb72fcc02b5a78c23ec89bbc1a84929f1616b
--- /dev/null
+++ b/cmd/spectre/README.md
@@ -0,0 +1,33 @@
+# Spectre CLI
+
+All flags can be supplied as environment variables starting with `SPECTRE_*`
+
+e.g. `--username` -> `SPECTRE_USERNAME`
+
+### Usage
+
+```text
+spectre [FLAGS] [site]
+  -counter int
+        counter (default 1)
+  -scope value
+        scope
+  -scoper string
+        scoper base (default "com.lyndir.masterpassword")
+  -secret string
+        secret
+  -template value
+        template
+  -username string
+        username
+```
+
+### Example
+
+```shell
+export SPECTRE_USERNAME="Robert Lee Mitchell"
+export SPECTRE_SECRET="banana colored duckling"
+
+spectre masterpasswordapp.com
+# Jejr5[RepuSosp
+```
\ No newline at end of file

 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

diff --git a/cmd/spectre/main.go b/cmd/spectre/main.go
index d67aac49369826d101f50a521a384cd131a2d7e5..9248bc2add33ff8eb80061f076f542d7e31ae9f1 100644
--- a/cmd/spectre/main.go
+++ b/cmd/spectre/main.go
@@ -11,9 +11,12 @@ )
 
 func main() {
 	fs := flag.NewFlagSet("spectre", flag.ExitOnError)
+	fs.Usage = func() {
+		fmt.Fprintln(fs.Output(), "spectre [FLAGS] [site]")
+		fs.PrintDefaults()
+	}
 	usernameFlag := fs.String("username", "", "username")
 	secretFlag := fs.String("secret", "", "secret")
-	siteFlag := fs.String("site", "", "site")
 	counterFlag := fs.Int("counter", 1, "counter")
 	scoperFlag := fs.String("scoper", "com.lyndir.masterpassword", "scoper base")
 	scopeFlag := spectre.Authentication
@@ -38,7 +41,7 @@ 	if templateFlag == "" {
 		templateFlag = scopeFlag.DefaultTemplate()
 	}
 
-	if *usernameFlag == "" || *secretFlag == "" || *siteFlag == "" {
+	if *usernameFlag == "" || *secretFlag == "" || len(os.Args) < 2 {
 		panic("username, secret, and site are required")
 	}
 
@@ -49,7 +52,7 @@ 	if err != nil {
 		panic(err)
 	}
 
-	pw := s.Site(*siteFlag,
+	pw := s.Site(os.Args[1],
 		spectre.WithScope(scopeFlag),
 		spectre.WithTemplate(templateFlag),
 		spectre.WithCounter(*counterFlag),

 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

diff --git a/spectre_test.go b/spectre_test.go
index a794aed52170fba297d73f58b2cca9e5f47993b5..3bfcec87a7e5a6ba0c54468fd809c78d323e3e51 100644
--- a/spectre_test.go
+++ b/spectre_test.go
@@ -3,6 +3,7 @@
 import (
 	_ "embed"
 	"encoding/xml"
+	"fmt"
 	"strconv"
 	"testing"
 
@@ -53,18 +54,34 @@ 	}
 }
 
 // From the website sanity check
-func TestSanity(t *testing.T) {
+func Example() {
 	s, err := spectre.New("Robert Lee Mitchell", "banana colored duckling")
 	if err != nil {
-		t.Logf("failed sanity check: %v", err)
-		t.FailNow()
+		panic(err)
 	}
 
 	pw := s.Site("masterpasswordapp.com")
-	if pw != "Jejr5[RepuSosp" {
-		t.Log("failed sanity check")
-		t.FailNow()
+	fmt.Println(pw)
+	// Output: Jejr5[RepuSosp
+}
+
+// Example with options
+func Example_second() {
+	scoper := spectre.SimpleScoper{
+		Key: "com.jojodev.jolheiser",
 	}
+	s, err := spectre.New("Robert Lee Mitchell", "banana colored duckling", spectre.WithScoper(scoper))
+	if err != nil {
+		panic(err)
+	}
+
+	pw := s.Site("jojodev.com",
+		spectre.WithScope(spectre.Identification),
+		spectre.WithTemplate(spectre.Maximum),
+		spectre.WithCounter(2), // Password was leaked, so increment counter (example)
+	)
+	fmt.Println(pw)
+	// Output: Ig^JIcxD!*)TbefJBi6-
 }
 
 //go:embed spectre_tests.xml