derivepassphrase.git

@@ -639,8 +639,8 @@ def commented(comments: str = "", /) -> TranslatableStringConstructor:

 class Label(enum.Enum):

     """Labels for the `derivepassphrase` command-line.

-    Includes help text (long-form and short-form), help metavar names,

-    diagnostic labels and interactive prompts.

+    Includes help text (long-form and short-form), diagnostic labels and

+    interactive prompts.

     """

@@ -762,6 +762,27 @@ class Label(enum.Enum):

         flags="python-brace-format",

     )

     """"""

+    REDUCED_DERIVEPASSPHRASE_EXPORT_VAULT_02 = commented(

+        "",

+    )(

+        "Label :: Help text :: Explanation",

+        "Depending on the configuration format, "

+        "PATH may either be a file or a directory.  "

+        'We support the vault "v0.2", "v0.3" and "storeroom" formats.',

+    )

+    """"""

+    REDUCED_DERIVEPASSPHRASE_EXPORT_VAULT_03 = commented(

+        "Same PATH metavar as "

+        "Label.DERIVEPASSPHRASE_EXPORT_VAULT_02.",

+    )(

+        "Label :: Help text :: Explanation",

+        "If PATH is explicitly given as `VAULT_PATH`, "

+        "then use the `VAULT_PATH` environment variable to "

+        "determine the correct path.  "

+        "(Use `./VAULT_PATH` or similar to indicate a file/directory "

+        "actually named `VAULT_PATH`.)",

+    )

+    """"""

     DERIVEPASSPHRASE_VAULT_02 = commented(

         "The metavar is Label.VAULT_METAVAR_SERVICE.",

     )(

@@ -772,6 +793,16 @@ class Label(enum.Enum):

         flags="python-brace-format",

     )

     """"""

+    REDUCED_DERIVEPASSPHRASE_VAULT_02 = commented(

+        "Same SERVICE metavar as in "

+        '"Deriving a passphrase requires a SERVICE." message.',

+    )(

+        "Label :: Help text :: Explanation",

+        "If operating on global settings, or importing/exporting settings, "

+        "then SERVICE must be omitted.  "

+        "Otherwise it is required.",

+    )

+    """"""

     DERIVEPASSPHRASE_VAULT_EPILOG_01 = commented(

         "",

     )(

@@ -833,6 +864,13 @@ class Label(enum.Enum):

         flags="python-brace-format",

     )

     """"""

+    REDUCED_PASSPHRASE_GENERATION_EPILOG = commented(

+        "Same NUMBER metavar as --lower option.",

+    )(

+        "Label :: Help text :: Explanation",

+        "Use NUMBER=0 to exclude a character type from the output.",

+    )

+    """"""

     STORAGE_MANAGEMENT_EPILOG = commented(

         "The metavar is Label.STORAGE_MANAGEMENT_METAVAR_PATH.",

     )(

@@ -842,6 +880,14 @@ class Label(enum.Enum):

         flags="python-brace-format",

     )

     """"""

+    REDUCED_STORAGE_MANAGEMENT_EPILOG = commented(

+        "Same PATH metavar as --export option.",

+    )(

+        "Label :: Help text :: Explanation",

+        'Using "-" as PATH for standard input/standard output '

+        "is supported.",

+    )

+    """"""

     DEPRECATED_COMMAND_LABEL = commented(

         "We use this format string to indicate, at the beginning "

         "of a command's help text, that this command is deprecated.",

@@ -1969,6 +2015,17 @@ class WarnMsgTemplate(enum.Enum):

         flags="python-brace-format",

     )

     """"""

+    REDUCED_EMPTY_SERVICE_NOT_SUPPORTED = commented(

+        "Same SERVICE metavar as in "

+        '"Deriving a passphrase requires a SERVICE." message.',

+    )(

+        "Warning message",

+        "An empty SERVICE is not supported by vault(1).  "

+        "For compatibility, this will be treated as if "

+        "SERVICE was not supplied, i.e., it will error out, "

+        "or operate on global settings.",

+    )

+    """"""

     EMPTY_SERVICE_SETTINGS_INACCESSIBLE = commented(

         "",

     )(

@@ -1981,6 +2038,19 @@ class WarnMsgTemplate(enum.Enum):

         flags="python-brace-format",

     )

     """"""

+    REDUCED_EMPTY_SERVICE_SETTINGS_INACCESSIBLE = commented(

+        "Same SERVICE metavar as in "

+        '"Deriving a passphrase requires a SERVICE." message.',

+    )(

+        "Warning message",

+        "An empty SERVICE is not supported by vault(1).  "

+        "The empty-string service settings will be inaccessible "

+        "and ineffective.  "

+        "To ensure that vault(1) and {PROG_NAME} see the settings, "  # noqa: RUF027

+        'move them into the "global" section.',

+        flags="python-brace-format",

+    )

+    """"""

     FAILED_TO_MIGRATE_CONFIG = commented(

         '"error" is supplied by the operating system (errno/strerror).',

     )(

@@ -2352,6 +2422,16 @@ class ErrMsgTemplate(enum.Enum):

         flags="python-brace-format",

     )

     """"""

+    REDUCED_PARAMS_NEEDS_SERVICE = commented(

+        "The param is a long-form command-line option name.  "

+        "Same SERVICE metavar as in "

+        '"Deriving a passphrase requires a SERVICE." message.',

+    )(

+        "Error message",

+        "{param} requires a SERVICE.",

+        flags="python-brace-format",

+    )

+    """"""

     PARAMS_NEEDS_SERVICE_OR_CONFIG = commented(

         "The param is a long-form command-line option name, "

         "the metavar is Label.VAULT_METAVAR_SERVICE.",

@@ -2361,6 +2441,16 @@ class ErrMsgTemplate(enum.Enum):

         flags="python-brace-format",

     )

     """"""

+    REDUCED_PARAMS_NEEDS_SERVICE_OR_CONFIG = commented(

+        "The param is a long-form command-line option name.  "

+        "Same SERVICE metavar as in "

+        '"Deriving a passphrase requires a SERVICE." message.',

+    )(

+        "Error message",

+        "{param} requires a SERVICE or --config.",

+        flags="python-brace-format",

+    )

+    """"""

     PARAMS_NO_SERVICE = commented(

         "The param is a long-form command-line option name, "

         "the metavar is Label.VAULT_METAVAR_SERVICE.",

@@ -2370,6 +2460,16 @@ class ErrMsgTemplate(enum.Enum):

         flags="python-brace-format",

     )

     """"""

+    REDUCED_PARAMS_NO_SERVICE = commented(

+        "The param is a long-form command-line option name.  "

+        "Same SERVICE metavar as in "

+        '"Deriving a passphrase requires a SERVICE." message.',

+    )(

+        "Error message",

+        "{param} does not take a SERVICE argument.",

+        flags="python-brace-format",

+    )

+    """"""

     SERVICE_REQUIRED = commented(

         "The metavar is Label.VAULT_METAVAR_SERVICE.",

     )(

@@ -2378,6 +2478,13 @@ class ErrMsgTemplate(enum.Enum):

         flags="python-brace-format",

     )

     """"""

+    REDUCED_SERVICE_REQUIRED = commented(

+        "",

+    )(

+        "Error message",

+        "Deriving a passphrase requires a SERVICE.",

+    )

+    """"""

     SET_AND_UNSET_SAME_SETTING = commented(

         "The rephrasing "

         '"Attempted to unset and set the same setting '