Build Your Python Project Documentation With MkDocs – Real Python
HOWTO on getting going with MkDocs and Python ode.
Public
Example Google Style Python Docstrings — napoleon 0.7 documentation
Useful samples for writing Google style docstrings in Python.
The announcement of the Textual CSS branch on HN
The Orange hate site’s reaction to the announcement of the release of the CSS branch of Textual.
New version of Textual adds CSS support
Announcement of Textual 0.2.0 on reddit.
Phylum Discovers Dozens More PyPI Packages Attempting to Deliver W4SP Stealer in Ongoing Supply-Chain Attack
"Last week, our automated risk detection platform alerted us to some suspicious activity in dozens of newly published PyPI packages. It appears that these packages are a more sophisticated attempt to deliver the W4SP Stealer on to Python developer’s machines by hiding a malicious import . Join us here on the Phylum research team as we investigate these new and shifting tactics the attacker is using to deploy W4SP stealer in this supply-chain attack."
Should You Use Upper Bound Version Constraints?
I don't agree with much of this, but I recognise it's a valid position. To quote from the TL;DR at the end:
"Capping dependencies has long term negative effects, especially for libraries, and should never be taken lightly. A library is not installed in isolation; it has to live with other libraries in a shared environment. Only add a cap if a dependency is known to be incompatible or there is a high (>75%) chance of it being incompatible in its next release. Do not cap by default - capping dependencies makes your software incompatible with other libraries that also have strict lower limits on dependencies, and limits future fixes. Anyone can fix a missing cap, but users cannot fix an over restrictive cap causing solver errors. It also encourages hiding issues until they become harder to fix, it does not scale to larger systems, it limits your ability to access security and bugfix updates, and some tools (Poetry) force these bad decisions on your downstream users if you make them. Never cap Python, it is fundamentally broken at the moment. Also, even packing capping has negative consequences that can produce unexpected solves."
transponderings.blog
Helpful review of a number of Mastodon clients for iOS, available late 2022.
Spacebear Federation
Mastodon hosting company.
Virtual Environments with Eglot, Tramp, and Pyright · robbmann
Blog post talking about getting eglot and pyright working together nicely.
A collective list of free APIs
Pretty epic list of all sorts of free public APIs. Handy when you're looking for inspiration for a project to mess with.
PyPi - API reference - Warehouse documentation
PyPi API reference.
Upload & sell your music on Apple, Spotify, Amazon and YouTube Music
A service that can be used to distribute music to all sorts of streaming services.
Asteroid Launcher
Throw rocks and more at places on Earth.
A Case Study on Raspberry Pi’s Incident on the Fediverse || Eiara Limited - Sustainable DevOps
Excellent write up of RPi’s social media meltdown after folk weren’t terribly happy about their glorification of a surveillance state.
What Are Python Wheels and Why Should You Care? – Real Python
Pretty comprehensive article covering the concept of Python "wheels".
A year of building for the terminal on Hacker News
Textualize devlog blog post on Hacker News; of course with the usual collection of very Hacker News replies along the way.
Steam Replay 2022
My 2022 Steam replay.
It's probably time to stop recommending Clean Code
Well-written review of why Clean Code isn’t a great book.
GitHub Contributions Chart Generator
Generate a full history of your GitHub contributions.
XTerm Control Sequences
A pretty definitive document covering XTerm control sequences.
These Years in Common Lisp: 2022 in review - Lisp journey
A revew of Common Lisp's 2022.
Full archive of BYTE magazines
Every issue of BYTE magazine, from 1975 until 1998, as a PDF.
Ask HN: Why are toggle switches replacing checkboxes? Isn't on/off less obvious? | Hacker News
A rare good discussion on Hacker News; folk pondering the issues of toggle switches vs checkboxes.
Trimmed down python setup for Emacs. This is a basic `init.el` file for Python, you can pick the bits you like.
Handy cut-down config for Emacs and Python, showing examples of comapny and eglot (or optionally lsp-mode) along the way.
How should Pyright consider typing stubs with try-excepted imports?
Visual design rules you can safely follow every time
Visual design rules you can safely follow every time.
You do not have to follow these rules every time. If you have a good reason to break any of them, do. But they are safe to follow every time.
Why (Python) type hinting sucks
I don’t agree with the post - type hinting is awesome in my experience - but it’s a cleverly-crafted argument and there’s some interesting debate in the comments.
Swearing makes code better
Fuck yeah quality fucking code!
Style guides for Google-originated open-source projects
Google's style guide for Python code. Obviously not the law, not even always a good suggestion, but worthy of consideration.
Textual 0.11.0 adds a beautiful Markdown widget
Reddit thread where the Textual Markdown widget was announced.
Also includes the rather hilarious comment "I wish there were more full blown app examples out there", back when Textual was pretty damn new and barely out of the initial "CSS branch" release.