Merge pull request #1 from MikunoNaka/anime

Merging anime branch into main, with all the currently available API endpoints implemented and working (not sure if properly)

1 files changed, 231 insertions, 21 deletions

diff --git a/anime/anime.go b/anime/anime.go
index 5d054ab..3344016 100644
--- a/anime/anime.go
+++ b/anime/anime.go
@@ -1,40 +1,250 @@
+/* mal2go - MyAnimeList V2 API wrapper for Go
+ * Copyright (C) 2022  Vidhu Kant Sharma <vidhukant@protonmail.ch>
+
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>. */
+
 package anime
 
 import (
 	"encoding/json"
+	"errors"
 	"fmt"
-	"io/ioutil"
-	"log"
-	"net/http"
+	"strconv"
 )
 
-func GetAnimeById(token string, animeId int) Anime {
-  client := &http.Client{}
-  endpoint := fmt.Sprintf("https://api.myanimelist.net/v2/anime/%d?fields=id,title,main_picture,alternative_titles,start_date,end_date,synopsis,mean,rank,popularity,num_list_users,num_scoring_users,nsfw,created_at,updated_at,media_type,status,genres,my_list_status,num_episodes,start_season,broadcast,source,average_episode_duration,rating,pictures,background,related_anime,related_manga,recommendations,studios,statistics", animeId)
+const BASE_URL string = "https://api.myanimelist.net/v2/anime"
 
-  // generate request
-  req, err := http.NewRequest("GET", endpoint, nil)
-  if err != nil {
-      log.Fatal(err)
+// in MAL documentation this is named Get Anime List
+func SearchAnime(token, searchString string, limit, offset int, fields []string) (AnimeSearch, error) {
+  var searchResults AnimeSearch
+
+  // error handling for limit and offset
+  limitsErr := limitsErrHandler(limit, offset)
+  if limitsErr != nil {
+    return searchResults, limitsErr
   }
-  req.Header.Add("Authorization", token)
-  // req.Header.Add("Content-Type", "application/json")
 
-  // do request
-  res, err := client.Do(req)
+  // handle all the errors for the fields
+  fields, err := fieldsErrHandler(fields)
   if err != nil {
-      log.Fatal(err)
+    return searchResults, err
   }
-  defer res.Body.Close()
 
-  body, err := ioutil.ReadAll(res.Body)
-  if err != nil {
-      log.Fatal(err)
+  // generate endpoint url with custom params
+  endpoint, _ := urlGenerator(
+    BASE_URL,
+    []string{"q", "limit", "offset", "fields"},
+    [][]string{{searchString}, {strconv.Itoa(limit)}, {strconv.Itoa(offset)}, fields},
+    true,
+  )
+
+  // gets data from API and stores it in a struct
+  var animeSearchData AnimeSearchRaw
+  data := requestHandler(token, endpoint)
+  json.Unmarshal([]byte(data), &animeSearchData)
+
+  // Adding all the animes to another list to get formatted results later
+  var animes []Anime
+  for _, element := range animeSearchData.Data {
+    animes = append(animes, element.Anime)
   }
-  data := string(body)
 
+  // finally generate AnimeList 
+  searchResults = AnimeSearch {
+    Animes: animes,
+    Paging: animeSearchData.Paging,
+  }
+
+  return searchResults, nil
+}
+
+// Each anime has its own ID on MAL
+func GetAnimeById(token string, animeId int, fields []string) (Anime, error) {
   var anime Anime
+
+  // handle all the errors for the fields
+  fields, err := fieldsErrHandler(fields)
+  if err != nil {
+    return anime, err
+  }
+
+  endpoint, _ := urlGenerator(
+    BASE_URL + "/" + strconv.Itoa(animeId),
+    []string{"fields"},
+    /* it seems to still return all fields from the API. 
+     * this might be an issue with MAL itself
+     * TODO: look into this */
+    [][]string{fields},
+    true,
+  )
+
+  data := requestHandler(token, endpoint)
   json.Unmarshal([]byte(data), &anime)
 
-  return anime
+  return anime, nil
+}
+
+// Ranking is a list of anime sorted by their rank
+func GetAnimeRanking(token string, rankingType string, limit, offset int, fields []string) (AnimeRanking, error) {
+  var animeRanking AnimeRanking
+
+  // error handling for limit and offset
+  limitsErr := limitsErrHandler(limit, offset)
+  if limitsErr != nil {
+    return animeRanking, limitsErr
+  }
+
+  // handle all the errors for the fields
+  fields, err := fieldsErrHandler(fields)
+  if err != nil {
+    return animeRanking, err
+  }
+
+  // if ranking type is invalid
+  if !isValidRankingType(rankingType) {
+    return animeRanking, errors.New(fmt.Sprintf("GetAnimeRanking: Invalid ranking type specified: \"%s\"", rankingType))
+  }
+
+  endpoint, _ := urlGenerator(
+    BASE_URL + "/ranking",
+    []string{"ranking_type", "limit", "offset", "fields"},
+    [][]string{{rankingType}, {strconv.Itoa(limit)}, {strconv.Itoa(offset)}, fields},
+    true,
+  )
+
+  // gets data from API and stores it in a struct
+  var rankingData RawRanking
+  data := requestHandler(token, endpoint)
+  json.Unmarshal([]byte(data), &rankingData)
+
+  // Adding all the animes in ranking list to a slice
+  var animeRankingTitles []AnimeRankingTitle
+  for _, element := range rankingData.Data {
+    animeRankingTitles = append(
+      animeRankingTitles,
+      AnimeRankingTitle {
+        Anime:   element.Anime, 
+        RankNum: element.Ranking.Rank,
+      },
+    )
+  }
+
+  // Finally, create the AnimeRanking object
+  animeRanking = AnimeRanking {
+    Titles: animeRankingTitles,
+    Paging: ListPaging {
+      NextPage: rankingData.Paging.NextPage,
+      PrevPage: rankingData.Paging.PrevPage,
+    },
+  }
+
+  return animeRanking, nil
+}
+
+// get list of animes from specified season
+func GetSeasonalAnime(token, year, season, sort string, limit, offset int, fields []string) (SeasonalAnime, error) {
+  var seasonalAnime SeasonalAnime
+
+  // error handling for limit and offset
+  limitsErr := limitsErrHandler(limit, offset)
+  if limitsErr != nil {
+    return seasonalAnime, limitsErr
+  }
+
+  // handle all the errors for the fields
+  fields, err := fieldsErrHandler(fields)
+  if err != nil {
+    return seasonalAnime, err
+  }
+
+  // checks if valid season is specified
+  if !isValidSeason(season) {
+    return seasonalAnime, errors.New(fmt.Sprintf("GetSeasonalAnime: Invalid season specified: \"%s\"", season))
+  }
+
+  // checks if valid sort is specified
+  if !isValidSort(sort) {
+    return seasonalAnime, errors.New(fmt.Sprintf("GetSeasonalAnime: Invalid sort specified: \"%s\"", sort))
+  }
+
+  endpoint, _ := urlGenerator(
+    BASE_URL + fmt.Sprintf("/season/%s/%s", year, season),
+    []string{"sort", "limit", "offset", "fields"},
+    [][]string{{sort}, {strconv.Itoa(limit)}, {strconv.Itoa(offset)}, fields},
+    true,
+  )
+
+  // gets data from API and stores it in a struct
+  var seasonalAnimeData SeasonalAnimeRaw
+  data := requestHandler(token, endpoint)
+  json.Unmarshal([]byte(data), &seasonalAnimeData)
+
+  // Adding all the animes to another list to get formatted results later
+  var animes []Anime
+  for _, element := range seasonalAnimeData.Data {
+    animes = append(animes, element.Anime)
+  }
+
+  // finally generate SeasonalAnime
+  seasonalAnime = SeasonalAnime {
+    Animes: animes,
+    Paging: seasonalAnimeData.Paging,
+    Season: seasonalAnimeData.Season,
+  }
+
+  return seasonalAnime, nil
+}
+
+// get anime suggestions for the user
+func GetSuggestedAnime(token string, limit, offset int, fields []string) (SuggestedAnime, error){
+  var suggestedAnime SuggestedAnime
+
+  // error handling for limit and offset
+  limitsErr := limitsErrHandler(limit, offset)
+  if limitsErr != nil {
+    return suggestedAnime, limitsErr
+  }
+
+  // handle all the errors for the fields
+  fields, err := fieldsErrHandler(fields)
+  if err != nil {
+    return suggestedAnime, err
+  }
+
+  endpoint, _ := urlGenerator(
+    BASE_URL + "/suggestions",
+    []string{"limit", "offset", "fields"},
+    [][]string{{strconv.Itoa(limit)}, {strconv.Itoa(offset)}, fields},
+    true,
+  )
+
+  // gets data from API and stores it in a struct
+  var suggestedAnimeData SuggestedAnimeRaw
+  data := requestHandler(token, endpoint)
+  json.Unmarshal([]byte(data), &suggestedAnimeData)
+
+  // Adding all the animes to another list to get formatted results later
+  var animes []Anime
+  for _, element := range suggestedAnimeData.Data {
+    animes = append(animes, element.Anime)
+  }
+
+  // finally generate RecommendedAnime struct
+  suggestedAnime = SuggestedAnime {
+    Animes: animes,
+    Paging: suggestedAnimeData.Paging,
+  }
+
+  return suggestedAnime, nil
 }