mirror of
https://github.com/pytorch/pytorch.git
synced 2025-10-20 12:54:11 +08:00
Modernize the development installation:
```bash
# python setup.py develop
python -m pip install --no-build-isolation -e .
# python setup.py install
python -m pip install --no-build-isolation .
```
Now, the `python setup.py develop` is a wrapper around `python -m pip install -e .` since `setuptools>=80.0`:
- pypa/setuptools#4955
`python setup.py install` is deprecated and will emit a warning during run. The warning will become an error on October 31, 2025.
- 9c4d383631/setuptools/command/install.py (L58-L67)
> ```python
> SetuptoolsDeprecationWarning.emit(
> "setup.py install is deprecated.",
> """
> Please avoid running ``setup.py`` directly.
> Instead, use pypa/build, pypa/installer or other
> standards-based tools.
> """,
> see_url="https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html",
> due_date=(2025, 10, 31),
> )
> ```
- pypa/setuptools#3849
Additional Resource:
- [Why you shouldn't invoke setup.py directly](https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html)
Pull Request resolved: https://github.com/pytorch/pytorch/pull/156027
Approved by: https://github.com/ezyang
45 lines
1.0 KiB
Markdown
45 lines
1.0 KiB
Markdown
# JIT C++ Tests
|
|
|
|
## Adding a new test
|
|
First, create a new test file. Test files should have be placed in this
|
|
directory, with a name that starts with `test_`, like `test_foo.cpp`.
|
|
|
|
In general a single test suite
|
|
|
|
Add your test file to the `JIT_TEST_SRCS` list in `test/cpp/jit/CMakeLists.txt`.
|
|
|
|
A test file may look like:
|
|
```cpp
|
|
#include <gtest/gtest.h>
|
|
|
|
using namespace ::torch::jit
|
|
|
|
TEST(FooTest, BarBaz) {
|
|
// ...
|
|
}
|
|
|
|
// Append '_CUDA' to the test case name will automatically filter it out if CUDA
|
|
// is not compiled.
|
|
TEST(FooTest, NeedsAGpu_CUDA) {
|
|
// ...
|
|
}
|
|
|
|
// Similarly, if only one GPU is detected, tests with `_MultiCUDA` at the end
|
|
// will not be run.
|
|
TEST(FooTest, NeedsMultipleGpus_MultiCUDA) {
|
|
// ...
|
|
}
|
|
```
|
|
|
|
## Building and running the tests
|
|
The following commands assume you are in PyTorch root.
|
|
|
|
```bash
|
|
# ... Build PyTorch from source, e.g.
|
|
python -m pip install --no-build-isolation -v -e .
|
|
# (re)build just the binary
|
|
ninja -C build bin/test_jit
|
|
# run tests
|
|
build/bin/test_jit --gtest_filter='glob_style_filter*'
|
|
```
|