WIP: Deb upload, todos, and errata

The "repository" field doesn't have a type right now, so I'm going to
skip deserializing it. The returned JSON has a value for this field, but
Serde will ignore it.

The `Packages.pkg_type` field is called "type" in the JSON string (and
Go code, as mentioned in the comment). Similarly, the PackageType enum
I have to represent this field in Rust has capital starting letters
where the JSON uses all lowercase. Both problems are solved with a Serde
rename attribute.

.gitea/workflows/release.yml

@@ -22,7 +22,9 @@ jobs:
       - name: Upload the program (using itself!)
         run: >
           target/release/gt-tool-${{ github.ref_name }}-$(arch)
-          -u ${{ vars.DEST_GITEA }} -r ${{ vars.DEST_REPO }}
+          -u ${{ vars.DEST_GITEA }}
+          -o ${{ vars.DEST_OWNER }}
+          -r ${{ vars.DEST_REPO }}
           upload-release
           "${{ github.ref_name }}"
           target/release/gt-tool-${{ github.ref_name }}-$(arch)

Cargo.toml

@@ -1,16 +1,16 @@
 [package]
 name = "gt-tool"
-version = "2.2.0"
+version = "4.0.0-dev"
 edition = "2024"
 
 [dependencies]
-clap = { version = "4.0.7", features = ["derive", "env"] }
-colored = "2.0.0"
-itertools = "0.10.0"
-reqwest = { version = "0.11.13", features = ["json", "stream", "multipart"] }
-serde = { version = "1.0.152", features = ["derive"] }
-tokio = { version = "1.24.2", features = ["macros", "rt-multi-thread"] }
-toml = "0.5"
+clap = { version = "4.5.23", features = ["derive", "env"] }
+colored = "2.2.0"
+itertools = "0.13.0"
+reqwest = { version = "0.12.15", features = ["json", "stream", "multipart"] }
+serde = { version = "1.0.217", features = ["derive"] }
+tokio = { version = "1.43.1", features = ["macros", "rt-multi-thread"] }
+toml = "0.8.19"
 
 # Packages available in Debian (Sid)
 # clap = "4.5.23"

README.md

@@ -5,7 +5,7 @@ CLI tools for interacting with the Gitea API. Use interactively to talk to your
 ## Usage
 
 ```txt
-Usage: gt-tools --url <GITEA_URL> --repo <REPO> <COMMAND>
+Usage: gt-tool [OPTIONS] <COMMAND>
 
 Commands:
   list-releases   
@@ -14,35 +14,52 @@ Commands:
   help            Print this message or the help of the given subcommand(s)
 
 Options:
-  -u, --url <GITEA_URL>  [env: GTTOOL_GITEA_URL=]
-  -r, --repo <REPO>      [env: GTTOOL_FQRN=]
-  -h, --help             Print help
-  -V, --version          Print version
+  -u, --url <GITEA_URL>    [env: GTTOOL_GITEA_URL=]
+  -o, --owner <OWNER>      [env: GTTOOL_OWNER=]
+  -r, --repo <REPO>        [env: GTTOOL_REPO=]
+  -p, --project <PROJECT>  Path to project (relative or absolute). Used to override configuration selection.
+  -h, --help               Print help
+  -V, --version            Print version
 ```
 
+### Required Information
+
+To function, this program requires knowledge of these items:
+
+- Gitea URL
+- Owner of repository
+- Repository name
+
+This info will be gathered from these locations, in order of priority:
+
+1. CLI argument
+2. Environment variable
+3. Configuration files
+
+It's worth noting that the "owner" is the entity that controls the repo on the Gitea instance. This will be the first part of the route in the URL: `http://demo.gitea.com/{owner}`.
+
+Likewise, the "repo" is what ever the Gitea instance thinks it's called -- which doesn't have to match anyone's local copy! It will be the second part of the route in the URL: `http://demo.gitea.com/{owner}/{repo}`.
+
 ### Authentication
 
