aboutsummaryrefslogtreecommitdiff
path: root/anime
diff options
context:
space:
mode:
authorVidhu Kant Sharma <vidhukant@protonmail.ch>2022-02-20 18:15:32 +0530
committerVidhu Kant Sharma <vidhukant@protonmail.ch>2022-02-20 18:15:32 +0530
commited6b859a8c5df2decaf888111e2cead7aaf2a2eb (patch)
tree81a91d64909c25a5e87e4932cf410e58b179d03f /anime
parentf1a83e9b5cf1931adcdccef9db4586eeab987700 (diff)
Fully documented anime package
Diffstat (limited to 'anime')
-rw-r--r--anime/README.md104
1 files changed, 103 insertions, 1 deletions
diff --git a/anime/README.md b/anime/README.md
index ec0b0a6..fe96f88 100644
--- a/anime/README.md
+++ b/anime/README.md
@@ -55,7 +55,109 @@ fmt.Println(searchResults.Animes) // print list of the search results
fmt.Println(searchResults.ListPaging.NextPage, searchResults.ListPaging.PrevPage)
```
-**More to be added later**
+- ### Getting an anime's info
+Each anime on MyAnimeList has a unique ID, which you need to find it
+
+Refer to [anime.structs.go](anime.structs.go) to find out all the keys the Anime struct has
+
+``` go
+animeId := 42351
+fields := []string{} // pull every field
+
+anime, err := myClient.GetAnimeById(animeId, fields)
+if err != nil {
+ fmt.Println(err)
+}
+
+fmt.Println(anime.Title, anime.MeanScore, anime.MyListStatus.Status)
+```
+
+- ### Get anime ranking
+Ranking is a list of anime sorted by their rank
+
+Possible ranking types are:
+- `all`
+- `airing`
+- `upcoming`
+- `tv`
+- `ova`
+- `movie`
+- `special`
+- `bypopularity`
+- `favorite`
+
+``` go
+rankingType := "favorite"
+limit, offset := 10, 0
+fields := []string{"title", "media_type"}
+
+ranking, err := myClient.GetAnimeRanking(rankingType, limit, offset, fields)
+
+// loop over the array of "titles" returned by the API
+for _, rankingAnime := range ranking.Titles {
+ anime := rankingAnime.Anime
+ rankNum := rankingAnime.RankNum
+
+ fmt.Printf("Title: %s, Rank Number: %d", anime.Title, rankNum)
+}
+
+// ranking lists have page numbers
+fmt.Println(ranking.Paging.NextPage, ranking.Paging.PrevPage)
+```
+
+- ### Get seasonal anime
+Get a list of anime from a particular season/year
+
+Possible seasons are:
+- `winter`
+- `spring`
+- `summer`
+- `fall`
+
+Possible ways to sort are:
+- `anime_score`
+- `anime_num_list_users`
+
+``` go
+year := "2021"
+season := "winter"
+sort := "anime_score"
+
+limit, offset := 10, 0
+
+fields := []string{"title"}
+
+seasonalAnime, err := myClient.GetSeasonalAnime(year, season, sort, limit, offset, fields)
+if err != nil {
+ fmt.Println(err)
+}
+
+for _, anime := range seasonalAnime.Animes {
+ fmt.Println(anime.Title)
+}
+
+fmt.Println(seaonalAnime.Season)
+fmt.Println(seasonalAnime.Paging.NextPage, seasonalAnime.Paging.PrevPage)
+```
+
+- ### Get suggested anime
+Returns suggestions related to the authenticated user
+
+``` go
+limit, offset := 10, 0
+fields := []string{"title"}
+
+suggestedAnime, err := myClient.GetSuggestedAnime(limit, offset, fields)
+if err != nil {
+ fmt.Println(err)
+}
+
+for _, anime := range suggestedAnime.Animes {
+ fmt.Println(anime.Titile)
+}
+
+fmt.Println(suggestedAnime.ListPaging.NextPage, suggestedAnime.ListPaging.PrevPage)
+```
## Structure
- [anime.go](anime.go)