GithubDataNet 0.3.2

dotnet add package GithubDataNet --version 0.3.2                
NuGet\Install-Package GithubDataNet -Version 0.3.2                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="GithubDataNet" Version="0.3.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add GithubDataNet --version 0.3.2                
#r "nuget: GithubDataNet, 0.3.2"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install GithubDataNet as a Cake Addin
#addin nuget:?package=GithubDataNet&version=0.3.2

// Install GithubDataNet as a Cake Tool
#tool nuget:?package=GithubDataNet&version=0.3.2                

GithubNet

Introduction

Github(Data)Net is a simple C# library, using HtmlAgilityPack to retrieve several things from GitHub, things like trending repositories, profiles of users, the repositories of users and related information.

Features ⭐

  • Trending Repositories: Retrieve trending repositories.
  • Repository Details: Obtain detailed information about repositories.
  • User Profiles: Access full and light GitHub user profiles.
  • User Repositories: Retrieve repositories associated with a GitHub user.
  • Topic URL: Obtain the GitHub URL for a specific topic.

Usage 🔧

General

The GithubNetClient needs to be used to access all functionalities:

GithubNetClient client = new();
IEnumerable<TrendRepository> GetAllTrendingRepositories(string customQuery = "https://github.com/trending");
IEnumerable<string> GetUrlsOfTrendingRepositories(string customQuery = "https://github.com/trending");
IEnumerable<FullRepository> GetFullTrendingRepositories(string customQuery = "https://github.com/trending");

User Profiles

FullUserprofile GetFullUserprofile(string Username);
LightUserprofile GetLightUserprofile(string Username);

Full Repositories

IEnumerable<FullRepository> GetFullRepositories(string Username);
FullRepository GetFullRepository(string RepositoryUrl);

LightUserprofile, UserRepositories and TopValues of User

(LightUserprofile Userprofile, IEnumerable<UserRepository> UserRepositories, TopValues topValues) GetLightUserprofileWithRepositories(string Username);

Utils

string GetTopicUrlFromTopicName(string topicName);

Types 🔖

  • FullUserprofile: Represents a comprehensive user profile with additional information such as last year's contributions count and whether the user has a special readme enabled. This type is based on LightUserprofile.

  • LightUserprofile: Represents a lightweight user profile with essential information like username, name, description, etc.

  • UserRepository: Represents a user's repository with additional details like whether it's a fork, license text, and last update information. This type is based on RepositoryBase.

  • TrendRepository: Represents a trending repository with information about stars received today, main language, total stars, total forks, etc. This type is based on RepositoryBase.

  • RepositoryBase: Base class for repositories, containing shared information like main language, total stars, total forks, username, repository name, and description.

  • FullRepository: Represents a comprehensive repository with additional details such as project URL, open issues count, open pull requests count, total commits count, etc. This type is based on RepositoryBase.

  • TopValues: Contains top values such as the top language, total stars count, and total forks count across user repositories.

Example ✍🏻

For a demonstration of the library's functionality, refer to the included GithubNetDemo project.

To-Do

  • Crawl every repository from a user, currently only the first page is crawled so these are not all repositories of a user.

License 📜

GithubNet is licensed under the GNU General Public License v3.0.

You can read the full license details of the GNU General Public License v3.0 here.

Disclaimer ⚠️

Please read the full disclaimer in the DISCLAIMER.md file before using this project. The author (liebki) of the project and the project itself are not endorsed by Microsoft and do not reflect the views or opinions of Microsoft or any individuals officially involved with the project. The author of this library is not responsible for any incorrect or inappropriate usage. Please ensure that you use this library in accordance with its intended purpose and guidelines.

Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.3.2 223 12/3/2023
0.3.1 94 12/2/2023
0.3.0 102 11/26/2023
0.2.0 132 6/19/2023
0.1.0 127 5/13/2023

New GetReadmeAuto() method, fixed the username in the GetFullRepository() method and changed the standard GetReadMeUrl() method..