Wrap changelog query into class like GetChangelogBuildRequest.

[andy840119]

karaoke/osu.Game.Rulesets.Karaoke/Overlays/KaraokeChangelogOverlay.cs

Lines 191 to 249 in 21e84f6

	return initialFetchTask = Task.Run(async () =>
	{
	var tcs = new TaskCompletionSource<bool>();
	var client = new GitHubClient(new ProductHeaderValue(organizationName));
	try
	{
	var reposAscending = await client.Repository.Content.GetAllContentsByRef(organizationName, projectName, "content/changelog", branchName).ConfigureAwait(false);
	if (reposAscending.Any())
	{
	builds.Clear();
	builds.AddRange(reposAscending.Reverse().Where(x => x.Type == ContentType.Dir).Select(x => new APIChangelogBuild(organizationName, projectName, branchName)
	{
	RootUrl = x.HtmlUrl,
	Path = x.Path,
	DisplayVersion = x.Name,
	PublishedAt = getPublishDateFromName(x.Name),
	}));
	foreach (var build in builds)
	{
	build.Versions.Previous = builds.GetPrevious(build);
	build.Versions.Next = builds.GetNext(build);
	}
	tcs.SetResult(true);
	}
	else
	{
	tcs.SetResult(false);
	}
	}
	catch (RateLimitExceededException)
	{
	// todo: maybe show something?
	}
	catch (Exception)
	{
	// todo: maybe show something?
	}
	await tcs.Task.ConfigureAwait(false);
	});
	static DateTimeOffset getPublishDateFromName(string name)
	{
	var regex = new Regex("(?<year>[-0-9]+).(?<month>[-0-9]{2})(?<day>[-0-9]{2})");
	var result = regex.Match(name);
	if (!result.Success)
	return DateTimeOffset.MaxValue;
	int year = result.GetGroupValue<int>("year");
	int month = result.GetGroupValue<int>("month");
	int day = result.GetGroupValue<int>("day");
	return new DateTimeOffset(new DateTime(year, month, day));
	}

Like in here, we did the logic for get the list of changelog build, paste the data and made some calculations
Maybe should make something like GetChangelogBuildRequest(might not just inherit the APIRequest because api is query from github, not osu!)

[andy840119]

Also, note that those classes in osu.game:

• APIChangelogIndex : has list of channel and changelog metadata.
• APIChangelogBuild : it's just a single changelog.
• APINewsSidebar : it's an apo for able to get the list of post metadata and years.
• APIWikiPage : has the full content in the wiki page (include markdown text).
• WikiMainPage: 裡面有一些科技與狠活，會把 https://osu.ppy.sh/api/v2/wiki/en/Main_Page 上面的文字複製下來後，用 html 解析後排本。

And note that APIChangelogBuild in the APIChangelogIndex might not have content, or just little bit of content(for preview purpose).

Maybe should create similar info like:

• APIChangelogSidebar or APIChangelogIndex : should be able to get list of change logs and years.
• APIChangelogInfo: only contains the metadata (e.g. build version, display text, link)
• APIChangelogBuild: contains the markdown content, previous build and next build(maybe with type APIChangelogInfo).

[andy840119]

Also, not very sure will github provide the api that can get small content from the list of files:

• https://docs.github.com/ja/rest/repos/contents?apiVersion=2022-11-28

But seems content property only exist only if select single of file:

gh api /repos/karaoke-dev/karaoke-dev.github.io/contents/content/changelog/2023.1212/index.md

will return:

{
  "name": "index.md",
  "path": "content/changelog/2023.1212/index.md",
  "sha": "791137b5ec2afcb43fb370de70a94be034207edc",
  "size": 362,
  "url": "https://api.github.com/repos/karaoke-dev/karaoke-dev.github.io/contents/content/changelog/2023.1212/index.md?ref=master",
  "html_url": "https://github.com/karaoke-dev/karaoke-dev.github.io/blob/master/content/changelog/2023.1212/index.md",
  "git_url": "https://api.github.com/repos/karaoke-dev/karaoke-dev.github.io/git/blobs/791137b5ec2afcb43fb370de70a94be034207edc",
  "download_url": "https://raw.githubusercontent.com/karaoke-dev/karaoke-dev.github.io/master/content/changelog/2023.1212/index.md",
  "type": "file",
  "content": "LS0tCnRpdGxlOiAiMjAyMy4xMjEyIgpkYXRlOiAyMDIzLTEyLTEyCi0tLQoK\nIyMgQWNoaWV2ZW1lbnQKCi0gVXNlIGNsb3VkZmxhcmUgYXMgQ0ROIGZvciB0\naGlzIGRvbWFpbi4gTmV4dCBzdGVwIGlzIHdhaXRpbmcgZm9yIGNsb3VkZmxh\ncmUgdG8gYWNjZXB0IHRoZSBkb21haW4uCi0gU3RpbGwgYnVzeWluZyBvbiBt\neSBqb2IgO1xfOwotIFdhaXRpbmcgZm9yIG15IHZhY2F0aW9uIHRyaXAuCi0g\nTlVuaXQgdXBncmFkZSB0byA0LjAgYW5kIGhhdmUgbG90cyBvZiBicmVha2lu\nZyBjaGFuZ2UgO1xfOwoKIyMgQ29kZSBxdWFsaXR5CgotIFVwZGF0ZSBwYWNr\nYWdlIHRvIHRoZSBsYXRlc3QuIFtrYXJhb2tlXSgjMjE1MkBhbmR5ODQwMTE5\nKQo=\n",
  "encoding": "base64",
  "_links": {
    "self": "https://api.github.com/repos/karaoke-dev/karaoke-dev.github.io/contents/content/changelog/2023.1212/index.md?ref=master",
    "git": "https://api.github.com/repos/karaoke-dev/karaoke-dev.github.io/git/blobs/791137b5ec2afcb43fb370de70a94be034207edc",
    "html": "https://github.com/karaoke-dev/karaoke-dev.github.io/blob/master/content/changelog/2023.1212/index.md"
  }
}

otherwise:

gh api /repos/karaoke-dev/karaoke-dev.github.io/contents/content/changelog/2023.1212

it will return:

[
  {
    "name": "index.md",
    "path": "content/changelog/2023.1212/index.md",
    "sha": "791137b5ec2afcb43fb370de70a94be034207edc",
    "size": 362,
    "url": "https://api.github.com/repos/karaoke-dev/karaoke-dev.github.io/contents/content/changelog/2023.1212/index.md?ref=master",
    "html_url": "https://github.com/karaoke-dev/karaoke-dev.github.io/blob/master/content/changelog/2023.1212/index.md",
    "git_url": "https://api.github.com/repos/karaoke-dev/karaoke-dev.github.io/git/blobs/791137b5ec2afcb43fb370de70a94be034207edc",
    "download_url": "https://raw.githubusercontent.com/karaoke-dev/karaoke-dev.github.io/master/content/changelog/2023.1212/index.md",
    "type": "file",
    "_links": {
      "self": "https://api.github.com/repos/karaoke-dev/karaoke-dev.github.io/contents/content/changelog/2023.1212/index.md?ref=master",
      "git": "https://api.github.com/repos/karaoke-dev/karaoke-dev.github.io/git/blobs/791137b5ec2afcb43fb370de70a94be034207edc",
      "html": "https://github.com/karaoke-dev/karaoke-dev.github.io/blob/master/content/changelog/2023.1212/index.md"
    }
  }
]

[andy840119]

Implemented.