Feature/min conan version

[memsharded]

Changelog: Feature: Implement required_conan_version in conanfile.py, will raise if the current Conan version does not match the defined version range.
Docs: conan-io/docs#1788

Proposal for discussing #7138

[jgsogo]

Nor really requesting changes, but I would like to wait for feedback on #7138 (comment). Those are my concerns about this feature.

[memsharded]

This PR proposes the simple syntax:

from conans import ConanFile

min_conan_version = "1.26"

class Lib(ConanFile):
    pass

Max version is not possible, min_conan_version is an exact version, not a range. This is a bit different to the https://docs.conan.io/en/latest/reference/config_files/conan.conf.html required_conan_version. Maybe it should match both the name and the behavior to be able to define a range? Wdyt?

[danimtb]

As discussed earlier today, let's converge this to the same name and version range used in conan.conf

[czoido]

Maybe the name of conans/test/functional/conanfile/min_version_test.py and MinVersionTest should be changed to conans/test/functional/conanfile/required_version_test.py and RequiredConanVersionTest ?

[memsharded]

Maybe the name of conans/test/functional/conanfile/min_version_test.py and MinVersionTest should be changed to conans/test/functional/conanfile/required_version_test.py and RequiredConanVersionTest ?

Agree, names changed

[danimtb]

Suggested change

	raise ConanException("The current Conan version ({}) does not match to the required"
	raise ConanException("The current Conan version ({}) does not match the recipe required"

[danimtb]

I see this message is used to raise from Conan required version from config as well as from recipe, but would like a more clear message about it

[memsharded]

Cannot be changed, because it is common.

[memsharded]

I have improved the message grammar, and added a capture of the error, so when you are reading a conanfile of a dependency it will throw and print:

pkg/version@user/channel: ERROR: Cannot load recipe
The conanfile at path .... version not satisfied message

[prince-chrismc]

This feature will make my life so much better... I didn't even know I needed this

[memsharded]

This feature will make my life so much better... I didn't even know I needed this

Happy to know it. Available now in Conan 1.28 just released. Remember that you also have the conan.conf variable, so you can define the required conan version also for all packages, and manage it with conan config install, so you can force your team to upgrade whenever you want.

[prince-chrismc]

so you can force your team to upgrade whenever you want.

😈 muhahaha, that's exactly my plan!