25 comments

[ 3.2 ms ] story [ 48.5 ms ] thread
Probably fun to read and educational, but why in the world does the page use grey text on a grey background?
It passes WCAG contrast guidelines just fine. It has a contrast ratio of 7.84, and the WCAG AAA standard requires 7.0.

I find it very readable.

Putting aside git, i love the format and step-by-step teaching! You've done a better job at this than 99% of CS professors i've ever had. Thank you for doing this!
This interface is downright awesome; I'd love something that takes a git repository and displays the commit message along with the diffs like this (might be how this works under the hood) If there's something usable like this I didn't know about, please say!

EDIT: from comment in the first page the author said it's custom typescript which isn't open-source yet, there's still hope :)

I really love the idea, but it's sent me down the Python packaging rabbit hole because the very first page's recommendation to use `python3 setup.py develop --user` doesn't work without some customization that I have yet to figure out.

First, it seems to (maybe?) work better with a venv running, which I didn't have. Ok, I can create one.

Next, `SetuptoolsDeprecationWarning: setup.py install is deprecated`, although I can live with that for now.

Next, I'm provided with a long list of ideas for how to enable `.pth` files, but https://setuptools.pypa.io/en/latest/deprecated/easy_install... strongly implies that `export PYTHONUSERBASE=`pwd`` prior to running setup should work. It doesn't.

Python, why does your ecosystem have to be so broken?

It's almost surprising how far Python has come with the state pip is in; it's so rare to have any remotely sizeable software's dependencies install properly without some hacking.
I can echo the same. My Python use has largely been automating some tasks at work, nothing incredibly large, but new installation of the deps is always problematic. And the same goes for more than a few OSS projects I try to get working locally.
(comment deleted)
I guess it depends very much on the niche. Datascience? Yeah, hacking probably necessary for all those C/rust stuff. Web? Things will work just fine.
Python packaging sucks. It's a big part of my job right now. To get various things to work, I've had to downgrade setuptools and manually install Cython.
Python packaging is dead simple. You just define your package in requirements.txt, setup.py, setup.cfg, MANIFEST.in, pyproject.toml (although this one has two different ways to declare dependencies), and/or Pipfile. You then use pip, pipenv, virtualenv, venv, virtualenvwrapper, pyenv, pyenv-virtualenv, pyenv-virtualenvwrapper, poetry, and/or conda to install and manage the package.
(comment deleted)
That instruction is not the recommended way.

To make it work, use a virtualenv, seriously always use a virtualenv. Then inside: pip install --editable ./

This has been the standard way to install packages since forever. Don’t know why author complicates it with lower level setuptools. This is the same message that deprecationwarning is giving btw.

Thanks, that did the trick.

I'm going to argue, however, that "standard" is far too strong a word. I've been using Python on a near-daily basis for the last 4 years. I've never run into that, and I don't see it at the Hitchhiker's Guide.

Well, that and Python doesn't seem to do standard.

I took this tutorial and it vastly improved my git understanding, nicely done in both content and the way it's presented!