[commands] New conan require

[franramirez688]

Changelog: Feature: Add conan require command to add/remove requirements to/from your local conanfile.
Docs: conan-io/docs#4354

$ conan require add -h
usage: conan dep add [-h] [--out-file OUT_FILE] [-v [{quiet,error,warning,notice,status,verbose,debug,v,trace,vv}]] [-cc CORE_CONF] [-req REQUIRES] [-tor TOOL_REQUIRES] [-ter TEST_REQUIRES] [-r REMOTE | -nr] [path]

Add a new requirement to your local conanfile as a version range. By default, it will look for the requirement versions remotely.

positional arguments:
  path                  Path to a folder containing a recipe (conanfile.py). Defaults to the current directory

options:
  -h, --help            show this help message and exit
  --out-file OUT_FILE   Write the output of the command to the specified file instead of stdout.
  -v [{quiet,error,warning,notice,status,verbose,debug,v,trace,vv}]
                        Level of detail of the output. Valid options from less verbose to more verbose: -vquiet, -verror, -vwarning, -vnotice, -vstatus, -v or -vverbose, -vv or -vdebug, -vvv or -vtrace
  -cc, --core-conf CORE_CONF
                        Define core configuration, overwriting global.conf values. E.g.: -cc core:non_interactive=True
  -req, --requires REQUIRES
                        Requirement name.
  -tor, --tool-requires TOOL_REQUIRES
                        Tool requirement name.
  -ter, --test-requires TEST_REQUIRES
                        Test requirement name.
  -r, --remote REMOTE   Remote names. Accepts wildcards ('*' means all the remotes available)
  -nr, --no-remote      Do not use remote, resolve exclusively in the cache

$ conan require remove -h
usage: conan dep remove [-h] [--out-file OUT_FILE] [-v [{quiet,error,warning,notice,status,verbose,debug,v,trace,vv}]] [-cc CORE_CONF] [-req REQUIRES] [-tor TOOL_REQUIRES] [-ter TEST_REQUIRES] [path]

Removes a requirement from your local conanfile.

positional arguments:
  path                  Path to a folder containing a recipe (conanfile.py). Defaults to the current directory

options:
  -h, --help            show this help message and exit
  --out-file OUT_FILE   Write the output of the command to the specified file instead of stdout.
  -v [{quiet,error,warning,notice,status,verbose,debug,v,trace,vv}]
                        Level of detail of the output. Valid options from less verbose to more verbose: -vquiet, -verror, -vwarning, -vnotice, -vstatus, -v or -vverbose, -vv or -vdebug, -vvv or -vtrace
  -cc, --core-conf CORE_CONF
                        Define core configuration, overwriting global.conf values. E.g.: -cc core:non_interactive=True
  -req, --requires REQUIRES
                        Requirement name.
  -tor, --tool-requires TOOL_REQUIRES
                        Tool requirement name.
  -ter, --test-requires TEST_REQUIRES
                        Test requirement name.

[franramirez688]

Pending issues/discussions:

• conan init: Jinja form? Allow more parameters as requirements?
• conan dep:
  • Only works with .py, but should it work with .txt too?
  • No API created for now.
  • Command name is fine?

[memsharded]

conan init: Jinja form? Allow more parameters as requirements?

This will be a given if using conan new existing command instead with a template just with the conanfile.py.

Only works with .py, but should it work with .txt too?

No, better only .py

[memsharded]

Looking good

[franramirez688]

@czoido @memsharded I'll open another PR with the full conan new changes. I did not want to make any further changes to this one.

[memsharded]

Look good to me.

Maybe my only issue is that conan dep as a command still doesn't fully click. It is a bit different to other commands that are more verb-like conan create/install/export/inspect/list..., the closest one would be conan editable add/remove and conan remote add/remove.

I can't think of a better name though, so all good for me.