mirror of
https://github.com/donl/homebrew-cask-versions.git
synced 2026-07-17 06:16:47 -06:00
a335d3b06d
* "Canonical App Name" becomes "Simplified App Name"
* devscript `cask_namer` renamed to `generate_cask_token`
* doc file `CASK_NAMING_REFERENCE.md` renamed to `cask_token_reference.md`
* DSL uses `"#{token}"` for interpolation instead of `"#{title}"`
* documentation text
* backend code (variables, method, class names)
* error message text
* tests
* code comments
* Cask comments
* emphasize `tags :name`
* doc: use "vendor" consistently instead of "developer"
* doc: many man page argument descriptions were incorrect
* incidental clarifications
Many backend variables similar to `cask_name` or `cask` have
been standardized to `cask_token`, `token`, etc, resolving a long-
standing ambiguity in which variables named `cask` might contain
a Cask instance or a string token.
In many places the docs could be shortened from "Cask name" to
simply "token", which is desirable because we use the term "Cask"
in too many contexts.
50 lines
1.6 KiB
Ruby
50 lines
1.6 KiB
Ruby
module Cask::QualifiedToken
|
|
def self.repo_prefix
|
|
'homebrew-'
|
|
end
|
|
|
|
def self.user_regexp
|
|
# per https://github.com/Homebrew/homebrew/blob/4c7bc9ec3bca729c898ee347b6135ba692ee0274/Library/Homebrew/cmd/tap.rb#L121
|
|
%r{[a-z_\-]+}
|
|
end
|
|
|
|
def self.repo_regexp
|
|
# per https://github.com/Homebrew/homebrew/blob/4c7bc9ec3bca729c898ee347b6135ba692ee0274/Library/Homebrew/cmd/tap.rb#L121
|
|
%r{(?:#{repo_prefix})?\w+}
|
|
end
|
|
|
|
def self.token_regexp
|
|
# per https://github.com/caskroom/homebrew-cask/blob/master/CONTRIBUTING.md#generating-a-token-for-the-cask
|
|
%r{[a-z0-9\-]+}
|
|
end
|
|
|
|
def self.tap_regexp
|
|
%r{#{user_regexp}[/\-]#{repo_regexp}}
|
|
end
|
|
|
|
def self.qualified_token_regexp
|
|
@qualified_token_regexp ||= %r{#{tap_regexp}/#{token_regexp}}
|
|
end
|
|
|
|
def self.parse(arg)
|
|
return nil if ! arg.kind_of?(String)
|
|
return nil if ! arg.downcase.match(%r{^#{qualified_token_regexp}$})
|
|
path_elements = arg.downcase.split('/')
|
|
if path_elements.count == 2
|
|
# eg phinze-cask/google-chrome.
|
|
# Not certain this form is needed, but it was supported in the past.
|
|
token = path_elements[1]
|
|
dash_elements = path_elements[0].split('-')
|
|
repo = dash_elements.pop
|
|
dash_elements.pop if dash_elements.count > 1 and dash_elements[-1] + '-' == repo_prefix
|
|
user = dash_elements.join('-')
|
|
else
|
|
# eg caskroom/cask/google-chrome
|
|
# per https://github.com/Homebrew/homebrew/wiki/brew-tap
|
|
user, repo, token = path_elements
|
|
end
|
|
repo.sub!(%r{^#{repo_prefix}}, '')
|
|
odebug "[user, repo, token] might be [#{user}, #{repo}, #{token}]"
|
|
[user, repo, token]
|
|
end
|
|
end
|