From 3f391a16dcc5ff87427058320ae4f29920e34f2a Mon Sep 17 00:00:00 2001 From: Vidhu Kant Sharma Date: Sun, 20 Feb 2022 19:50:18 +0530 Subject: Fully documented user package --- user/README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 user/README.md (limited to 'user/README.md') diff --git a/user/README.md b/user/README.md new file mode 100644 index 0000000..503f4da --- /dev/null +++ b/user/README.md @@ -0,0 +1,48 @@ +# MAL2Go/user +MAL2Go `user` package has functionality related to getting data about the authenticated user. + +## Usage +Firstly, import this package and instanciate the client. +``` go +import ( + "github.com/MikunoNaka/MAL2Go/user" +) +``` + +Now instanciate with +``` go +myClient := user.Client { + AuthToken: "Bearer " + yourTokenHere, +} +``` + +- ### Get authenticated user's info +``` go +userData := myClient.GetSelfUserInfo() + +fmt.Println(userData.Name, userData.Picture) +``` + +The `User` datatype has the following fields: +- `Id` `int` +- `Name` `string` +- `Picture` `string` +- `Gender` `string` +- `Birthday` `string` +- `Location` `string` +- `JoinedAt` `string` +- `TimeZone` `string` +- `IsSupporter` `bool` + +## Structure +- [user.go](user.go) +Contains all the exported functions for pulling data from the API. + +- [user.structs.go](user.structs.go) +Represents the user data returned by the API + +- [client.go](client.go) +The Client for accessing the API with this package. + +- [request_handler.go](request_handler.go) +Responsible for making HTTP requests -- cgit v1.2.3