File: aliases.go

package info (click to toggle)
snapd 2.71-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 79,536 kB
  • sloc: ansic: 16,114; sh: 16,105; python: 9,941; makefile: 1,890; exp: 190; awk: 40; xml: 22
file content (102 lines) | stat: -rw-r--r-- 3,288 bytes parent folder | download | duplicates (6)
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
// -*- Mode: Go; indent-tabs-mode: t -*-

/*
 * Copyright (C) 2016 Canonical Ltd
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 3 as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 */

package client

import (
	"bytes"
	"encoding/json"
)

// aliasAction represents an action performed on aliases.
// With action "unalias" if Snap and Alias are set to the same value,
// snapd will check if what is referred to is indeed a snap or an alias.
type aliasAction struct {
	Action string `json:"action"`
	Snap   string `json:"snap,omitempty"`
	App    string `json:"app,omitempty"`
	Alias  string `json:"alias,omitempty"`
}

// performAliasAction performs a single action on aliases.
func (client *Client) performAliasAction(sa *aliasAction) (changeID string, err error) {
	b, err := json.Marshal(sa)
	if err != nil {
		return "", err
	}
	return client.doAsync("POST", "/v2/aliases", nil, nil, bytes.NewReader(b))
}

// Alias sets up a manual alias from alias to app in snapName.
func (client *Client) Alias(snapName, app, alias string) (changeID string, err error) {
	return client.performAliasAction(&aliasAction{
		Action: "alias",
		Snap:   snapName,
		App:    app,
		Alias:  alias,
	})
}

// // DisableAllAliases disables all aliases of a snap, removing all manual ones.
func (client *Client) DisableAllAliases(snapName string) (changeID string, err error) {
	return client.performAliasAction(&aliasAction{
		Action: "unalias",
		Snap:   snapName,
	})
}

// RemoveManualAlias removes a manual alias.
func (client *Client) RemoveManualAlias(alias string) (changeID string, err error) {
	return client.performAliasAction(&aliasAction{
		Action: "unalias",
		Alias:  alias,
	})
}

// Unalias tears down a manual alias or disables all aliases of a snap (removing all manual ones)
func (client *Client) Unalias(aliasOrSnap string) (changeID string, err error) {
	return client.performAliasAction(&aliasAction{
		Action: "unalias",
		Snap:   aliasOrSnap,
		Alias:  aliasOrSnap,
	})
}

// Prefer enables all aliases of a snap in preference to conflicting aliases
// of other snaps whose aliases will be disabled (removed for manual ones).
func (client *Client) Prefer(snapName string) (changeID string, err error) {
	return client.performAliasAction(&aliasAction{
		Action: "prefer",
		Snap:   snapName,
	})
}

// AliasStatus represents the status of an alias.
type AliasStatus struct {
	Command string `json:"command"`
	Status  string `json:"status"`
	Manual  string `json:"manual,omitempty"`
	Auto    string `json:"auto,omitempty"`
}

// Aliases returns a map snap -> alias -> AliasStatus for all snaps and aliases in the system.
func (client *Client) Aliases() (allStatuses map[string]map[string]AliasStatus, err error) {
	_, err = client.doSync("GET", "/v2/aliases", nil, nil, nil, &allStatuses)
	return
}