[CASSANDRA-17236] Add support for short form of version to CQLSH

• Type: Improvement
• Status: Resolved
• Priority: Low
• Resolution: Fixed
• Fix Version/s: 4.1-alpha1, 4.1
• Component/s: CQL/Semantics
• Labels: lhf
• Change Category: Operability
• Complexity: Low Hanging Fruit
• Platform: All

Source Control Link

https://github.com/apache/cassandra/commit/f6169d399f79168cbc3580d95082b0e2a99db048

Test and Documentation Plan

Check the binary using `-v` and `–version`.

• Assignee: Yash Ladha
• Reporter: Madhavan

Authors

Yash Ladha

Reviewers

Brandon Williams, Stefan Miklosovic

• Created: 04/Jan/22 16:46
• Updated: 27/May/22 19:24
• Resolved: 09/Feb/22 18:13

Description

Today we do only support the `–version` long option/form for cqlsh and this enhancement Jira is to request that we also offer a shorter version `-v` to cqlsh. This will have consistency benefits with other tools and even match with what we have at `bin/cassandra -v` option for instance.

Today, `cqlsh` does support `--v` to get the version which is different than the single dashed short form that is available at many other tools. Thanks to Ekaterina for finding this. It looks like this is stemming from Python's parse mechanism which is detailed here, https://docs.python.org/2.7/library/optparse.html#printing-a-version-string.

 

https://github.com/apache/cassandra/blob/trunk/bin/cqlsh.py#L194-L196

parser = optparse.OptionParser(description=description, epilog=epilog,
                               usage="Usage: %prog [options] [host [port]]",
                               version='cqlsh ' + version)

 

$ bin/cqlsh --v
cqlsh 6.0.0

This looks like a weird implementation at Python. Both (--help) and (--version) options are stemming from here, https://github.com/python/cpython/blob/2.7/Lib/optparse.py#L1248-L1256 and they did decide to ignore the short form option for version and it somehow automatically takes the (--v) option to spit the version info.