use crate::client::{GitFoxClient, Query};
use crate::error::Result;
use crate::models::{RepoRef, Repository};
pub struct ReposApi<'a> {
client: &'a GitFoxClient,
}
impl<'a> ReposApi<'a> {
pub(crate) fn new(client: &'a GitFoxClient) -> Self {
Self { client }
}
pub async fn get(&self, repo: &RepoRef) -> Result<Repository> {
self.client
.get_json(&format!("/api/v1/repos/{}", repo.encoded()))
.await
}
pub async fn list(
&self,
query: Option<&str>,
sort: RepoSort,
page: u32,
limit: u32,
) -> Result<Vec<Repository>> {
self.client
.get_json(&list_query(query, sort, page, limit).apply("/api/v1/repos"))
.await
}
pub async fn list_in_space(
&self,
space: &str,
query: Option<&str>,
sort: RepoSort,
page: u32,
limit: u32,
) -> Result<Vec<Repository>> {
let space = space.replace('/', "%2F");
self.client
.get_json(
&list_query(query, sort, page, limit)
.apply(&format!("/api/v1/spaces/{space}/repos")),
)
.await
}
}
fn list_query(query: Option<&str>, sort: RepoSort, page: u32, limit: u32) -> Query {
let mut q = Query::new();
q.push_opt("query", query)
.push("sort", sort.as_str())
.push("order", sort.order())
.push("page", page)
.push("limit", limit);
q
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum RepoSort {
#[default]
Name,
Created,
Updated,
}
impl RepoSort {
pub fn as_str(self) -> &'static str {
match self {
Self::Name => "identifier",
Self::Created => "created",
Self::Updated => "updated",
}
}
pub fn order(self) -> &'static str {
match self {
Self::Name => "asc",
Self::Created | Self::Updated => "desc",
}
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn listings_are_ordered_the_way_each_sort_key_is_read() {
assert_eq!(RepoSort::Name.as_str(), "identifier");
assert_eq!(RepoSort::Name.order(), "asc");
assert_eq!(RepoSort::Updated.as_str(), "updated");
assert_eq!(RepoSort::Updated.order(), "desc");
}
#[test]
fn the_space_listing_encodes_a_nested_space_as_one_segment() {
let q = list_query(None, RepoSort::Name, 1, 30);
assert_eq!(
q.apply("/api/v1/spaces/org%2Fteam/repos"),
"/api/v1/spaces/org%2Fteam/repos?sort=identifier&order=asc&page=1&limit=30"
);
}
#[test]
fn a_search_term_is_escaped_not_concatenated() {
let q = list_query(Some("back end"), RepoSort::Name, 1, 30);
assert!(q.encode().contains("query=back+end"), "{}", q.encode());
}
}