-Authentication is token-based via environment variable `RELEASE_KEY_GITEA`.
+Authentication is token-based. There is no CLI option to prevent the token from appearing in any command logs.
 
-Ensure your token has the appropriate access for your usage. This depends on what you're doing and how your Gitea instance is configured, so you'll have to figure it out for yourself.
+In order of priority, the token is loaded from:
 
-Most likely, you will need a token with "repository: read-and-write" permissions. See Gitea's documentation on [token scopes](https://docs.gitea.com/development/oauth2-provider#scopes) for more.
+1. The environment variable `RELEASE_KEY_GITEA`
+2. Config files, key `token`
 
-### `<GITEA_URL>`:
+Whether or not it is required depends on how your Gitea instance and the repositories inside are configured.  For example, a default Gitea configuration will allow unauthenticated users to see public repositories but not make any changes. This means no token is required to run `gt-tool list-releases`, while `gt-tool upload-release` *will* require a token.
 
-The Gitea server URL must be provided with `--url` or `-u` on the command line, or via the environment variable `GTTOOL_GITEA_URL`. Use the base URL for your Gitea instance.
+For details, see Gitea's documentation on [token scopes](https://docs.gitea.com/development/oauth2-provider#scopes).
 
-E.g.: Using the Gitea org's demo instance, it would be: `--url "https://demo.gitea.com/"`
+### The `--project` option
 
-### `<REPO>`:
+Settings retrieved from config files are selected based on the project's path. By default, the current directory will be used. In case that guess is incorrect, this option can be specified with another path.
 
