feat: list and inspect sites

Author: kulti

internal/app/enaptercli/cmd_site.go

@@ -0,0 +1,33 @@
+package enaptercli
+
+import (
+	"context"
+	"fmt"
+	"net/url"
+
+	"github.com/urfave/cli/v2"
+)
+
+type cmdSite struct {
+	cmdBase
+}
+
+func buildCmdSites() *cli.Command {
+	return &cli.Command{
+		Name:  "site",
+		Usage: "Manage sites",
+		Subcommands: []*cli.Command{
+			buildCmdSitesList(),
+			buildCmdSiteInspect(),
+		},
+	}
+}
+
+func (c *cmdSite) doHTTPRequest(ctx context.Context, p doHTTPRequestParams) error {
+	path, err := url.JoinPath("/sites", p.Path)
+	if err != nil {
+		return fmt.Errorf("join path: %w", err)
+	}
+	p.Path = path
+	return c.cmdBase.doHTTPRequest(ctx, p)
+}

internal/app/enaptercli/cmd_site_inspect.go

@@ -0,0 +1,44 @@
+package enaptercli
+
+import (
+	"context"
+	"net/http"
+
+	"github.com/urfave/cli/v2"
+)
+
+type cmdSiteInspect struct {
+	cmdSite
+	siteID string
+}
+
+func buildCmdSiteInspect() *cli.Command {
+	cmd := &cmdSiteInspect{}
+	return &cli.Command{
+		Name:               "inspect",
+		Usage:              "Inspect a site",
+		CustomHelpTemplate: cmd.HelpTemplate(),
+		Flags:              cmd.Flags(),
+		Before:             cmd.Before,
+		Action: func(cliCtx *cli.Context) error {
+			return cmd.do(cliCtx.Context)
+		},
+	}
+}
+
+func (c *cmdSiteInspect) Flags() []cli.Flag {
+	flags := c.cmdSite.Flags()
+	return append(flags, &cli.StringFlag{
+		Name:        "site-id",
+		Usage:       "site ID",
+		Destination: &c.siteID,
+		Required:    true,
+	})
+}
+
+func (c *cmdSiteInspect) do(ctx context.Context) error {
+	return c.doHTTPRequest(ctx, doHTTPRequestParams{
+		Method: http.MethodGet,
+		Path:   "/" + c.siteID,
+	})
+}

internal/app/enaptercli/cmd_site_list.go

@@ -0,0 +1,46 @@
+package enaptercli
+
+import (
+	"context"
+	"net/http"
+	"net/url"
+	"strconv"
+
+	"github.com/urfave/cli/v2"
+)
+
+type cmdSitesList struct {
+	cmdSite
+	offset int
+	limit  int
+}
+
+func buildCmdSitesList() *cli.Command {
+	cmd := &cmdSitesList{}
+	return &cli.Command{
+		Name:               "list",
+		Usage:              "List user sites",
+		CustomHelpTemplate: cmd.HelpTemplate(),
+		Flags:              cmd.Flags(),
+		Before:             cmd.Before,
+		Action: func(cliCtx *cli.Context) error {
+			return cmd.do(cliCtx.Context)
+		},
+	}
+}
+
+func (c *cmdSitesList) do(ctx context.Context) error {
+	query := url.Values{}
+	if c.offset != 0 {
+		query.Set("offset", strconv.Itoa(c.offset))
+	}
+	if c.limit != 0 {
+		query.Set("limit", strconv.Itoa(c.limit))
+	}
+
+	return c.cmdBase.doHTTPRequest(ctx, doHTTPRequestParams{
+		Method: http.MethodGet,
+		Path:   "/users/me/sites",
+		Query:  query,
+	})
+}

internal/app/enaptercli/execute.go

@@ -21,6 +21,7 @@ func NewApp() *cli.App {
 		"The token can be obtained in your Enapter Cloud account settings."
 
 	app.Commands = []*cli.Command{
+		buildCmdSites(),
 		buildCmdDevices(),
 		buildCmdBlueprints(),
 		buildCmdProvisioning(),

internal/app/enaptercli/testdata/helps/enapter

@@ -8,6 +8,7 @@ DESCRIPTION:
    Enapter CLI requires access token for authentication. The token can be obtained in your Enapter Cloud account settings.
 
 COMMANDS:
+   site          Manage sites
    device        Manage devices
    blueprint     Manage blueprints
    provisioning  Create devices of different types

internal/app/enaptercli/testdata/helps/enapter site

@@ -0,0 +1,13 @@
+NAME:
+   enaptercli.test site - Manage sites
+
+USAGE:
+   enaptercli.test site command [command options]
+
+COMMANDS:
+   list     List user sites
+   inspect  Inspect a site
+   help, h  Shows a list of commands or help for one command
+
+OPTIONS:
+   --help, -h  show help

internal/app/enaptercli/testdata/helps/enapter site inspect

@@ -0,0 +1,15 @@
+NAME:
+   enaptercli.test site inspect - Inspect a site
+
+USAGE:
+   enaptercli.test site inspect [command options]
+
+OPTIONS:
+   --verbose        log extra details about operation (default: false)
+   --site-id value  site ID
+   --help, -h       show help
+
+ENVIRONMENT VARIABLES:
+   ENAPTER3_API_TOKEN  Enapter API access token
+   ENAPTER3_API_HOST   Enapter API base URL (https://api.enapter.com by default)
+

internal/app/enaptercli/testdata/helps/enapter site list

@@ -0,0 +1,14 @@
+NAME:
+   enaptercli.test site list - List user sites
+
+USAGE:
+   enaptercli.test site list [command options]
+
+OPTIONS:
+   --verbose   log extra details about operation (default: false)
+   --help, -h  show help
+
+ENVIRONMENT VARIABLES:
+   ENAPTER3_API_TOKEN  Enapter API access token
+   ENAPTER3_API_HOST   Enapter API base URL (https://api.enapter.com by default)
+