Skip to content

Commit

Permalink
Merge pull request #210 from RomainBelorgey/pkg_doc
Browse files Browse the repository at this point in the history
Add help on using hub-tool as a library
  • Loading branch information
silvin-lubecki authored Jul 26, 2022
2 parents d383e72 + 9fd330d commit 44062da
Showing 1 changed file with 38 additions and 0 deletions.
38 changes: 38 additions & 0 deletions pkg/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Using tool as lib

You can use this tool as a library to make actions to Docker Hub.

## Examples

### Login

```
username := toto
password := pass
hubClient, err := hub.NewClient(
hub.WithHubAccount(username),
hub.WithPassword(password))
if err != nil {
log.Fatalf("Can't initiate hubClient | %s", err.Error())
}
//Login to retrieve new token to Hub
token, _, err := hubClient.Login(username, password, func() (string, error) {
return "2FA required, please provide the 6 digit code: ", nil
})
if err != nil {
log.Fatalf("Can't get token from Docker Hub | %s", err.Error())
}
```

After a successfull login, it is quite easy to do any action possible and listed inside `pkg/` directory.

### Removing a tag

```
err = hubClient.RemoveTag("toto/myrepo", "v1.0.0")
if err != nil {
log.Fatalf("Can't remove tag | %s", err.Error())
}
```

0 comments on commit 44062da

Please sign in to comment.