Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Mention non-support for VSCodium in README #1322

Closed
wants to merge 2 commits into from

Conversation

rogermparent
Copy link
Contributor

This PR mentions in the README that we do not suppport VSCodium, and that it has known issues with the Python extension that we integrate with.

Fixes #1318

@rogermparent rogermparent self-assigned this Feb 15, 2022
@rogermparent rogermparent changed the title Mention VSCodium in README Mention non-support for VSCodium in README Feb 15, 2022
@codeclimate
Copy link

codeclimate bot commented Feb 15, 2022

Code Climate has analyzed commit e38b87d and detected 0 issues on this pull request.

The test coverage on the diff in this pull request is 100.0% (85% is the threshold).

This pull request will bring the total coverage in the repository to 96.3% (0.0% change).

View more on Code Climate.

README.md Outdated

## VSCode Forks

While the DVC Extension can work with VSCode forks like
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[C] We do have some other mentions of VSCode in the repo but I think that VS Code is actually correct. See https://code.visualstudio.com/.

README.md Outdated
[VSCodium](https://vscodium.com/), our team only supports the official Microsoft
build and it's possible that issues can arise. The Python extension in
particular has problems with VSCodium, and often causes our extension's
integration with it to fail.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[F] This is not a show stopper as users can still "setup the workspace" and everything will still work:

image

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Setup the workspace is the second step in the walkthrough:

image

Copy link
Member

@mattseddon mattseddon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IMO if a user is using VSCodium and the python extension then they should know that sometimes it stops working. They will have also had to mess with VSCodium to get Pylance to work. No worries on merging this but feels like a very unusual case.

@rogermparent
Copy link
Contributor Author

IMO if a user is using VSCodium and the python extension then they should know that sometimes it stops working. They will have also had to mess with VSCodium to get Pylance to work.

I'll admit it is a bit niche, but on a few Linux distros the default install of code in the package manager is VSCodium and the user actually has to go slightly out of their way to install MS VS Code, so it's completely possible for a user to end up in this state without taking extra power user steps (beyond the amount that one would be running Linux and DVC).

When installing the Python extension in VSCodium, the parts that don't work are automatically omitted and a limited set of features (mostly virtual environments) "just work".

Good point that even if the user's in the situation of DVC in a venv they can manually set up the workspace, I'll modify the text. My main concern in that this is a silent error so if a user does encounter it, our extension will mysteriously fail even though the Python extension looks like it's working fine outside of the console.

@mattseddon
Copy link
Member

When installing the Python extension in VSCodium, the parts that don't work are automatically omitted and a limited set of features (mostly virtual environments) "just work".

That would not be enough for a normal Python user. Imagine IntelliSense not working for JavaScript in your IDE, you'd either fix it or move to another IDE.

@rogermparent
Copy link
Contributor Author

Fair point, I'll close this and keep the case in mind if we ever run into it when public release comes around.

@mattseddon mattseddon deleted the mention-vscodium-in-readme branch March 3, 2022 22:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Python extension integration does not work with Code OSS / VSCodium
2 participants