[BUG] Correct documentation for installing sub packages like language-server and so on

[faizanazim11]

Please describe.
I need to integrate robotcode language server in my project with Monaco Editor.

I went through docs here, but when I try to install robotcode with language-server option I get a warning:

WARNING: robotcode 1.8.0 does not provide the extra 'language-server'

After installation of robotcode when I try the command language-server it gives error:

Error: No such command 'language-server'.

When I try with help I am not able to see language-server command in the list as well.

Usage: robotcode [OPTIONS] COMMAND [ARGS]...

---

| __ \ | | | | / | | |
| |) | | |__ ___ | || | ___ _| | ___
| _ // _ | ' \ / _ | __| | / _ \ / _ |/ _
| | \ \ () | |) | () | || || () | (| | __/
|| __/|_./ _/ _|_____/ _,|___|
A CLI tool for Robot Framework.

Options:
-c, --config PATH * Config file to use. If not specified, the default config file is used.
[env var: ROBOTCODE_CONFIG_FILES]
-p, --profile TEXT * The Execution Profile to use. If not specified, the default profile is used.
[env var: ROBOTCODE_PROFILES]
-r, --root DIRECTORY Specifies the root path to be used for the project. It will be automatically
detected if not provided. [env var: ROBOTCODE_ROOT]
--no-vcs Ignore version control system directories (e.g., .git, .hg) when detecting the
project root. [env var: ROBOTCODE_NO_VCS]
-f, --format [toml|json|json_indent|text]
Set the output format.
-d, --dry Dry run, do not execute any commands. [env var: ROBOTCODE_DRY]
--color / --no-color Whether or not to display colored output (default is auto-detection). [env var:
ROBOTCODE_COLOR]
--pager / --no-pager Whether or not use a pager to display long text or data. [env var: ROBOTCODE_PAGER]
-v, --verbose Enables verbose mode. [env var: ROBOTCODE_VERBOSE]
--log Enables logging. [env var: ROBOTCODE_LOG]
--log-level [TRACE|DEBUG|INFO|WARNING|ERROR|CRITICAL]
Sets the log level. [env var: ROBOTCODE_LOG_LEVEL; default: CRITICAL]
--log-format TEXT Sets the log format. See python logging documentation for more information. [env
var: ROBOTCODE_LOG_FORMAT; default: %(levelname)s:%(name)s:%(message)s]
--log-style [%|{|$] Sets the log style. See python logging documentation for more information. [env
var: ROBOTCODE_LOG_STYLE; default: %]
--log-filename FILE Write log output to a file instead to console. [env var: ROBOTCODE_LOG_FILENAME]
--log-calls Enables logging of method/function calls. [env var: ROBOTCODE_LOG_CALLS]
--log-config FILE Path to a logging configuration file. This must be a valid Python logging
configuration file in JSON format. If this option is set, the other logging options
are ignored. [env var: ROBOTCODE_LOG_CONFIG]
--version Show the version and exit.
--help Show this message and exit.

Commands:
config Shows information about the configuration.
profiles Shows information on defined profiles.

Desktop (please complete the following information):

• VS Code Version [e.g. 1.60] - Not required VS Code
• RobotCode Version [e.g. 0.3.2] - 1.8.0
• OS: [e.g. Windows, Linux] - Windows
• Python Version [e.g. 3.9.7] - 3.10.0
• RobotFramework Version [e.g. 4.0.0] - 4.1
• Additional tools like robocop, robotidy

[faizanazim11]

Update:

I found this page, and installing language server separately added the language-server command option to robotcode.

Still some clarity would be nice.

[d-biehl]

You can find this in the CLI reference: https://robotcode.io/03_reference/cli

What did you expect, and where would you expect it to be?
If anything’s unclear or missing, let me know and we can improve it.

[faizanazim11]

The additional package installation command is not working and also robotcode-language-server as a package is not mentioned in docs. If this can be improved that will help others as well.

[d-biehl]

Can you explain a little bit more?

for me both ways are working:

pip install robotcode[language-server]

or

pip install robotcode-language-server

do you get any errors?

The second way is not documented in the docs, because the first way is the prefered way. If you know Python, you can also use the second way.

[faizanazim11]

For me the first method is not working.

Can you try installing in a new python env.

I have mentioned the error that I am getting in the description.

[faizanazim11]

robotcode/pyproject.toml

Line 75 in a6ffcf5

languageserver = ["robotcode-language-server==1.8.0"]

Check this line, the - is missing in language-server

This might be causing the issue.

pip install robotcode[languageserver]

For me this command is working instead which is not same as the documentation. I think either one of them should be updated.

[d-biehl]

ahh, know I got it, sorry ;-)

I will correct that in the documentation.
I will relabel this as a bug for the documentation.