-The repository name must be provided with `--repo` or `-u` on the command line, or via the environment variable `GTTOOL_GITEA_FQRN` ("fully qualified repo name"). Use the format `<owner>/<repo>`, which is the route immediately following the GITEA_URL base. This is how GitHub and Gitea identify repos in the URL, and how Golang locates it's modules, so this tool does the same.
+See [configuration](#configuration) for details on format and file locations.
 
-E.g.: `--repo "go-gitea/gitea"` would name the Gitea repo belonging to the go-gitea organization.
-
-### `<COMMAND>`:
-
-One of these, defaults to `help`:
+### Commands:
 
 | Command | Description |
 |-|-|
@@ -51,3 +68,69 @@ One of these, defaults to `help`:
 | upload-release | Uploads one-or-more files to an existing release, identified by it's tag name. |
 | help | prints the help text (the usage summary above). |
 
+## Configuration
+
+Instead of specifying everything on the command line every single run, some TOML files can be used to persist project settings.
+
+> Exporting some environment variables would be similar, but that would be *more* annoying when working on multiple projects. One would have to constantly re-export the settings or use two shells. But then there's the issue of losing track of which shell has which settings.
+
+### File Format
+
+Settings are retrieved from a table named the same as the project's path on disk. For example, gt_tool itself could have an entry as follows:
+
+```toml
+["/home/robert/projects/gt-tool"]
+gitea_url = "https://demo.gitea.com/"
+owner = "dummy"
+repo = "gt-tool"
+token = "fake-token"
+```
+
+Sometimes one may want to apply a setting to all projects. For this, they can use the special `[all]` table.
+
+```toml
+[all]
+gitea_url = "https://demo.gitea.com/"
+```
+
+Since the more-specific settings are preferred, these can be combined to have an override effect.
+
+```toml
+[all]
+gitea_url = "https://demo.gitea.com/"
+owner = "robert"
+token = "fake-token"
+
+# Override Gitea target so I can test my uploads privately.
+["/home/robert/projects/gt-tool"]
+gitea_url = "http://localhost:3000"
+repo = "gt-tool"
+```
+
+### Search Paths
+
+Similar to how unspecified project settings will fall back to those in the "`[all]`" table, whole files will fall back to other, lower priority files.
+
+1. First, each dir in `$XDG_CONFIG_DIRS` is scanned for a `gt-tool.toml` file.
+2. Then, `/etc/gt-tool.toml`.
+
+> All config files **MUST** be named named `gt-tool.toml`.
+
+### Recognized Keys
+
+| Key | Description |
+|-|-|
+| gitea_url |  URL of the Gitea server. Same as `-u`, `--url`, and `$GTTOOL_GITEA_URL`. |
+| owner | Owner of the repository (individual, or organization). Combined with "repo" key to produce the fully-qualified-repo-name. Front-half of `-r`, `--repo`, and `$GTTOOL_FQRN` |
+| repo | Name of the repository on the Gitea server. Combined with "owner" key to produce the fully-qualified-repo-name. Back-half of `-r`, `--repo`, and `$GTTOOL_FQRN` |
+| token | Gitea auth token, exactly the same as `$RELEASE_KEY_GITEA` |
+
+Additional keys are quietly ignored. The config loading is done by querying a HashMap, so anything not touched doesn't get inspected. The only requirements are that the file is valid TOML, and that these keys are all strings.h
+
+# Errata
+
+- Gitea's package *uploading* API endpoints are not documented with Swagger.
+  * https://github.com/go-gitea/gitea/issues/30597
+  * It seems this is intentional because of which side defines the protocol (the consumer, not Gitea).
+  * This is an open issue (as of 12-Sep-2025) that doesn't have much attention.
+  * HTTP-POST (`curl`) is sufficient for upload. Use that either directly or as reference to make custom code.

src/api/packages.rs

@@ -1,4 +1,42 @@
-pub fn list_packages() {}
+use std::{fs, path::Path};
+
+use crate::structs::package::{Package, PackageType};
+
+/// Gets all packages of an owner
+///
+/// https://github.com/go-gitea/gitea/blob/main/routers/api/v1/packages/package.go#L22
+///
+/// Matches the route `GET /packages/{owner}`
+pub async fn list_packages(
+    client: &reqwest::Client,
+    gitea_url: &str,
+    owner: &str,
+    pkg_type: Option<PackageType>,
+) -> crate::Result<Vec<Package>> {
+    let request_url = format!("{gitea_url}/api/v1/packages/{owner}");
+    // add the query parameter only when a package type filter has been set.
+    let request_url = if let Some(pkg_type) = pkg_type {
+        let pkg_type = pkg_type.to_string();
+        format!("{request_url}?type={pkg_type}")
+    } else {
+        request_url
+    };
+    let req = client.get(request_url).send().await;
+    let response = req.map_err(crate::Error::WrappedReqwestErr)?;
+
+    if response.status().is_success() {
+        let release_list = response
+            .json::<Vec<Package>>()
+            .await
+            .map_err(crate::Error::WrappedReqwestErr)?;
+        return Ok(release_list);
+    } else if response.status().is_client_error() {
+        let mesg = crate::decode_client_error(response).await?;
+        return Err(crate::Error::ApiErrorMessage(mesg));
+    }
+    panic!("Reached the end of `api::list_packages()` without matching a return pathway.");
+}
+
 pub fn get_packages() {}
 pub fn delete_package() {}
 pub fn list_package_files() {}
@@ -6,3 +44,73 @@ pub fn get_latest_package_version() {}
 pub fn link_package() {}
 pub fn unlink_package() {}
 pub fn search_packages() {}
+
+
+/// Upload a Debian package and link it to it's source repository
+fn upload_debian(
+    client: &reqwest::Client,
+    gitea_url: &str,
+    repo: &str,
+    file: &Path,
+    owner: &str,
+    distribution: &str,
+    component: &str,
+) -> crate::Result<()> {
+    let request_url = format!("{gitea_url}/api/packages/{owner}/debian/pool/{distribution}/{component}/upload");
+    match file.try_exists() {
+        Ok(true) => (),
+        Ok(false) => return Err(crate::Error::NoSuchFile),
+        Err(e) => {
+            eprintln!("Uh oh! The file-exists check couldn't be done: {e}");
+            panic!(
+                "TODO: Deal with scenario where the file's existence cannot be checked (e.g.: no permission)"
+            );
+        }
+    };
+
+    let data = reqwest::multipart::Part::stream(fs::read(&file).unwrap())
+        .file_name("deb-pkg")
+        .mime_str("text/plain")?;
+
+    Ok(())
+}
+
+/// Uploads a package file to the Gitea registry.
+/// 
+/// This route is not documented in Swagger. The reason seems to be that some
+/// package managers have their own upload protocol (e.g. `docker push`). Gitea
+/// implements it but does not define it, so it doesn't include the API docs.
+pub fn upload_package(
+    client: &reqwest::Client,
+    gitea_url: &str,
+    file: String, // TODO: Use a path buffer of some flavor.
+) {
+    let request_url = format!("{gitea_url}/{}", route_for_upload(PackageType::Debian));
+}
+
+fn route_for_upload(kind: PackageType) -> &'static str {
+    match kind {
+        PackageType::Alpine => "https://gitea.example.com/api/packages/{owner}/alpine/{branch}/{repository}",
+        PackageType::Arch => "api/packages/{owner}/arch/{repository}",
+        PackageType::Cargo => todo!(),
+        PackageType::Chef => todo!(),
+        PackageType::Composer => todo!(),
+        PackageType::Conan => todo!(),
+        PackageType::Conda => todo!(),
+        PackageType::Container => todo!(),
+        PackageType::Cran => todo!(),
+        PackageType::Debian => "https://gitea.example.com/api/packages/{owner}/debian/pool/{distribution}/{component}/upload",
+        PackageType::Generic => todo!(),
+        PackageType::Go => todo!(),
+        PackageType::Helm => todo!(),
+        PackageType::Maven => todo!(),
+        PackageType::Npm => todo!(),
+        PackageType::Nuget => todo!(),
+        PackageType::Pub => todo!(),
+        PackageType::PyPi => todo!(),
+        PackageType::Rpm => todo!(),
+        PackageType::RubyGems => todo!(),
+        PackageType::Swift => todo!(),
+        PackageType::Vagrant => todo!(),
+    }
+}

