Migrate `getCurrentCommittish` and `GitHubURL` here? about github-url-detection

[fregante]

Link: https://github.com/refined-github/refined-github/blob/3547c9bc0e60443dafe06752bc94e9e5b73f8d55/source/github-helpers/index.ts#L37

Things I'm not excited about:

• how transient and imperfect each of those API is
• documenting them and releasing breaking versions more often than this module requires
• external contributions (or lack thereof)
• the slowing of RG’s development due to having them externally and having to consider third parties
• having to also extract every internal function that those helpers use, further slowing RG’s development

I wouldn't be totally opposed to publishing a "gh extensions utils" package but I'd probably suggest using npm install refined-github/refined-github in order to access those files directly instead.

[fregante]

I'll add, even if we go to the trouble of doing all of that, it doesn't mean it actually helps that many people. See how many repos use this very simple, very old package:

https://github.com/refined-github/github-url-detection/network/dependents

Here's the total of 2 non-fork non-ghosttown extensions that use it:

• https://github.com/ineo6/git-master/search?q=github-url-detection
• https://github.com/hypertrons/hypertrons-crx/search?q=github-url-detection

I'd argue we didn't even need to extract github-url-detection. 😃 The only reason it's still great to have is that it makes it easier to test it and work on it.

[yakov116]

I think we can extract it to be its own module, I like how simple this one is no need to complicated it.

@refined-github/maintainers thoughts?

[kidonng]

To be fair, I think most github-helpers are useful on their own¹, like get-user-avatar. But let's not overcomplicate things 😅 this issue only considers branch name related stuff.

Footnotes

1. maybe one day I extract them to modules myself, that's MIT for you ↩

[yakov116]

The only reason it's still great to have is that it makes it easier to test it and work on it.

Exactly why we extracted, the tests took too much time.

[kidonng]

@fregante Really good points. I agree it's too much hassle for those simple helpers, I brought up about this one because I think it's an exception:

• There are projects that could benefit from it
• It (mostly) fits in this package
• More people using it, more/faster bugs are found

[yakov116]

maybe one day I extract them to modules myself, that's MIT for you ↩

Well be glad to host them. That's refined-github for you 🤪

[fregante]

PR welcome to add those two:

• utils/github-url.ts
• utils/get-current-committish.ts