8000 Document windows known issues · oracle/graalpython@cb34120 · GitHub
[go: up one dir, main page]
Skip to content

Commit cb34120

Browse files
timfeltimfel
committed
Document windows known issues
1 parent 0bc1623 commit cb34120

File tree

1 file changed

+13
-2
lines changed

1 file changed

+13
-2
lines changed

‎docs/user/README.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,19 @@ To try GraalPy with a full GraalVM, including support for Java embedding and int
4848

4949
### Windows
5050

51-
There is currently no installer for Windows.
52-
Instead, follow [these instructions](https://github.com/oracle/graalpython#user-content-building-from-source) to build GraalPy from source.
51+
There is a preview binary build of Windows that you can download via [www.graalvm.org](https://www.graalvm.org/downloads/).
52+
The Windows build has several known issues:
53+
54+
- JLine treats Windows a dumb terminal, no autocomplete and limited editing capabilities in the REPL
55+
- Interactive help() in the REPL doesn't work
56+
- Oracle GraalPy builds cannot create venvs or install packages, use community GraalPy builds to do those things.
57+
- Inside venvs:
58+
- graalpy.cmd and graalpy.exe are broken
59+
- pip.exe cannot be used directly
60+
- pip has trouble with cache file loading, use `--no-cache-dir`
61+
- Only pure Python binary wheels can be installed, no native extensions or source builds
62+
- To install a package, use `myvenv/Scripts/python.cmd -m pip --no-cache-dir install <pkg>`
63+
- Running from PowerShell works better than running from CMD, various scripts will fail on the latter
5364

5465
## Running Python
5566

0 commit comments

Comments
 (0)
0