[jira] [Updated] (CASSANDRA-17684) MacOS install should include cql.html local help file
[
https://issues.apache.org/jira/browse/CASSANDRA-17684?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali updated CASSANDRA-17684:
Test and Documentation Plan: I ensured the given patch was activated in the
if statement through print statements. If the cql.html file was to open in the
given browser, the patch ran properly.
Status: Patch Available (was: In Progress)
This fix packages cql.html as a resource file and imports it in cqlshmain.py
(if available).
> MacOS install should include cql.html local help file
> -
>
> Key: CASSANDRA-17684
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17684
> Project: Cassandra
> Issue Type: Improvement
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 5.x
>
>
> On MacOS, /usr/share is not writable – even by root. Instead,
> /usr/local/share is the preferred location.
> The current share directory path is /usr/share/doc/cassandra/CQL.html. This
> would just add an alternative path.
> Using a list comprehension would simplify the current code. E.g.,
> {quote}import pathlib
> HTML_FALLBACK = 'https://cassandra.apache.org/doc/latest/cql/index.html'
> loc = ( Path('./doc/cql3/CQL.html'),
> Path('/usr/share/doc/cassandra/CQL.html'),
> Path('{color:#4c9aff}/usr/local/share{color}/doc/cassandra/CQL.html' ))
> item = next((x.as_uri() for x in loc if os.path.exists( x )), HTML_FALLBACK)
> {quote}
> Homebrew doesn't install the doc files, so this would likely need either
> a) added to homebrew in
> [https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/cassandra.rb]
> or
> b) installed with pip's setup.cql and accessed with Python's
> [importlib.resources|https://docs.python.org/3/library/importlib.resources.html]
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Updated] (CASSANDRA-17667) Text value containing "/*" interpreted as multiline comment in cqlsh
[
https://issues.apache.org/jira/browse/CASSANDRA-17667?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali updated CASSANDRA-17667:
Status: Patch Available (was: Open)
> Text value containing "/*" interpreted as multiline comment in cqlsh
>
>
> Key: CASSANDRA-17667
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17667
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: ANOOP THOMAS
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 4.0.x, 4.1.x, 5.x
>
>
> I use CQLSH command line utility to load some DDLs. The version of utility I
> use is this:
> {noformat}
> [cqlsh 6.0.0 | Cassandra 4.0.0.47 | CQL spec 3.4.5 | Native protocol
> v5]{noformat}
> Command that loads DDL.cql:
> {noformat}
> cqlsh -u username -p password cassandra.example.com 65503 --ssl -f DDL.cql
> {noformat}
> I have a line in CQL script that breaks the syntax.
> {noformat}
> INSERT into tablename (key,columnname1,columnname2) VALUES
> ('keyName','value1','/value2/*/value3');{noformat}
> {{/*}} here is interpreted as start of multi-line comment. It used to work on
> older versions of cqlsh. The error I see looks like this:
> {noformat}
> SyntaxException: line 4:2 mismatched input 'Update' expecting ')'
> (...,'value1','/value2INSERT into tablename(INSERT into tablename
> (key,columnname1,columnname2)) VALUES ('[Update]-...) SyntaxException: line
> 1:0 no viable alternative at input '(' ([(]...)
> {noformat}
> Same behavior while running in interactive mode too. {{/*}} inside a CQL
> statement should not be interpreted as start of multi-line comment.
> With schema:
> {code:java}
> CREATE TABLE tablename ( key text primary key, columnname1 text, columnname2
> text);{code}
>
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Updated] (CASSANDRA-17667) Text value containing "/*" interpreted as multiline comment in cqlsh
[
https://issues.apache.org/jira/browse/CASSANDRA-17667?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali updated CASSANDRA-17667:
Mentor: Attila Homoki (was: Brad Schoening)
> Text value containing "/*" interpreted as multiline comment in cqlsh
>
>
> Key: CASSANDRA-17667
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17667
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: ANOOP THOMAS
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 4.0.x, 4.1.x, 5.x
>
>
> I use CQLSH command line utility to load some DDLs. The version of utility I
> use is this:
> {noformat}
> [cqlsh 6.0.0 | Cassandra 4.0.0.47 | CQL spec 3.4.5 | Native protocol
> v5]{noformat}
> Command that loads DDL.cql:
> {noformat}
> cqlsh -u username -p password cassandra.example.com 65503 --ssl -f DDL.cql
> {noformat}
> I have a line in CQL script that breaks the syntax.
> {noformat}
> INSERT into tablename (key,columnname1,columnname2) VALUES
> ('keyName','value1','/value2/*/value3');{noformat}
> {{/*}} here is interpreted as start of multi-line comment. It used to work on
> older versions of cqlsh. The error I see looks like this:
> {noformat}
> SyntaxException: line 4:2 mismatched input 'Update' expecting ')'
> (...,'value1','/value2INSERT into tablename(INSERT into tablename
> (key,columnname1,columnname2)) VALUES ('[Update]-...) SyntaxException: line
> 1:0 no viable alternative at input '(' ([(]...)
> {noformat}
> Same behavior while running in interactive mode too. {{/*}} inside a CQL
> statement should not be interpreted as start of multi-line comment.
> With schema:
> {code:java}
> CREATE TABLE tablename ( key text primary key, columnname1 text, columnname2
> text);{code}
>
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Updated] (CASSANDRA-17667) Text value containing "/*" interpreted as multiline comment in cqlsh
[
https://issues.apache.org/jira/browse/CASSANDRA-17667?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali updated CASSANDRA-17667:
Mentor: Brad Schoening
> Text value containing "/*" interpreted as multiline comment in cqlsh
>
>
> Key: CASSANDRA-17667
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17667
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: ANOOP THOMAS
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 4.0.x, 4.1.x, 5.x
>
>
> I use CQLSH command line utility to load some DDLs. The version of utility I
> use is this:
> {noformat}
> [cqlsh 6.0.0 | Cassandra 4.0.0.47 | CQL spec 3.4.5 | Native protocol
> v5]{noformat}
> Command that loads DDL.cql:
> {noformat}
> cqlsh -u username -p password cassandra.example.com 65503 --ssl -f DDL.cql
> {noformat}
> I have a line in CQL script that breaks the syntax.
> {noformat}
> INSERT into tablename (key,columnname1,columnname2) VALUES
> ('keyName','value1','/value2/*/value3');{noformat}
> {{/*}} here is interpreted as start of multi-line comment. It used to work on
> older versions of cqlsh. The error I see looks like this:
> {noformat}
> SyntaxException: line 4:2 mismatched input 'Update' expecting ')'
> (...,'value1','/value2INSERT into tablename(INSERT into tablename
> (key,columnname1,columnname2)) VALUES ('[Update]-...) SyntaxException: line
> 1:0 no viable alternative at input '(' ([(]...)
> {noformat}
> Same behavior while running in interactive mode too. {{/*}} inside a CQL
> statement should not be interpreted as start of multi-line comment.
> With schema:
> {code:java}
> CREATE TABLE tablename ( key text primary key, columnname1 text, columnname2
> text);{code}
>
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Assigned] (CASSANDRA-17667) Text value containing "/*" interpreted as multiline comment in cqlsh
[
https://issues.apache.org/jira/browse/CASSANDRA-17667?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali reassigned CASSANDRA-17667:
---
Assignee: Vineet Gali
> Text value containing "/*" interpreted as multiline comment in cqlsh
>
>
> Key: CASSANDRA-17667
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17667
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: ANOOP THOMAS
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 4.0.x, 4.1.x, 5.x
>
>
> I use CQLSH command line utility to load some DDLs. The version of utility I
> use is this:
> {noformat}
> [cqlsh 6.0.0 | Cassandra 4.0.0.47 | CQL spec 3.4.5 | Native protocol
> v5]{noformat}
> Command that loads DDL.cql:
> {noformat}
> cqlsh -u username -p password cassandra.example.com 65503 --ssl -f DDL.cql
> {noformat}
> I have a line in CQL script that breaks the syntax.
> {noformat}
> INSERT into tablename (key,columnname1,columnname2) VALUES
> ('keyName','value1','/value2/*/value3');{noformat}
> {{/*}} here is interpreted as start of multi-line comment. It used to work on
> older versions of cqlsh. The error I see looks like this:
> {noformat}
> SyntaxException: line 4:2 mismatched input 'Update' expecting ')'
> (...,'value1','/value2INSERT into tablename(INSERT into tablename
> (key,columnname1,columnname2)) VALUES ('[Update]-...) SyntaxException: line
> 1:0 no viable alternative at input '(' ([(]...)
> {noformat}
> Same behavior while running in interactive mode too. {{/*}} inside a CQL
> statement should not be interpreted as start of multi-line comment.
> With schema:
> {code:java}
> CREATE TABLE tablename ( key text primary key, columnname1 text, columnname2
> text);{code}
>
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Updated] (CASSANDRA-17667) Text value containing "/*" interpreted as multiline comment in cqlsh
[
https://issues.apache.org/jira/browse/CASSANDRA-17667?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali updated CASSANDRA-17667:
Description:
I use CQLSH command line utility to load some DDLs. The version of utility I
use is this:
{noformat}
[cqlsh 6.0.0 | Cassandra 4.0.0.47 | CQL spec 3.4.5 | Native protocol
v5]{noformat}
Command that loads DDL.cql:
{noformat}
cqlsh -u username -p password cassandra.example.com 65503 --ssl -f DDL.cql
{noformat}
I have a line in CQL script that breaks the syntax.
{noformat}
INSERT into tablename (key,columnname1,columnname2) VALUES
('keyName','value1','/value2/*/value3');{noformat}
{{/*}} here is interpreted as start of multi-line comment. It used to work on
older versions of cqlsh. The error I see looks like this:
{noformat}
SyntaxException: line 4:2 mismatched input 'Update' expecting ')'
(...,'value1','/value2INSERT into tablename(INSERT into tablename
(key,columnname1,columnname2)) VALUES ('[Update]-...) SyntaxException: line 1:0
no viable alternative at input '(' ([(]...)
{noformat}
Same behavior while running in interactive mode too. {{/*}} inside a CQL
statement should not be interpreted as start of multi-line comment.
With schema:
{code:java}
CREATE TABLE tablename ( key text primary key, columnname1 text, columnname2
text);{code}
was:
I use CQLSH command line utility to load some DDLs. The version of utility I
use is this:
{noformat}
[cqlsh 6.0.0 | Cassandra 4.0.0.47 | CQL spec 3.4.5 | Native protocol
v5]{noformat}
Command that loads DDL.cql:
{noformat}
cqlsh -u username -p password cassandra.example.com 65503 --ssl -f DDL.cql
{noformat}
I have a line in CQL script that breaks the syntax.
{noformat}
INSERT into tablename (key,columnname1,columnname2) VALUES
('keyName','value1','/value2/*/value3');{noformat}
{{/*}} here is interpreted as start of multi-line comment. It used to work on
older versions of cqlsh. The error I see looks like this:
{noformat}
SyntaxException: line 4:2 mismatched input 'Update' expecting ')'
(...,'value1','/value2INSERT into tablename(INSERT into tablename
(key,columnname1,columnname2)) VALUES ('[Update]-...) SyntaxException: line 1:0
no viable alternative at input '(' ([(]...)
{noformat}
Same behavior while running in interactive mode too. {{/*}} inside a CQL
statement should not be interpreted as start of multi-line comment.
> Text value containing "/*" interpreted as multiline comment in cqlsh
>
>
> Key: CASSANDRA-17667
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17667
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: ANOOP THOMAS
>Priority: Normal
> Fix For: 4.0.x, 4.1.x, 5.x
>
>
> I use CQLSH command line utility to load some DDLs. The version of utility I
> use is this:
> {noformat}
> [cqlsh 6.0.0 | Cassandra 4.0.0.47 | CQL spec 3.4.5 | Native protocol
> v5]{noformat}
> Command that loads DDL.cql:
> {noformat}
> cqlsh -u username -p password cassandra.example.com 65503 --ssl -f DDL.cql
> {noformat}
> I have a line in CQL script that breaks the syntax.
> {noformat}
> INSERT into tablename (key,columnname1,columnname2) VALUES
> ('keyName','value1','/value2/*/value3');{noformat}
> {{/*}} here is interpreted as start of multi-line comment. It used to work on
> older versions of cqlsh. The error I see looks like this:
> {noformat}
> SyntaxException: line 4:2 mismatched input 'Update' expecting ')'
> (...,'value1','/value2INSERT into tablename(INSERT into tablename
> (key,columnname1,columnname2)) VALUES ('[Update]-...) SyntaxException: line
> 1:0 no viable alternative at input '(' ([(]...)
> {noformat}
> Same behavior while running in interactive mode too. {{/*}} inside a CQL
> statement should not be interpreted as start of multi-line comment.
> With schema:
> {code:java}
> CREATE TABLE tablename ( key text primary key, columnname1 text, columnname2
> text);{code}
>
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Updated] (CASSANDRA-18726) Simplify helptopics.py using associative array
[ https://issues.apache.org/jira/browse/CASSANDRA-18726?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Vineet Gali updated CASSANDRA-18726: Test and Documentation Plan: I ran the pytests so ensure the codebase was working properly and ran tests on each of the help commands before and after the changes. Status: Patch Available (was: Open) > Simplify helptopics.py using associative array > -- > > Key: CASSANDRA-18726 > URL: https://issues.apache.org/jira/browse/CASSANDRA-18726 > Project: Cassandra > Issue Type: Task > Components: CQL/Interpreter >Reporter: Vineet Gali >Assignee: Vineet Gali >Priority: Normal > Fix For: 5.0 > > > The ~200 lines of code in helptopics.py can be greatly simplified using an > associative array to map topics to HTML anchors instead of class reflection. > This will halve the lines of code and improve readability. > Functionality will not be changed. -- This message was sent by Atlassian Jira (v8.20.10#820010) - To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Created] (CASSANDRA-18726) Simplify helptopics.py using associative array
Vineet Gali created CASSANDRA-18726: --- Summary: Simplify helptopics.py using associative array Key: CASSANDRA-18726 URL: https://issues.apache.org/jira/browse/CASSANDRA-18726 Project: Cassandra Issue Type: Task Components: CQL/Interpreter Reporter: Vineet Gali Assignee: Vineet Gali The ~200 lines of code in helptopics.py can be greatly simplified using an associative array to map topics to HTML anchors instead of class reflection. This will halve the lines of code and improve readability. Functionality will not be changed. -- This message was sent by Atlassian Jira (v8.20.10#820010) - To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17750329#comment-17750329
]
Vineet Gali commented on CASSANDRA-17534:
-
[~smiklosovic] any updates on if this looks fine now?
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Updated] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali updated CASSANDRA-17534:
Status: Review In Progress (was: Changes Suggested)
New PR's for fix
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17748310#comment-17748310
]
Vineet Gali commented on CASSANDRA-17534:
-
3.0 fixed
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17748309#comment-17748309
]
Vineet Gali commented on CASSANDRA-17534:
-
3.11 fixed
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17748307#comment-17748307
]
Vineet Gali commented on CASSANDRA-17534:
-
4.1 fixed
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[ https://issues.apache.org/jira/browse/CASSANDRA-17534 ]
Vineet Gali deleted comment on CASSANDRA-17534:
-
was (Author: JIRAUSER300849):
3.11
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[ https://issues.apache.org/jira/browse/CASSANDRA-17534 ]
Vineet Gali deleted comment on CASSANDRA-17534:
-
was (Author: JIRAUSER300849):
3.0 (I misnamed the commit but it is 3.0)
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[ https://issues.apache.org/jira/browse/CASSANDRA-17534 ]
Vineet Gali deleted comment on CASSANDRA-17534:
-
was (Author: JIRAUSER300849):
Cassandra-4.1
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17747522#comment-17747522
]
Vineet Gali commented on CASSANDRA-17534:
-
3.0 (I misnamed the commit but it is 3.0)
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17747520#comment-17747520
]
Vineet Gali commented on CASSANDRA-17534:
-
3.11
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Comment Edited] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17747503#comment-17747503
]
Vineet Gali edited comment on CASSANDRA-17534 at 7/26/23 1:13 PM:
--
Trunk
You're right I put the wrong link, it's fixed now!
was (Author: JIRAUSER300849):
Trunk
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[ https://issues.apache.org/jira/browse/CASSANDRA-17534 ]
Vineet Gali deleted comment on CASSANDRA-17534:
-
was (Author: JIRAUSER300849):
I fixed the double ''. Also, I believe I only opened one for 4.0 and another
for 4.1 correct?
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17747503#comment-17747503
]
Vineet Gali commented on CASSANDRA-17534:
-
Trunk
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17747229#comment-17747229
]
Vineet Gali commented on CASSANDRA-17534:
-
I fixed the double ''. Also, I believe I only opened one for 4.0 and another
for 4.1 correct?
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17747138#comment-17747138
]
Vineet Gali commented on CASSANDRA-17534:
-
Cassandra-4.1
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17747136#comment-17747136
]
Vineet Gali commented on CASSANDRA-17534:
-
Cassandra-4.0
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17747135#comment-17747135
]
Vineet Gali commented on CASSANDRA-17534:
-
Trunk
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Updated] (CASSANDRA-17534) CQLSH help topic links are broken between textile and online files
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali updated CASSANDRA-17534:
Test and Documentation Plan: We found the correct link to be
[https://cassandra.apache.org/doc/latest/cassandra/cql/cql_singlefile.html] and
tested all of the help functions with the new link.
Status: Patch Available (was: In Progress)
> CQLSH help topic links are broken between textile and online files
> --
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17914) Argparse migration as the Python Optparse library is deprecated
[
https://issues.apache.org/jira/browse/CASSANDRA-17914?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17744295#comment-17744295
]
Vineet Gali commented on CASSANDRA-17914:
-
[~brandon.williams] Could you kickstart the 4.1 tests again?
> Argparse migration as the Python Optparse library is deprecated
> ---
>
> Key: CASSANDRA-17914
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17914
> Project: Cassandra
> Issue Type: Improvement
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
>
> [Deprecated since version 2.7: The optparse module is deprecated and will not
> be developed further; development will continue with the argparse
> module.|https://docs.python.org/2/library/optparse.html]
> Argparse is described in [PEP 389 – argparse - New Command Line Parsing
> Module|https://peps.python.org/pep-0389/]
>
> A partial upgrade path from
> [{{optparse}}|https://docs.python.org/3/library/optparse.html#module-optparse]
> to
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]:
> https://docs.python.org/3/library/argparse.html#upgrading-optparse-code
> * Replace all
> [{{optparse.OptionParser.add_option()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.add_option]
> calls with
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls.
> * Replace {{(options, args) = parser.parse_args()}} with {{args =
> parser.parse_args()}} and add additional
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls for the positional arguments. Keep in mind that what was previously
> called {{{}options{}}}, now in the
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]
> context is called {{{}args{}}}.
> * Replace
> [{{optparse.OptionParser.disable_interspersed_args()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.disable_interspersed_args]
> by using
> [{{parse_intermixed_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_intermixed_args]
> instead of
> [{{parse_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_args].
> * Replace callback actions and the {{callback_*}} keyword arguments with
> {{type}} or {{action}} arguments.
> * Replace string names for {{type}} keyword arguments with the corresponding
> type objects (e.g. int, float, complex, etc).
> * Replace {{optparse.Values}} with
> [{{Namespace}}|https://docs.python.org/3/library/argparse.html#argparse.Namespace]
> and {{optparse.OptionError}} and {{optparse.OptionValueError}} with
> {{{}ArgumentError{}}}.
> * Replace strings with implicit arguments such as {{%default}} or {{%prog}}
> with the standard Python syntax to use dictionaries to format strings, that
> is, {{%(default)s}} and {{{}%(prog)s{}}}.
> * Replace the OptionParser constructor {{version}} argument with a call to
> {{{}parser.add_argument('--version', action='version', version=' version>'){}}}.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Updated] (CASSANDRA-17914) Argparse migration as the Python Optparse library is deprecated
[
https://issues.apache.org/jira/browse/CASSANDRA-17914?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali updated CASSANDRA-17914:
Mentor: Brad Schoening
Test and Documentation Plan:
Optparse to Argparse test writeup
I copied the old optparse code (cqlshmain.py for trunk and cqlsh.py for 4.0 and
4.1) into a new file called optparse_test_main.py and placed it in the same
folder as cqlshmain.py. Then I created a copy of the test file (cqlsh.py) in
its same folder called optparse_test.py. I am running each argument
individually on both files to see if they get the same output.
| |Same |
|--version |yes |
|-c |Yes |
|--no-color |Yes |
|--browser |Yes |
|--ssl |Yes |
|-u |Yes |
|-p |Yes |
|-k |Yes |
|-f |Yes |
|--debug |Yes |
|--coverage |Yes |
|--encoding |Yes |
|--cqlshrc |Yes |
|--credentials |Yes |
|--cqlversion |Yes |
|--protocol-version |Yes |
|-e |Yes |
|--connect-timeout |Yes |
|--request-timeout |Yes |
|-t |Yes |
|-v |Yes |
|--insecure-password-without-warning |yes |
was:
Optparse to Argparse test writeup
I copied the old optparse code (cqlshmain.py) into a new file called
optparse_test_main.py and placed it in the same folder as cqlshmain.py. Then I
created a copy of the test file (cqlsh.py) in its same folder called
optparse_test.py. I am running each argument individually on both files to see
if they get the same output.
| |Same |
|--version |yes |
|-c |Yes |
|--no-color |Yes |
|--browser |Yes |
|--ssl |Yes |
|-u |Yes |
|-p |Yes |
|-k |Yes |
|-f |Yes |
|--debug |Yes |
|--coverage |Yes |
|--encoding |Yes |
|--cqlshrc |Yes |
|--credentials |Yes |
|--cqlversion |Yes |
|--protocol-version |Yes |
|-e |Yes |
|--connect-timeout |Yes |
|--request-timeout |Yes |
|-t |Yes |
|-v |Yes |
|--insecure-password-without-warning |yes |
Status: Patch Available (was: In Progress)
> Argparse migration as the Python Optparse library is deprecated
> ---
>
> Key: CASSANDRA-17914
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17914
> Project: Cassandra
> Issue Type: Improvement
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
>
> [Deprecated since version 2.7: The optparse module is deprecated and will not
> be developed further; development will continue with the argparse
> module.|https://docs.python.org/2/library/optparse.html]
> Argparse is described in [PEP 389 – argparse - New Command Line Parsing
> Module|https://peps.python.org/pep-0389/]
>
> A partial upgrade path from
> [{{optparse}}|https://docs.python.org/3/library/optparse.html#module-optparse]
> to
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]:
> https://docs.python.org/3/library/argparse.html#upgrading-optparse-code
> * Replace all
> [{{optparse.OptionParser.add_option()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.add_option]
> calls with
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls.
> * Replace {{(options, args) = parser.parse_args()}} with {{args =
> parser.parse_args()}} and add additional
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls for the positional arguments. Keep in mind that what was previously
> called {{{}options{}}}, now in the
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]
> context is called {{{}args{}}}.
> * Replace
> [{{optparse.OptionParser.disable_interspersed_args()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.disable_interspersed_args]
> by using
> [{{parse_intermixed_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_intermixed_args]
> instead of
> [{{parse_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_args].
> * Replace callback actions and the {{callback_*}} keyword arguments with
> {{type}} or {{action}} arguments.
> * Replace string names for {{type}} keyword arguments with the corresponding
> type objects (e.g. int, float, complex, etc).
> * Replace {{optparse.Values}} with
> [{{Namespace}}|https://docs.python.org/3/library/argparse.html#argparse.Namespace]
> and {{optparse.OptionError}} and {{optparse.OptionValueError}} with
> {{{}ArgumentError{}}}.
> * Replace strings with implicit arguments such as {{%default}} or {{%prog}}
> with the standard Python syntax to use dictionaries to format strings, that
> is, {{%(default)s}} and {{{}%(prog)s{}}}.
> * Replace the OptionParser constructor {{version}} argument with a call to
>
[jira] [Commented] (CASSANDRA-17914) Argparse migration as the Python Optparse library is deprecated
[
https://issues.apache.org/jira/browse/CASSANDRA-17914?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17741142#comment-17741142
]
Vineet Gali commented on CASSANDRA-17914:
-
[~brandon.williams] I tried that and it gave me this error,
fatal: The current branch cassandra-17914/cassandra-4.1 has no upstream branch.
I'm hesitant to set the upstream as the origin/cassandra-4.1 branch just
because I'm not 100% sure that's the right thing to do.
Sorry, I don't have slack!
> Argparse migration as the Python Optparse library is deprecated
> ---
>
> Key: CASSANDRA-17914
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17914
> Project: Cassandra
> Issue Type: Improvement
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
>
> [Deprecated since version 2.7: The optparse module is deprecated and will not
> be developed further; development will continue with the argparse
> module.|https://docs.python.org/2/library/optparse.html]
> Argparse is described in [PEP 389 – argparse - New Command Line Parsing
> Module|https://peps.python.org/pep-0389/]
>
> A partial upgrade path from
> [{{optparse}}|https://docs.python.org/3/library/optparse.html#module-optparse]
> to
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]:
> https://docs.python.org/3/library/argparse.html#upgrading-optparse-code
> * Replace all
> [{{optparse.OptionParser.add_option()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.add_option]
> calls with
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls.
> * Replace {{(options, args) = parser.parse_args()}} with {{args =
> parser.parse_args()}} and add additional
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls for the positional arguments. Keep in mind that what was previously
> called {{{}options{}}}, now in the
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]
> context is called {{{}args{}}}.
> * Replace
> [{{optparse.OptionParser.disable_interspersed_args()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.disable_interspersed_args]
> by using
> [{{parse_intermixed_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_intermixed_args]
> instead of
> [{{parse_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_args].
> * Replace callback actions and the {{callback_*}} keyword arguments with
> {{type}} or {{action}} arguments.
> * Replace string names for {{type}} keyword arguments with the corresponding
> type objects (e.g. int, float, complex, etc).
> * Replace {{optparse.Values}} with
> [{{Namespace}}|https://docs.python.org/3/library/argparse.html#argparse.Namespace]
> and {{optparse.OptionError}} and {{optparse.OptionValueError}} with
> {{{}ArgumentError{}}}.
> * Replace strings with implicit arguments such as {{%default}} or {{%prog}}
> with the standard Python syntax to use dictionaries to format strings, that
> is, {{%(default)s}} and {{{}%(prog)s{}}}.
> * Replace the OptionParser constructor {{version}} argument with a call to
> {{{}parser.add_argument('--version', action='version', version=' version>'){}}}.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17914) Argparse migration as the Python Optparse library is deprecated
[
https://issues.apache.org/jira/browse/CASSANDRA-17914?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17741136#comment-17741136
]
Vineet Gali commented on CASSANDRA-17914:
-
[~smiklosovic] I've created the files for 4.0.x and 4.1.x but I'm as to how to
properly branch from my cloned repo to submit the PR's. Is there any
documentation I can follow?
> Argparse migration as the Python Optparse library is deprecated
> ---
>
> Key: CASSANDRA-17914
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17914
> Project: Cassandra
> Issue Type: Improvement
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
>
> [Deprecated since version 2.7: The optparse module is deprecated and will not
> be developed further; development will continue with the argparse
> module.|https://docs.python.org/2/library/optparse.html]
> Argparse is described in [PEP 389 – argparse - New Command Line Parsing
> Module|https://peps.python.org/pep-0389/]
>
> A partial upgrade path from
> [{{optparse}}|https://docs.python.org/3/library/optparse.html#module-optparse]
> to
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]:
> https://docs.python.org/3/library/argparse.html#upgrading-optparse-code
> * Replace all
> [{{optparse.OptionParser.add_option()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.add_option]
> calls with
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls.
> * Replace {{(options, args) = parser.parse_args()}} with {{args =
> parser.parse_args()}} and add additional
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls for the positional arguments. Keep in mind that what was previously
> called {{{}options{}}}, now in the
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]
> context is called {{{}args{}}}.
> * Replace
> [{{optparse.OptionParser.disable_interspersed_args()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.disable_interspersed_args]
> by using
> [{{parse_intermixed_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_intermixed_args]
> instead of
> [{{parse_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_args].
> * Replace callback actions and the {{callback_*}} keyword arguments with
> {{type}} or {{action}} arguments.
> * Replace string names for {{type}} keyword arguments with the corresponding
> type objects (e.g. int, float, complex, etc).
> * Replace {{optparse.Values}} with
> [{{Namespace}}|https://docs.python.org/3/library/argparse.html#argparse.Namespace]
> and {{optparse.OptionError}} and {{optparse.OptionValueError}} with
> {{{}ArgumentError{}}}.
> * Replace strings with implicit arguments such as {{%default}} or {{%prog}}
> with the standard Python syntax to use dictionaries to format strings, that
> is, {{%(default)s}} and {{{}%(prog)s{}}}.
> * Replace the OptionParser constructor {{version}} argument with a call to
> {{{}parser.add_argument('--version', action='version', version=' version>'){}}}.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Assigned] (CASSANDRA-17534) CQLSH help topic links appear broken with online version
[
https://issues.apache.org/jira/browse/CASSANDRA-17534?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali reassigned CASSANDRA-17534:
---
Assignee: Vineet Gali
> CQLSH help topic links appear broken with online version
>
>
> Key: CASSANDRA-17534
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17534
> Project: Cassandra
> Issue Type: Bug
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
> Fix For: 3.0.x, 3.11.x, 4.0.x, 4.1.x, 5.x
>
>
> CQLSH help topics opens a generic CQL page, not the specific topic. This
> happens when docs are not installed locally, and it tries to open the online
> version.
> The file cqlsh.py has:
> {{ # default location of local CQL.html}}
> {{ if os.path.exists(CASSANDRA_PATH + '/doc/cql3/CQL.html'):}}
> {{ }}
> {{ else:}}
> {{ # fallback to online version}}
> {{ CASSANDRA_CQL_HTML = CASSANDRA_CQL_HTML_FALLBACK}}
> For example,
> {{cqlsh> help truncate;}}
> opens the page:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/index.html#truncateStmt]
> but there is no information about 'truncate' on that page and the anchor
> #truncateStmt doesn't exist.
> the correct page anchor is:
> [https://cassandra.apache.org/doc/latest/cassandra/cql/ddl.html#truncate-statement]
> The local file anchors appear they may be incorrect as well:
> [https://github.com/apache/cassandra/blob/trunk/doc/cql3/CQL.textile#truncate]
> To reproduce this, 'pip install cqlsh' on a machine without a Cassandra
> package install.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17914) Argparse migration as the Python Optparse library is deprecated
[
https://issues.apache.org/jira/browse/CASSANDRA-17914?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17739133#comment-17739133
]
Vineet Gali commented on CASSANDRA-17914:
-
[~smiklosovic] Okay, I'm getting some help with branching. The patches for 4.0
and 4.1 should be done by Monday.
> Argparse migration as the Python Optparse library is deprecated
> ---
>
> Key: CASSANDRA-17914
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17914
> Project: Cassandra
> Issue Type: Improvement
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
>
> [Deprecated since version 2.7: The optparse module is deprecated and will not
> be developed further; development will continue with the argparse
> module.|https://docs.python.org/2/library/optparse.html]
> Argparse is described in [PEP 389 – argparse - New Command Line Parsing
> Module|https://peps.python.org/pep-0389/]
>
> A partial upgrade path from
> [{{optparse}}|https://docs.python.org/3/library/optparse.html#module-optparse]
> to
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]:
> https://docs.python.org/3/library/argparse.html#upgrading-optparse-code
> * Replace all
> [{{optparse.OptionParser.add_option()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.add_option]
> calls with
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls.
> * Replace {{(options, args) = parser.parse_args()}} with {{args =
> parser.parse_args()}} and add additional
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls for the positional arguments. Keep in mind that what was previously
> called {{{}options{}}}, now in the
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]
> context is called {{{}args{}}}.
> * Replace
> [{{optparse.OptionParser.disable_interspersed_args()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.disable_interspersed_args]
> by using
> [{{parse_intermixed_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_intermixed_args]
> instead of
> [{{parse_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_args].
> * Replace callback actions and the {{callback_*}} keyword arguments with
> {{type}} or {{action}} arguments.
> * Replace string names for {{type}} keyword arguments with the corresponding
> type objects (e.g. int, float, complex, etc).
> * Replace {{optparse.Values}} with
> [{{Namespace}}|https://docs.python.org/3/library/argparse.html#argparse.Namespace]
> and {{optparse.OptionError}} and {{optparse.OptionValueError}} with
> {{{}ArgumentError{}}}.
> * Replace strings with implicit arguments such as {{%default}} or {{%prog}}
> with the standard Python syntax to use dictionaries to format strings, that
> is, {{%(default)s}} and {{{}%(prog)s{}}}.
> * Replace the OptionParser constructor {{version}} argument with a call to
> {{{}parser.add_argument('--version', action='version', version=' version>'){}}}.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Commented] (CASSANDRA-17914) Argparse migration as the Python Optparse library is deprecated
[
https://issues.apache.org/jira/browse/CASSANDRA-17914?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17738250#comment-17738250
]
Vineet Gali commented on CASSANDRA-17914:
-
[~smiklosovic] I updated the PR with fixes for the pycode style issues
https://github.com/apache/cassandra/compare/trunk...vgali7:cassandra:cassandra-17914
> Argparse migration as the Python Optparse library is deprecated
> ---
>
> Key: CASSANDRA-17914
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17914
> Project: Cassandra
> Issue Type: Improvement
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
>
> [Deprecated since version 2.7: The optparse module is deprecated and will not
> be developed further; development will continue with the argparse
> module.|https://docs.python.org/2/library/optparse.html]
> Argparse is described in [PEP 389 – argparse - New Command Line Parsing
> Module|https://peps.python.org/pep-0389/]
>
> A partial upgrade path from
> [{{optparse}}|https://docs.python.org/3/library/optparse.html#module-optparse]
> to
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]:
> https://docs.python.org/3/library/argparse.html#upgrading-optparse-code
> * Replace all
> [{{optparse.OptionParser.add_option()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.add_option]
> calls with
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls.
> * Replace {{(options, args) = parser.parse_args()}} with {{args =
> parser.parse_args()}} and add additional
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls for the positional arguments. Keep in mind that what was previously
> called {{{}options{}}}, now in the
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]
> context is called {{{}args{}}}.
> * Replace
> [{{optparse.OptionParser.disable_interspersed_args()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.disable_interspersed_args]
> by using
> [{{parse_intermixed_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_intermixed_args]
> instead of
> [{{parse_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_args].
> * Replace callback actions and the {{callback_*}} keyword arguments with
> {{type}} or {{action}} arguments.
> * Replace string names for {{type}} keyword arguments with the corresponding
> type objects (e.g. int, float, complex, etc).
> * Replace {{optparse.Values}} with
> [{{Namespace}}|https://docs.python.org/3/library/argparse.html#argparse.Namespace]
> and {{optparse.OptionError}} and {{optparse.OptionValueError}} with
> {{{}ArgumentError{}}}.
> * Replace strings with implicit arguments such as {{%default}} or {{%prog}}
> with the standard Python syntax to use dictionaries to format strings, that
> is, {{%(default)s}} and {{{}%(prog)s{}}}.
> * Replace the OptionParser constructor {{version}} argument with a call to
> {{{}parser.add_argument('--version', action='version', version=' version>'){}}}.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Updated] (CASSANDRA-17914) Argparse migration as the Python Optparse library is deprecated
[
https://issues.apache.org/jira/browse/CASSANDRA-17914?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali updated CASSANDRA-17914:
Test and Documentation Plan:
Optparse to Argparse test writeup
I copied the old optparse code (cqlshmain.py) into a new file called
optparse_test_main.py and placed it in the same folder as cqlshmain.py. Then I
created a copy of the test file (cqlsh.py) in its same folder called
optparse_test.py. I am running each argument individually on both files to see
if they get the same output.
| |Same |
|--version |yes |
|-c |Yes |
|--no-color |Yes |
|--browser |Yes |
|--ssl |Yes |
|-u |Yes |
|-p |Yes |
|-k |Yes |
|-f |Yes |
|--debug |Yes |
|--coverage |Yes |
|--encoding |Yes |
|--cqlshrc |Yes |
|--credentials |Yes |
|--cqlversion |Yes |
|--protocol-version |Yes |
|-e |Yes |
|--connect-timeout |Yes |
|--request-timeout |Yes |
|-t |Yes |
|-v |Yes |
|--insecure-password-without-warning |yes |
Status: Patch Available (was: In Progress)
> Argparse migration as the Python Optparse library is deprecated
> ---
>
> Key: CASSANDRA-17914
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17914
> Project: Cassandra
> Issue Type: Improvement
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
>
> [Deprecated since version 2.7: The optparse module is deprecated and will not
> be developed further; development will continue with the argparse
> module.|https://docs.python.org/2/library/optparse.html]
> Argparse is described in [PEP 389 – argparse - New Command Line Parsing
> Module|https://peps.python.org/pep-0389/]
>
> A partial upgrade path from
> [{{optparse}}|https://docs.python.org/3/library/optparse.html#module-optparse]
> to
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]:
> https://docs.python.org/3/library/argparse.html#upgrading-optparse-code
> * Replace all
> [{{optparse.OptionParser.add_option()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.add_option]
> calls with
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls.
> * Replace {{(options, args) = parser.parse_args()}} with {{args =
> parser.parse_args()}} and add additional
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls for the positional arguments. Keep in mind that what was previously
> called {{{}options{}}}, now in the
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]
> context is called {{{}args{}}}.
> * Replace
> [{{optparse.OptionParser.disable_interspersed_args()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.disable_interspersed_args]
> by using
> [{{parse_intermixed_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_intermixed_args]
> instead of
> [{{parse_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_args].
> * Replace callback actions and the {{callback_*}} keyword arguments with
> {{type}} or {{action}} arguments.
> * Replace string names for {{type}} keyword arguments with the corresponding
> type objects (e.g. int, float, complex, etc).
> * Replace {{optparse.Values}} with
> [{{Namespace}}|https://docs.python.org/3/library/argparse.html#argparse.Namespace]
> and {{optparse.OptionError}} and {{optparse.OptionValueError}} with
> {{{}ArgumentError{}}}.
> * Replace strings with implicit arguments such as {{%default}} or {{%prog}}
> with the standard Python syntax to use dictionaries to format strings, that
> is, {{%(default)s}} and {{{}%(prog)s{}}}.
> * Replace the OptionParser constructor {{version}} argument with a call to
> {{{}parser.add_argument('--version', action='version', version=' version>'){}}}.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
[jira] [Assigned] (CASSANDRA-17914) Argparse migration as the Python Optparse library is deprecated
[
https://issues.apache.org/jira/browse/CASSANDRA-17914?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Vineet Gali reassigned CASSANDRA-17914:
---
Assignee: Vineet Gali
> Argparse migration as the Python Optparse library is deprecated
> ---
>
> Key: CASSANDRA-17914
> URL: https://issues.apache.org/jira/browse/CASSANDRA-17914
> Project: Cassandra
> Issue Type: Improvement
> Components: CQL/Interpreter
>Reporter: Brad Schoening
>Assignee: Vineet Gali
>Priority: Normal
>
> [Deprecated since version 2.7: The optparse module is deprecated and will not
> be developed further; development will continue with the argparse
> module.|https://docs.python.org/2/library/optparse.html]
> Argparse is described in [PEP 389 – argparse - New Command Line Parsing
> Module|https://peps.python.org/pep-0389/]
>
> A partial upgrade path from
> [{{optparse}}|https://docs.python.org/3/library/optparse.html#module-optparse]
> to
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]:
> https://docs.python.org/3/library/argparse.html#upgrading-optparse-code
> * Replace all
> [{{optparse.OptionParser.add_option()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.add_option]
> calls with
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls.
> * Replace {{(options, args) = parser.parse_args()}} with {{args =
> parser.parse_args()}} and add additional
> [{{ArgumentParser.add_argument()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.add_argument]
> calls for the positional arguments. Keep in mind that what was previously
> called {{{}options{}}}, now in the
> [{{argparse}}|https://docs.python.org/3/library/argparse.html#module-argparse]
> context is called {{{}args{}}}.
> * Replace
> [{{optparse.OptionParser.disable_interspersed_args()}}|https://docs.python.org/3/library/optparse.html#optparse.OptionParser.disable_interspersed_args]
> by using
> [{{parse_intermixed_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_intermixed_args]
> instead of
> [{{parse_args()}}|https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.parse_args].
> * Replace callback actions and the {{callback_*}} keyword arguments with
> {{type}} or {{action}} arguments.
> * Replace string names for {{type}} keyword arguments with the corresponding
> type objects (e.g. int, float, complex, etc).
> * Replace {{optparse.Values}} with
> [{{Namespace}}|https://docs.python.org/3/library/argparse.html#argparse.Namespace]
> and {{optparse.OptionError}} and {{optparse.OptionValueError}} with
> {{{}ArgumentError{}}}.
> * Replace strings with implicit arguments such as {{%default}} or {{%prog}}
> with the standard Python syntax to use dictionaries to format strings, that
> is, {{%(default)s}} and {{{}%(prog)s{}}}.
> * Replace the OptionParser constructor {{version}} argument with a call to
> {{{}parser.add_argument('--version', action='version', version=' version>'){}}}.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
-
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
