[jira] [Work logged] (BEAM-8787) Python setup issues

["ASF GitHub Bot (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/BEAM-8787?focusedWorklogId=592823&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-592823 ]

ASF GitHub Bot logged work on BEAM-8787:
----------------------------------------

                Author: ASF GitHub Bot
            Created on: 04/May/21 16:17
            Start Date: 04/May/21 16:17
    Worklog Time Spent: 10m 
      Work Description: tysonjh commented on a change in pull request #14477:
URL: https://github.com/apache/beam/pull/14477#discussion_r625920453



##########
File path: website/www/site/content/en/contribute/_index.md
##########
@@ -98,27 +109,52 @@ sudo apt-get install \
    docker-ce
 ```
 
-On some systems (like Ubuntu 20.04) these need to be installed also
+2. On some systems, like Ubuntu 20.04, install these:
+
 ```
 pip3 install grpcio-tools mypy-protobuf
 ```
 
-You also need to [install Go](https://golang.org/doc/install).
-
-Once Go is installed, install goavro:
+3. If you you develop in GO:
+    1. Install [Go](https://golang.org/doc/install).
+    1. Check BEAM repo is in: `$GOPATH/src/github.com/apache/`
+    1. At the end, it should look like this: `$GOPATH/src/github.com/apache/beam`
+4. Once Go is installed, install goavro:
 
 ```
 $ export GOPATH=`pwd`/sdks/go/examples/.gogradle/project_gopath
 $ go get github.com/linkedin/goavro
 ```
 
-gLinux users should configure their machines for sudoless Docker.
+**Important**: gLinux users should configure their machines for sudoless Docker.
+
+##### Automated script for Linux and macOS
+
+You can install these in a Debian-based distribution for Linux or macOs using the [local-env-setup.sh](https://github.com/apache/beam/blob/master/local-env-setup.sh) script, which is part of the Beam repo. It contains:

Review comment:
       I'm in favor of waiting to merge.




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Issue Time Tracking
-------------------

    Worklog Id:     (was: 592823)
    Time Spent: 2h 50m  (was: 2h 40m)

> Python setup issues
> -------------------
>
>                 Key: BEAM-8787
>                 URL: https://issues.apache.org/jira/browse/BEAM-8787
>             Project: Beam
>          Issue Type: Bug
>          Components: build-system
>    Affects Versions: 2.16.0
>         Environment: debian x86 (gLinux)
>            Reporter: Elliotte Rusty Harold
>            Assignee: Josias Misael Rico Garcia
>            Priority: P2
>          Time Spent: 2h 50m
>  Remaining Estimate: 0h
>
> This could be an issue with incomplete or inaccurate contributing docs. tldr; `./gradlew check` fails on Debian after initial checkout.
> The docs say that one should first run:
> sudo apt-get install \
>     openjdk-8-jdk \
>     python-setuptools \
>     python-pip \
>     virtualenv
> but even after running this pieces are missing. I'm still debugging exactly what's missing but the symptoms look like this:
> > Task :sdks:python:test-suites:tox:py35:setupVirtualenv FAILED
> The path python3.5 (from --python=python3.5) does not exist
> > Task :sdks:python:test-suites:tox:py36:setupVirtualenv FAILED
> [ant:fmpp] Traceback (most recent call last):
> [ant:fmpp]   File "/usr/lib/python3/dist-packages/virtualenv.py", line 25, in <module>
> [ant:fmpp]     import distutils.sysconfig
> [ant:fmpp] ModuleNotFoundError: No module named 'distutils.sysconfig'
> ...
> FAILURE: Build completed with 2 failures.
> 1: Task failed with an exception.
> -----------
> * What went wrong:
> Execution failed for task ':sdks:python:test-suites:tox:py35:setupVirtualenv'.
> > Process 'command 'virtualenv'' finished with non-zero exit value 3
> Indeed there is no Python 3.5 on this system:
> gnome-user-share                      python2.6
> gnome-vfs-2.0                         python2.7
> gnupg                                 python3
> gnupg2                                python3.6
> gold-ld                               python3.7
> goobuntu-config-tools                 python3.8
> But nowhere in the setup docs do we say that Python 3.5 is required to build this. 



--
This message was sent by Atlassian Jira
(v8.3.4#803005)