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

[train/tune] Raise actionable error message for missing dependencies #38497

Merged
merged 3 commits into from
Aug 17, 2023

Conversation

krfricke
Copy link
Contributor

Why are these changes needed?

When users pip install ray but not ray[train]/ray[tune], they can run into confusing error messages, such as:

ModuleNotFoundError: No module named 'pyarrow'

With this PR, we import the core library requirements in the respective __init__.py and raise an actionable error message if they are not found:

ImportError: Can't import ray.train as some dependencies are missing. Run `pip install ray[train]` to fix.

Related issue number

Checks

  • I've signed off every commit(by using the -s flag, i.e., git commit -s) in this PR.
  • I've run scripts/format.sh to lint the changes in this PR.
  • I've included any doc changes needed for https://docs.ray.io/en/master/.
    • I've added any new APIs to the API Reference. For example, if I added a
      method in Tune, I've added it in doc/source/tune/api/ under the
      corresponding .rst file.
  • I've made sure the tests are passing. Note that there might be a few flaky tests, see the recent failures at https://flakey-tests.ray.io/
  • Testing Strategy
    • Unit tests
    • Release tests
    • This PR is not tested :(

Kai Fricke added 2 commits August 16, 2023 17:46
Signed-off-by: Kai Fricke <kai@anyscale.com>
Signed-off-by: Kai Fricke <kai@anyscale.com>
Copy link
Contributor

@justinvyu justinvyu left a comment

Choose a reason for hiding this comment

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

LGTM with one small nit.

Also, let's add fsspec as a required dependency of train/tune in a follow-up and make sure to do the same for that.

python/ray/train/__init__.py Outdated Show resolved Hide resolved
Signed-off-by: Kai Fricke <kai@anyscale.com>
Copy link
Contributor

@ericl ericl left a comment

Choose a reason for hiding this comment

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

Nice!

@ericl ericl added the @author-action-required The PR author is responsible for the next step. Remove tag to send back to the reviewer. label Aug 16, 2023
@krfricke krfricke merged commit 0a4bc10 into ray-project:master Aug 17, 2023
57 of 62 checks passed
@krfricke krfricke deleted the train/import-guard branch August 17, 2023 09:12
arvind-chandra pushed a commit to lmco/ray that referenced this pull request Aug 31, 2023
…ay-project#38497)

When users `pip install ray` but not `ray[train]`/`ray[tune]`, they can run into confusing error messages, such as:

```
ModuleNotFoundError: No module named 'pyarrow'
```

With this PR, we import the core library requirements in the respective `__init__.py` and raise an actionable error message if they are not found:

```
ImportError: Can't import ray.train as some dependencies are missing. Run `pip install ray[train]` to fix.
```

Signed-off-by: Kai Fricke <kai@anyscale.com>
Signed-off-by: e428265 <arvind.chandramouli@lmco.com>
vymao pushed a commit to vymao/ray that referenced this pull request Oct 11, 2023
…ay-project#38497)

When users `pip install ray` but not `ray[train]`/`ray[tune]`, they can run into confusing error messages, such as:

```
ModuleNotFoundError: No module named 'pyarrow'
```

With this PR, we import the core library requirements in the respective `__init__.py` and raise an actionable error message if they are not found:

```
ImportError: Can't import ray.train as some dependencies are missing. Run `pip install ray[train]` to fix.
```

Signed-off-by: Kai Fricke <kai@anyscale.com>
Signed-off-by: Victor <vctr.y.m@example.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
@author-action-required The PR author is responsible for the next step. Remove tag to send back to the reviewer.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants