Monorepo for Tangled
knotserver/xrpc: introduce sh.tangled.repo.tag to get a single tag
produces info about a single tag object
Signed-off-by: oppiliappan <me@oppi.li>
authored by
oppiliappan
and committed by
tangled.org
(Feb 6, 2026, 8:11 AM UTC)
a2e81892
eaaec770
+166
+33
api/tangled/repotag.go
+33
api/tangled/repotag.go
···
1
+
// Code generated by cmd/lexgen (see Makefile's lexgen); DO NOT EDIT.
2
+
3
+
package tangled
4
+
5
+
// schema: sh.tangled.repo.tag
6
+
7
+
import (
8
+
"bytes"
9
+
"context"
10
+
11
+
"github.com/bluesky-social/indigo/lex/util"
12
+
)
13
+
14
+
const (
15
+
RepoTagNSID = "sh.tangled.repo.tag"
16
+
)
17
+
18
+
// RepoTag calls the XRPC method "sh.tangled.repo.tag".
19
+
//
20
+
// repo: Repository identifier in format 'did:plc:.../repoName'
21
+
// tag: Name of tag, such as v1.3.0
22
+
func RepoTag(ctx context.Context, c util.LexClient, repo string, tag string) ([]byte, error) {
23
+
buf := new(bytes.Buffer)
24
+
25
+
params := map[string]interface{}{}
26
+
params["repo"] = repo
27
+
params["tag"] = tag
28
+
if err := c.LexDo(ctx, util.Query, "", "sh.tangled.repo.tag", params, nil, buf); err != nil {
29
+
return nil, err
30
+
}
31
+
32
+
return buf.Bytes(), nil
33
+
}
+85
knotserver/xrpc/repo_tag.go
+85
knotserver/xrpc/repo_tag.go
···
1
+
package xrpc
2
+
3
+
import (
4
+
"fmt"
5
+
"net/http"
6
+
7
+
"github.com/go-git/go-git/v5/plumbing"
8
+
"github.com/go-git/go-git/v5/plumbing/object"
9
+
10
+
"tangled.org/core/knotserver/git"
11
+
"tangled.org/core/types"
12
+
xrpcerr "tangled.org/core/xrpc/errors"
13
+
)
14
+
15
+
func (x *Xrpc) RepoTag(w http.ResponseWriter, r *http.Request) {
16
+
repo := r.URL.Query().Get("repo")
17
+
repoPath, err := x.parseRepoParam(repo)
18
+
if err != nil {
19
+
writeError(w, err.(xrpcerr.XrpcError), http.StatusBadRequest)
20
+
return
21
+
}
22
+
23
+
tagName := r.URL.Query().Get("tag")
24
+
if tagName == "" {
25
+
writeError(w, xrpcerr.NewXrpcError(
26
+
xrpcerr.WithTag("InvalidRequest"),
27
+
xrpcerr.WithMessage("missing name parameter"),
28
+
), http.StatusBadRequest)
29
+
return
30
+
}
31
+
32
+
gr, err := git.PlainOpen(repoPath)
33
+
if err != nil {
34
+
x.Logger.Error("failed to open", "error", err)
35
+
writeError(w, xrpcerr.RepoNotFoundError, http.StatusNoContent)
36
+
return
37
+
}
38
+
39
+
// if this is not already formatted as refs/tags/v0.1.0, then format it
40
+
if !plumbing.ReferenceName(tagName).IsTag() {
41
+
tagName = plumbing.NewTagReferenceName(tagName).String()
42
+
}
43
+
44
+
tags, err := gr.Tags(&git.TagsOptions{
45
+
Pattern: tagName,
46
+
})
47
+
48
+
if len(tags) != 1 {
49
+
writeError(w, xrpcerr.NewXrpcError(
50
+
xrpcerr.WithTag("TagNotFound"),
51
+
xrpcerr.WithMessage(fmt.Sprintf("expected 1 tag to be returned, got %d tags", len(tags))),
52
+
), http.StatusBadRequest)
53
+
return
54
+
}
55
+
56
+
tag := tags[0]
57
+
58
+
if err != nil {
59
+
x.Logger.Warn("getting tags", "error", err.Error())
60
+
tags = []object.Tag{}
61
+
}
62
+
63
+
var target *object.Tag
64
+
if tag.Target != plumbing.ZeroHash {
65
+
target = &tag
66
+
}
67
+
tr := types.TagReference{
68
+
Tag: target,
69
+
}
70
+
71
+
tr.Reference = types.Reference{
72
+
Name: tag.Name,
73
+
Hash: tag.Hash.String(),
74
+
}
75
+
76
+
if tag.Message != "" {
77
+
tr.Message = tag.Message
78
+
}
79
+
80
+
response := types.RepoTagResponse{
81
+
Tag: &tr,
82
+
}
83
+
84
+
writeJson(w, response)
85
+
}
+1
knotserver/xrpc/xrpc.go
+1
knotserver/xrpc/xrpc.go
···
59
59
r.Get("/"+tangled.RepoLogNSID, x.RepoLog)
60
60
r.Get("/"+tangled.RepoBranchesNSID, x.RepoBranches)
61
61
r.Get("/"+tangled.RepoTagsNSID, x.RepoTags)
62
+
r.Get("/"+tangled.RepoTagNSID, x.RepoTag)
62
63
r.Get("/"+tangled.RepoBlobNSID, x.RepoBlob)
63
64
r.Get("/"+tangled.RepoDiffNSID, x.RepoDiff)
64
65
r.Get("/"+tangled.RepoCompareNSID, x.RepoCompare)
+43
lexicons/repo/tag.json
+43
lexicons/repo/tag.json
···
1
+
{
2
+
"lexicon": 1,
3
+
"id": "sh.tangled.repo.tag",
4
+
"defs": {
5
+
"main": {
6
+
"type": "query",
7
+
"parameters": {
8
+
"type": "params",
9
+
"required": [
10
+
"repo",
11
+
"tag"
12
+
],
13
+
"properties": {
14
+
"repo": {
15
+
"type": "string",
16
+
"description": "Repository identifier in format 'did:plc:.../repoName'"
17
+
},
18
+
"tag": {
19
+
"type": "string",
20
+
"description": "Name of tag, such as v1.3.0"
21
+
}
22
+
}
23
+
},
24
+
"output": {
25
+
"encoding": "*/*"
26
+
},
27
+
"errors": [
28
+
{
29
+
"name": "RepoNotFound",
30
+
"description": "Repository not found or access denied"
31
+
},
32
+
{
33
+
"name": "TagNotFound",
34
+
"description": "Tag not found"
35
+
},
36
+
{
37
+
"name": "InvalidRequest",
38
+
"description": "Invalid request parameters"
39
+
}
40
+
]
41
+
}
42
+
}
43
+
}