From e5dfabfa8ee370cbcda356448d7153d53a59a5cf Mon Sep 17 00:00:00 2001 From: Vidhu Kant Sharma Date: Mon, 5 Sep 2022 21:09:11 +0530 Subject: Update README: add link to documentation website --- user/manga/README.md | 185 +-------------------------------------------------- 1 file changed, 1 insertion(+), 184 deletions(-) (limited to 'user/manga/README.md') diff --git a/user/manga/README.md b/user/manga/README.md index 01fc8f0..cc93d9a 100644 --- a/user/manga/README.md +++ b/user/manga/README.md @@ -1,190 +1,7 @@ # MAL2Go/user/manga MAL2Go `user/manga` package has functionality related to updating the user's manga list. -To *get* anime data, refer to the [`manga`](../../manga) package. - -**There are multiple possible server responses and errors currently haven't been implemented yet.** - -## Installation -In a terminal, run -``` fish -go get "github.com/MikunoNaka/MAL2Go/v2/user/manga" -``` - -## Usage -Firstly, import this package and instanciate the client. -``` go -import ( - "github.com/MikunoNaka/MAL2Go/v2/user/manga" -) -``` - -Now instanciate with -``` go -myClient := manga.Client { - AuthToken: "Bearer " + yourTokenHere, -} -``` - -- ### Delete a manga from user's anime list -``` go -mangaId := 108407 // manga's ID - -resp := myClient.DeleteManga(mangaId) - -/* if manga is successfully deleted, resp is 200 - * if manga isn't in the list resp is 404 */ -fmt.Println(resp) -``` - -- ### Get user's manga list -Possible statuses are: -- `reading` -- `completed` -- `on_hold` -- `dropped` -- `plan_to_watch` - -Leaving blank (`""`) gets all the anime - -Possible sorts are: -- `list_score` -- `list_updated_at` -- `manga_title` -- `manga_start_date` -- `manga_id` (beta) - -Leaving user blank (`""`) or as `"@me"` returns the authenticated user's list - -``` go -user := "0ZeroTsu" -status := "reading" -sort := "list_score" - -limit := 1000 // max is 1000 -offset := 0 - -// fields := []string{} means get all the fields -fields := []string{"title"} - -mangaList, err := myClient.GetMangaList(user, status, sort, limit, offset, fields) -if err != nil { - fmt.Println(err) -} - -// mangaList.Mangas is an array of the mangas in the list -for _, manga := range mangaList.Mangas { - fmt.Println(manga.Title) -} - -fmt.Println(mangaList.Paging.NextPage, mangaList.Paging.PrevPage) -``` - -- ### Set a manga's status -``` go -mangaId := 108407 // manga's ID -status := "dropped" -resp, _ := myClient.SetStatus(mangaId, status) -fmt.Println(resp.Error, resp.Message) -``` - -- ### Set read volumes -``` go -mangaId := 108407 // manga's ID -volumesRead := 10 -resp, _ := myClient.SetVolumesRead(mangaId, volumesRead) -fmt.Println(resp.Error, resp.Message) -``` - -- ### Set read chapters -``` go -mangaId := 108407 // manga's ID -chaptersRead := 150 -resp, _ := myClient.SetChaptersread(mangaId, chaptersRead) -fmt.Println(resp.Error, resp.Message) -``` - -- ### Set is rereading status -``` go -mangaId := 108407 // manga's ID -isRereading := true -_, _ := myClient.SetIsRereading(mangaId, isRereading) -``` - -- ### Set a manga's score -``` go -mangaId := 108407 // manga's ID -score := 1 -_, _ := myClient.SetScore(mangaId, score) -``` - -- ### Set a manga's priority -Priority on MyAnimeList ranges from 0 to 2 -``` go -mangaId := 108407 // manga's ID -priority := 2 -_, _ := myClient.SetPriority(mangaId, priority) -``` - -- ### Set a manga's reread value -Reread value on MyAnimeList ranges from 0 to 5 -``` go -mangaId := 108407 // manga's ID -rereadValue := 4 -_, _ := myClient.SetRereadValue(mangaId, rereadValue) -``` - -- ### Set a manga's reread count -Number of times user has reread the manga. There is no limit -``` go -mangaId := 108407 // manga's ID -rereadCount := 69 -_, _ := myClient.SetRereadCount(mangaId, rereadCount) -``` - -- ### Set a manga's tags -``` go -mangaId := 108407 // manga's ID -tags := "tags" -_, _ := myClient.UpdateTags(mangaId, tags) -``` - -- ### Set a manga's comments -``` go -mangaId := 108407 // manga's ID -comments := "I hate but love this" -_, _ := myClient.UpdateComments(mangaId, comments) -``` - -- ### Update all fields of a manga -WARNING: this function can overwrite any data and set it to null -if you don't specify a value to it. - -Refrain/use it carefully to avoid data loss. - -``` go -updateData := manga.UpdateMangaData { - Status: "dropped", - IsRereading: true, - Score: 1, - VolumesRead: 10, - ChaptersRead: 150, - Priority: 2, - TimesReread: 69, - RereadValue: 4, - Tags: "tags", - Comments: "I hate but love this", -} - -mangaId := 108407 // manga's ID - -resp, err := myClient.UpdateManga(mangaId, updateData) -if err != nil { - fmt.Println(err) -} - -fmt.Println(resp.Error, resp.Message) -``` +To *get* manga data, refer to the [`manga`](../../manga) package. ## Structure - [mangalist.go](mangalist.go) -- cgit v1.2.3