rely 0.1.2

Rely is a tool for vetting dependencies on GitHub.

Rely

Rely is a tool for vetting GitHub dependencies.

[!NOTE]

Rely is in active development and certain features may be incomplete.

We need to know if we can rely on packages before we add them as dependencies in our own projects. Rely scores GitHub repositories based on a number of metrics, including time since last commit, star count, open issues, documentation, and more. Rely is partially inspired by a discussion of the metrics that are used to evaluate open source projects on Hacker News.

$ uv run rely https://github.com/fastapi/fastapi
           Rely score for https://github.com/fastapi/fastapi
┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃                Metric ┃ Value ┃ Raw score ┃ Weight ┃ Weighted score ┃
┡━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ Last commit (in days) │ 3     │ 3/3       │ 1.0    │            3.0 │
│       Number of stars │ 91186 │ 3/3       │ 0.65   │           1.95 │
│       Number of forks │ 8122  │ 3/3       │ 0.5    │            1.5 │
│    Number of watchers │ 91186 │ 3/3       │ 0.5    │            1.5 │
│ Number of open issues │ 199   │ 3/3       │ 0.85   │           2.55 │
│             Archived? │ False │ 3/3       │ 1.0    │            3.0 │
│             Disabled? │ False │ 3/3       │ 1.0    │            3.0 │
│          Has license? │ True  │ 3/3       │ 0.5    │            1.5 │
│      Has description? │ True  │ 3/3       │ 0.25   │           0.75 │
│           Has README? │ True  │ 3/3       │ 1.0    │            3.0 │
└───────────────────────┴───────┴───────────┴────────┴────────────────┘
Overall score is 100%

Installation

1. Create a GitHub personal access token (guide)

2. Set the GITHUB_PERSONAL_ACCESS_TOKEN environment variable (token from step 1):

   export GITHUB_PERSONAL_ACCESS_TOKEN=...
   

3. Install and run rely with uv:

   uv add rely
   uv run rely https://github.com/1cph93/rely
   

   Or just run it as a tool:

   uv tool run rely https://github.com/1cph93/rely
   

Roadmap

• Improve test coverage
• Add security-related metrics

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE.txt for more information.