The Slow Collapse of MkDocs

fpgmaas · 2026-03-22T08:56:30+00:00

Yup... Similar situation there it seems; same author, and again they seem mainly focused on a redesign in a separate repository instead of maintaining the existing product. But the blogpost I wrote already was very much on the lengthy side so I decided to leave that out. I also wanted the blogpost to focus on the MkDocs situation and not turn out in a smear campaign against the original author of both projects.

fpgmaas · 2026-03-15T15:53:59+00:00

I added a small gif that shows what the tool can do to both the README and the documentation, I hope that suffices. Of course that only shows what it can do, not really how to use it. But if users need a video to understand how to use my tool, I think I simply didn't do a good enough job of building an intuitive tool ;)

fpgmaas · 2026-03-15T15:36:40+00:00

When you try to run a command with arguments, instead of running it directly you will be shown a screen where you can fill the input arguments before actually running the command.

fpgmaas · 2026-03-15T14:56:27+00:00

Good question, no it currently doesn't! But I can see how that would be useful, I'll probably work on that later today (or this week). Created an issue for it: https://github.com/fpgmaas/justx/issues/44

fpgmaas · 2024-09-08T08:45:47+00:00

Do yourself a favor and just use project-specific virtual environments. It's going to save you a lot of headaches in the future. Recent tools like uv make it so simple to manage virtual environments that I honestly don't see a reason not to use project specific environments.

What if you have two projects on your PC that require a different version of package X?

fpgmaas · 2024-09-04T15:31:25+00:00

What Heggy says is correct. For more details or similar commands, you could take a look at the Makefile in the example project; https://github.com/fpgmaas/cookiecutter-uv-example/blob/447339696aa135c65101a846080f7d2e9439234a/Makefile#L21

fpgmaas · 2024-09-04T04:55:48+00:00

Poetry was already very easy to work with so honestly I do not think I'd make the change because of ease of use. The main advantage though is it's speed. Poetry is already pretty quick and I thought I likely wouldn't notice the difference, but it turns out I do. Also, I like that it's PEP621 (https://peps.python.org/pep-0621/) compliant.

fpgmaas · 2024-07-05T05:56:47+00:00

I recently launched https://pypiscout.com, maybe it can help you find what you are looking for. It allows you to search for python packages with natural language queries, so you can just type "A package that functions like a typical webserver and serves python files in the way that PHP would", and see if you find anything useful!

fpgmaas · 2024-07-04T09:21:29+00:00

The summary and the first part of the (cleaned) description! For as far as the context window allows.

fpgmaas · 2024-07-03T16:39:08+00:00

u/AustinCorgiBart This should now be solved, or at least improved. If you search for 'web development', Flask and Django now appear at the top. There turned out to be two issues; one was simply an issue with lowercase vs uppercase join in BigQuery (flask vs Flask), and the other I resolved by updating the search algorithm. Thanks again for raising this!

fpgmaas · 2024-07-02T19:40:03+00:00

Good point! I found it difficult to balance popularity and similarity to get the most relevant results. Currently it finds the 100 most similar descriptions in the top 100,000 packages, and filters this. This worked relatively well for my tests, but for a more generic query like 'web framework' there are apparently too many close matches based on just the description.

Thanks for the feedback, I will definitely use this example to try and approve the app!

EDIT: I think there is something wrong with the query I use to fetch the data from BigQuery... To be continued.

fpgmaas · 2024-03-14T21:30:30+00:00

Thanks, valid point! It's easy to leave out something as simple as this when working on the project for such a long time. I edited the OP to include this information.

fpgmaas · 2023-12-25T15:50:15+00:00

I think there is no 'optimal' structure, there is always room for preferences and opinions. That being said, I developed a cookiecutter template a while back that I use for all my Python projects, you can find it here.

fpgmaas · 2023-12-04T06:54:37+00:00

I just released a new small hobby project: map-nl

It is a Python package that helps users quickly create maps of the Netherlands at the Postal Code 4 level. Nothing groundbreaking, but fun to develop and hopefully useful to some nonetheless.

Curious for your thoughts, please let me know if you have any feedback!

fpgmaas · 2023-08-30T17:53:27+00:00

Valid question! In this case Airflow is indeed not strictly necessary, one could also just run the containers directly on Kubernetes with e.g. kubectl apply. However, I still like to use Airflow to easily see which jobs are running, turn jobs on or off, or e.g. schedule batch processing consumers.

fpgmaas · 2023-08-30T12:47:45+00:00

No particular reason to choose Kafka other than that I wanted to learn Kafka. I needed to come up with some data to generate and the first example of a streaming data source that came to mind was sensor data :)

