aboutsummaryrefslogtreecommitdiff
path: root/user/manga/README.md
diff options
context:
space:
mode:
authorVidhu Kant Sharma <vidhukant@vidhukant.xyz>2022-09-05 21:09:11 +0530
committerVidhu Kant Sharma <vidhukant@vidhukant.xyz>2022-09-05 21:09:11 +0530
commite5dfabfa8ee370cbcda356448d7153d53a59a5cf (patch)
tree98aaaebbdcc5fd5c796f2ff402a82997d622845d /user/manga/README.md
parent4dd68495f4d1e993af72d2a47530e85522b43a6e (diff)
Update README: add link to documentation website
Diffstat (limited to 'user/manga/README.md')
-rw-r--r--user/manga/README.md185
1 files changed, 1 insertions, 184 deletions
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)