You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/user/Embedding-Build-Tools.md
+2-34Lines changed: 2 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -53,13 +53,10 @@ The factory methods in [GraalPyResources](https://github.com/oracle/graalpython/
53
53
-`${root}/venv`: used for the Python virtual environment holding installed third-party Python packages.
54
54
The Context will be configured as if it is executed from this virtual environment. Notably packages installed in this
55
55
virtual environment will be automatically available for importing.
56
-
-`${root}/home`: used for the Python standard library (equivalent to `PYTHONHOME` environment variable).
57
56
58
-
The Maven or Gradle plugin will fully manage the contents of the `venv`and `home` subdirectories.
59
-
Any manual changes in these directories will be overridden by the plugin during the build.
57
+
The Maven or Gradle plugin will fully manage the contents of the `venv`subdirectory.
58
+
Any manual change will be overridden by the plugin during the build.
60
59
-`${root}/venv`: the plugin creates a virtual environment and installs required packages according to the plugin configuration in _pom.xml_ or _build.gradle_.
61
-
-`${root}/home`: the plugin copies the required (also configurable) parts of the Python standard library into this directory.
62
-
By default, the full standard library is used.
63
60
64
61
The _src_ subdirectory is left to be manually populated by the user with custom Python scripts or modules.
65
62
@@ -88,24 +85,6 @@ The **packages** element declares a list of third-party Python packages to be do
88
85
...
89
86
</configuration>
90
87
```
91
-
- The **pythonHome** subsection declares what parts of the standard library should be deployed.
92
-
93
-
Each `include` and `exclude` element is interpreted as a Java-like regular expression specifying which file paths should be included or excluded.
94
-
```xml
95
-
<configuration>
96
-
<pythonHome>
97
-
<includes>
98
-
<include>.*</include>
99
-
...
100
-
</includes>
101
-
<excludes>
102
-
<exclude></exclude>
103
-
...
104
-
</excludes>
105
-
</pythonHome>
106
-
...
107
-
</configuration>
108
-
```
109
88
- If the **pythonResourcesDirectory** element is specified, then the given directory is used as an [external directory](#external-directory) and no Java resources are embedded.
110
89
Remember to use the appropriate `GraalPyResources` API to create the Context.
111
90
```xml
@@ -140,17 +119,6 @@ The plugin can be configured in the `graalPy` block:
140
119
...
141
120
}
142
121
```
143
-
- The **pythonHome** subsection declares what parts of the standard library should be deployed.
144
-
Each element in the `includes` and `excludes` list is interpreted as a Java-like regular expression specifying which file paths should be included or excluded.
145
-
```
146
-
graalPy {
147
-
pythonHome {
148
-
includes = [".*"]
149
-
excludes = []
150
-
}
151
-
...
152
-
}
153
-
```
154
122
- If the **pythonResourcesDirectory** element is specified, then the given directory is used as an [external directory](#external-directory) and no Java resources are embedded.
155
123
Remember to use the appropriate `GraalPyResources` API to create the Context.
0 commit comments