github-starred/cargo-aur
2
0
Fork 0
mirror of https://github.com/fosskers/cargo-aur.git synced 2026-03-09 07:13:12 -05:00
Code Issues 6 Packages Projects Releases 15 Wiki Activity

Make "homepage" optional in Cargo.toml #9

New Issue
Closed
opened 2026-03-01 09:10:56 -06:00 by GiteaMirror · 1 comment
GiteaMirror commented 2026-03-01 09:10:56 -06:00
Owner
Copy Link

Originally created by @bunburya on GitHub (Feb 24, 2024).

This tool appears to fail if the homepage field is not specified in Cargo.toml. C-METADATA, which is linked in the README, states that homepage is optional and further states:

The homepage metadata should only be set if there is a unique website for the crate other than the source repository or API documentation. Do not make homepage redundant with either the documentation or repository values. For example, serde sets homepage to https://serde.rs, a dedicated website.

Given that a lot of crates these days will just have a repository URL and not a separate homepage, I think it would be good to make homepage optional in cargo-aur (following the approach in C-METADATA). The url field in the PKGBUILD could be set to homepage or, if that is not present, documentation or, if that is not present, repository (the last being a required field per C-METADATA).

Happy to work on a PR for this if helpful.

Originally created by @bunburya on GitHub (Feb 24, 2024). This tool appears to fail if the `homepage` field is not specified in `Cargo.toml`. [C-METADATA](https://rust-lang.github.io/api-guidelines/documentation.html#c-metadata), which is linked in the README, states that `homepage` is optional and further states: > The homepage metadata should only be set if there is a unique website for the crate other than the source repository or API documentation. Do not make `homepage` redundant with either the `documentation` or `repository` values. For example, serde sets homepage to https://serde.rs, a dedicated website. Given that a lot of crates these days will just have a repository URL and not a separate homepage, I think it would be good to make `homepage` optional in `cargo-aur` (following the approach in C-METADATA). The `url` field in the PKGBUILD could be set to `homepage` or, if that is not present, `documentation` or, if that is not present, `repository` (the last being a required field per C-METADATA). Happy to work on a PR for this if helpful.
GiteaMirror commented 2026-03-01 09:10:58 -06:00
Author
Owner
Copy Link

@fosskers commented on GitHub (Feb 24, 2024):

Great suggestion. Want to give it a shot?

@fosskers commented on GitHub (Feb 24, 2024): Great suggestion. Want to give it a shot?
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
pull-request
Mirrored from GitHub Pull Request
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/cargo-aur#9
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?