A Go package for connecting to Phabricator via the Conduit API.
Originally created to help develop Merlin, an Arcanist like tool written in Go.
This library uses conduit.connect to establish an authenticated session. You'll need to have a valid username and conduit certificate in order to use this API.
To get your conduit certificate, go to https://{MY_PHABRICATOR_URL}/settings/panel/conduit and copy/paste.
conn, err := conduit.Dial("https://secure.phabricator.com")
err = conn.Connect("USERNAME", "CERTIFICATE")
Any conduit error response will be returned as a
conduit.ConduitError type
conn, err := conduit.Dial("https://secure.phabricator.com")
err = conn.Connect("USERNAME", "CERTIFICATE")
ce, ok := err.(*conduit.ConduitError)
if ok {
println("code: " + ce.Code())
println("info: " + ce.Info())
}
// Or
if conduit.IsConduitError(err) {
// do something else
}
result, err := conduit.PHIDLookup([]string{"T1", "D1"})
result, err := conduit.PHIDLookupSingle("T1")
result, err := conduit.PHIDQuery([]string{"PHID-DREV-gumr6ra5wm32ez46qo3f", "..."})
result, err := conduit.PHIDQuerySingle("PHID-DREV-gumr6ra5wm32ez46qo3f")
You can use the conn.Call() method to make arbitrary
conduit method calls that aren't specifically supported
by the package.
type params struct {
Names []string `json:"names"`
Session *conduit.Session `json:"__conduit__"`
}
type result map[string]*struct{
URI string `json:"uri"`
FullName string `json:"fullName"`
Status string `json:"status"`
}
p := ¶ms {
Names: []string{"T1"},
Session: conn.Session,
}
var r result
err := conn.Call("phid.lookup", p, &r)