Background

I am designing a CLI for a container build tool I am making. It uses Gentoo’s Portage behind the scenes

Question

I want to give the user the ability to specify a custom package repository. The repository must have a name, URI and sync type.

custom_repo: {
    uri: 'https://...',
    name: 'custom',
    sync_type: 'git',
}

How do I have the user represent this in the CLI? keep in mind, this is not the main input and is optional.

One way is to make this only provide-able via a config file using JSON or another structured data representation. But I want to see if theres a good way to do it in the CLI

What I am thinking of: command --custom-repo uri='https://...',name=custom,sync_type=git --custom-repo ... [main input]

Is this the best way of doing this?

8 points

Just pass in the name of a json file as a CLI input (or default the name and act on it if present or use it if indicated [e.g. /U == use json.config]).

permalink
report
reply
3 points

I will definitely make that an option, but I would still want it to be invokable via CLI only if the user chooses. It makes scripting easier sometimes.

permalink
report
parent
reply
2 points

perhaps also useful in this case to document the shortcut of

<(echo ‘{…}’)

since not many people know about it, and it makes your tool work with things specified entirely on the command line rather than temp files

alternatively —config-file and —config-json or similar

making and cleaning up temp files when writing scripts is just such a massive PITA

permalink
report
parent
reply
3 points

For something like that i’d take a parameter like this (repeated as necessary):

--custom-repo=<name>=<synctype>+<url>

for example:

--custom-repo=custom=git+https://github.com/matcha/custom

permalink
report
reply
2 points

Ask the user to customize a preset.json?

permalink
report
reply
1 point

That is certainly one solution and I plan to make that an option. But I’d still like to make the program invokable without having to write a file.

permalink
report
parent
reply
1 point

command --git-url https://... --alias myalias --svn-url http://... --alias mysvnalias

You may process it as a stack.

When reading within the program from stdin I recommend a state machine.

permalink
report
reply

Programming

!programming@programming.dev

Create post

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person’s post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you’re posting long videos try to add in some form of tldr for those who don’t want to watch videos

Wormhole

Follow the wormhole through a path of communities !webdev@programming.dev



Community stats

  • 1

    Monthly active users

  • 555

    Posts

  • 2.8K

    Comments