src/cli.rs

@@ -5,8 +5,16 @@ use clap::{Parser, Subcommand};
 pub struct Args {
     #[arg(short = 'u', long = "url", env = "GTTOOL_GITEA_URL")]
     pub gitea_url: Option<String>,
-    #[arg(short = 'r', long = "repo", env = "GTTOOL_FQRN")]
+    #[arg(short = 'o', long = "owner", env = "GTTOOL_OWNER")]
+    pub owner: Option<String>,
+    #[arg(short = 'r', long = "repo", env = "GTTOOL_REPO")]
     pub repo: Option<String>,
+    #[arg(
+        short = 'p',
+        long = "project",
+        help = "Path to project (relative or absolute). Used to override configuration selection."
+    )]
+    pub project: Option<String>,
 
     #[command(subcommand)]
     pub command: Commands,
@@ -36,4 +44,5 @@ pub enum Commands {
         #[arg()]
         files: Vec<String>,
     },
+    ListPackages,
 }

src/config.rs

@@ -105,16 +105,20 @@ pub fn get_config(
             // 2. Get table
 
             get_table(cfg_table, project)
-                // 3. convert to PartialConfig
+                // 3a. convert to PartialConfig
                 .and_then(PartialConfig::try_from)
+                // 3b. or default, if the table couldn't be found.
+                .or(Ok(PartialConfig::default()))
                 // 4. assemble a 2-tuple of PartialConfigs by...
-                .and_then(|proj| {
-                    Ok((
+                .map(|proj| {
+                    (
                         // 4-1. Passing in the project-specific PartialConfig
                         proj.project_path(project),
                         // 4-2. Getting and converting to PartialConfig, or returning any Err() if one appears.
-                        get_table(cfg_table, "all").and_then(PartialConfig::try_from)?,
-                    ))
+                        get_table(cfg_table, "all")
+                            .and_then(PartialConfig::try_from)
+                            .unwrap_or(PartialConfig::default()),
+                    )
                 })
                 .map(|pair| pair.0.merge(pair.1))
         })
@@ -161,6 +165,12 @@ impl PartialConfig {
 impl TryFrom<&Table> for PartialConfig {
     type Error = crate::config::Error;
 
+    /// Scans properties out of a `toml::Table` to get a PartialConfig.
+    ///
+    /// `Error::NoSuchProperty` is quietly ignored (mapped to `None`) since it
+    /// isn't an error in this context.
+    ///
+    /// All other errors are propagated and should be treated as real failures.
     fn try_from(value: &Table) -> Result<Self> {
         Ok(Self {
             // can't get table name because that key is gone by this point.
@@ -285,7 +295,7 @@ mod tests {
             .map(PathBuf::from);
         let load_result = get_config("/no/such/project", search_paths)?;
         let expected = PartialConfig {
-            project_path: None,
+            project_path: Some(String::from("/no/such/project")),
             owner: None,
             repo: None,
             gitea_url: Some(String::from("http://localhost:3000")),
@@ -304,10 +314,39 @@ mod tests {
             .map(PathBuf::from);
         let load_result = get_config("/some/other/path", search_paths)?;
         let expected = PartialConfig {
-            gitea_url: Some(String::from("fake-url")),  
-            ..PartialConfig::default() 
+            project_path: Some(String::from("/some/other/path")),
+            gitea_url: Some(String::from("fake-url")),
+            ..PartialConfig::default()
         };
         assert_eq!(load_result, expected);
         Ok(())
     }
+
+    // Ensure that trying to load files that don't exist simply get skipped over
+    // instead of causing a short-circuit exit or other bogus output.
+    #[test]
+    fn test_get_config_many_missing_files() -> Result<()> {
+        let search_paths = [
+            "./test_data/not_real_1.toml",
+            "./test_data/not_real_2.toml",
+            "./test_data/not_real_3.toml",
+            "./test_data/not_real_4.toml",
+            "./test_data/not_real_5.toml",
+            "./test_data/sample_config.toml",
+            "./test_data/not_real_6.toml",
+        ]
+        .into_iter()
+        .map(PathBuf::from);
+        let load_result = get_config("/home/robert/projects/gt-tool", search_paths)?;
+        let expected = PartialConfig {
+            project_path: Some(String::from("/home/robert/projects/gt-tool")),
+            owner: Some(String::from("robert")),
+            repo: Some(String::from("gt-tool")),
+            gitea_url: Some(String::from("http://localhost:3000")),
+            token: Some(String::from("fake-token")),
+        };
+
+        assert_eq!(load_result, expected);
+        Ok(())
+    }
 }

src/lib.rs

@@ -20,9 +20,11 @@ pub(crate) async fn decode_client_error(response: reqwest::Response) -> Result<A
 
 #[derive(Debug)]
 pub enum Error {
-    Placeholder, // TODO: Enumerate error modes
+    Placeholder,     // TODO: Enumerate error modes
     MissingGiteaUrl, // the gitea URL wasn't specified on the CLI, env, or config file.
     MissingRepoFRQN, // either the owner, repo, or both weren't specified in the loaded PartialConfig
+    MissingRepoOwner,
+    MissingRepoName,
     WrappedConfigErr(config::Error),
     WrappedReqwestErr(reqwest::Error),
     MissingAuthToken,

src/main.rs

@@ -1,4 +1,4 @@
-use std::path;
+use std::path::{self, PathBuf};
 
 use gt_tool::cli::Args;
 use gt_tool::structs::release::{CreateReleaseOption, Release};
@@ -12,33 +12,37 @@ use reqwest::header::ACCEPT;
 async fn main() -> Result<(), gt_tool::Error> {
     let args = Args::parse();
 
-    // TODO: Heuristics to guess project path
-    // See issue #8: https://git.gelvin.dev/robert/gt-tool/issues/8
-    let pwd = std::env::current_dir()
-        .map_err(|_e| gt_tool::Error::WrappedConfigErr(
-            gt_tool::config::Error::CouldntReadFile
-        ))?;
+    let project_path =
+        args.project
+            .map(PathBuf::from)
+            .unwrap_or(std::env::current_dir().map_err(|_e| {
+                gt_tool::Error::WrappedConfigErr(gt_tool::config::Error::CouldntReadFile)
+            })?);
     let config = gt_tool::config::get_config(
-        pwd.to_str().expect("I assumed the path can be UTF-8, but that didn't work out..."),
-        gt_tool::config::default_paths()
+        project_path
+            .to_str()
+            .expect("I assumed the path can be UTF-8, but that didn't work out..."),
+        gt_tool::config::default_paths(),
     )?;
     println!("->> Loaded Config: {config:?}");
     // arg parser also checks the environment. Prefer CLI/env, then config file.
-    let gitea_url = args.gitea_url.or(config.gitea_url).ok_or(gt_tool::Error::MissingGiteaUrl)?;
-    // Config files split the repo FQRN into "owner" and "repo" (confusing naming, sorry)
-    // These must be merged back together and passed along.
-    let conf_fqrn = config.owner
-        .ok_or(gt_tool::Error::MissingRepoFRQN)
-        .and_then(| mut own| {
-            let repo = config.repo.ok_or(gt_tool::Error::MissingRepoFRQN)?;
-            own.push_str("/");
-            own.push_str(&repo);
-            Ok(own)
-        });
-    let repo_fqrn  = args.repo
-        .ok_or(gt_tool::Error::MissingRepoFRQN)
-        .or(conf_fqrn)?;
+    let gitea_url = args
+        .gitea_url
+        .or(config.gitea_url)
+        .ok_or(gt_tool::Error::MissingGiteaUrl)?;
 
+    let owner = args
+        .owner
+        .or(config.owner)
+        .ok_or(gt_tool::Error::MissingRepoOwner)?;
+
+    let repo = args
+        .repo
+        .or(config.repo)
+        .or_else(infer_repo)
+        .ok_or(gt_tool::Error::MissingRepoName)?;
+
+    let repo_fqrn = format!("{owner}/{repo}");
 
     let mut headers = reqwest::header::HeaderMap::new();
     headers.append(ACCEPT, header::HeaderValue::from_static("application/json"));
@@ -64,7 +68,7 @@ async fn main() -> Result<(), gt_tool::Error> {
                 releases.iter().rev().map(|release| release.colorized()),
                 String::from(""),
             )
-            .map(|release| println!("{}", release))
+            .map(|release| println!("{release}"))
             .fold((), |_, _| ());
         }
         gt_tool::cli::Commands::CreateRelease {
@@ -121,11 +125,7 @@ async fn main() -> Result<(), gt_tool::Error> {
                 }
                 for file in files {
                     let _attach_desc = gt_tool::api::release_attachment::create_release_attachment(
-                        &client,
-                        &gitea_url,
-                        &repo_fqrn,
-                        release.id,
-                        file,
+                        &client, &gitea_url, &repo_fqrn, release.id, file,
                     )
                     .await?;
                 }
@@ -134,6 +134,16 @@ async fn main() -> Result<(), gt_tool::Error> {
                 return Err(gt_tool::Error::NoSuchRelease);
             }
         }
+        gt_tool::cli::Commands::ListPackages => {
+            let packages = gt_tool::api::packages::list_packages(&client, &gitea_url, &owner, None).await?;
+            itertools::Itertools::intersperse(
+                packages
+                    .iter()
+                    .rev()
+                    .map(|pkg| pkg.colorized()),
+                String::from("")
+            ).for_each(|package| println!("{package}"));
+        }
     }
 
     Ok(())
@@ -172,3 +182,10 @@ fn match_release_by_tag(tag: &String, releases: Vec<Release>) -> Option<Release>
     }
     release
 }
+
+fn infer_repo() -> Option<String> {
+    let pwd = std::env::current_dir().ok()?;
+    let file_name = pwd.file_name()?;
+    let file_name_string = file_name.to_str()?;
+    Some(String::from(file_name_string))
+}

src/structs/mod.rs

@@ -1,5 +1,6 @@
 use serde::{Deserialize, Serialize};
 
+pub mod package;
 pub mod release;
 pub mod repo;
 

src/structs/package.rs

@@ -0,0 +1,94 @@
+use colored::Colorize;
+use serde::{Deserialize, Serialize};
+
+use crate::structs::release::Author;
+
+/// Represents the package as described by JSON
+///
+/// https://github.com/go-gitea/gitea/blob/main/modules/structs/package.go
+#[derive(Debug, Deserialize, Serialize)]
+pub struct Package {
+    created_at: String,          // TODO: Datetime struct
+    creator: Author,
+    html_url: String,
+    id: u64,
+    name: String,
+    owner: Author,
+    #[serde(skip)]
+    repository: (),             // TODO: Create a `struct Repository`
+    #[serde(rename = "type")]   // field is "type" in JSON & Go, but that's a
+    pkg_type: PackageType,      // keyword in Rust so we need to serde-rename it.
+    version: String,
+}
+
+impl Package {
+    pub fn colorized(&self) -> String {
+        let name = "Name:".green().bold();
+        let version = &self.version;
+        let pkg_type = "Type:".green();
+
+        format!(
+            "{name} {} {version}
+{pkg_type} {}",
+            self.name,
+            self.version,
+        )
+    }
+}
+
+/// A marker for the kind of package being handled.
+#[derive(Debug, Deserialize, Serialize)]
+#[serde(rename_all = "snake_case")]
+pub enum PackageType {
+    Alpine,
+    Arch,
+    Cargo,
+    Chef,
+    Composer,
+    Conan,
+    Conda,
+    Container,
+    Cran,
+    Debian,
+    Generic,
+    Go,
+    Helm,
+    Maven,
+    Npm,
+    Nuget,
+    Pub,
+    PyPi,
+    Rpm,
+    RubyGems,
+    Swift,
+    Vagrant,
+}
+
+impl ToString for PackageType {
+    fn to_string(&self) -> String {
+        match self {
+            PackageType::Alpine => "alpine".into(),
+            PackageType::Arch => "arch".into(),
+            PackageType::Cargo => "cargo".into(),
+            PackageType::Chef => "chef".into(),
+            PackageType::Composer => "composer".into(),
+            PackageType::Conan => "conan".into(),
+            PackageType::Conda => "conda".into(),
+            PackageType::Container => "container".into(),
+            PackageType::Cran => "cran".into(),
+            PackageType::Debian => "debian".into(),
+            PackageType::Generic => "generic".into(),
+            PackageType::Go => "go".into(),
+            PackageType::Helm => "helm".into(),
+            PackageType::Maven => "maven".into(),
+            PackageType::Npm => "npm".into(),
+            PackageType::Nuget => "nuget".into(),
+            PackageType::Pub => "pub".into(),
+            PackageType::PyPi => "pypi".into(),
+            PackageType::Rpm => "rpm".into(),
+            PackageType::RubyGems => "rubygems".into(),
+            PackageType::Swift => "swift".into(),
+            PackageType::Vagrant => "vagrant".into(),
+        }
+    }
+}

src/structs/release.rs

@@ -50,6 +50,7 @@ impl Release {
     }
 }
 
+// TODO: Rename to "User" to match Gitea's code
 #[derive(Debug, Deserialize, Serialize)]
 pub struct Author {
     id: usize,