[
https://issues.apache.org/jira/browse/CASSANDRA-17684?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Brad Schoening updated CASSANDRA-17684:
---------------------------------------
Description:
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 = [ f"\{pkgpath}/doc/cql3/CQL.html', "/usr/share/doc/cassandra/CQL.html",
"{color:#4c9aff}/usr/local/share{color}/doc/cassandra/CQL.html" ]
item = next((x.as_uri() for x in loc if Path( x ).exists()), 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]
was:
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]
> 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
> 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 = [ f"\{pkgpath}/doc/cql3/CQL.html', "/usr/share/doc/cassandra/CQL.html",
> "{color:#4c9aff}/usr/local/share{color}/doc/cassandra/CQL.html" ]
> item = next((x.as_uri() for x in loc if Path( x ).exists()), 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
