https://github.com/uniwue-rz/phabricator-go
A simple Phabricator Go API
https://github.com/uniwue-rz/phabricator-go
api golang phabricator
Last synced: 3 months ago
JSON representation
A simple Phabricator Go API
- Host: GitHub
- URL: https://github.com/uniwue-rz/phabricator-go
- Owner: uniwue-rz
- License: mit
- Created: 2017-10-27T15:08:55.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-09-09T14:12:52.000Z (over 5 years ago)
- Last Synced: 2025-01-14T00:49:50.927Z (5 months ago)
- Topics: api, golang, phabricator
- Language: Go
- Size: 17.6 KB
- Stars: 3
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Phabricator Go API
This is a simple Phabricator Go Conduit API, covering Almanac and Passphrase.
This API can be used with different automatization tools like and Ansible, Puppet, Chef or Salt to
create a dynamic inventory of the devices, services and their properties. The insecure
data can be saved in Phabricator as property of given device or service and the secure data can be handled using the
Passphrase.
## Installation
To install this packet you should add the repository in your import section
and the run the `goget` command.
```lang=go
import phabricator "github.com/uniwue-rz/phabricator-go"
```
## Usage
The following code exmaple is how this API is used:
```lang=go
request := phabricator.NewRequest("https://phabricator-domain/api/", "api-token")
resp, err := phabricator.GetService(&request, "serivce-name")
```
## Supported API
This Conduit API wrapper for go supports following Phabricator apis:
- `almanac`
- `passphrase`
- `phid`
## Extending
You can extend this library to enhance the functionality. To do so
you should create a new file with your `conduit_api.go` and `conduit_api_types.go`. In the `conduit_api` like the existing files you should declare your Methods, that
fetch the data from the server. In this you simply can use the `Request` struct and
add your modification to it. In `coundit_api_types.go` you describe the way the
data should be decoded. See `passphrase.go` and `passphrase_types.go` for hints.
## License
See LICENSE file