| from enum import Enum |
| |
| # Used for the --wrap-mode command-line argument |
| # |
| # Special wrap modes: |
| # nofallback: Don't download wraps for dependency() fallbacks |
| # nodownload: Don't download wraps for all subproject() calls |
| # |
| # subprojects are used for two purposes: |
| # 1. To download and build dependencies by using .wrap |
| # files if they are not provided by the system. This is |
| # usually expressed via dependency(..., fallback: ...). |
| # 2. To download and build 'copylibs' which are meant to be |
| # used by copying into your project. This is always done |
| # with an explicit subproject() call. |
| # |
| # --wrap-mode=nofallback will never do (1) |
| # --wrap-mode=nodownload will do neither (1) nor (2) |
| # |
| # If you are building from a release tarball, you should be |
| # able to safely use 'nodownload' since upstream is |
| # expected to ship all required sources with the tarball. |
| # |
| # If you are building from a git repository, you will want |
| # to use 'nofallback' so that any 'copylib' wraps will be |
| # download as subprojects. |
| # |
| # Note that these options do not affect subprojects that |
| # are git submodules since those are only usable in git |
| # repositories, and you almost always want to download them. |
| WrapMode = Enum('WrapMode', 'default nofallback nodownload') |