major: :star:

1 files changed, 78 insertions, 0 deletions

diff --git a/src/routes.rs b/src/routes.rs
new file mode 100644
index 0000000..e492404
--- /dev/null
+++ b/src/routes.rs
@@ -0,0 +1,78 @@
+// Copyleft 2021-2021 The Senpy Club
+// SPDX-License-Identifier: GPL-3.0-only
+
+use rand::{thread_rng, Rng};
+use rocket_contrib::json::Json;
+
+use crate::{
+  structures::{GitHubAPIResponse, SenpyRandom},
+  utils::{filter_images_by_language, filter_languages, github_api},
+};
+
+#[get("/")]
+pub fn index() -> &'static str {
+  r#"# senpy-api
+## routes
+if a language requires a parameter, it will be notated like <this>.
+for example; if a route is notated as "/api/v1/route?<parameter>", you can
+access that route via the url
+"http://this.domain/api/v1/route?parameter=something"
+
+- /
+    - /: index page (you are here)
+
+- /api/v1
+    - /github: github api mirror
+    - /languages: a list of all languages that appear in _the_ repository
+    - /language?<lang>: get a list of all images that pertain to the language "<lang>"
+
+## notes
+### rate-limit (s)
+there aren't any rate-limits or whatnot on api usage but don't abuse it, it only takes one bad
+apple to spoil the lot.
+
+### contributing
+if you'd like to support the project in anyway, check out the repository!
+https://github.com/senpy-club/api
+
+### supporting
+if you would like to support my development ventures, visit my github profile here :3
+https://github.com/fuwn
+
+### license
+gnu general public license v3.0 (gpl-3.0-only)
+https://github.com/senpy-club/api/blob/main/LICENSE"#
+}
+
+#[get("/github")]
+pub async fn github() -> Json<GitHubAPIResponse> { Json(github_api().await.unwrap()) }
+
+#[get("/languages")]
+pub async fn languages() -> Json<Vec<String>> { Json(filter_languages().await) }
+
+#[get("/language?<lang>")]
+pub async fn language(lang: Option<String>) -> Json<Vec<String>> {
+  // lang.map(async |lang| Json(filter_images_by_language(lang).await))
+  //   .unwrap_or_else(|| Json(vec!["invalid language or no language
+  // specified".to_string()]));
+
+  return if lang.is_none() {
+    Json(vec!["invalid language or no language specified".to_string()])
+  } else {
+    Json(filter_images_by_language(lang.unwrap()).await)
+  };
+}
+
+#[get("/random")]
+pub async fn random() -> Json<SenpyRandom> {
+  let filtered_languages = filter_languages().await;
+  let random_language =
+    &filtered_languages[thread_rng().gen_range(0..filtered_languages.len() - 1)];
+  let filtered_images = filter_images_by_language(random_language.clone().to_owned()).await;
+  let random_image = &filtered_images[thread_rng().gen_range(0..filtered_images.len() - 1)];
+
+  Json(SenpyRandom {
+    language: random_language.clone().to_owned(),
+    image:    random_image.clone().to_owned(),
+  })
+}