aboutsummaryrefslogtreecommitdiff
path: root/manga
diff options
context:
space:
mode:
authorVidhu Kant Sharma <vidhukant@protonmail.ch>2022-02-23 20:52:09 +0530
committerVidhu Kant Sharma <vidhukant@protonmail.ch>2022-02-23 20:52:09 +0530
commit5e01fb1297e25314184effe2c9f9fbbda0e512fb (patch)
tree0d4d1b1aedd67a3b660dfb26c8ce407c5367898a /manga
parent8c685067611d829e5fb8eeaaba48508d15cd4dde (diff)
Pushing barebones manga package
Diffstat (limited to 'manga')
-rw-r--r--manga/README.md45
-rw-r--r--manga/client.go23
-rw-r--r--manga/manga.structs.go64
-rw-r--r--manga/request_handler.go48
-rw-r--r--manga/search.structs.go32
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
+}