support fine-grained PAT

Author: kyoh86

.github/workflows/release.yml

@@ -45,7 +45,7 @@ jobs:
       - name: Setup Go
         uses: actions/setup-go@v3
         with:
-          go-version: 1.19
+          go-version: 1.21
       - name: Run GoReleaser
         uses: goreleaser/goreleaser-action@v3
         env:

.github/workflows/test.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Setup Go
         uses: actions/setup-go@v3
         with:
-          go-version: 1.19
+          go-version: 1.21
       - name: Test Go
         run: go test -v --race ./...
   test-release:
@@ -30,7 +30,7 @@ jobs:
       - name: Setup Go
         uses: actions/setup-go@v3
         with:
-          go-version: 1.19
+          go-version: 1.21
       - name: Try Bump-up Semantic Version
         uses: kyoh86/git-vertag-action@v1
         with:
@@ -48,11 +48,11 @@ jobs:
       - name: Setup Go
         uses: actions/setup-go@v3
         with:
-          go-version: 1.19
+          go-version: 1.21
       - name: Search diagnostics
         uses: golangci/golangci-lint-action@v3
         with:
-          version: v1.50.1
+          version: v1.55.2
   test-covers:
     name: Take test coverages
     runs-on: ubuntu-latest
@@ -62,7 +62,7 @@ jobs:
       - name: Setup Go
         uses: actions/setup-go@v3
         with:
-          go-version: 1.19
+          go-version: 1.21
       - name: Take coverage
         run: go test -coverprofile=coverage.txt -covermode=atomic ./...
       - name: Send coverage

.golangci.yml

@@ -1,13 +1,11 @@
 linters:
   enable:
     - bodyclose
-    - depguard
     - dogsled
     - gocritic
     - godox
     - gofmt
     - goimports
-    - golint
     - misspell
     - nakedret
     - prealloc

Makefile

@@ -25,6 +25,7 @@ test: gen
 .PHONY: test
 
 man: gen
