diff options
author | Vidhu Kant Sharma <vidhukant@vidhukant.com> | 2023-08-13 11:54:33 +0530 |
---|---|---|
committer | Vidhu Kant Sharma <vidhukant@vidhukant.com> | 2023-08-13 11:54:33 +0530 |
commit | 211888b8a396df8d5166afba85af54e0240015c1 (patch) | |
tree | 14edbc114f5cec9da57dd08c9369e3c2f1aaa80c /content/docs/mal2go/v4/user | |
parent | 54e1b7496d6a06c92b030114e9d54019ab4ba87f (diff) |
removed MAL2Go documentation
Diffstat (limited to 'content/docs/mal2go/v4/user')
34 files changed, 0 insertions, 1369 deletions
diff --git a/content/docs/mal2go/v4/user/_index.md b/content/docs/mal2go/v4/user/_index.md deleted file mode 100644 index 02c62bc..0000000 --- a/content/docs/mal2go/v4/user/_index.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: User -description: Actions related to a user's account/lists -weight: 3 ---- diff --git a/content/docs/mal2go/v4/user/anime/_index.md b/content/docs/mal2go/v4/user/anime/_index.md deleted file mode 100644 index 4e48940..0000000 --- a/content/docs/mal2go/v4/user/anime/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: User's Animelist -description: Actions related to a user's animelist -weight: 3 ---- - -The `MAL2Go/user/anime` package supports updating the currently authenticated user's anime list along with reading the anime lists of the current user as well as other users. diff --git a/content/docs/mal2go/v4/user/anime/delete-anime.md b/content/docs/mal2go/v4/user/anime/delete-anime.md deleted file mode 100644 index b3476cb..0000000 --- a/content/docs/mal2go/v4/user/anime/delete-anime.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: "Delete Anime" -description: "Delete an anime from the user's animelist" -weight: 3 ---- - -Use the `DeleteAnime` method to remove an entry from the user's animelist. -This method takes these arguments: - -- `id int` ID of the anime - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.DeleteAnime(50172) - if err != nil { - log.Fatal(err) - } - - if res == "200" { - fmt.Println("Anime successfully deleted from your list") - } else { - fmt.Println("Something went wrong. Is the anime even in your list?") - } -} -``` - -The above example deletes "Summertime Render" from your list - -This method returns `"200"` on a successful attempt in deleting the anime from your list. It returns `"404"` if the anime is not in your list. diff --git a/content/docs/mal2go/v4/user/anime/get-anime-list.md b/content/docs/mal2go/v4/user/anime/get-anime-list.md deleted file mode 100644 index 22f6f4a..0000000 --- a/content/docs/mal2go/v4/user/anime/get-anime-list.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: "Get anime list" -description: "Get an arbitrary user's animelist" -weight: 2 ---- - -Use the `GetAnimeList` method to get the animelist of a user. -This method takes these arguments: - -- `username string` Username of the user to get animelist of. An empty string or `"@me"` will return the logged-in user's list -- `status string` Status of the animes, accepted values are `watching`, `completed`, `on_hold`, `dropped` and `plan_to_watch` -- `sort string` How to sort the list, accepted values are `list_score`, `list_updated_at`, `anime_title`, `anime_start_date` and `anime_id` -- `limit int` Limit of results to pull, Max is 1000 -- `offset int` Offset for the results -- `nsfw bool` To include NSFW elements or not -- `fields []string` Specify which fields to get for each anime. [List of valid fields](/docs/mal2go/v4/anime/types/#mal2goanimeanime) - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - animeList, nextPageExists, err := myClient.GetAnimeList("0ZeroTsu", "completed", "list_score", 1000, 0, true, []string{"title"}) - if err != nil { - log.Fatal(err) - } - - for _, i := range animeList { - fmt.Println(i.Title) - } - - if nextPageExists { - fmt.Println("This user has even more animes in their animelist.") - fmt.Println("Please increase the offset to look at the hidden entries.") - } -} -``` - -The above example prints the first 1000 entries from 0ZeroTsu's (mine) completed anime list. -If the list has more than 1000 items, the `nextPageExists` becomes true, which can be used to show -a notice like this, or maybe append the remaining items to animeList by calling `anime.GetAnimeList` with a higher offset. diff --git a/content/docs/mal2go/v4/user/anime/set-priority.md b/content/docs/mal2go/v4/user/anime/set-priority.md deleted file mode 100644 index 9c76ff3..0000000 --- a/content/docs/mal2go/v4/user/anime/set-priority.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: "Set Priority" -description: "Set Priority of The Anime" -weight: 10 ---- - -Use the `SetPriority` method to set the priority of the anime. -This method takes these arguments: - -- `id int` ID of the anime -- `priority int` Self explanatory - -The accepted values for priority are integers 1 to 2. Each meaning: - -0. Low -1. Medium -2. High - - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetPriority(47194, 2) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Priority has been set to", res.Priority) -} -``` - -The above example sets the priority of "Summertime Render" to 2 (High). - -The [response](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateresponse) from the API can be used to show the information of the anime after being updated. diff --git a/content/docs/mal2go/v4/user/anime/set-rewatch-count.md b/content/docs/mal2go/v4/user/anime/set-rewatch-count.md deleted file mode 100644 index ffe88af..0000000 --- a/content/docs/mal2go/v4/user/anime/set-rewatch-count.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Set Rewatch Count" -description: "Set times rewatched" -weight: 9 ---- - -Use the `SetRewatchCount` method to set the number of times the user has rewatched this anime. -This method takes these arguments: - -- `id int` ID of the anime -- `rewatchCount int` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetRewatchCount(47194, 2) - if err != nil { - log.Fatal(err) - } - - fmt.Println("You have rewatched this anime", res.TimesRewatched, "times.") -} -``` - -The above example sets the number of times rewatched for "Summertime Render" to 2. - -The [response](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateresponse) from the API can be used to show the information of the anime after being updated. diff --git a/content/docs/mal2go/v4/user/anime/set-rewatch-value.md b/content/docs/mal2go/v4/user/anime/set-rewatch-value.md deleted file mode 100644 index 10e0b76..0000000 --- a/content/docs/mal2go/v4/user/anime/set-rewatch-value.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: "Set Rewatch Value" -description: "Set Rewatch Value of The Anime" -weight: 8 ---- - -Use the `SetRewatchValue` method to set the rewatch value. -This method takes these arguments: - -- `id int` ID of the anime -- `rewatchValue int` Self explanatory - -The accepted values for rewatchValue are integers 1 to 5. Each meaning: - -0. Never -1. Very Low -2. Low -3. Medium -4. High -5. Very High - - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetRewatchValue(47194, 3) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Rewatch Value has been set to", res.RewatchValue) -} -``` - -The above example sets the rewatch value of "Summertime Render" to 3 (Medium). - -The [response](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateresponse) from the API can be used to show the information of the anime after being updated. diff --git a/content/docs/mal2go/v4/user/anime/set-rewatching-status.md b/content/docs/mal2go/v4/user/anime/set-rewatching-status.md deleted file mode 100644 index 3c4a767..0000000 --- a/content/docs/mal2go/v4/user/anime/set-rewatching-status.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: "Set Rewatching Status" -description: "Set Rewatching to true or false" -weight: 7 ---- - -Use the `SetIsRewatching` method to set the rewatching status. -This method takes these arguments: - -- `id int` ID of the anime -- `isRewatching bool` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" - "strconv" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetIsRewatching(47194, true) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Rewatching status has been set to ", strconv.FormatBool(res.IsRewatching)) -} -``` - -The above example sets the rewatching status of "Summertime Render" to true. - -The [response](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateresponse) from the API can be used to show the information of the anime after being updated. diff --git a/content/docs/mal2go/v4/user/anime/set-score.md b/content/docs/mal2go/v4/user/anime/set-score.md deleted file mode 100644 index 1268f9c..0000000 --- a/content/docs/mal2go/v4/user/anime/set-score.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Set Anime Score" -description: "Set Score of The Anime" -weight: 6 ---- - -Use the `SetScore` method to set the score. -This method takes these arguments: - -- `id int` ID of the anime -- `score int` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetScore(47194, 10) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Score has been set to", res.Score) -} -``` - -The above example sets the score of "Summertime Render" to 10. - -The [response](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateresponse) from the API can be used to show the information of the anime after being updated. diff --git a/content/docs/mal2go/v4/user/anime/set-status.md b/content/docs/mal2go/v4/user/anime/set-status.md deleted file mode 100644 index f4c6a84..0000000 --- a/content/docs/mal2go/v4/user/anime/set-status.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Set Anime Status" -description: "Set an anime's status" -weight: 4 ---- - -Use the `SetStatus` method to set the status of an anime. -This method takes these arguments: - -- `id int` ID of the anime -- `status string` Status to set. Accepted values are `watching`, `completed`, `on_hold`, `dropped`, `plan_to_watch` - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetStatus(47194, "plan_to_watch") - if err != nil { - log.Fatal(err) - } - - fmt.Println("Status has been set to", res.Status) -} -``` - -The above example adds "Summertime Render" to your plan to watch list. - -The [response](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateresponse) from the API can be used to show the information of the anime after being updated. diff --git a/content/docs/mal2go/v4/user/anime/set-watched-episodes.md b/content/docs/mal2go/v4/user/anime/set-watched-episodes.md deleted file mode 100644 index b2ced63..0000000 --- a/content/docs/mal2go/v4/user/anime/set-watched-episodes.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Set Watched Episodes" -description: "Set Number of Episodes Watched" -weight: 5 ---- - -Use the `SetWatchedEpisodes` method to set the number of episodes watched. -This method takes these arguments: - -- `id int` ID of the anime -- `episodesWatched int` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetWatchedEpisodes(47194, 3) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Number of episodes has been set to", res.EpWatched) -} -``` - -The above example sets the episodes watched of "Summertime Render" to 3. - -The [response](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateresponse) from the API can be used to show the information of the anime after being updated. diff --git a/content/docs/mal2go/v4/user/anime/setting-up.md b/content/docs/mal2go/v4/user/anime/setting-up.md deleted file mode 100644 index 4a3fdad..0000000 --- a/content/docs/mal2go/v4/user/anime/setting-up.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: "Setting up" -description: "Install MAL2Go/user/anime and write some boilerplate" -weight: 1 ---- - -How to use the anime package: - -1. Install the MAL2Go/user/anime package using this command - -``` fish -go get github.com/MikunoNaka/MAL2Go/v4/user/anime -``` - -2. Import and initialise the anime client. The client holds the authentication token of the user. The OAuth token should be set as "Bearer TOKEN". Refer to below example - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" -) - -func main() { - // you should never hard-code tokens. This is just an example - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } -} -``` - -Every program using MAL2Go needs something like this to initialise everything (that you need). -And now we are ready to use the MAL2Go/user/anime package! diff --git a/content/docs/mal2go/v4/user/anime/types.md b/content/docs/mal2go/v4/user/anime/types.md deleted file mode 100644 index e9383da..0000000 --- a/content/docs/mal2go/v4/user/anime/types.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: "Types" -description: "The structs defined in this package" -weight: 14 ---- - -## MAL2Go/user/anime/UpdateAnimedata - -| Struct Field | Type | Description | -|----------------|----------|----------------------------| -| Status | `string` | Status to be set | -| IsRewatching | `bool` | Rewatching status | -| Score | `int` | Score of the anime | -| EpWatched | `int` | Number of episodes watched | -| Priority | `int` | Priority of the anime | -| TimesRewatched | `int` | Number of times rewatched | -| RewatchValue | `int` | Frequency of rewatches | -| Tags | `string` | Tags for the anime | -| Comments | `string` | Comments for the anime | - -## MAL2Go/user/anime/UpdateResponse - -| Struct Field | Type | Description | -|----------------|----------|----------------------------------------------------| -| Status | `string` | Status of the anime | -| Score | `int` | Score of the anime | -| EpWatched | `int` | Number of episodes watched | -| IsRewatching | `bool` | true if user is rewatching this anime | -| StartDate | `string` | Date user started watching this | -| FinishDate | `string` | Date user finished watching this | -| Priority | `string` | Priority of this anime | -| TimesRewatched | `string` | Number of times rewatched | -| RewatchValue | `string` | Frequency of rewatches | -| Tags | `string` | Tags set for this anime | -| Comments | `string` | Comments set for this anime | -| UpdatedAt | `string` | Time stamp of the last time this entry was updated | diff --git a/content/docs/mal2go/v4/user/anime/update-anime.md b/content/docs/mal2go/v4/user/anime/update-anime.md deleted file mode 100644 index b2cfbce..0000000 --- a/content/docs/mal2go/v4/user/anime/update-anime.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: "Update Anime" -description: "Update every field of an anime" -weight: 13 ---- - -The `UpdateAnime` method combines all the other methods used to update any of the fields of an entry in the animelist. - -**Warning: This method will overwrite every field of the specified anime. -If you don't specify a field it'd be set back to the default option. -Use it with caution at your own risk.** - -- `id int` ID of the anime -- `updateData `[`UpdateAnimeData`](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateanimedata) -A struct containing all the fields that need to be updated. **If a field is missing it will be set to the default option.** - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - updateData := anime.UpdateAnimeData { - Status: "watching", - IsRewatching: false, - Score: 10, - EpWatched: 20, - Priority: 2, - TimesRewatched: 0, - RewatchValue: 0, - Tags: "", - Comments: "", - } - - res, err := myClient.UpdateAnime(47194, updateData) - if err != nil { - log.Fatal(err) - } - - fmt.Println(res) -} -``` - -This is useful if you want to update many things without making too many API calls. -You can get the previously set data with the `GetAnimeById` method, if a value needs to be -unchanged, just use the previously set value returned by GetAnimeById. This way, -you can update multiple fields with only two API calls. - -The [response](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateresponse) from the API can be used to show the information of the anime after being updated. diff --git a/content/docs/mal2go/v4/user/anime/update-comments.md b/content/docs/mal2go/v4/user/anime/update-comments.md deleted file mode 100644 index 18d1775..0000000 --- a/content/docs/mal2go/v4/user/anime/update-comments.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Update Comments" -description: "Update the Comments for this anime" -weight: 12 ---- - -Use the `UpdateComments` method to set the comments for this anime. -This method takes these arguments: - -- `id int` ID of the anime -- `comments string` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.UpdateComments(47194, "This is a comment.") - if err != nil { - log.Fatal(err) - } - - fmt.Println("Comments have been set to \"", res.Comments, "\"" ) -} -``` - -The above example sets the comments for "Summertime Render" to "This is a comment.". - -The [response](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateresponse) from the API can be used to show the information of the anime after being updated. diff --git a/content/docs/mal2go/v4/user/anime/update-tags.md b/content/docs/mal2go/v4/user/anime/update-tags.md deleted file mode 100644 index 8792151..0000000 --- a/content/docs/mal2go/v4/user/anime/update-tags.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Update Tags" -description: "Update tags for this anime" -weight: 11 ---- - -Use the `UpdateTags` method to set the tags for this anime. -This method takes these arguments: - -- `id int` ID of the anime -- `tags string` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/anime" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.UpdateTags(47194, "tag1, tag2") - if err != nil { - log.Fatal(err) - } - - fmt.Println("Tags have been set to \"", res.Tags, "\"" ) -} -``` - -The above example sets the tags for "Summertime Render" to "tag1, tag2". - -The [response](/docs/mal2go/v4/user/anime/types/#mal2gouseranimeupdateresponse) from the API can be used to show the information of the anime after being updated. diff --git a/content/docs/mal2go/v4/user/get-self-user-info/_index.md b/content/docs/mal2go/v4/user/get-self-user-info/_index.md deleted file mode 100644 index 31b943c..0000000 --- a/content/docs/mal2go/v4/user/get-self-user-info/_index.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Getting authenticated user's info -description: Returns information about currenlty logged in user -weight: 2 ---- - -## Getting self user's info - -The `GetSelfUserInfo` function can be used to get information about the currently logged in user. - -``` go -package main - -import ( - "fmt" - "log" - "github.com/MikunoNaka/MAL2Go/v4/user" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := user.Client { - AuthToken: "Bearer " + authToken, - } - - userInfo, err := myClient.GetSelfUserInfo() - if err != nil { - log.Fatal(err) - } - - fmt.Printf("Username: %s\n", userInfo.Name) - fmt.Printf("Profile Picture: %s\n", userInfo.Picture) - fmt.Printf("Gender: %s\n", userInfo.Gender) - fmt.Printf("Location: %s\n", userInfo.Location) - fmt.Printf("Birthday: %s\n", userInfo.Birthday) - fmt.Printf("Time Zone: %s\n", userInfo.TimeZone) - fmt.Printf("Joined At: %s\n", userInfo.JoinedAt) - fmt.Printf("User ID: %d\n", userInfo.Id) - - if userInfo.IsSupporter { - fmt.Println("You are a MyAnimeList Supporter.") - } else { - fmt.Println("You are not a MyAnimeList Supporter.") - } -} -``` - -**MyAnimeList's Official API only allows getting info about the currently logged in user.** diff --git a/content/docs/mal2go/v4/user/manga/_index.md b/content/docs/mal2go/v4/user/manga/_index.md deleted file mode 100644 index c2060d8..0000000 --- a/content/docs/mal2go/v4/user/manga/_index.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: User's Mangalist -description: Actions related to a user's mangalist -weight: 4 ---- - -The `MAL2Go/user/manga` package supports updating the currently authenticated user's manga list along with reading the manga lists of the current user as well as other users. diff --git a/content/docs/mal2go/v4/user/manga/delete-manga.md b/content/docs/mal2go/v4/user/manga/delete-manga.md deleted file mode 100644 index 47d737a..0000000 --- a/content/docs/mal2go/v4/user/manga/delete-manga.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: "Delete Manga" -description: "Delete a manga from the user's mangalist" -weight: 3 ---- - -Use the `DeleteManga` method to remove an entry from the user's mangalist. -This method takes these arguments: - -- `id int` ID of the manga - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.DeleteManga(82745) - if err != nil { - log.Fatal(err) - } - - if res == "200" { - fmt.Println("Manga successfully deleted from your list") - } else { - fmt.Println("Something went wrong. Is the manga even in your list?") - } -} -``` - -The above example deletes "Demi-chan wa Kataritai" from your list - -This method returns `"200"` on a successful attempt in deleting the manga from your list. It returns `"404"` if the manga is not in your list. diff --git a/content/docs/mal2go/v4/user/manga/get-manga-list.md b/content/docs/mal2go/v4/user/manga/get-manga-list.md deleted file mode 100644 index 004e764..0000000 --- a/content/docs/mal2go/v4/user/manga/get-manga-list.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: "Get manga list" -description: "Get an arbitrary user's mangalist" -weight: 2 ---- - -Use the `GetMangaList` method to get the mangalist of a user. -This method takes these arguments: - -- `username string` Username of the user to get mangalist of. An empty string or `"@me"` will return the logged-in user's list -- `status string` Status of the mangas, accepted values are `reading`, `completed`, `on_hold`, `dropped` and `plan_to_read` -- `sort string` How to sort the list, accepted values are `list_score`, `list_updated_at`, `manga_title`, `manga_start_date` and `manga_id` -- `limit int` Limit of results to pull, Max is 1000 -- `offset int` Offset for the results -- `nsfw bool` To include NSFW elements or not -- `fields []string` Specify which fields to get for each manga. [List of valid fields](/docs/mal2go/v4/manga/types/#mal2gomangamanga) - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - mangaList, nextPageExists, err := myClient.GetMangaList("0ZeroTsu", "completed", "list_score", 1000, 0, true, []string{"title"}) - if err != nil { - log.Fatal(err) - } - - for _, i := range mangaList { - fmt.Println(i.Title) - } - - if nextPageExists { - fmt.Println("This user has even more mangas in their mangalist.") - fmt.Println("Please increase the offset to look at the hidden entries.") - } -} -``` - -The above example prints the first 1000 entries from 0ZeroTsu's (mine) completed manga list. -If the list has more than 1000 items, the `nextPageExists` becomes true, which can be used to show -a notice like this, or maybe append the remaining items to mangaList by calling `manga.GetMangaList` with a higher offset. diff --git a/content/docs/mal2go/v4/user/manga/set-priority.md b/content/docs/mal2go/v4/user/manga/set-priority.md deleted file mode 100644 index 7362f89..0000000 --- a/content/docs/mal2go/v4/user/manga/set-priority.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: "Set Priority" -description: "Set Priority of The Manga" -weight: 11 ---- - -Use the `SetPriority` method to set the priority of the manga. -This method takes these arguments: - -- `id int` ID of the manga -- `priority int` Self explanatory - -The accepted values for priority are integers 1 to 2. Each meaning: - -0. Low -1. Medium -2. High - - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetPriority(82745, 2) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Priority has been set to", res.Priority) -} -``` - -The above example sets the priority of "Demi-chan wa Kataritai" to 2 (High). - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/manga/set-read-chapters.md b/content/docs/mal2go/v4/user/manga/set-read-chapters.md deleted file mode 100644 index f87da43..0000000 --- a/content/docs/mal2go/v4/user/manga/set-read-chapters.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Set Chapters Read" -description: "Set Number of Chapters Read" -weight: 5 ---- - -Use the `SetChaptersRead` method to set the number of chapters read. -This method takes these arguments: - -- `id int` ID of the manga -- `chaptersRead int` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetChaptersRead(82745, 3) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Number of chapters has been set to", res.ChaptersRead) -} -``` - -The above example sets the number of chapters read of "Demi-chan wa Kataritai" to 3. - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/manga/set-read-volumes.md b/content/docs/mal2go/v4/user/manga/set-read-volumes.md deleted file mode 100644 index 1738f61..0000000 --- a/content/docs/mal2go/v4/user/manga/set-read-volumes.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Set Volumes Read" -description: "Set Number of Volumes Read" -weight: 6 ---- - -Use the `SetVolumesRead` method to set the number of volumes read. -This method takes these arguments: - -- `id int` ID of the manga -- `volumesRead int` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetVolumesRead(82745, 3) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Number of volumes has been set to", res.VolumesRead) -} -``` - -The above example sets the number of volumes read of "Demi-chan wa Kataritai" to 3. - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/manga/set-reread-count.md b/content/docs/mal2go/v4/user/manga/set-reread-count.md deleted file mode 100644 index 1e51eaf..0000000 --- a/content/docs/mal2go/v4/user/manga/set-reread-count.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Set Reread Count" -description: "Set times reread" -weight: 10 ---- - -Use the `SetRereadCount` method to set the number of times the user has reread this manga. -This method takes these arguments: - -- `id int` ID of the manga -- `rereadCount int` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetRereadCount(82745, 2) - if err != nil { - log.Fatal(err) - } - - fmt.Println("You have reread this manga", res.TimesReread, "times.") -} -``` - -The above example sets the number of times reread for "Demi-chan wa Kataritai" to 2. - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/manga/set-reread-value.md b/content/docs/mal2go/v4/user/manga/set-reread-value.md deleted file mode 100644 index 044f9a5..0000000 --- a/content/docs/mal2go/v4/user/manga/set-reread-value.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: "Set Reread Value" -description: "Set Reread Value of The Manga" -weight: 9 ---- - -Use the `SetRereadValue` method to set the reread value. -This method takes these arguments: - -- `id int` ID of the manga -- `rereadValue int` Self explanatory - -The accepted values for rereadValue are integers 1 to 5. Each meaning: - -0. Never -1. Very Low -2. Low -3. Medium -4. High -5. Very High - - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetRereadValue(82745, 3) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Reread Value has been set to", res.RereadValue) -} -``` - -The above example sets the reread value of "Demi-chan wa Kataritai" to 3 (Medium). - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/manga/set-rereading-status.md b/content/docs/mal2go/v4/user/manga/set-rereading-status.md deleted file mode 100644 index cd62050..0000000 --- a/content/docs/mal2go/v4/user/manga/set-rereading-status.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: "Set Rereading Status" -description: "Set Rereading to true or false" -weight: 8 ---- - -Use the `SetIsRereading` method to set the rereading status. -This method takes these arguments: - -- `id int` ID of the manga -- `isRereading bool` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" - "strconv" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetIsRereading(82745, true) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Rereading status has been set to ", strconv.FormatBool(res.IsRereading)) -} -``` - -The above example sets the rereading status of "Demi-chan wa Kataritai" to true. - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/manga/set-score.md b/content/docs/mal2go/v4/user/manga/set-score.md deleted file mode 100644 index 94c15e3..0000000 --- a/content/docs/mal2go/v4/user/manga/set-score.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Set Manga Score" -description: "Set Score of The Manga" -weight: 7 ---- - -Use the `SetScore` method to set the score. -This method takes these arguments: - -- `id int` ID of the manga -- `score int` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetScore(82745, 10) - if err != nil { - log.Fatal(err) - } - - fmt.Println("Score has been set to", res.Score) -} -``` - -The above example sets the score of "Demi-chan wa Kataritai" to 10. - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/manga/set-status.md b/content/docs/mal2go/v4/user/manga/set-status.md deleted file mode 100644 index f8c1d1c..0000000 --- a/content/docs/mal2go/v4/user/manga/set-status.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Set Manga Status" -description: "Set a manga's status" -weight: 4 ---- - -Use the `SetStatus` method to set the status of a manga. -This method takes these arguments: - -- `id int` ID of the manga -- `status string` Status to set. Accepted values are `reading`, `completed`, `on_hold`, `dropped`, `plan_to_read` - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.SetStatus(82745, "plan_to_read") - if err != nil { - log.Fatal(err) - } - - fmt.Println("Status has been set to", res.Status) -} -``` - -The above example adds "Demi-chan wa Kataritai" to your plan to read list. - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/manga/setting-up.md b/content/docs/mal2go/v4/user/manga/setting-up.md deleted file mode 100644 index e5db990..0000000 --- a/content/docs/mal2go/v4/user/manga/setting-up.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: "Setting up" -description: "Install MAL2Go/user/manga and write some boilerplate" -weight: 1 ---- - -How to use the anime package: - -1. Install the MAL2Go/user/manga package using this command - -``` fish -go get github.com/MikunoNaka/MAL2Go/v4/user/manga -``` - -2. Import and initialise the manga client. The client holds the authentication token of the user. The OAuth token should be set as "Bearer TOKEN". Refer to below example - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" -) - -func main() { - // you should never hard-code tokens. This is just an example - authToken := "YOUR_TOKEN_HERE" - myClient := anime.Client { - AuthToken: "Bearer " + authToken, - } -} -``` - -Every program using MAL2Go needs something like this to initialise everything (that you need). -And now we are ready to use the MAL2Go/user/manga package! diff --git a/content/docs/mal2go/v4/user/manga/types.md b/content/docs/mal2go/v4/user/manga/types.md deleted file mode 100644 index 21ce7f6..0000000 --- a/content/docs/mal2go/v4/user/manga/types.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: "Types" -description: "The structs defined in this package" -weight: 15 ---- - -## MAL2Go/user/manga/UpdateMangadata - -| Struct Field | Type | Description | -|--------------|----------|-------------------------| -| Status | `string` | Status to be set | -| IsRereading | `bool` | Rereading status | -| Score | `int` | Score of the manga | -| VolumesRead | `int` | Number of volumes read | -| ChaptersRead | `int` | Number of chapters read | -| Priority | `int` | Priority of the manga | -| TimesReread | `int` | Number of times rereads | -| RereadValue | `int` | Frequency of rereads | -| Tags | `string` | Tags for the manga | -| Comments | `string` | Comments for the manga | - -## MAL2Go/user/manga/UpdateResponse - -| Struct Field | Type | Description | -|--------------|----------|--------------------------------------| -| Status | `string` | Status of the manga | -| Score | `int` | Score of the manga | -| VolumesRead | `int` | Number of volumes read | -| ChaptersRead | `int` | Number of chapters read | -| IsRereading | `bool` | true if user is rereading this manga | -| Priority | `string` | Priority of this manga | -| TimesReread | `string` | Number of times reread | -| RereadValue | `string` | Frequency of rereads | -| Tags | `string` | Tags set for this manga | -| Comments | `string` | Comments set for this manga | diff --git a/content/docs/mal2go/v4/user/manga/update-comments.md b/content/docs/mal2go/v4/user/manga/update-comments.md deleted file mode 100644 index a33fe65..0000000 --- a/content/docs/mal2go/v4/user/manga/update-comments.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Update Comments" -description: "Update the Comments for this manga" -weight: 13 ---- - -Use the `UpdateComments` method to set the comments for this manga. -This method takes these arguments: - -- `id int` ID of the manga -- `comments string` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.UpdateComments(82745, "This is a comment.") - if err != nil { - log.Fatal(err) - } - - fmt.Println("Comments have been set to \"", res.Comments, "\"" ) -} -``` - -The above example sets the comments for "Demi-chan wa Kataritai" to "This is a comment.". - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/manga/update-manga.md b/content/docs/mal2go/v4/user/manga/update-manga.md deleted file mode 100644 index abf70cb..0000000 --- a/content/docs/mal2go/v4/user/manga/update-manga.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: "Update Manga" -description: "Update every field of an manga" -weight: 14 ---- - -The `UpdateManga` method combines all the other methods used to update any of the fields of an entry in the mangalist. - -**Warning: This method will overwrite every field of the specified manga. -If you don't specify a field it'd be set back to the default option. -Use it with caution at your own risk.** - -- `id int` ID of the manga -- `updateData `[`UpdateMangaData`](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdatemangadata) -A struct containing all the fields that need to be updated. **If a field is missing it will be set to the default option.** - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - updateData := manga.UpdateMangaData { - Status: "reading", - IsRereading: false, - Score: 10, - ChaptersRead: 20, - Priority: 2, - TimesReread: 0, - RereadValue: 0, - Tags: "", - Comments: "", - } - - res, err := myClient.UpdateManga(82745, updateData) - if err != nil { - log.Fatal(err) - } - - fmt.Println(res) -} -``` - -This is useful if you want to update many things without making too many API calls. -You can get the previously set data with the `GetMangaById` method, if a value needs to be -unchanged, just use the previously set value returned by GetMangaById. This way, -you can update multiple fields with only two API calls. - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/manga/update-tags.md b/content/docs/mal2go/v4/user/manga/update-tags.md deleted file mode 100644 index f0d4a23..0000000 --- a/content/docs/mal2go/v4/user/manga/update-tags.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Update Tags" -description: "Update tags for this manga" -weight: 12 ---- - -Use the `UpdateTags` method to set the tags for this manga. -This method takes these arguments: - -- `id int` ID of the manga -- `tags string` Self explanatory - -Example: - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user/manga" - "log" - "fmt" -) - -func main() { - authToken := "YOUR_TOKEN_HERE" - myClient := manga.Client { - AuthToken: "Bearer " + authToken, - } - - res, err := myClient.UpdateTags(82745, "tag1, tag2") - if err != nil { - log.Fatal(err) - } - - fmt.Println("Tags have been set to \"", res.Tags, "\"" ) -} -``` - -The above example sets the tags for "Demi-chan wa Kataritai" to "tag1, tag2". - -The [response](/docs/mal2go/v4/user/manga/types/#mal2gousermangaupdateresponse) from the API can be used to show the information of the manga after being updated. diff --git a/content/docs/mal2go/v4/user/setting-up/_index.md b/content/docs/mal2go/v4/user/setting-up/_index.md deleted file mode 100644 index 0b2b890..0000000 --- a/content/docs/mal2go/v4/user/setting-up/_index.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: "Setting up" -description: "Install MAL2Go/user and write some boilerplate" -weight: 1 ---- - -How to use the user package: - -1. Install the user package using this command - -``` fish -go get github.com/MikunoNaka/MAL2Go/v4/user -``` - -2. Import and initialise the user client. The client holds the authentication token of the user. The OAuth token should be set as "Bearer TOKEN". Refer to below example - -``` go -package main - -import ( - "github.com/MikunoNaka/MAL2Go/v4/user" -) - -func main() { - // you should never hard-code tokens. This is just an example - authToken := "YOUR_TOKEN_HERE" - myClient := user.Client { - AuthToken: "Bearer " + authToken, - } -} -``` - -Every program using MAL2Go needs something like this to initialise everything (that you need). -And now we are ready to use the MAL2Go/anime package! |