Struct Client

pub struct Client { /* private fields */ }

The gitea client that all gitea calls will go through. This wraps reqwest::Client and operates asyncronously.

Implementations

impl Client

pub fn new<T>(base_url: String, token: String, user_agent: T) -> Result<Self>

where T: Into<String>,

Create a new API client with the given base URL, token and user agent. If you need inspiration for a user agent, try this:

const APP_USER_AGENT: &'static str =
   concat!(env!("CARGO_PKG_NAME"), "/", env!("CARGO_PKG_VERSION"));
gitea::Client::new("https://tulpa.dev".into(), "ayylmao".into(), APP_USER_AGENT).unwrap();

pub async fn version(&self) -> Result<Version>

Gets the current version of gitea.

use gitea::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let cli = gitea::Client::new("https://tulpa.dev".into(), "ayylmao".into(), "test/test")?;
    println!("{:?}", cli.version().await?);
    Ok(())
}

pub async fn get_release_by_tag( &self, owner: String, repo: String, tag: String, ) -> Result<Release>

Gets a release of a repo by its tag name.

use gitea::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let cli = gitea::Client::new("https://tulpa.dev".into(), "ayylmao".into(), "test/test")?;
    let release = cli.get_release_by_tag("cadey".into(), "gitea-release".into(), "0.3.2".into()).await;
    Ok(())
}

pub async fn create_user_repo(&self, cr: CreateRepo) -> Result<Repo>

Creates a new gitea repo for the currently authenticated user with given details.

pub async fn create_org_repo(&self, org: String, cr: CreateRepo) -> Result<Repo>

Creates a new gitea repo for a given organization with given details.

pub async fn delete_repo(&self, owner: String, repo: String) -> Result<()>

Deletes a gitea repo by owner and name.

pub async fn get_repo(&self, owner: String, repo: String) -> Result<Repo>

Gets a gitea repo by name.

use gitea::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let cli = gitea::Client::new("https://tulpa.dev".into(), "ayylmao".into(), "test/test")?;
    let repo = cli.get_repo("cadey".into(), "gitea-release".into()).await;
    Ok(())
}

pub async fn get_releases( &self, owner: String, repo: String, ) -> Result<Vec<Release>>

Gets all of the releases for a given gitea repo.

use gitea::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let cli = gitea::Client::new("https://tulpa.dev".into(), "ayylmao".into(), "test/test")?;
    let repo = cli.get_releases("cadey".into(), "gitea-release".into()).await;
    Ok(())
}

pub async fn create_release( &self, owner: String, repo: String, cr: CreateRelease, ) -> Result<Release>

Creates a new gitea release.

use gitea::{CreateRelease, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let cli = gitea::Client::new("https://tulpa.dev".into(), "ayylmao".into(), "test/test")?;
    let repo = cli.create_release(
        "cadey".into(),
        "gitea-release".into(),
        CreateRelease{
            body: "This is a cool release".into(),
            draft: false,
            name: "test".into(),
            prerelease: false,
            tag_name: "v4.2.0".into(),
            target_commitish: "HEAD".into(),
        },
    ).await;
    Ok(())
}

pub async fn delete_release( &self, owner: String, repo: String, tag: String, ) -> Result<()>

Deletes a given release by tag name.

use gitea::Result;

#[tokio::main]
async fn main() -> Result<()> {
    let cli = gitea::Client::new("https://tulpa.dev".into(), "ayylmao".into(), "test/test")?;
    let _ = cli.delete_release("cadey".into(), "gitea-release".into(), "4.2.0".into()).await;
    Ok(())
}

pub async fn whoami(&self) -> Result<User>

Returns information about the currently authenticated user.