cli rework

[jkowalleck]

current CLI works like nichtparasoup [options] subcommand [subcommand-options]
e.g.: nichtparasoup config --dump _tmp/np.yaml

the issue is, that most subcommand-options are actually sub-subcommands.
e.g. nichtparasoup config dump _tmp/np.yaml

goal:

• all options being real options, not (sub-)subcommands.
• options that trigger a sub-subcommand are such sub-commands

this will be a breaking change.
ut this should be no problem, since version 2.5.0 is going to bring breaking CLI changes, anyways.

[jkowalleck]

!! work in prograss !!

this is how the cli should look like:

• command: nichtparasoup
  • optional switch: --version display version and exit
  • subcommand: server
    • subcommand: run
      • optional argument: --config <config file>
        • default: use internal default config
        • completion: existing file .+\.ya?ml
      • optional switch: --debug enable debug output
        • default to false
      • optional switch: --develop enable web-developer-mode
        • default to false
    • subcommand: config
      • subcommand: check
        • argument: <config file>
          • completion: existing file .+\.ya?ml
        • optional switch: --debug enable debug output
          • default to false
        • optional switch: --[no-]probe disble crawler probes
          • default to false
        • optional argument: --probe-retries <retries>
          • default to 3 or a reasonable positive int
        • optional argument: --probe-delay <seconds>
          • default to 0.1 or a reasonable positie float
      • subcommand: dump-defaults
        • argument: <config file> target file
        • optional switch: --overwrite dont ask to overwrite
          • default to false
        • optional switch: --debug enable debug output
          • default to false
  • subcommand: imagecrawler
    • subcommand: list
      • optional switch: --debug enable debug output
        • default to false
    • subcommand: desc
      • argument: <crawler>
        • completion: available crawler names
      • optional switch: --debug enable debug output
        • default to false
    • subcommand: run --- just an idea -- see IDEA: crawlers are callable modules #221
      • optional switch: --debug enable debug output
        • default to false
      • optional argument: --delay <seconds>
        • default to 1 or a reasonable amount
      • optional switch: --auto-reset
        • default to false
      • subcommand: <crawler>
        • completion: available crawler names
        • arguments, options, etc ... are defnied by the imagecrawler
  • subcommand: completion
    • argument: <shell>
      • values: bash, fish, ...

[jkowalleck]

IDEAL:

• put actual commands under nichtparasoup.command.
  and each has its own aimeplementation of __main__ and brings an own arg parser
• the CLI is under nichtparasoup.cli and has the cli structured arg parser