summaryrefslogtreecommitdiff
path: root/src/SMAPI.Web/Framework/ModRepositories/GitHubRepository.cs
blob: c62cb73fb275b001a414518f714b26819c60df04 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
using System;
using System.Threading.Tasks;
using StardewModdingAPI.Toolkit.Framework.UpdateData;
using StardewModdingAPI.Web.Framework.Clients.GitHub;

namespace StardewModdingAPI.Web.Framework.ModRepositories
{
    /// <summary>An HTTP client for fetching mod metadata from GitHub project releases.</summary>
    internal class GitHubRepository : RepositoryBase
    {
        /*********
        ** Fields
        *********/
        /// <summary>The underlying GitHub API client.</summary>
        private readonly IGitHubClient Client;


        /*********
        ** Public methods
        *********/
        /// <summary>Construct an instance.</summary>
        /// <param name="client">The underlying GitHub API client.</param>
        public GitHubRepository(IGitHubClient client)
            : base(ModRepositoryKey.GitHub)
        {
            this.Client = client;
        }

        /// <summary>Get metadata about a mod in the repository.</summary>
        /// <param name="id">The mod ID in this repository.</param>
        public override async Task<ModInfoModel> GetModInfoAsync(string id)
        {
            ModInfoModel result = new ModInfoModel().SetBasicInfo(id, $"https://github.com/{id}/releases");

            // validate ID format
            if (!id.Contains("/") || id.IndexOf("/", StringComparison.InvariantCultureIgnoreCase) != id.LastIndexOf("/", StringComparison.InvariantCultureIgnoreCase))
                return result.SetError(RemoteModStatus.DoesNotExist, $"The value '{id}' isn't a valid GitHub mod ID, must be a username and project name like 'Pathoschild/LookupAnything'.");

            // fetch info
            try
            {
                // fetch repo info
                GitRepo repository = await this.Client.GetRepositoryAsync(id);
                if (repository == null)
                    return result.SetError(RemoteModStatus.DoesNotExist, "Found no GitHub repository for this ID.");
                result
                    .SetBasicInfo(repository.FullName, $"{repository.WebUrl}/releases")
                    .SetLicense(url: repository.License?.Url, name: repository.License?.SpdxId ?? repository.License?.Name);

                // get latest release (whether preview or stable)
                GitRelease latest = await this.Client.GetLatestReleaseAsync(id, includePrerelease: true);
                if (latest == null)
                    return result.SetError(RemoteModStatus.DoesNotExist, "Found no GitHub release for this ID.");

                // split stable/prerelease if applicable
                GitRelease preview = null;
                if (latest.IsPrerelease)
                {
                    GitRelease release = await this.Client.GetLatestReleaseAsync(id, includePrerelease: false);
                    if (release != null)
                    {
                        preview = latest;
                        latest = release;
                    }
                }

                // return data
                return result.SetVersions(version: this.NormalizeVersion(latest.Tag), previewVersion: this.NormalizeVersion(preview?.Tag));
            }
            catch (Exception ex)
            {
                return result.SetError(RemoteModStatus.TemporaryError, ex.ToString());
            }
        }

        /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
        public override void Dispose()
        {
            this.Client.Dispose();
        }
    }
}