diff options
author | Vidhu Kant Sharma <vidhukant@protonmail.ch> | 2022-02-23 20:52:09 +0530 |
---|---|---|
committer | Vidhu Kant Sharma <vidhukant@protonmail.ch> | 2022-02-23 20:52:09 +0530 |
commit | 5e01fb1297e25314184effe2c9f9fbbda0e512fb (patch) | |
tree | 0d4d1b1aedd67a3b660dfb26c8ce407c5367898a /manga | |
parent | 8c685067611d829e5fb8eeaaba48508d15cd4dde (diff) |
Pushing barebones manga package
Diffstat (limited to 'manga')
-rw-r--r-- | manga/README.md | 45 | ||||
-rw-r--r-- | manga/client.go | 23 | ||||
-rw-r--r-- | manga/manga.structs.go | 64 | ||||
-rw-r--r-- | manga/request_handler.go | 48 | ||||
-rw-r--r-- | manga/search.structs.go | 32 |
5 files changed, 212 insertions, 0 deletions
diff --git a/manga/README.md b/manga/README.md new file mode 100644 index 0000000..74a97a3 --- /dev/null +++ b/manga/README.md @@ -0,0 +1,45 @@ +# MAL2Go/manga +MAL2Go `manga` package has functionality related to getting data about anime. + +## Installation +In a terminal, run +``` fish +go get "github.com/MikunoNaka/MAL2Go/manga" +``` + +## Usage +Firstly, import this package and instanciate the client. +``` go +import ( + "github.com/MikunoNaka/MAL2Go/manga" +) +``` + +Now instanciate with +``` go +myClient := manga.Client { + AuthToken: "Bearer " + yourTokenHere, +} +``` + +- ### Searching for a manga +``` go +``` + +- ### Getting a manga's info +``` go +``` + +- ### Get manga ranking +``` go +``` + +## Structure +- [manga.go](anime.go) +Contains all the exported functions for pulling data from the API. + +- [manga.structs.go](anime.structs.go) +Contains all the structs representing a manga entry on MyAnimeList. + +- [client.go](client.go) +The Client for accessing the API with this package. diff --git a/manga/client.go b/manga/client.go new file mode 100644 index 0000000..272bfff --- /dev/null +++ b/manga/client.go @@ -0,0 +1,23 @@ +/* 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 manga + +import ( + "github.com/MikunoNaka/MAL2Go/util" +) + +type Client util.DefaultClient diff --git a/manga/manga.structs.go b/manga/manga.structs.go new file mode 100644 index 0000000..b9748c4 --- /dev/null +++ b/manga/manga.structs.go @@ -0,0 +1,64 @@ +/* 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 manga + +import ( + "github.com/MikunoNaka/MAL2Go/util" +) + +type ListPaging util.ListPaging + +type Author struct { + // TODO: add stuff +} + +type ListStatus struct { + util.DefaultListStatus + VolumesRead int `json:"num_volumes_read"` + ChaptersRead int `json:"num_chapters_read"` + IsRereading bool `json:"is_rereading"` + TimesReread int `json:"num_times_reread"` + RereadValue int `json:"reread_value"` +} + +type Manga struct { + Id int `json:"id"` + Title string `json:"title"` + MainPicture util.Picture `json:"main_picture"` + AltTitles util.AltTitles `json:"alternative_titles"` + StartDate string `json:"start_date"` + EndDate string `json:"end_date"` + Synopsis string `json:"synopsis"` + MeanScore float32 `json:"mean"` + Rank int `json:"rank"` + Popularity int `json:"popularity"` + NumListUsers int `json:"num_list_users"` + NsfwStatus string `json:"nsfw"` + Genres []util.Genre `json:"genres"` + CreatedAt string `json:"created_at"` + UpdatedAt string `json:"updated_at"` + MediaType string `json:"media_type"` + Status string `json:"status"` + MyListStattus ListStatus `json:"my_list_status"` + NumVolumes int `json:"num_volumes"` + NumChapters int `json:"num_chapters"` + Authors []Author `json:"authors"` + Pictures []util.Picture `json:"pictures"` + Background string `json:"background"` + /* TODO add these fields: + * related_anime, related_manga, recommendations, serialization */ +} diff --git a/manga/request_handler.go b/manga/request_handler.go new file mode 100644 index 0000000..892289b --- /dev/null +++ b/manga/request_handler.go @@ -0,0 +1,48 @@ +/* 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 manga + +import ( + "io/ioutil" + "log" + "net/http" +) + +// Handles HTTP request with your OAuth token as a Header +func (c Client) requestHandler(endpoint string) string { + // generate request + req, err := http.NewRequest("GET", endpoint, nil) + if err != nil { + log.Fatal(err) + } + req.Header.Add("Authorization", c.AuthToken) + + // do request + res, err := c.HttpClient.Do(req) + if err != nil { + log.Fatal(err) + } + defer res.Body.Close() + + // read body + body, err := ioutil.ReadAll(res.Body) + if err != nil { + log.Fatal(err) + } + + return string(body) +} diff --git a/manga/search.structs.go b/manga/search.structs.go new file mode 100644 index 0000000..af154a9 --- /dev/null +++ b/manga/search.structs.go @@ -0,0 +1,32 @@ +/* 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 manga + +// this is how the API returns data (looks horrible) +type MangaSearchRaw struct { + Data []struct { + Manga Manga `json:"node"` + } `json:"data"` + + Paging ListPaging `json:"paging"` +} + +// this is how mal2go returns data +type AnimeSearch struct { + Mangas []Manga + Paging ListPaging +} |