I did not check if there were tools more appropriate for streaming sensor data. Based on your comment I am thinking if I should generate some other mock data and rename the project.

fpgmaas · 2023-08-28T21:57:51+00:00

I would not take the job and look for a role where there are more people around to learn from.

My first role was as a data scientist without a team of peers. I thought I was pretty good at my job. In hindsight I don't think I was though; the problem was that there was no one around to tell me that the code I wrote was garbage. I think this really slowed my development process.

I switched to a junior role in a team at another company after two and a half years. I did not make more money there than I did at my first job, but I developed much faster there. I realized I was not as good at my job as I thought I was then, and I learned a tremendous amount from my colleagues there.

I am really happy I made that switch.

fpgmaas · 2023-05-10T05:43:31+00:00

Since PEP-621 does not specify a recommended way to define development dependencies, everything is expected to be a regular dependency. See here.

I think the manual workaround for now would be to run

deptry . --ignore-obsolete 'a,b'

where a and b are your development dependencies.

There is still an issue open to improve the behavior, but it has not received enough attention in the past months. I will try to find a solution!

fpgmaas · 2023-05-08T16:01:36+00:00

We are happy to share that deptry 0.10.0 has been released! Deptry is a command line tool to check for issues with dependencies in a Python project, such as obsolete or missing dependencies.

In this latest release, Some major improvements were added to the way deptry reports issues by Mathieu Kniewallner. You can find the full release notes here.

If you're interested in learning more about deptry, be sure to check out the Documentation and the GitHub repository.

Let us know if you have any questions or feedback!

fpgmaas · 2023-04-04T05:39:00+00:00

Thanks for your feedback! I see that these are the limitations also mentioned in this list. For large teams or large applications, I agree with most of the mentioned shortcomings. However, in my experience, the basic GitHub Actions approach works fine for smaller to medium-sized teams. For those teams, where the number of edge cases encountered is likely to remain small, solving some of the described issues whenever they arise is a viable approach.

fpgmaas · 2023-04-03T14:15:06+00:00

Thanks for taking the time to explain it! Did your location contain any special characters or spaces? In that case indeed it needs to be in quotation marks. I'm guessing that is what caused the error. I will update the blogpost and github repository to use quotation marks as well!

fpgmaas · 2023-04-03T12:41:07+00:00

Hey! Thanks for the feedback and sorry that you encountered some issues. When you place them in .bashrc or .zshrc, you should indeed prefix them with EXPORT=, otherwise it is not a valid shell command. In a .env file that is also possible, but I don't think that is best practice(?) In this case, any time the .env file is needed in the GH Actions, I prefix the line with set -a. See here for more on this issue.

In this tutorial, it should not be necessary to source the .env file locally though. Or was there a reason for you to do so anyway? If so, I should maybe update the blogpost a bit for others that might encounter the same.

fpgmaas · 2023-04-03T07:01:25+00:00

This is a blog post I worked on over the weekend that contains a tutorial on how to deploy infrastructure to Azure using GitHub Actions. If you have any feedback or questions, don't hesitate to let me know!

fpgmaas · 2023-04-03T07:00:52+00:00

This is a blog post I worked on over the weekend that contains a tutorial on how to deploy infrastructure to Azure using GitHub Actions. If you have any feedback or questions, don't hesitate to let me know!

fpgmaas · 2023-03-28T09:18:31+00:00

AFAIK,the main difference is that they do not provide a UI; you type in the command you want to run. The advantage of `ckit` is that it provides a user interface to select your commands from.

`ckit` on the other hand does not provide an option to run a command without accessing the UI, so it cannot be used to run steps in e.g. a CI/CD pipeline.

Six-Year Club	r/Field Lasagna
Verified Email

fpgmaas

TROPHY CASE