giteaclient

This library provides a client for interacting with the Gitea API.

Configuration

You can configure the client using a HeroScript file:

!!giteaclient.configure
    name: 'default' // optional, 'default' is the default instance name
    url: 'https://git.ourworld.tf'
    secret: 'your-gitea-api-token'

Usage Example

Here's how to get the client and use its methods.

import incubaid.herolib.clients.giteaclient
import incubaid.herolib.core.base

fn main() ! {
    // Make sure hero is initialized
    base.init()!

 // Example configuration (can also be loaded from file)
 heroscript_config := "!!giteaclient.configure url:'https://gitea.com' secret:'...your_token...'"
 mut plbook := playbook.new(text: heroscript_config)!
 giteaclient.play(mut plbook)!

 // Get the default configured client
 mut client := giteaclient.get()!

 // Get the authenticated user
 user := client.get_current_user()!
 println('Authenticated as: ${user.login}')

 // List repositories for the authenticated user
 repos := client.user_list_repos()!
 println('Found ${repos.len} repositories:')
 for repo in repos {
  println('- ${repo.full_name}')
 }

    // Get a specific repository's issues
    owner := 'gitea'
    repo_name := 'gitea'
    println('\nFetching issues for ${owner}/${repo_name}...')
    issues := client.list_repo_issues(owner, repo_name)!
    println('Found ${issues.len} issues.')
    for issue in issues[..5] { // print first 5 issues
        println('  #${issue.number}: ${issue.title}')
    }
}


## tips

- to see the admin api: https://git.ourworld.tf/api/swagger