7 ms·
Lesser known parts of Python standard library
- brianyu8 2y agoIf you liked this blog post, I can’t recommend PyMOTW[0] highly enough. It’s my goto for a concise introduction whenever I need to pick up a new Python stdlib module. [0]: https://pymotw.com/3/ https://pymotw.com/3/
- judicious 2y agoI find defaultdict, OrderedDict, namedtuple among other data structures/classes in the collections module to be incredibly useful. Another module that's packaged with the stdlib that's immensely useful is itertools. I especially find takewhile, cycle, and chain to be incredibly useful building blocks for list-related functions. I highly recommend a quick read. EDIT: functools is also great! Fantastic module for higher-order functions on callable objects. https://docs.python.org/3/library/itertools.html https://docs.python.org/3/library/itertools.html
- padthai 2y agoWhy do you use OrderedDict for now that regular dicts are ordered by default?
- judicious 2y agoI work with different versions of Python3 (and 2 unfortunately) and some code is still in 3.6, hence I used OrderedDicts.
- mixmastamyk 2y ago3.6 was the first with the new ordered by default dicts, even though wasn't specc'd until 3.7.
- Izkata 2y agoIt worked as an accidental implementation detail in CPython from some other optimization, but it wasn't intentional at the time. Because it wasn't intentional and wasn't part of the spec, that code could be incompatible with other interpreters like pypy or jython.
- ericvsmith 2y agoSee my comment and the linked email at https://github.com/ericvsmith/dataclasses?tab=readme-ov-file#compatibility https://github.com/ericvsmith/dataclasses?tab=readme-ov-file... for dataclasses and 3.6. I think it's still true.
- raymondh 2y agoThe reason Guido didn't want 3.6 to guarantee dict ordering was to protect 3.5 projects from mysteriously failing when using code that implicitly relied on 3.6 behaviors (for example, cutting and pasting a snippet from StackOverflow). He thought that one cycle of "no ordering assumptions" would give a smoother transition. All 3.6 implementations would have dict ordering, but it was safer to not have people rely on it right away.
- masklinn 2y agopypy implemented naturally ordered dict before cpython did. jython never released a P3 version so is irrelevant, ironpython has yet to progress beyond 3.4 so is also irrelevant.
- sgarland 2y agoAs someone who just had to backport a fairly large script to support 3.6, I found myself surprised at how much had changed. Dataclasses? Nope. `__future__.annotations`? Nope. `namedtuple.defaults`? Nope. It's also been frustrating with the lack of tooling support. I mean, I get it – it's hideously EOL'd – but I can't use Poetry, uv, pytest... at least it still has type hints.
- neves 2y agoNot even VSCode extension works anymore
- heavyset_go 2y agoOrderedDicts have some convenience methods and features that ordinary dicts don't have.
- rbanffy 2y agoAlso, dicts can become unordered at any time in the future. Right now the OrderedDict implementation is a thin layer over dict, but there are no guarantees it’ll always be that.
- wodenokoto 2y agoThey can, but ordered dict can also become unordered in the future, should the steering committee decide. But seriously: It’s no longer an implementation detail that dictionaries are ordered in Python. It’s a specification of how Python works.
- rbanffy 2y agoI missed that in the 3.7 release notes.
- judicious 2y agoThere in lies another reason why OrderedDicts are still useful even in 3.12
- rbanffy 2y agoNot really. It was pointed out that since 3.7 the order preserving behaviour is part of the spec for dicts.
- judicious 2y agoI guess for most purposes, OrderedDicts are then obsolete, but I believe there are some extra convenience methods that they have, but I've only really needed to preserve order. Makes you think what other parts of Python have become obsolete.
- d0mine 2y agoIt may be more explicit: OrderedDict has move_to_end() which may be useful e.g., for implementing lru_cache-like functionality (like deque.rotate but with arbitrary keys).
- masklinn 2y agoOTOH that’s a lot less useful now that functools.lru_cache exists: it’s more specialised so it’s lighter, more efficient, and thread-safe. So unless you have extended flexibility requirements around your LRU, OD loses a lot there. And if you’re using a FIFO cache, threading a regular dict through a separate fifo (whether linked list or deque) is more efficient in my experience of implementing both S3 and Sieve.
- Flimm 2y agoTwo dictionaries with equal keys and values are considered equal in Python, even if the order of the entries differ. By contrast, two OrderedDict objects are only equal if their respective entries are equal and if their order does not differ.
- BerislavLopac 2y agoChainMap might be the most underrated bit in the standard library.
- stevesimmons 2y agoFor anyone wanting some more explanation, ChainMap can be used to build nested namespaces from a series of dicts without having to explicitly merge the names in each level. Updates to the whole ChainMap go into the top-level dict. The docs are here [0]. Some simple motivating applications: - Look up names in Python locals before globals before built-in functions: `pylookup = ChainMap(locals(), globals(), vars(builtins))` - Get config variables from various sources in priority order: `var_map = ChainMap(command_line_args, os.environ, defaults)` - Simulate layered filesystems - etc [0] https://docs.python.org/3/library/collections.html#collections.ChainMap https://docs.python.org/3/library/collections.html#collectio...
- BerislavLopac 2y agoI found it perfect for structured logging, where you might want to modify some details of the logged structures (e.g. a password) without changing the underlying data.
- mont_tag 2y agoMy faves are the lru_cache, namedtuples, deques, chainmap, and all of the itertools.
- sevensor 2y agoI mostly migrated to frozen dataclasses from namedtuples when dataclasses became available. I’m curious about your preference for the namedtuple. Is it the lighter weight, the strong immutability, the easy destructing? Or is it that most tuples might as well be namedtuples? Those are the advantages I can think of anyway :)
- sgarland 2y agoThe main thing I find myself using them for is `_make()`. From the canonical [0] example: import sqlite3 EmployeeRecord = namedtuple('EmployeeRecord', 'name, age, title, department, paygrade') conn = sqlite3.connect('/companydata') cursor = conn.cursor() cursor.execute('SELECT name, age, title, department, paygrade FROM employees') for emp in map(EmployeeRecord._make, cursor.fetchall()): print(emp.name, emp.title) You could of course accomplish the same with a dictionary comprehension, but I find this to be less noisy. Also, they have `_asdict()` should you want to have the contents as a dict. [0]: https://docs.python.org/3/library/collections.html#collections.namedtuple https://docs.python.org/3/library/collections.html#collectio...
- gcr 2y agoHoly shit that’s really clever. Didn’t know about _make, thank you!
- sgarland 2y agoI didn’t either until I read docs tbf. It’s just kind of thrown in as an afterthought for the section, too.
- judicious 2y agoDictionary comprehensions can be very elegant. List and dictionary comprehensions are very powerful and expressive abstractions. In fact, while not good practice you can pretty much write all Python code inside comprehensions including stuff regarding mutation. This is valid(as in it will run, but highly unidiomatic) code: quicksort = lambda arr: [pivot:=arr[0], left:= [x for x in arr[1:] if x < pivot], right := [x for x in arr[1:] if x >= pivot], quicksort(left) + [pivot] + quicksort(right)][-1] if len(arr) > 1 else arr print(quicksort([1, 33, -4, -2, 110, 5, 88]))
- tpoacher 2y agoalso more_itertools ! even less known than itertools, but equally useful.
- matsemann 2y agoI just wish python had some better ergonomics/syntactic sugar working with itertools and friends. Grouping and mapping and filtering and stuff quickly become so unwieldy without proper lambdas etc, especially as the typing is quite bad so after a few steps you're not sure what you even have. Just as recent as today I went to Kotlin to process something semicomplex even though we're a python shop, just because I wanted to bash my head in after a few attempts in python. A DS could probably solve it minutes with pandas or something, but again stringly typed and lots of guesswork. (It was actually a friendly algorithmic competition at work, I won, and even found a bug in the organizer's code that went undetected exactly because of this)
- judicious 2y agoI find converting things from map objects or filter objects back to lists to be a bit clunky. Not to mention chaining operations makes it even more clunky. Some syntatic sugar would go a long way.
- mturmon 2y agoI use defaultdict a lot - for accumulators when you're not sure about what is coming. Here's a simplified example: # a[star_name][instrument] = set of (seed, planet index) of visited planets a = defaultdict(lambda: defaultdict(set)) for row in rows: a[row.star][row.inst].add((row.seed, row.planet)) This is a dict-of-dict-of-set that is accumulating from a stream of rows, and I don't know what stars and instruments will be present. Another related tool is Counter (https://docs.python.org/3/library/collections.html#collections.Counter https://docs.python.org/3/library/collections.html#collectio...)
- daniel_grady 2y agoAlthough it's not part of the standard library, toolz is wonderful for rounding out these modules. https://toolz.readthedocs.io/en/latest/ https://toolz.readthedocs.io/en/latest/
- joshdavham 2y agoI did not know about that webbrowser module. This will definitely come in handy for sure!
- fuzztester 2y agoTry: import antigravity and import braces separately.
- adm_ 2y agoActually it is from __future__ import braces
- fuzztester 2y agoOh yeah, thanks. That also makes it more funny. :)
- joshdavham 2y agoThat's cool! I didn't know about this one. Also, just to make sure I understand the joke. It's basically just saying that they'll never add braces to the python syntax, right?
- Sohcahtoa82 2y agoI mean, technically braces ARE part of Python syntax. They're used by sets and dictionaries. But I know what you meant, and yeah...they'll never use braces as block delimiters. IMO, that's a good thing. Whitespace-as-syntax means you're FORCED to have a minimal level of decent code formatting or it doesn't work.
- fuzztester 2y agoThere is also: from __future__ import print_function following which you can print output using the Python 3 print() function instead of the Python 2 print statement. Also see: https://stackoverflow.com/questions/7075082/what-is-future-in-python-used-for-and-how-when-to-use-it-and-how-it-works https://stackoverflow.com/questions/7075082/what-is-future-i... Note that all this is for Python 2.
- Uptrenda 2y agoThrowing frozensets out, too. If regular sets aren't obscure enough, frozensets might be your thing. It looks like a set, it acts like a set, but its... hashable (for indexing) and (immutable.) Why use this? For algorithms that rely on combinations (not permutations), frozensets can be very useful. E.g. NOT this -- (0, 1) (1, 0) (both distinct using tuples) vs frozenset([0, 1]) ([1, 0] or [0, 1] have the same identity / frozenset.) You can use this for indexing algorithms and things like that. Sometimes, sets are very convenient because they naturally 'normalise' entries into a fixed order. This can simply a lot of code.
- nick238 2y agoThe following are identical fractions.Fraction(numerator=1, denominator=3) fractions.Fraction(1) / 3 ChainMap is maybe better described/used as inheritance for dicts, where something like settings = ChainMap(instance_settings, region_settings, global_settings) would give you one object to look in.
- openrisk 2y agoSome modules are essential additions while others are handy so as not to have to manage dependencies. Good example of the latter use case is the statistics module. There is a price to pay though: its performance is 10x slower than numpy. So its mostly useful when the required calculation is not a bottleneck. The benefit is you are good to go (batteries included) without any virtual environmemts, pip's etc.
- dairiki 2y agoI just discovered graphlib.TopologicalSorter the other day. Nice! When you need it, you need it. It's nice not to have to implement it oneself.
- crabbone 2y agoOnce I found myself needing to sort something topologically... and the interface to this sorter is so bad that you cannot really retrofit any kind of graph data to make it work with the sorter. So, it's kinda worthless, unless you specifically design your graph to be sorted with this sorter. Also, topological sort is like five lines of code... so, it doesn't matter if the function is there.
- halfcat 2y agoIs this because graphlib.TopologicalSorter is “backwards” in the sense that it takes a dependency graph instead of an adjacency list? Or what didn’t you like about it?
- h4l 2y agoMappingProxyType is another handy one. It wraps a regular dict/Mapping to create a read-only live view of the underlying dict. You can use it to expose a dict that can't be modified, but doesn't need copying. https://docs.python.org/3/library/types.html#types.MappingProxyType https://docs.python.org/3/library/types.html#types.MappingPr...
- teddyh 2y ago> file_url = 'file://' + os.path.realpath('test.html') You have to encode the file name! file_url = 'file://' + urllib.parse.quote(os.path.realpath('test.html'))
- Qem 2y ago> For people eager to join the AI/ML revolution it provides Naive Bayes classifier - an algorithm that can be considered a minimum viable example of machine learning. I don't think this is true. It allows you to specify and calculate parameters for normal distributions, what allows you to jury rig a naive bayes classifier, what is shown as a doc example. This is not the same as providing a built in classifier.
- alexpotato 2y agoFor a funny and insightful tour of the Python "built in" functions, I highly recommend Dave Beazley's talk: https://www.youtube.com/watch?v=j6VSAsKAj98 https://www.youtube.com/watch?v=j6VSAsKAj98
- skinner927 2y agocontextlib.ExitStack is a lesser known trick for limiting context manager nesting.
- chadash 2y ago> OrderedDict - dictionary that maintains order of key-value pairs (e.g. when HTTP header value matters for dealing with certain security mechanisms). Word to the wise... as of Python 3.7, the regular dictionary data structure guarantees order. Declaring an OrderedDict can still be worthwhile for readability (to let code reviewers/maintainers know that order is important) but I don't know of any other reason to use it anymore.
- LudwigNagasena 2y agoComparison of OrderedDict is order-sensitive. They also have some extra methods.
- buildbot 2y agoYep, those extra methods are extremely useful. Basically turns them into stack/queues in addition to being dictionaries which can be very helpful.
- dataflow 2y ago> Word to the wise... as of Python 3.7, the regular dictionary data structure guarantees order. Which means you still should use it if you might run on 3.6 or earlier.
- sestep 2y agoEven for 3.6 it's still true, just not guaranteed in writing: https://stackoverflow.com/a/39980744/5044950 https://stackoverflow.com/a/39980744/5044950 And Python <=3.7 is already end-of-life anyways: https://devguide.python.org/versions/ https://devguide.python.org/versions/
- Helmut10001 2y agoThis hit me bad once bad. I tested the regular dict and it _looked_ like it was ordered. Turned out, 1 out of about 100000 times it was not. And I had a lot of trouble identifying the reason 3 weeks later, when the bug was buried deep in complex code, and it appeared mostly what looked like random.
- sgarland 2y agoAdding `array` [0] to the list. It's generally slower than a list, but massively more memory-efficient. You're limited to a heterogeneous type, of course, but they can be quite useful for some operations. [0]: https://docs.python.org/3/library/array.html https://docs.python.org/3/library/array.html
- cgopalan 2y agoYou mean homogenous instead of heterogenous, right?
- tomjakubowski 2y agoTo add to this, arrays are also restricted to primitive C types. A Python array object is simply a heap allocated `unsigned long *` or what have you. https://docs.python.org/3/library/array.html https://docs.python.org/3/library/array.html https://github.com/python/cpython/blob/main/Modules/arraymodule.c https://github.com/python/cpython/blob/main/Modules/arraymod... And you can use struct for heterogenous data =) It has a neat DSL for packing/unpacking the data, reminiscent of the "little languages" from classic book The Practice of Programming. Python is actually pretty nice working with binary data. https://docs.python.org/3/library/struct.html https://docs.python.org/3/library/struct.html
- sgarland 2y ago> Python is actually pretty nice working with binary data. It really is! I’ve been working on a project to generate large amounts of synthetic data, and it calls out to C for various shared libraries to do the heavy lifting *. Instead of encoding and decoding back and forth, I can just ship bytes around, and then directly write them out to a file. Saves a lot of time. *: yes, I should just rewrite it into a faster language entirely. I intend to, but for the time being it’s been “how fast can I make Python without anything but stdlib,” as long as you accept ctypes as being included in that definition.
- sgarland 2y agoUgh… yes. Thank you.
- timdiggerm 2y agoThe contrast between links and the background colors is too low, making this very hard to read.
- tpoacher 2y agoI was not aware of zipapp ... but it's interesting to see it exists as a method for enabling python to run 'zipped packages' ... since python can already do that by default with normal zipfiles, as long as the zipfile appears / is added to the python path (which is roughly analogous to how one can add .jar files to the classpath in java). E.g.: export PYTHONPATH="package.zip" python3 -m packagename will work just fine. (PS. I document this technique in one of my python-template projects: https://git.sr.ht/~tpapastylianou/python-self-contained-runnable-package-template https://git.sr.ht/~tpapastylianou/python-self-contained-runn...) I suppose, if the intent is to package something in a manner that attempts to make it newbie-proof, then requiring a PYTHONPATH incantation before the python part might be one step too far ... but then again, one could argue the same about people not quite knowing what to do with a .pyz file and getting stuck.
- BiteCode_dev 2y agoCheckout shiv for turning even more zipapp goodness: https://shiv.readthedocs.io/en/latest/ https://shiv.readthedocs.io/en/latest/
- ttyprintk 2y agoshiv has two things over zipapp: A bootstrap boilerplate that allows the shiv to be able to run as an interpreter. I think zipapp can only be given code.interact as main. Unpacking wheels into ~/.shiv, which might be faster. I can’t remember if this permits running compiled C, which is not possible from within a zipapp.
- djoldman 2y agoTIL decimal and fraction. Pretty cool.
- seoulbigchris 2y agoDoes this Python decimal mode use IEEE 754 decimal mode arithmetic (assuming any modern floating point hardware supports it).
- BiteCode_dev 2y agoAdd functools to the list. Espacially functools.wraps() and functools.partial(). The stdlib is full of goodies. Now I always appreciated the battery included logic in python. But I noticed this week that LLM diminish that need. It's so easy to prompt for small utilities and saves you from using entire libraries for a few tools. And the AI can create doc and tests for them as quickly. So while I was really enthusiastic things like pairwise() were added to itertools, it's not as revolutionary as before.
- BeetleB 2y agoAnd itertools!
- gcr 2y agoIf you’re saying that LLMs trade idiomatic tools for ease-of-boilerplate-generation, shouldn’t that be a point against them, not in their favor? Pardon the hyperbole but it’s a bit like lauding an IDE for automatically generating thousands of Java class stubs.
- rurp 2y agoAgreed, rewriting standard functions is much worse than using standard tools that already exist. In addition to the extra boilerplate and reduced readability, that also sounds like an easy way to introduce subtle bugs. Standard library functions have been exhaustively field tested, a similar looking LLM generated function could easily include a footgun.
- BiteCode_dev 2y agoSure, but have you tried to introduce a new standard tool in the stdlib? It's not a fun process. Writing the code is the easy part. And installing more-itertools for one functions is a bit silly
- BiteCode_dev 2y agoFor decades you had the famous itertools recipes taunting you in the doc: https://docs.python.org/3/library/itertools.html#itertools-recipes https://docs.python.org/3/library/itertools.html#itertools-r... They were super useful, but not included in the stdlib, despite being a few lines long. We also had more-itertools, bolton, and others, to bridge that gap. Now, there was always a tension between adding more stuff to the stdlib, or letting 3rd party libs handle it. Remember the saying: the stdlib is where projects go to die. And of course tensions about installing full on 3rd party libs just for a few functions. The result is that many people copy/pasted a lot of small utilities, and endless debates on python-ideas to include some more. I think this is going to slow down. Now if you want "def first_true(iterable, default=False, predicate=None)", you ask chatgpt, and you don't care. The cost of adding those into the project is negligeable. It's nowhere near generating thousand of class stubs. It's actually the opposite: very targetted, specific code needs being filled instead of haunting python debates or your venv. But to stimulate a bit your anxiety, I do think code gen is going also making a big comeback with LLM :)
- pjot 2y agoTo run a localhost webserver on port 8000, serving the content of the current directory: python -m http.server Pass -h for more options.
- macNchz 2y agoThis is one I use all the time, super handy. Another CLI module I regularly make use of is `python -m json.tool`, for formatting and validating json. Last year I ran http.server with -h to remind myself of something, and the --cgi flag caught my eye...funnily enough there's built in support in the web server for running CGI scripts. Alas, it's deprecated and will be removed in 3.13 later this year, but I when I discovered it I couldn't resist the opportunity to write a CGI script for the first time 20-something years: https://github.com/drien/python-httpserver-upload https://github.com/drien/python-httpserver-upload
- ttyprintk 2y agoYou’ll probably like -m zipfile for those times unzip is not installed.
- magicmicah85 2y agoProbably silly, but I went five years of programming in python before I learned about the help function. Only learned about it when I had to take an intro to python class for school.
- stavros 2y agoWell, I went twenty-five years of programming in Python before I saw your comment, sooo...
- magicmicah85 2y agoHaha, I feel like it’s such an unknown feature and it’s incredibly useful too.
- ttyprintk 2y agoTry pydoc -p 0
- jjice 2y agoThis is the reason I love python for small personal projects. I can get up and going in a heartbeat and the stdlib has so much that I'd need. If there was a Flask-style HTTP server and a more requests-like HTTP client in the stdlib, I'd be a content man. Maybe I need to suck it up, but I just find venvs and Python packaging in general annoying to deal with, especially for something small. That said, Go has those things so it's crept in a little bit into my quick programming, but I'll always love python.
- guhcampos 2y agoI've significantly reduced my use of `namedtuple` since DataClasses were introduced, but I confess I never did much performance comparisons between the two. I assume the `namedtuple` syntax is more pleasing for Functional favorable programmers, but this makes me wonder if the stdlib should choose one of them?
- crabbone 2y agoLast I looked at named tuple implementation, it was along these lines: * generate source code from a template string. * eval generated code. * call constructor. This is woefully slow and wasteful compared to a sensible solution: writing it in C. But, nobody really cares.
- twixfel 2y agoI suspect nobody cares because it's not a problem. That bit of code you're moaning about will only be called once per namedtuple. It's unlikely to be a problem.
- crabbone 2y agoGuess who cares? The person you replied to... and it would've been really easy to figure that out, given that parent went all the way to look for implementation, isn't it? Anyways. The reason I cared is because I was working on a Protobuf parser, where named tuple was supposed to play a key role: the message class. Imagine my disappointment when I started to run benchmarks.
- twixfel 2y agoBut namedtuple makes classes, it does not instantiate them. If you're in a situation where your bottle neck is defining classes rather than instantiating them, then I would hope you can appreciate that this is an edge case.
- pletnes 2y agoIn my opinion, namedtuple was created to allow usage of a tuple (they are required in many places) while giving names to the members, rather than plain indexes.
- rurp 2y agoI see a lot of mentions of itertools in this thread, which is indeed a great library, but I want to mention that itertools.groupby is one of the easiest to misuse functions I've seen. It's not necessarily intuitive that it groups contiguous records. Passing it an unsorted list won't break, but also might not return the results you're expecting.
- globular-toast 2y agoYes, it's similar to Unix's `uniq` (which is mentioned in the doc). Some SQL stuff also requires prior sorting to work right (although usually you can't accidentally miss it). Nowadays the GNU `uniq` can sort and the `sort` can unique because there are performance benefits. Assume the same is true in Python so if worried about performance `groupby(sorted(...))` might not be the best. The other thing that is a bit odd is it returns iterators. It's up to you to build concrete groups if that's what you need.
- ttyprintk 2y agoI feel like non-trivial uses always involve a complex key function. At that point, I reach for defaultdict(list)
- flakiness 2y agoDidn't know "dis". It looks nice! Everyone these days is using ast [1] but the might be room for dis instead in some cases. [1] https://docs.python.org/3/library/ast.html#module-ast https://docs.python.org/3/library/ast.html#module-ast
- globular-toast 2y agoChainMap is one of my favourites. I like when I find a use for it. The obvious one is cascading options type thing (like cmdline options -> env -> defaults). I also found a use for it recently when changing the underlying storage layer of a class without breaking the API. My other favourite parts of the stdlib are functools and itertools. They are both full of stuff that gives you superpowers. I always find it a shame when I see developers do an ad hoc reimplantation of something in functools/itertools.
- m463 2y agowhat do people use when they want shorthand for something like this: a['foo'] = 20 a['bar'] = 9 where you want to be able to do: a.foo = 20 a.bar = 9
- hooverd 2y agoPydantic, attrs, or dataclasses (standard library option). Or you can override __getattr__ on a dict subclass.
- Am4TIfIsER0ppos 2y agoUse Lua?
- Sohcahtoa82 2y agoOr JavaScript.
- Too 2y agoYou don't. Use dataclasses instead to get type checking. Otherwise there are tons of tricks to get what you want. To add to the list posted in sibling: a = vars(a) # readonly print(a.foo) or class Obj: pass; a = Obj() a.foo = 20
- OutOfHere 2y agoIt has an HTTP server that can compete with Flask for simple use.
- nurettin 2y agoI am surprised that they didn't mention pack/unpack. And a namedtuple can take the results of unpack which means you can easily parse binary files. Like header = Header._make(unpack(f.read(64), header_format)) print(header)