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

Publish RuboCop::LSP.enable to enable LSP mode #12679

Merged
merged 1 commit into from Feb 9, 2024

Conversation

koic
Copy link
Member

@koic koic commented Feb 8, 2024

RuboCop::Cop::Base.enable_lsp_mode will be renamed to RuboCop::LSP.enable.

Before:

RuboCop::Cop::Base.enable_lsp_mode

After:

RuboCop::LSP.enable

This is because whether or not it is LSP should not be set per cop but should be a state controlled for the entire RuboCop process.

Since RuboCop::Cop::Base.enable_lsp_mode was an experimental private API, it will be renamed without a deprecation warning.

Along with this, the module name has been changed from RuboCop::Lsp to RuboCop::LSP. This change is made to align with Ruby's standard API, like RubyVM::YJIT.enable, making it RuboCop::LSP.enable instead. RuboCop::Lsp.enable does not look as pretty name.

With the renaming to RuboCop::LSP.enable, the usage of this API will be documented. This allows libraries like Ruby LSP and Solargraph, which use internal modules other than RuboCop's built-in RuboCop::LSP::Server#start, to easily utilize the features in #12586 and #12657.


Before submitting the PR make sure the following are checked:

  • The PR relates to only one subject with a clear title and description in grammatically correct, complete sentences.
  • Wrote good commit messages.
  • Commit message starts with [Fix #issue-number] (if the related issue exists).
  • Feature branch is up-to-date with master (if not - rebase it).
  • Squashed related commits together.
  • Added tests.
  • Ran bundle exec rake default. It executes all tests and runs RuboCop on its own code.
  • Added an entry (file) to the changelog folder named {change_type}_{change_description}.md if the new code introduces user-observable changes. See changelog entry format for details.

`RuboCop::Cop::Base.enable_lsp_mode` will be renamed to `RuboCop::LSP.enable`.

Before:

```ruby
RuboCop::Cop::Base.enable_lsp_mode
```

After:

```ruby
RuboCop::LSP.enable
```

This is because whether or not it is LSP should not be set per cop
but should be a state controlled for the entire RuboCop process.

Since `RuboCop::Cop::Base.enable_lsp_mode` was an experimental private API,
it will be renamed without a deprecation warning.

Along with this, the module name has been changed from `RuboCop::Lsp` to `RuboCop::LSP`.
This change is made to align with Ruby's standard API, like `RubyVM::YJIT.enable`,
making it `RuboCop::LSP.enable` instead. `RuboCop::Lsp.enable` does not look as pretty name.

With the renaming to `RuboCop::LSP.enable`, the usage of this API will be documented.
This allows libraries like Ruby LSP and Solargraph, which use internal modules other than
RuboCop's built-in `RuboCop::LSP::Server#start`, to easily utilize the features in rubocop#12586 and rubocop#12657.
@bbatsov bbatsov merged commit 3f9a75a into rubocop:master Feb 9, 2024
32 checks passed
@bbatsov
Copy link
Collaborator

bbatsov commented Feb 9, 2024

Good change!

@koic koic deleted the publish_lsp_enable_api branch February 9, 2024 08:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants