Skip to content

Commit 7eb4a0a

Browse files
committed
explain installing and using py-3.8.3 to run locally
1 parent 1fdb52d commit 7eb4a0a

File tree

1 file changed

+12
-15
lines changed

1 file changed

+12
-15
lines changed

README.md

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Python-3.8 such as that provided by
6060
First install [Docker](https://www.docker.com/products/docker-desktop). Once
6161
installed, start the Docker desktop application.
6262

63-
Next check out or download the glowscript repository. Then:
63+
Next check out or download the glowscript repository. Then, in a terminal window, change directory to the glowscript repository and type:
6464

6565
docker-compose up
6666

@@ -80,28 +80,25 @@ When you're finished, shut down the system with:
8080

8181
To run a local webserver with only the datastore in Docker, but the
8282
webserver itself running natively you need Python-3.8.3. The easiest method
83-
is probably to install [anaconda](https://docs.anaconda.com/anaconda/install/) (or [miniconda](https://docs.conda.io/en/latest/miniconda.html), if you don't want the GUI package manager and extra applications). Once you have that you need to check out
84-
the glowscript repository.
85-
(How you do this depends on your familiarity with git. The simplest is to download a .zip file of the repository [here](https://github.com/vpython/glowscript/archive/refs/heads/master.zip))
86-
First "cd" to the `glowscript` directory (the root directory of the repository)
87-
and create a virtual environment for glowscript like so:
83+
is probably to install [anaconda](https://docs.anaconda.com/anaconda/install/) (or [miniconda](https://docs.conda.io/en/latest/miniconda.html), if you don't want the GUI package manager and extra applications). With Anaconda or miniconda you can use the `conda` command to do this, for example:
8884

89-
cd /path/to/glowscript
90-
python -m venv venv
85+
conda install -n py383 python=3.8.3
86+
conda activate py383
9187

92-
This will build a virtual environment for running locally. To activiate the virtual environment:
88+
Your terminal prompt should now have a `(py383)` indicating that you have
89+
activated the python-3.8.3 virtual environment. Once you have that you need to check out the glowscript repository. (How you do this depends on your familiarity with git. The simplest is to download a .zip file of the repository [here](https://github.com/vpython/glowscript/archive/refs/heads/master.zip))
90+
Next change directory to the glowscript repository:
9391

94-
mac: source venv/bin/activate
95-
windows (power shell): venv\Scripts\Activate.ps1
96-
windows (cmd.exe shell): venv\Scripts\activate.bat
92+
cd /path/to/glowscript
9793

98-
Your terminal prompt should now have a `(venv)` indicating that you have
99-
activated the glowscript virtual environment. Before you can run glowscript the
94+
Before you can run glowscript the
10095
first time, you'll need to install dependencies into the virtual environment.
10196
This can be done with pip:
10297

10398
pip install -r requirements.txt
10499

100+
If you encounter any problems, follow the suggestions provided by the error messages.
101+
105102
In order to run the local datastore emulator it's easiest to use
106103
[Docker](https://www.docker.com/products/docker-desktop). Download
107104
a version of Docker that works with your OS. To test that you've
@@ -135,7 +132,7 @@ When you're finished hit ctrl-c and then type:
135132

136133
To stop the background datastore emulator.
137134

138-
Then next time you're ready to develop, you can simply activate the environment again (make sure you see the "(venv)" in the shell prompt) and type:
135+
Then next time you're ready to develop, you can simply activate the environment again (make sure you see the "(py383)" in the shell prompt) and type:
139136

140137
docker-compose -f docker-datastore.yml up -d
141138

0 commit comments

Comments
 (0)