https://linen.dev logo
Join Slack
Powered by
re office hours chat Have some dev friends checki...
# troubleshooting
v
re office hours chat Have some dev friends checking out meltano, though they are new to Python. I wonder if Meltano should have a new to python help guide. Specefically the problems I ran into when I started and new users 1. How to properly install python on Ubuntu 
<https://realpython.com/installing-python/>
apt-get install python3.8 python3-pip
2. Venvs are good here's what they are and why they matter (note pipx / poetry but I skipping over the venv layer and just saying use pipx/poetry pushes a devs issue to later in the process 🤷 ) 3. On ubuntu you need to use pip3 and python3 or you can alias them 4. PIP needs to be upgraded everytime you make a new venv, that's why you see a bunch of errors when you run pip3 install I'd guess these are super normal things that come up in all of Python and maybe there's easier guides / tooling out there I could point people to?
To make part of this easy in Java / Groovy land we used https://sdkman.io/usage It looks like for python the decision has been to let package managers of each distro do their own thing
The problem we ended up hitting specefically came down to updating pip
Copy code
pip install --upgrade pip
Showed its head here, we fixed pretty quickly but had to go through answering questions about python, venvs, pip3, etc.
a
I think that sort of documentation would be really useful (especially as we target folks who may be less familiar with these sorts of things).
I don't want to set the expectation that we'll teach people to code or help them set up their environments but I think something like this would help folks make sure their env is set up properly before diving in for sure
v
On the main page the first tutorial is
Copy code
# Create directory for Meltano projects
mkdir meltano-projects
cd meltano-projects

# Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate
Maybe include
Copy code
# Create directory for Meltano projects
mkdir meltano-projects
cd meltano-projects

# Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Update PIP
pip install --upgrade pip
Open in Slack
PreviousNext
Powered by