+	rm -rf ./usage/**.md
 	go run -tags man -ldflags "-X=main.version=$(VERSION) -X=main.commit=$(COMMIT) -X=main.date=$(DATE)" ./cmd/gogh man
 .PHONY: man
 

README.md

@@ -67,8 +67,20 @@ $ mkdir -p gogh_build && \
 $ makepkg -i
 ```
 
+## Setup
+
+`gogh` manages repositories in multiple servers that is pairs of an owner and a host name.
+To login in new server or logout, you should use `auth login` with personal access tokens.
+
+You should generate personal access tokens with repository permissions:
+
+- ✔️ Read access to code and metadata
+- ✔️ Read and Write access to administration
+
 ## Available commands
 
+See manual for detail: [usage/gogh.md](./usage/gogh.md).
+
 ### Show projects
 
 | Command        | Description              |
@@ -78,26 +90,28 @@ $ makepkg -i
 
 ### Manipulate projects
 
-| Command        | Description                                   |
-| --             | --                                            |
-| `gogh create`  | Create a new project with a remote repository |
-| `gogh delete`  | Delete a repository with a remote repository  |
-| `gogh fork`    | Fork a repository                             |
-| `gogh clone`   | Clone a repository to local                   |
+| Command       | Description                                   |
+| --            | --                                            |
+| `gogh create` | Create a new project with a remote repository |
+| `gogh delete` | Delete a repository with a remote repository  |
+| `gogh fork`   | Fork a repository                             |
+| `gogh clone`  | Clone a repository to local                   |
 
 ### Others
 
-| Command        | Description              |
-| --             | --                       |
-| `gogh roots`   | Manage roots             |
-| `gogh servers` | Manage servers           |
-| `gogh bundle`  | Manage bundle            |
-| `gogh help`    | Help about any command   |
+| Command       | Description            |
+| --            | --                     |
+| `gogh roots`  | Manage roots           |
+| `gogh auth`   | Manage Authentications |
+| `gogh bundle` | Manage bundle          |
+| `gogh help`   | Help about any command |
 
 Use `gogh [command] --help` for more information about a command.
 Or see the manual in [usage/gogh.md](./usage/gogh.md).
 
-## Roots
+## Configurations
+
+### Roots
 
 `gogh` manages projects under the `roots` directories.
 
@@ -109,32 +123,26 @@ local project under it. If you want to change the default, use `roots set-defaul
 
 Default: `~/Projects`.
 
-## Servers
+### Default Host and Owner
 
-`gogh` manages repositories in some servers that pairs of a user and a host name.  To login in new
-server or logout, you should use `servers login`.  `gogh` uses the first server as the default one.
 When you specify a repository with ambiguous user or host, it will be interpolated with a default
-server.
-
-I.E. when servers are:
+value. You may set them with `set-default`.
 
-```
-- github.com:
-  - user: kyoh86
-- example.com:
-  - user: foobar
-```
+If you set them like below:
 
-Ambiguous repository names will be interpolated:
+| key     | value         |
+| -       | -             |
+| `host`  | `example.com` |
+| `owner` | `kyoh86`      |
 
-| Ambiguous name | Interpolated name      |
-| --             | --                     |
-| `gogh`         | github.com/kyoh86/gogh |
-| `foobar/gogh`  | github.com/foobar/gogh |
+ambiguous repository names will be interpolated:
 
-## Commands
+| Ambiguous name | Interpolated name       |
+| --             | --                      |
+| `gogh`         | example.com/kyoh86/gogh |
+| `foobar/gogh`  | example.com/foobar/gogh |
 
-Manual: [usage/gogh.md](./usage/gogh.md).
+NOTE: default host will be "github.com" if you don't set it.
 
 ## Directory structures
 

cmd/gogh/auth.go

@@ -0,0 +1,21 @@
+package main
+
+import (
+	"github.com/kyoh86/gogh/v2"
+	"github.com/spf13/cobra"
+)
+
+var tokens gogh.TokenManager
+
+var authCommand = &cobra.Command{
+	Use:   "auth",
+	Short: "Manage tokens",
+	PersistentPostRunE: func(*cobra.Command, []string) error {
+		return saveTokens()
+	},
+}
+
+func init() {
+	configCommand.AddCommand(authCommand)
+	facadeCommand.AddCommand(authCommand)
+}

cmd/gogh/auth_list.go

@@ -0,0 +1,32 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/apex/log"
+	"github.com/spf13/cobra"
+)
+
+var authListCommand = &cobra.Command{
+	Use:   "list",
+	Short: "Listup authenticated host and owners",
+	Args:  cobra.ExactArgs(0),
+	RunE: func(cmd *cobra.Command, _ []string) error {
+		ctx, cancel := context.WithCancel(cmd.Context())
+		defer cancel()
+		entries := tokens.Entries()
+		if len(entries) == 0 {
+			log.FromContext(ctx).Warn("No valid token found: you need to set token by `gogh auth login`")
+			return nil
+		}
+		for _, entry := range entries {
+			fmt.Println(entry)
+		}
+		return nil
+	},
+}
+
+func init() {
+	authCommand.AddCommand(authListCommand)
+}

cmd/gogh/servers_login.go renamed to cmd/gogh/auth_login.go

@@ -16,7 +16,7 @@ var loginFlags struct {
 
 var loginCommand = &cobra.Command{
 	Use:   "login",
-	Short: "Login for a server",
+	Short: "Login for the host and owner",
 	Args:  cobra.ExactArgs(0),
 	RunE: func(*cobra.Command, []string) error {
 		if err := survey.Ask([]*survey.Question{
@@ -45,7 +45,8 @@ var loginCommand = &cobra.Command{
 		}, &loginFlags); err != nil {
 			return err
 		}
-		return servers.Set(loginFlags.Host, loginFlags.User, loginFlags.Password)
+		tokens.Set(loginFlags.Host, loginFlags.User, gogh.Token(loginFlags.Password))
+		return nil
 	},
 }
 
@@ -60,11 +61,10 @@ func stringValidator(v func(s string) error) survey.Validator {
 }
 
 func init() {
-	setup()
 	loginCommand.Flags().
 		StringVarP(&loginFlags.Host, "host", "", gogh.DefaultHost, "Host name to login")
 	loginCommand.Flags().StringVarP(&loginFlags.User, "user", "", "", "User name to login")
 	loginCommand.Flags().
 		StringVarP(&loginFlags.Password, "password", "", "", "Password or developer private token")
-	serversCommand.AddCommand(loginCommand)
+	authCommand.AddCommand(loginCommand)
 }

cmd/gogh/auth_logout.go

@@ -0,0 +1,49 @@
+package main
+
+import (
+	"github.com/AlecAivazis/survey/v2"
+	"github.com/apex/log"
+	"github.com/kyoh86/gogh/v2"
+	"github.com/spf13/cobra"
+)
+
+var logoutCommand = &cobra.Command{
+	Use:   "logout",
+	Short: "Logout from the host and owner",
+	RunE: func(cmd *cobra.Command, indices []string) error {
+		if len(indices) == 0 {
+			configured := tokens.Entries()
+			if len(configured) == 0 {
+				return nil
+			}
+			indices = make([]string, 0, len(configured))
+			for _, c := range configured {
+				indices = append(indices, c.String())
+			}
+
+			var selected []string
+			if err := survey.AskOne(&survey.MultiSelect{
+				Message: "Hosts to logout from",
+				Options: indices,
+			}, &selected); err != nil {
+				return err
+			}
+			indices = selected
+		}
+
+		for _, target := range indices {
+			log.FromContext(cmd.Context()).WithField("target", target).Info("logout from")
+			target, err := gogh.ParseTokenTarget(target)
+			if err != nil {
+				log.FromContext(cmd.Context()).WithField("target", target).Error("invalid target")
+				continue
+			}
+			tokens.Delete(target.Host, target.Owner)
+		}
+		return nil
+	},
+}
+
+func init() {
+	authCommand.AddCommand(logoutCommand)
+}

cmd/gogh/bundle.go

@@ -7,12 +7,8 @@ import (
 var bundleCommand = &cobra.Command{
 	Use:   "bundle",
 	Short: "Manage bundle",
-	PersistentPostRunE: func(*cobra.Command, []string) error {
-		return saveServers()
-	},
 }
 
 func init() {
-	setup()
 	facadeCommand.AddCommand(bundleCommand)
 }