Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aivruu/repo-viewer

Utility for view GitHub repositories' information/releases, and download releases' assets.
https://github.com/aivruu/repo-viewer

downloader functional-programming github github-api gradle http-requests https java json library viewer

Last synced: 3 months ago
JSON representation

Utility for view GitHub repositories' information/releases, and download releases' assets.

Awesome Lists containing this project

README

        

# repo-viewer | [![Codacy Badge](https://app.codacy.com/project/badge/Grade/2af8dd31da77439ea518ee1df8d725be)](https://app.codacy.com/gh/aivruu/repo-viewer/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
[![](https://jitpack.io/v/aivruu/repo-viewer.svg)](https://jitpack.io/#aivruu/repo-viewer)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/aivruu/repo-viewer/build.yml)
![GitHub License](https://img.shields.io/github/license/aivruu/repo-viewer)
![GitHub commit activity](https://img.shields.io/github/commit-activity/t/aivruu/repo-viewer)

`repo-viewer` permits to get information about GitHub repositories, and any release published for these repositories, besides of allowing download these releases' adjunted assets, providing several functionalities with a decent code-quality and an understandable and very docummented structure.

> [!NOTE]\
> I started this project with the only propuse of testing HTTP utilities with Java. I taken as base [OcZi/release-watcher](https://github.com/OcZi/release-watcher) for the main idea of this project.

## Features
* View specified repository's information.
* View each repository's releases' information.
* Permits comparing between releases' defined tag-names.
* Easy to usage.
* Download assets from each repository release.

## Guides
* [Download assets from any repository releases.](https://github.com/aivruu/repo-viewer/blob/main/docs/download-assets-guide.md)
* [Make a request to an specified repository.](https://github.com/aivruu/repo-viewer/blob/main/docs/make-request-guide.md)
* [Compare a release's tag-name with another.](https://github.com/aivruu/repo-viewer/blob/main/docs/version-comparing-guide.md)

## Download
```kotlin
repositories {
maven("https://jitpack.io/")
}

dependencies {
// You can visualize the latest version on the document header.
implementation("com.github.aivruu:repo-viewer:VERSION")
}
```

## Building
This project require Gradle for building and management, and Java 21 as minimum.
```
git clone https://github.com/aivruu/repo-viewer.git
cd repo-viewer
./gradlew shadowJar
```