Crate git_bot_feedback

Source
Expand description

§Git-bot-feedback

rust-ci-badge docs-rs-badge codecov-badge crates-io-badge

A rust library designed for CI tools to easily submit feedback on a git server.

Feedback on a git server using this library can be in the form of

  • thread comments (for a PR or commit)
  • setting output variables for other CI tools to consume
  • append a summary comment to a CI workflow run’s summary page
  • mark the start and end of a group of log statements (in the CI workflow run’s logs)

More features are planned, like PR reviews and file annotations.

§Supported git servers

Initially this project os designed to work with GitHub. But the API is designed to easily add support for other git servers. The following is just a list of git servers that are planned (in order or priority).

  • GitHub
  • GitLab
  • Gitea
  • BitBucket

§GPL license

This project is licensed under GPL-3.0-or-later.

Since this library ultimately requires write access to users’ projects (to allow posting comments), it could easily be modified with malicious intent.

By using the GPL-3.0-or-later license, we can offer some assurance and help safeguard end-users’ data/privacy because the following conditions must be met:

  • the source code is publicly available
  • any redistributed forms must state their modifications (if any)
  • any redistributed forms must use the same GPL-3.0-or-later license

Re-exports§

pub use client::RestApiClient;
pub use client::RestApiRateLimitHeaders;
pub use error::RestClientError;

Modules§

client
A module to contain traits and structs that are needed by the rest of the git-bot-feedback crate’s API.
error

Structs§

OutputVariable
A type to represent an output variable.
ThreadCommentOptions

Enums§

CommentKind
An enumeration of possible type of comments being posted.
CommentPolicy
An enumeration of possible values that control [FeedBackOptions::thread_comments].