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

deprecate config.globOptions #1152

Merged
merged 1 commit into from
Jun 14, 2024
Merged

deprecate config.globOptions #1152

merged 1 commit into from
Jun 14, 2024

Conversation

nfischer
Copy link
Member

This removes support for configuring config.globOptions. Exposing this variable makes it difficult to change (or upgrade) our glob library. It's best to consider our choice of glob library to be an implementation detail.

As far as I know, this is not a commonly used option: https://github.com/shelljs/shelljs/issues?q=globOptions currently shows no GitHub issues of users using this option, and there was never really a motivation for why this needed to be exposed (#400 exposed the option just because we could, not because we should).

This is one step toward supporting Issue #828.

@nfischer nfischer added the breaking Breaking change label Feb 18, 2024
Copy link

codecov bot commented Feb 18, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 97.28%. Comparing base (c3797a9) to head (04a30d1).

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #1152   +/-   ##
=======================================
  Coverage   97.27%   97.28%           
=======================================
  Files          36       36           
  Lines        1360     1361    +1     
=======================================
+ Hits         1323     1324    +1     
  Misses         37       37           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@nfischer
Copy link
Member Author

Let me see if it is possible to deprecate this but keep maintaining it for the time being (e.g., add the test cases back). I need to see if that approach will be compatible with PR #1153.

This deprecates support for configuring `config.globOptions`. Exposing
this variable makes it difficult to change (or upgrade) our glob
library. This discourages users from depending on this config option
going forward.

If anyone is using `config.globOptions` then it should continue to
function, however this support is not promised for the long-term.

As far as I know, this is not a commonly used option:
https://github.com/shelljs/shelljs/issues?q=globOptions currently shows
no GitHub issues of users using this option, and there was never really
a motivation for why this needed to be exposed (#400 exposed the option
just because we could, not because we should).

This is one step toward supporting Issue #828.
@nfischer nfischer removed the breaking Breaking change label Jun 14, 2024
@nfischer
Copy link
Member Author

It does look like there's some usage of this option when I search all of GitHub: https://github.com/search?q=shell.config.globOptions&type=code

So I think the plan should be: deprecate official support, but don't break existing usage. I'll remove the "breaking" label since this technically is not a breaking change anymore.

@nfischer nfischer merged commit d81c325 into master Jun 14, 2024
76 checks passed
@nfischer nfischer deleted the deprecate-glob-options branch June 14, 2024 20:07
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

1 participant