Running brew create --cask <new-cask-token> results in Error

[cesarcoatl]

Hello.

I am attempting to add a new Cask under homebrew-cask-versions following the Adding a Cask guide, but when I run the brew create --cask command I get the following:

$ brew create --cask my-new-cask
...
Error: Invalid usage: The `--set-name` flag is required for creating casks.

After a couple of attempts, the only command that worked was:

$ brew create --cask my-new-cask --set-name my-new-cask

This last command did open my $EDITOR and allowed me to save my new cask into "$(brew --repository)"/Library/Taps/homebrew/homebrew-cask/Casks.

Just sharing this in case the documentation needs to be modified or the command behavior.

Thanks.

[hyuraku]

Thanks a lot @thecesrom
I opened PR Homebrew/homebrew-cask#95740 to fix this

[cesarcoatl]

As I mentioned, I was not sure if the documentation needed to be updated or the command behavior.

But now that I've read @SMillerDev's comments and having tried that, I have a few questions.

For the sake of clarity and consistency, specially with the Basic Instructions from the Formula Cookbook, wouldn't it be better to have the following?

The brew create URL --cask Command

Once you know the token, create your Cask with the handy-dandy brew create --cask command:

$ brew create URL --cask --set-name my-new-cask

This will open $EDITOR with a template for your new Cask, to be stored in the file my-new-cask.rb. Running the create command above will get you a template that looks like this:

cask "my-new-cask" do
  version ""
  sha256 ""

  url "URL"
  name ""
  desc ""
  homepage ""

  app ""
end

Additionally, I see another possible change, and that is to the help output by the brew create --help command. Since the URL is required, and the options, well, optional.

Change this:

$ brew create --help
Usage: brew create [options] URL
...

For this:

$ brew create --help
Usage: brew create URL [options]
...

[gromgit]

By convention, Unix commands take --prefixed options immediately after the command name and before command arguments, exactly as it stands right now, so I don't see your suggestion being adopted any time soon.

[cesarcoatl]

Understood. Thanks.