From dd71dbc969218f097a383014276c63d170ce9b2f Mon Sep 17 00:00:00 2001 From: Davide <579771+davidedelvento@users.noreply.github.com> Date: Thu, 20 Feb 2020 14:58:23 -0700 Subject: [PATCH 1/4] Fixing installation instructions per issue#656 --- transcrypt/docs/sphinx/installation_use.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/transcrypt/docs/sphinx/installation_use.rst b/transcrypt/docs/sphinx/installation_use.rst index 0acb1406a..328236c17 100644 --- a/transcrypt/docs/sphinx/installation_use.rst +++ b/transcrypt/docs/sphinx/installation_use.rst @@ -24,9 +24,9 @@ To enable minification, additionally the Java Runtime Environment 6 or later has You can test your installation as follows (replacing *transcrypt* by *run_transcrypt* if you installed manually rather than with pip): 1. Go to directory *../Transcrypt-/transcrypt/development/automated_tests/transcrypt* -2. From the command prompt run *transcrypt -b -c -da autotest*. This will compile the autotests into a number of .js files and put them into the *__target__* subdirectory. Do NOT go to that directory (there's no need, stay where you went at point 4) -3. From the command prompt run *transcrypt -r -c autotest*. This will run the autotests with CPython creating file *autotest.html* that refers to the generated *autotest.js* file -4. Start a http server from the command prompt by typing *python -m http.server*, or, dependent on your installation *python3 -m http.server*. In the address bar of your browser, type *localhost:8000/animals.html*. This will load the autotest, run it and compare the output with what was generated by CPython. It should report no errors +2. From the command prompt run *call run_transcrypt -xr -n -b -da -xg -c -sf autoTest*. This will compile the autotests into a number of .js files and put them into the *__target__* subdirectory. Do NOT go to that directory (there's no need, stay where you went at the previous bullet point) +3. From the command prompt run *transcrypt -r -xr -n -b -da -xg -c -sf autotest*. This will run the autotests with CPython creating file *autotest.html* that refers to the generated *autotest.js* file +4. Start a http server from the command prompt by typing *python -m http.server*, or, dependent on your installation *python3 -m http.server*. In the address bar of your browser, type *http://localhost:8000/autotest.html*. This will load the autotest, run it and compare the output with what was generated by CPython. It should show a table with the number of errors for each test case (which should be zero for all of them) and a summary Status field at the top which should say *Test succeeded* To experiment with Transcrypt yourself: From 3f36026f619b97fc68bfdbd9a28816c902f40aa6 Mon Sep 17 00:00:00 2001 From: Davide <579771+davidedelvento@users.noreply.github.com> Date: Thu, 20 Feb 2020 15:01:41 -0700 Subject: [PATCH 2/4] fixing a copy-paste issue --- transcrypt/docs/sphinx/installation_use.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/transcrypt/docs/sphinx/installation_use.rst b/transcrypt/docs/sphinx/installation_use.rst index 328236c17..1e52cefa6 100644 --- a/transcrypt/docs/sphinx/installation_use.rst +++ b/transcrypt/docs/sphinx/installation_use.rst @@ -24,7 +24,7 @@ To enable minification, additionally the Java Runtime Environment 6 or later has You can test your installation as follows (replacing *transcrypt* by *run_transcrypt* if you installed manually rather than with pip): 1. Go to directory *../Transcrypt-/transcrypt/development/automated_tests/transcrypt* -2. From the command prompt run *call run_transcrypt -xr -n -b -da -xg -c -sf autoTest*. This will compile the autotests into a number of .js files and put them into the *__target__* subdirectory. Do NOT go to that directory (there's no need, stay where you went at the previous bullet point) +2. From the command prompt run *transcrypt -xr -n -b -da -xg -c -sf autoTest*. This will compile the autotests into a number of .js files and put them into the *__target__* subdirectory. Do NOT go to that directory (there's no need, stay where you went at the previous bullet point) 3. From the command prompt run *transcrypt -r -xr -n -b -da -xg -c -sf autotest*. This will run the autotests with CPython creating file *autotest.html* that refers to the generated *autotest.js* file 4. Start a http server from the command prompt by typing *python -m http.server*, or, dependent on your installation *python3 -m http.server*. In the address bar of your browser, type *http://localhost:8000/autotest.html*. This will load the autotest, run it and compare the output with what was generated by CPython. It should show a table with the number of errors for each test case (which should be zero for all of them) and a summary Status field at the top which should say *Test succeeded* From 2a8a42cc102cecaf283bc359895826f444fad843 Mon Sep 17 00:00:00 2001 From: Davide <579771+davidedelvento@users.noreply.github.com> Date: Thu, 20 Feb 2020 15:03:35 -0700 Subject: [PATCH 3/4] fixing case --- transcrypt/docs/sphinx/installation_use.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/transcrypt/docs/sphinx/installation_use.rst b/transcrypt/docs/sphinx/installation_use.rst index 1e52cefa6..0b3d20a0b 100644 --- a/transcrypt/docs/sphinx/installation_use.rst +++ b/transcrypt/docs/sphinx/installation_use.rst @@ -24,7 +24,7 @@ To enable minification, additionally the Java Runtime Environment 6 or later has You can test your installation as follows (replacing *transcrypt* by *run_transcrypt* if you installed manually rather than with pip): 1. Go to directory *../Transcrypt-/transcrypt/development/automated_tests/transcrypt* -2. From the command prompt run *transcrypt -xr -n -b -da -xg -c -sf autoTest*. This will compile the autotests into a number of .js files and put them into the *__target__* subdirectory. Do NOT go to that directory (there's no need, stay where you went at the previous bullet point) +2. From the command prompt run *transcrypt -xr -n -b -da -xg -c -sf autotest*. This will compile the autotests into a number of .js files and put them into the *__target__* subdirectory. Do NOT go to that directory (there's no need, stay where you went at the previous bullet point) 3. From the command prompt run *transcrypt -r -xr -n -b -da -xg -c -sf autotest*. This will run the autotests with CPython creating file *autotest.html* that refers to the generated *autotest.js* file 4. Start a http server from the command prompt by typing *python -m http.server*, or, dependent on your installation *python3 -m http.server*. In the address bar of your browser, type *http://localhost:8000/autotest.html*. This will load the autotest, run it and compare the output with what was generated by CPython. It should show a table with the number of errors for each test case (which should be zero for all of them) and a summary Status field at the top which should say *Test succeeded* From 5ac2db7215431cf5f93464b5db5b4848172f77c2 Mon Sep 17 00:00:00 2001 From: Davide <579771+davidedelvento@users.noreply.github.com> Date: Thu, 20 Feb 2020 15:05:14 -0700 Subject: [PATCH 4/4] Clarifying that it does not work with earlier python versions --- transcrypt/docs/sphinx/installation_use.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/transcrypt/docs/sphinx/installation_use.rst b/transcrypt/docs/sphinx/installation_use.rst index 0b3d20a0b..1f4283e57 100644 --- a/transcrypt/docs/sphinx/installation_use.rst +++ b/transcrypt/docs/sphinx/installation_use.rst @@ -4,7 +4,7 @@ Getting started Installation ------------ -Transcrypt is currently tested under Windows, Linux and OSX, with Chrome, Internet Explorer and Firefox. To be able to use it, Python 3.7 has to be installed. After that, install *virtualenv* as explained in `Jamie Matthews very clear and brief introduction `_. Be sure to install virtualenv for the right Python version, by using the right *pip*. For each Transcrypt project (or group of projects using the same Transcrypt version) create an environment as described in the referenced introduction. To install Trancrypt into that environment, *activate* the environment as also described there, and then type: +Transcrypt is currently tested under Windows, Linux and OSX, with Chrome, Internet Explorer and Firefox. To be able to use it, Python 3.7 has to be installed (Transcrypt will not work with any earlier versions, including the whole Python 3.6 series). After that, install *virtualenv* as explained in `Jamie Matthews very clear and brief introduction `_. Be sure to install virtualenv for the right Python version, by using the right *pip*. For each Transcrypt project (or group of projects using the same Transcrypt version) create an environment as described in the referenced introduction. To install Trancrypt into that environment, *activate* the environment as also described there, and then type: *pip install transcrypt*