gfas-cli
| Crates.io | gfas-cli |
| lib.rs | gfas-cli |
| version | |
| source | src |
| created_at | 2024-08-23 10:42:06.111901 |
| updated_at | 2024-12-09 00:48:00.38121 |
| description | Sync GitHub followings to followers |
| homepage | https://github.com/Resonaa/gfas |
| repository | https://github.com/Resonaa/gfas |
| max_upload_size | |
| id | 1349020 |
| Cargo.toml error: | TOML parse error at line 19, column 1 | 19 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include` |
| size | 0 |
(Resonaa)
documentation
README
gfas
gfas (GitHub Following Auto Synchronization) manipulates your GitHub following list to match your followers, enabling you to follow back and unfollow back automatically. It runs on CLI and can be scheduled with GitHub Actions.
Usage
GitHub Actions
- Copy-paste the Sync workflow to any of your repositories. You can just fork this repository for convenience.
- Create a
personal access token
with the
user:followpermission. - Create an
secret
named
TOKENin the repository containing the token value. - Customize your workflow, e.g. modify the scheduled time (defaults to every 6 hours).
- Maybe you want to trigger it manually to see the effect.
CLI
Archives of precompiled binaries for gfas are available for Windows, macOS and Linux. Linux and Windows binaries are static executables. Users of platforms not explicitly mentioned below are advised to download one of these archives.
If you're a Rust programmer, gfas can be installed with cargo.
Note that the minimum supported version of Rust for gfas is 1.77.0,
although gfas may work with older versions.
$ cargo install gfas
Alternatively, one can use cargo binstall to install a gfas
binary directly from GitHub:
$ cargo binstall gfas
After installation, run gfas --help for all commands and options.
API
The gfas-api crate exports some GitHub API bindings which can be used to build your application.
$ cargo add gfas-api
use gfas_api::GitHub;
let github = GitHub::new(String::from("<TOKEN>"))?;
github.explore("<USER-TO-EXPLORE>", true).await?;
Building
gfas is written in Rust, so you'll need to grab a Rust installation in order to compile it. gfas compiles with Rust 1.77.0 (stable) or newer. In general, gfas tracks the latest stable release of the Rust compiler.
To build gfas:
$ git clone https://github.com/Resonaa/gfas
$ cd gfas
$ cargo build --release
$ ./target/release/gfas --help
Running tests
gfas is relatively well-tested, including both unit tests and integration tests. To run the full test suite, use:
$ cargo test
from the repository root.
Contributing
See CONTRIBUTING.md.
License
This project is licensed under the Unlicense.