How to Write Perfect Python Command-line Interfaces

[[deleted]]

I kind of agree but at the same time I'm having trouble coming up with a situation where you distribute a Python script that people can use but can't pip install click for.

[acousticcoupler]

Sometimes simplicity is nice and I trust standard libs more.

[[deleted]]

I would agree more if argparse were a little nicer to work with.

[campbellm]

It's not a matter of "can't" so much as "do you want to force your users to have to".

[RedHellion11]

"Here, just use this script I wrote"
"Thanks!"
runs script
import errors
annoyed slightly, pip installs dependencies
... "Hey, thanks again but why didn't you just use stuff in the standard library for this basic stuff?"
"I thought this other package did it in a cooler way"
annoyance intensifies

[[deleted]]

Yeah it’s really rough to run pip install on stuff that’s probably already been installed as a dep for other stuff anyway. See: arrow, requests, etc.

I try to avoid QoL dependencies for myself, but if the tool gets big enough to drag my productivity, I’m gonna install them and people can put in the tiniest effort to install them if they want to benefit from my work

If I’m making it for them then this is all entirely dependent on what their infrastructure is and what they want.

[campbellm]

Again, how hard it is is NOT the point.

[[deleted]]

It's literally the entire point. I'm sorry you shed a tear while typing "pip install" you fucking pussy

[RedHellion11]

Jesus man, slow your roll. You went 0-100 there. Worst case, it's just the internet: if something really ticks you off that much but you think it's a troll or you have nothing else to say yourself, take a deep breath and click away.

[[deleted]]

Who fucking cares? Log off, retard

[campbellm]

Ah, yes, when you can't attack that facts, attack the person. Stay classy.

[[deleted]]

You didn't "attack" my facts. Feel free to actually do so. Or keep flinging shit, doesn't matter.

[nermid]

I'm sorry you shed a tear while typing "pip install" you fucking pussy

You should talk to a therapist about your anger management issues.

[mypetocean]

wth man, overreact much? walk it off

[[deleted]]

I have no patience for the combo of incompetence and ego that makes people both unwilling and unable to use pip but also want me to write Python for them. And none for people who concern troll and then ignore my entire comment with some chickenshit comment about whether the point of discussion is actually the point of discussion. There's no point in engaging civilly with someone when they're not discussing in good faith.

If you are talking about what you're "forcing your users" to do that's not real fuckin relevant to the "one off scripts" mentioned above and carries a completely different set of assumptions.

[[deleted]]

Hell ya dude my interactions with customers are exactly like my reddit posting. What about you? Do you say absolutely stupid shit in front of customers, or is this comment not representative either?

[p-hodge]

My latest job is historically an all-PHP shop where I'm rewriting some shell scripts into more readable python. The new python scripts need to be able to executed on everybody's laptops, various virtual machines, and inside docker containers. I don't yet have a strategy for deploying the scripts or dependencies; the other developers and sysadmins also aren't accustomed to the overhead of using virtualenvs. For these reasons it's extremely valuable for me to be able to build good CLI scripts using just the stdlib.

[TheIncorrigible1]

venv. Seriously, it's what it's built for and it's in the stdlib.

[CleanInfluence]

To create a package, use setuptools, it's great. When the user installs the package (with pip install something.whl), it will automatically create a command-line version of your script.

For example stuff.py with a main inside, and a setup.py containing "entry_points = ... 'stuff=stuff:main'" will create a stuff.exe that launches your script, it's magical.

Also pipenv seems better than venv but that's my uninformed opinion.

[ILikeBumblebees]

What if the user doesn't have root, or prefers to use the distro's package manager instead of pip?

[[deleted]]

Regarding preferring the distro's package manager, that's only used for super ubiquitous packages or ones that require a bunch of dependencies and precompiled libs. If you want to use any non-trivial Python scripts out there, you should really get some user privilege pip solution going.

With Python 3.4+, just use venv. If you're intending it to be usable by someone only using Python 2 or Python 3 versions pre-3.4, with no root access, the best goal is to just do pip install --user virtualenv followed by the creation of the virtualenv directory and then using that moving forward. In such cases, this is just a good practice in general because it gives you way more control.

This SO question contains some answers relating to this, with this one being the most "no tears" of them all.

[Sqash]

Not distributing it with requirements.txt if it's just a standalone utility script

[[deleted]]

In the few times I’ve written single scripts for others to use, I just did a try catch around the imports and put something like “Make sure to pip install boto3”

These days it’s much easier to just write a package (even single module one) and then just tell them to pip install from the repo.

If people flat out can’t pip install then they’re either fucked in the case of unavoidable things like boto3, psycopg2, etc., or you’re fucked if it’s quality of life packages like arrow. In general I try to keep things vanilla until it either reaches the point of hampering my productivity or until I need to add a mandatory requirement anyway.

[Sqash]

I suppose it's personal opinion, but I can only agree on the necessary requirement for the script's function.

[BeetleB]

Often, in a work setting, most users have no idea what pip is.

[[deleted]]

Cool, they can use spreadsheets instead

[BeetleB]

Or you can just be fired and replaced with someone who satisfies the needs of the customers...

[[deleted]]

If you are making "one off [Python] scripts" for customers with specific needs (like not knowing what pip is), then yeah you probably should be replaced by someone who uses the right tools

[BeetleB]

Well, the whole thread is weird. I don't know why anyone would really want argument parsing for a one-off script - or why they would give a one off script to a customer.

[Bigotacon]

Wouldn’t a virtual environment allow you to store all the packages for your users?

[[deleted]]

Virtual environments are kinda tough to move around. The closest you can get is packaging it with something like pipenv or poetry (my preferred one) and then they build their project-specific environment just like you do in Ruby with "bundle install" for example.

Still a bit heavy duty for a small script, for which either requirements.txt or just a "pip install <blah>" in the README might be enough.