samba.git/python/samba/getopt.py, branch master

python:getopt: hack to generate docbook stubs from --help

2025-03-12T19:57:34+00:00

We have many many samba-tool subcommands that are not documented in
the manpage. Often the --help text is a good place to start, but doing
it entirely manually is VERY tedious.

This automates some of the process.

Signed-off-by: Douglas Bagnall 
Reviewed-by: Rowland Penny

py:get_opts:VersionOptions prints version in --help

2025-02-08T02:33:38+00:00

Because it might as well. Like this:

  Version Options:
    -V, --version       Display version number (4.22.2)

BUG: https://bugzilla.samba.org/show_bug.cgi?id=15770

Signed-off-by: Douglas Bagnall 
Reviewed-by: Jennifer Sutton

python/samba/getopt: don't prompt for a password for --use-krb5-ccache=...

2024-04-23T14:17:32+00:00

BUG: https://bugzilla.samba.org/show_bug.cgi?id=15018

Signed-off-by: Stefan Metzmacher 
Reviewed-by: Andreas Schneider

python: getopt: HostOptions and other option groups inherit from samba OptionGroup class

2023-10-25T00:31:36+00:00

Signed-off-by: Rob van der Linde 
Reviewed-by: Douglas Bagnall 
Reviewed-by: Andrew Bartlett 

Autobuild-User(master): Andrew Bartlett 
Autobuild-Date(master): Wed Oct 25 00:31:37 UTC 2023 on atb-devel-224

netcmd: auth policy: add OptionGroup classes for user, service and computer options

2023-10-24T23:31:29+00:00

Signed-off-by: Rob van der Linde 
Reviewed-by: Douglas Bagnall 
Reviewed-by: Andrew Bartlett

python: getopt: Add HostOptions to avoid need to manually add -H

2023-10-24T23:31:29+00:00

Signed-off-by: Rob van der Linde 
Reviewed-by: Douglas Bagnall 
Reviewed-by: Andrew Bartlett

python: getopt: implement required flag on options and OptionParser

2023-10-24T23:31:29+00:00

Signed-off-by: Rob van der Linde 
Reviewed-by: Douglas Bagnall 
Reviewed-by: Andrew Bartlett

python: getopt: subclass OptionParser to populate option_class

2023-10-24T23:31:29+00:00

The option_class needs to be set correctly for OptionGroups that use self.add_option

Override OptionParser `__init__` to change the default Option class to the samba one.

Signed-off-by: Rob van der Linde 
Reviewed-by: Douglas Bagnall 
Reviewed-by: Andrew Bartlett

python: netcmd: remove OptionError alias to OptionValueError

2023-10-24T23:31:29+00:00

The other methods in this file already raise optparse.OptionValueError
directly, except for two older ones.

They are using an alias which changes the name to OptionError, the
confusing part about this is that optparse.OptionError actually does
exist, so the incorrect alias needs to be removed.

Signed-off-by: Rob van der Linde 
Reviewed-by: Douglas Bagnall 
Reviewed-by: Andrew Bartlett

python: getopt: rename SambaOption to Option

2023-10-24T23:31:29+00:00

 * Nothing uses SambaOption directly, everything imports it through samba.netcmd.Option
 * Avoid an unnecessary rename on import

Signed-off-by: Rob van der Linde 
Reviewed-by: Douglas Bagnall 
Reviewed-by: Andrew Bartlett