Git designed for AI agents.
package praefect
import (
"context"
"errors"
"fmt"
glcli "github.com/feder-cr/git-ai/internal/cli"
"github.com/feder-cr/git-ai/internal/log"
"github.com/feder-cr/git-ai/proto/go/gitalypb"
"github.com/urfave/cli/v3"
)
func newMetadataCommand() *cli.Command {
return &cli.Command{
Name: "metadata",
Usage: "show metadata about a repository",
Description: `Show detailed information about a repository. To specify a repository, provide either:
- A repository ID.
- A virtual storage and the repository's relative path on the virtual storage.
The output includes the following information about the specified repository:
- Repository ID.
- Virtual storage.
- Relative path on the virtual storage.
- Physical path on the physical storage.
- Which physical storage holds the primary replica of the repository.
- Detailed information about replicas of the repository.
Examples:
- praefect --config praefect.config.toml metadata --repository-id 1
- praefect --config praefect.config.toml metadata --virtual-storage default --relative-path <relative_path_on_the_physical_storage>`,
Action: metadataAction,
Flags: []cli.Flag{
&cli.IntFlag{
Name: "repository-id",
Usage: "the repository's ID",
},
&cli.StringFlag{
Name: paramVirtualStorage,
Usage: "the repository's virtual storage",
},
&cli.StringFlag{
Name: "relative-path",
Usage: "the repository's relative path in the virtual storage",
},
},
Before: func(ctx context.Context, cmd *cli.Command) (context.Context, error) {
if cmd.Args().Present() {
_ = cli.ShowSubcommandHelp(cmd)
return nil, cli.Exit(unexpectedPositionalArgsError{Command: cmd.Name}, 1)
}
return ctx, nil
},
}
}
func metadataAction(ctx context.Context, cmd *cli.Command) error {
log.ConfigureCommand()
conf, err := readConfig(cmd.String(configFlagName))
if err != nil {
return err
}
repositoryID := cmd.Int("repository-id")
virtualStorage := cmd.String(paramVirtualStorage)
relativePath := cmd.String("relative-path")
var request gitalypb.GetRepositoryMetadataRequest
switch {
case repositoryID != 0:
if virtualStorage != "" || relativePath != "" {
return errors.New("virtual storage and relative path can't be provided with a repository ID")
}
request.Query = &gitalypb.GetRepositoryMetadataRequest_RepositoryId{RepositoryId: int64(repositoryID)}
case virtualStorage != "" || relativePath != "":
if virtualStorage == "" {
return errors.New("virtual storage is required with relative path")
} else if relativePath == "" {
return errors.New("relative path is required with virtual storage")
}
request.Query = &gitalypb.GetRepositoryMetadataRequest_Path_{
Path: &gitalypb.GetRepositoryMetadataRequest_Path{
VirtualStorage: virtualStorage,
RelativePath: relativePath,
},
}
default:
return errors.New("repository ID or virtual storage and relative path required")
}
nodeAddr, err := getNodeAddress(conf)
if err != nil {
return fmt.Errorf("get node address: %w", err)
}
conn, err := glcli.Dial(ctx, nodeAddr, conf.Auth.GetToken(), defaultDialTimeout)
if err != nil {
return fmt.Errorf("dial: %w", err)
}
defer conn.Close()
metadata, err := gitalypb.NewPraefectInfoServiceClient(conn).GetRepositoryMetadata(ctx, &request)
if err != nil {
return fmt.Errorf("get metadata: %w", err)
}
fmt.Fprintf(cmd.Writer, "Repository ID: %d\n", metadata.GetRepositoryId())
fmt.Fprintf(cmd.Writer, "Virtual Storage: %q\n", metadata.GetVirtualStorage())
fmt.Fprintf(cmd.Writer, "Relative Path: %q\n", metadata.GetRelativePath())
fmt.Fprintf(cmd.Writer, "Replica Path: %q\n", metadata.GetReplicaPath())
fmt.Fprintf(cmd.Writer, "Primary: %q\n", metadata.GetPrimary())
fmt.Fprintf(cmd.Writer, "Generation: %d\n", metadata.GetGeneration())
fmt.Fprintf(cmd.Writer, "Replicas:\n")
for _, replica := range metadata.GetReplicas() {
fmt.Fprintf(cmd.Writer, "- Storage: %q\n", replica.GetStorage())
fmt.Fprintf(cmd.Writer, " Assigned: %v\n", replica.GetAssigned())
generationText := fmt.Sprintf("%d, fully up to date", replica.GetGeneration())
if replica.GetGeneration() == -1 {
generationText = "replica not yet created"
} else if replica.GetGeneration() < metadata.GetGeneration() {
generationText = fmt.Sprintf("%d, behind by %d changes", replica.GetGeneration(), metadata.GetGeneration()-replica.GetGeneration())
}
verifiedAt := "unverified"
if replica.GetVerifiedAt().IsValid() {
verifiedAt = replica.GetVerifiedAt().AsTime().String()
}
fmt.Fprintf(cmd.Writer, " Generation: %s\n", generationText)
fmt.Fprintf(cmd.Writer, " Healthy: %v\n", replica.GetHealthy())
fmt.Fprintf(cmd.Writer, " Valid Primary: %v\n", replica.GetValidPrimary())
fmt.Fprintf(cmd.Writer, " Verified At: %s\n", verifiedAt)
}
return nil
}