Timothée Mazzucotelli :python: / is on Nostr

I'm an open-source developer! Author of mkdocstrings :)

Last Notes

2025-05-14 13:18:32

Is there someone working at #Meta that could relay this? #MkDocs is getting test PRs from trainees, apparently coming from a Meta course. See https://github.com/mkdocs/mkdocs/pull/3965 and many other similar PRs in the tracker.

2025-03-11 22:15:42

Kinda crazy to see #Griffe mentioned as inspiration for the design of #OpenAI's Agents SDK 🤯 Cool to see the SDK's API reference being documented with #mkdoctrings, too 🥰

2024-12-24 13:57:22

- reply

@nprofile…m624 Try Radicle 🙂 https://docs.radicle.xyz/

2024-10-15 17:48:57

- reply

@npub133s…ts8h oh yes, same for me when I did too 🙂 Then I moved to PDM which I much preferred. And now I moved again to uv 😄

2024-10-15 17:40:04

- reply

@npub133s…ts8h
I agree with most of the article, with a tiny bit of nuance. But this:
> Use click instead of argparse or heaven forbid, sys.argv
...is no thanks ^^ Click, when used wrong (which is easy to do), makes it painfully hard to read code, use it programmatically, and debug it. argparse can be very verbose, but at least it isn't magic. Have a look at Cappa instead! Top 1 CLI framework :)

2024-10-15 17:40:04

- reply

2024-10-07 18:06:36

- reply

@npub172v…689n and thank you again for your work in the Python ecosystem ☺️

2024-09-18 15:33:11

Is #X blocking #Firefox now?
https://cdn.fosstodon.org/media_attachments/files/113/159/279/055/834/434/original/f16ceb3ceb7ce29a.png

2024-08-08 15:20:41

Hey #Python friends, could you give me a few examples of Python packages using Numpydoc-style docstrings?
I'm working on code to detect the style of a docstring. I ran it on all the packages I have installed locally, but almost none of them use Numpydoc-style docstrings.

2024-05-01 09:33:44

#MkDocs just launched their sponsorship page on #GitHub 🎉
https://github.com/sponsors/mkdocs

2024-04-17 11:05:35

I've started sponsoring @npub172v…689n (who just launched his sponsorship page on GitHub) for his work on Python! Thanks Brett for everything you're doing for the language and its ecosystem 🎉
https://github.com/sponsors/brettcannon

2024-03-06 15:23:43

#Python devs, do you often have a submodule and a member with the same name?
For example:
- pkg/__init__.py declares `thing = 1`
- pkg also has a `thing.py` submodule
#Griffe does not support that and will ignore the member in such cases, giving priority to the submodule. This limitation has been reported multiple times, and I wanted to fix it, but after having worked on it a bit, I'm quite convinced I shouldn't, and instead should say it's bad practice.
https://github.com/mkdocstrings/griffe/issues/124#issuecomment-1981072243

2023-08-22 13:50:56

- reply

@npub172v…689n
> planning to make the design of my resolver code flexible
One use-case for me would be to prioritize the latest, most specific version of packages. By most specific I mean, with the most parts in the version. For example: 1.2.3.4 over 1.2.4.

2023-08-22 13:47:27

- reply

@npub172v…689n well I'm not sure what I said makes sense. It seems PDM does not have a lot of code using resolvelib, so I guess it relies almost completely on it and there's no particular approach in PDM. They do have different "strategies" for locking and writing versions in pyproject.toml: https://pdm.fming.dev/latest/usage/dependency/#save-version-specifiers and https://pdm.fming.dev/latest/usage/dependency/#about-update-strategy.

2023-08-19 10:16:11

- reply

@npub172v…689n will you try to write your resolver without any inspiration from other projects, or risk getting biased by for example PDM's approach, which is using resolvelib too :)?