「複数のファイル(および文字列)を、個別の形式を指定しつつ読み取る」ようなインターフェースを持つコマンドとして、例に挙げられているcurlや、ffmpeg/ffplay、ImageMagickなどがよく知られているように思います。
もちろん、これらのコマンドでの、複数形式の文字列・ファイルの同時指定の方法が最良のインターフェースであるとは限りませんが、とりあえずはこれらのオプション体系を参考にするのが、もっとも無難なやり方だと思われます。
curlでは、-dまたは--dataというオプションの引数について、その先頭が@である場合に、続く文字列をファイル名だとして処理します。ただしこのような実装の場合、「先頭に@があるが、文字列として扱う」ことを実現するために、適宜対応しなくてはなりません。curlでは、--data-rawというオプションを用意し、--data-rawオプションの引数は常に文字列とみなす、という仕様にすることでこの状況に対応しています。
データの形式は、--data-ascii、--data-binaryといったオプションを用いて明示できます。これらのオプションについても、「先頭に@があれば続く文字列をファイル名とみなす」という仕様が定められています。
curlのオプション体系に素直に従うなら、
$ cli --data-json string --data-json @file --data-json-raw @string
# string, @stringはそのままJSON文字列として読み取り、
# @fileはfileというファイル名のJSONファイルとして読み取る。
$ cli \
--data-json '{"foo":1}' --data-user 'alice bob' \
--data-json @foo.txt --data-user @user.txt
# 混合した例
のような仕様にするのがよいでしょう。
参考:
https://curl.se/docs/manpage.html#-d
ffmpegでは、文字列とファイルをそれぞれ違うオプションで指定するのが基本です。たとえばメタデータ(作曲者やチャプターなどの情報)を指定する場合、メタデータを文字列で入力する際には--metadataというオプションの引数として指定し、ファイルで入力する際には-f ffmetadata -i file
というように、「入力するファイルの形式」と「入力するファイルの名前」を二つのオプションで指定します。
ffmepgのオプション体系に素直に従うなら、
$ cli --json string [-f|--format] json [-i|--input] file
# stringはそのままJSON文字列として読み取り、
# @fileはfileというファイル名のJSONファイルとして読み取る。
$ cli \
--json '{"foo":1}' --user 'alice bob' \
-f json -i foo.txt -f user -i user.txt
# 混合した例
のような仕様にするのがよいでしょう。
参考:
http://ffmpeg.org/ffmpeg.html#Main-options
http://ffmpeg.org/ffmpeg-formats.html#Metadata-1
ImageMagickでは、複数の入力をオプション引数ではなく非演算子として受け取り、それらの先頭に指定されている固有の書式に基づいて処理が行われます。
例えば「標準入力のgif形式とファイル記述子3のPNG形式」という入力なら、gif:- png:fd:3
というように指定します。
ImageMagickのオプション体系に素直に従うなら、
$ cli json:str:string json:file
# json:str:stringはstringというJSON文字列として読み取り、
# json:fileはfileというファイル名のJSONファイルとして読み取る。
$ cli \
json:str:'{"foo":1}' user:str:'alice bob' \
json:foo.txt user:user.txt
# 混合した例
のような仕様にするのがよいでしょう。
参考:
https://imagemagick.org/script/command-line-processing.php#input
ところで、質問で例示なさっているコマンドラインにおいて、空白を含むテキスト形式の文字列を、引用符や逆斜線などで空白をエスケープすることなくオプション引数に指定してありますが、一つのオプションに対して複数個のオプション引数を用意するのはあまり適切とは言えません。
Unix系OSの最低限の共通インターフェースを定めているPOSIXでも、そのような仕様のオプション体系は禁止されています。なお、LinuxはUnixではありませんが、POSIXへの準拠と互換性向上を開発の一目的に据えているので、従っておくべきだと思います。
$ cli --user alice bob
# ではなく
$ cli --user 'alice bob'
参考
https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap12.html#tag_12_02
【追記】
いただいたコメントをうけて追記します。
補足に書きましたが、pythonのargparseモジュールを使ってCLIを作る予定でした。 argparseを使うと、1つのオプションに複数の値を指定できます。 POSIXに準拠するつもりはなかったです。
- POSIXへの準拠について
質問に「Linux」というタグをつけられていることから,このプログラムはLinux上の端末で動かすものだと想定しました。
また,「プログラムのCLI設計について質問する」ということは,ある程度の利用性を持たせたいと思ってらっしゃるのではないですか。どのような場面で用いるプログラムかは分かりませんが,たとえば「同僚に使わせる」程度の利用性は確保したいのではないですか。
そのような場面では,できるだけ現地の慣習に従うことで,無用な混乱を避けられるでしょう。
また,「Pythonのargparseライブラリは基本的にPOSIXでの慣習に倣う」というargparseライブラリ開発者(paul.j3氏)の意見もあります。もちろん,これは一つの意見にすぎず,argparse開発陣の総意はまったく異なるものである可能性は多いにあります。しかしながら,オプション前置子の既定が-であることなどを鑑みると,argparseを用いる際にPOSIXへの準拠を考える,という指針はそれほど極端なものではないと言えるのではないでしょうか。
- Pythonのargparseライブラリを使うことを前提した回答
argparseライブラリのArgumentParser構築子にはfromfile_prefix_charsという属性があるようですね(私事ですが,この回答を書いていて知りました)。
参考
https://docs.python.org/3/library/argparse.html#fromfile-prefix-chars
おそらくですが,これを用いて「オプション引数の文字列をファイル名とみなして処理する」挙動を実装しようと考えてらしたのではないですか。
fromfile_prefix_chars属性の解説には,例として「先頭に@がある場合にファイル名としてみなす」という,curlの仕様とそっくりなコード例が載っています。
そういう理由からも,curl風のオプション体系を採用するのがいいですね。