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: readme.md
+9-19Lines changed: 9 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,29 +1,19 @@
1
-
# UENV 2
1
+
# UENV
2
2
3
-
Documentation for uenv2 is available on the [new cscs documentation](https://eth-cscs.github.io/cscs-docs/software/uenv/).
4
-
5
-
A rewrite of uenv in C++:
6
-
* deployed as static binaries
7
-
* no longer supports modification of the environment in the calling shell
8
-
* bring the CLI and Slurm plugin under one roof, with a common library
9
-
10
-
Some old features are gone:
11
-
*`uenv view` and `uenv modules` have been removed - the tool can no longer modify the environment of the calling shell
12
-
* all views must be loaded with the `--view` flag on `uenv run` and `uenv start`
13
-
* or using the `--view` flag of `srun` and `sbatch`.
3
+
Documentation for uenv is available on the [CSCS documentation](https://eth-cscs.github.io/cscs-docs/software/uenv/).
14
4
15
5
## Alps quickstart
16
6
17
7
> Before running the build script, install [uv](https://docs.astral.sh/uv/getting-started/installation/), which is used to provide meson and ninja for the build.
18
8
19
-
To take uenv2 for a test drive on alps,
9
+
To take uenv for a test drive on alps,
20
10
21
11
```
22
-
git clone https://github.com/eth-cscs/uenv2.git
12
+
git clone https://github.com/eth-cscs/uenv.git
23
13
24
-
cd uenv2
14
+
cd uenv
25
15
26
-
# this script will build uenv2, and install it in $HOME/.local/$(uname -m)/bin
16
+
# this script will build uenv, and install it in $HOME/.local/$(uname -m)/bin
27
17
./install-alps-local.sh
28
18
```
29
19
@@ -55,7 +45,7 @@ There are 4 main components that can be enabled/disabled
55
45
56
46
57
47
```bash
58
-
cduenv2
48
+
cduenv
59
49
60
50
# make a build directory
61
51
mkdir build
@@ -77,7 +67,7 @@ Install [uv](https://docs.astral.sh/uv/getting-started/installation/) to use app
77
67
78
68
The following will build the cli, and run tests, on an Alps system:
79
69
```bash
80
-
# from a build directory inside the uenv2 repository
70
+
# from a build directory inside the uenv repository
81
71
alias e="uvx --with meson,ninja"
82
72
CXX=g++-12 e meson setup -Dtests=enabled ..
83
73
e meson compile
@@ -134,7 +124,7 @@ meson test unit
134
124
Running the `squashfs-mount` tests requires an additional step, because it has to be installed as [setuid](https://en.wikipedia.org/wiki/Setuid).
0 commit comments