[
https://issues.apache.org/jira/browse/BEAM-4471?focusedWorklogId=125644&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-125644
]
ASF GitHub Bot logged work on BEAM-4471:
----------------------------------------
Author: ASF GitHub Bot
Created on: 20/Jul/18 20:42
Start Date: 20/Jul/18 20:42
Worklog Time Spent: 10m
Work Description: asfgit closed pull request #505: [BEAM-4471] Update
Python QuickStart with Windows instructions
URL: https://github.com/apache/beam-site/pull/505
This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:
As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):
diff --git a/src/get-started/quickstart-py.md b/src/get-started/quickstart-py.md
index 3447aa461..e9edfeaaf 100644
--- a/src/get-started/quickstart-py.md
+++ b/src/get-started/quickstart-py.md
@@ -46,9 +46,14 @@ pip --version
If you do not have `pip` version 7.0.0 or newer, run the following command to
install it. This command might require administrative privileges.
+{:.unix}
```
pip install --upgrade pip
```
+{:.powershell}
+```
+PS> python -m pip install --upgrade pip
+```
### Install Python virtual environment
@@ -58,17 +63,27 @@ for initial experiments. If you do not have `virtualenv`
version 13.1.0 or
newer, run the following command to install it. This command might require
administrative privileges.
+{:.unix}
```
pip install --upgrade virtualenv
```
+{:.powershell}
+```
+PS> python -m pip install --upgrade virtualenv
+```
If you do not want to use a Python virtual environment (not recommended),
ensure
`setuptools` is installed on your machine. If you do not have `setuptools`
version 17.1 or newer, run the following command to install it.
+{:.unix}
```
pip install --upgrade setuptools
```
+{:.powershell}
+```
+PS> python -m pip install --upgrade setuptools
+```
## Get Apache Beam
@@ -76,9 +91,14 @@ pip install --upgrade setuptools
A virtual environment is a directory tree containing its own Python
distribution. To create a virtual environment, create a directory and run:
+{:.unix}
```
virtualenv /path/to/directory
```
+{:.powershell}
+```
+PS> virtualenv C:\path\to\directory
+```
A virtual environment needs to be activated for each shell that is to use it.
Activating it sets some environment variables that point to the virtual
@@ -86,11 +106,16 @@ environment's directories.
To activate a virtual environment in Bash, run:
+{.unix}
```
. /path/to/directory/bin/activate
```
+{.powershell}
+```
+PS> C:\path\to\directory\Scripts\activate.ps1
+```
-That is, source the script `bin/activate` under the virtual environment
directory you created.
+That is, execute the `activate` script under the virtual environment directory
you created.
For instructions using other shells, see the [virtualenv
documentation](https://virtualenv.pypa.io/en/stable/userguide/#activate-script).
@@ -98,9 +123,14 @@ For instructions using other shells, see the [virtualenv
documentation](https://
Install the latest Python SDK from PyPI:
+{:.unix}
```
pip install apache-beam
```
+{:.powershell}
+```
+PS> python -m pip install apache-beam
+```
#### Extra requirements
@@ -130,6 +160,10 @@ For example, run `wordcount.py` with the following command:
```
python -m apache_beam.examples.wordcount --input /path/to/inputfile --output
/path/to/write/counts
```
+{:.runner-direct-powershell}
+```
+python -m apache_beam.examples.wordcount --input C:\path\to\inputfile --output
C:\path\to\write\counts
+```
{:.runner-apex}
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
Issue Time Tracking
-------------------
Worklog Id: (was: 125644)
Time Spent: 20m (was: 10m)
> Documentation for Windows SDK users
> -----------------------------------
>
> Key: BEAM-4471
> URL: https://issues.apache.org/jira/browse/BEAM-4471
> Project: Beam
> Issue Type: New Feature
> Components: website
> Reporter: Udi Meiri
> Assignee: Rafael Fernandez
> Priority: Major
> Time Spent: 20m
> Remaining Estimate: 0h
>
> This is a request to document how to use Apache Beam on Windows machines.
> At minimum, add Windows-specific steps to the Java quickstart guide:
> [https://beam.apache.org/get-started/quickstart-java/]
>
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
