💾 Archived View for missbanal.net › atom.xml captured on 2024-08-31 at 12:15:11.
⬅️ Previous capture (2024-08-25)
-=-=-=-=-=-=-
<?xml version="1.0" encoding="utf-8"?> <feed xmlns="http://www.w3.org/2005/Atom"> <id>gemini://missbanal.net/</id> <title>Willow's feed</title> <updated>2024-08-22T07:21:49Z</updated> <link href="gemini://missbanal.net/" rel="alternate"/> <link href="gemini://missbanal.net/atom.xml" rel="self"/> <entry> <id>gemini://missbanal.net/status-update-2024-08/</id> <title>Status update August 2024</title> <updated>2024-08-04T00:00:00Z</updated> <link href="gemini://missbanal.net/status-update-2024-08/" rel="alternate"/> <content type="html">Hey, it's been a while! But as I started a daily job, I don't have that much to summarize: ## Sxmo We released last month Sxmo 1.16. With some patch tags, it went great. It is a tiny release, mostly containing fixes, integrating new apps, and supporting new devices. Of my most notable patches, we can count (1) some refactorisations around wake scripts. They are now more usefull to the user outside the sxmo internals. It is now very easy for the user to write basic periodic jobs that wake the device from suspension, and keep it awake while doing so. (2) A red LED when the battery level is low. (3) Support for distro wallpaper to be selected instead of the Sxmo one when available. Mainly usefull for the new wallpapers from PostmarketOs. Another notable thing is that Peter left the maintainer team. He did not announce this himself, and asked for us to do so. For some reason that I'm not sure to understand, it was something hard to do for me. I think it took me three full weeks to officially announce it. ## Hare release, and so are my Hare childs 0.24.2 has been flagged recently, and so I took some time to clean my projects using Hare, and flagged new minors. Bonsai and Sxmobar are already merged in Alpine packages. => https://sr.ht/~stacyharper/bonsai/ Bonsai - A Finite State Machine structured as a tree that trigger commands => https://git.sr.ht/~stacyharper/sxmobar/ Sxmobar - A status bar component manager Splitter is on the way, mainly because hari depends on the new hare-harfbuzz. => https://git.sr.ht/~stacyharper/splitter/ Splitter - A Speedrun GUI tool => https://git.sr.ht/~sircmpwn/hari hari - UI toolkit for Hare => https://git.sr.ht/~sircmpwn/hare-harfbuzz hare-harfbuzz - Harfbuzz wrapper for Hare And a new one, mcron is already on the way to be packaged. I wrote this post some months ago to present it. => https://sr.ht/~stacyharper/mcron Mcron - a sleeping Cron Job Scheduler => /another-cron/ Did I write another cron job scheduler? </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/perfect-docker-bind-mount-permissions/</id> <title>How to keep clean your Docker bind-mounts files permissions?</title> <updated>2024-05-31T00:00:00Z</updated> <link href="gemini://missbanal.net/perfect-docker-bind-mount-permissions/" rel="alternate"/> <content type="html">If you ever used Docker to develop for any project, you might have already discovered some mess within your filesystem:
$ ls -lh
drwxr-sr-x 313 root root 12K May 29 19:18 node_modules
Very similar situations are produced with a PHP project, on `vendor/` or `var/` folders by example. We all tried to do some kind of manual user ID mapping. If the user "www-data", from inside our containers, use the same user ID than our host user, the process should produce inodes that our regular user have access to. Mhh? Also, maybe it is possible, somehow, to configure our projects, or Docker itself, to keep clean our host filesystem. Can we configure docker with this "user-namespace"? Or better, could we run Docker as rootless? What about Podman? There should be some way to do so, right? Quick answer: Have you considered wanting something else? To elaborate my thoughts, I'll give some context, demonstrate with examples, and enumerate facts. We'll see what is possible, and what is not. Some context first: My username is "stacy", my uid and gid are 1000. I'll test (1) a rootfull Docker vanilla experience, (2) rootfull Docker with user-namespace mapping, (3) rootless Docker, and (4) rootless Podman. I'm starting with an empty folder. We'll be doing the same commands, and we'll check what are the consequences over the filesystem. Docker rootfull vanilla:
$ doas docker run --rm -it -v ./data/:/var/src -w /var/src alpine sh
/var/src # whoami
root
/var/src # id
uid=0(root) gid=0(root) groups=0(root),...
/var/src # mkdir foo
/var/src # ls -lhn
drwxr-sr-x 2 0 0 4.0K May 29 19:27 foo
/var/src # exit
$ ls -lhn
drwxr-sr-x 3 0 0 4.0K May 29 21:27 data
$ ls -lhn data/
drwxr-sr-x 2 0 0 4.0K May 29 21:37 foo
$ rmdir data/foo/
rmdir: failed to remove 'data/foo/': Permission denied
The `data/` folder has been created by the Docker daemon, as root, while creating the bind-mount. The `data/foo/` directory is also owned by root, created by the root process from the container, that is also root on the host system. My regular user can't remove those directories. That is the default experience. In this situation there is no user mapping at all. 0 for the containers is also 0 for the host. Then: what if we give a user ID explicitly? To do so we have to create `data/` ourselves, because 1000 will not have permissions over `/var/src` otherwise.
$ mkdir data
$ doas docker run --rm -it -u 1000:1000 -v ./data/:/var/src -w /var/src alpine sh
/var/src $ mkdir foo
/var/src $ ls -lhn
drwxr-sr-x 2 1000 1000 4.0K May 29 19:54 foo
/var/src $ exit
$ ls -lhn
drwxr-sr-x 3 1000 1000 4.0K May 29 21:54 data
$ ls -lhn data
drwxr-sr-x 2 1000 1000 4.0K May 29 21:54 foo
$ rmdir data/foo/
This is generally what I encounter on projects I work for. But it brings a lot of constraints we will demonstrate, because the daemon configuration may vary, or because some Docker images decide otherwise. Docker rootfull with user-namespace over "stacy":
$ cat /etc/sub[u,g]id
stacy:100000:65536
stacy:100000:65536
$ doas docker run --rm -it -v ./data/:/var/src -w /var/src alpine sh
/var/src # whoami
root
/var/src # id
uid=0(root) gid=0(root) groups=0(root),...
/var/src # mkdir foo
/var/src # ls -lhn
drwxr-sr-x 2 0 0 4.0K May 29 19:33 foo
/var/src # exit
$ ls -lhn
drwxr-sr-x 3 100000 100000 4.0K May 29 21:33 data
$ ls -lhn data/
drwxr-sr-x 2 100000 100000 4.0K May 29 21:33 foo
$ rmdir data/foo
rmdir: failed to remove 'data/foo': Permission denied
Here, we still are considered "root" from the container point of view. But we are actually creating directories with owner IDs 100000. This means that our regular user still can't remove those directories. But it is worse than that: what happens if you try to give your IDs explicitly now?
$ doas docker run --rm -it -u 1000:1000 -v ./data/:/var/src -w /var/src alpine sh
/var/src $ mkdir foo
mkdir: can't create directory 'foo': Permission denied
/var/src $ exit
$ doas rm -rf data/
$ mkdir data
$ doas docker run --rm -it -u 1000:1000 -v ./data/:/var/src -w /var/src alpine sh
/var/src $ mkdir foo
mkdir: can't create directory 'foo': Permission denied
Hehe, surprised? Now that we are using the user-namespace, the ID 1000 from the container point of view does not match your host user ID at all. In that situation, any preparation of the filesystem is expected to fail. I recommend avoiding bind-mounts completely when Docker is used this way. Docker rootless:
$ docker run --rm -it -v ./data/:/var/src -w /var/src alpine sh
/var/src # whoami
root
/var/src # id
uid=0(root) gid=0(root) groups=0(root),...
/var/src # mkdir foo
/var/src # ls -lhn
drwxr-sr-x 2 0 0 4.0K May 29 19:40 foo
/var/src # exit
$ ls -lhn
drwxr-sr-x 3 1000 1000 4.0K May 29 21:40 data
$ ls -lhn data/
drwxr-sr-x 2 1000 1000 4.0K May 29 21:40 foo
$ rmdir data/foo
Okay, you might think we won right? We still are "root" from the container point of view, but we are actually creating directories as 1000. Rootless also use the user-namespace for every user, except for "root". So problems comes when we use another user:
$ mkdir data
$ docker run --rm -it -u 1000:1000 -v ./data/:/var/src -w /var/src alpine sh
/var/src $ whoami
whoami: unknown uid 1000
/var/src $ id
uid=1000 gid=1000 groups=1000
/var/src $ mkdir foo
mkdir: can't create directory 'foo': Permission denied
Rootless brings the same constraints as rootfull with user-namespace. It is now impossible to make IDs to match your host ones, except for the "root" user. Unfortunately, some Docker images just refuse to works as "root". I've encountered the situation with OpenSearch images. But we can also argue that `php-fpm` can delegate its process pool to some "www-data". Fortunately, Podman give us some tools to deal with rootless: Podman rootless:
$ mkdir data
$ whoami
stacy
$ podman unshare
$ whoami
root
$ id
uid=0(root) gid=0(root) groups=0(root),...
$ ls -lh
drwxr-sr-x 2 root root 4.0K May 29 22:08 data
$ ls -lhn
drwxr-sr-x 3 0 0 4.0K May 29 22:09 data
$ chown 1000:1000 data
$ ls -lh
drwxr-sr-x 2 stacy stacy 4.0K May 29 22:08 data
$ ls -lhn
drwxr-sr-x 3 1000 1000 4.0K May 29 22:09 data
$ exit
exit
$ ls -lh
drwxr-sr-x 2 100999 100999 4.0K May 29 22:08 data
$ docker run --rm -it -u 1000:1000 -v ./data/:/var/src -w /var/src alpine sh
/var/src # mkdir foo
/var/src # exit
$ ls -lhn data
drwxr-sr-x 2 100999 100999 4.0K May 29 22:09 foo
$ rmdir data/foo
rmdir: failed to remove 'data/foo': Permission denied
`podman unshare` is a wrapper over `unshare`. It runs the user command within the user-namespace that Podman uses. While we are "unshared", we `chown 1000:1000 data`. From the host filesystem perspective, `data/` now belongs to 100999:100999. This looks like a mess, but it is actually what the container needs to write to this folder. To be said vulgarly, `podman unshare` give root privileges to the user over its own user-namespace. The user is now free to manipulate the inodes permissions, to prepare the filesystem for the containers. What did we learn? It is impossible to reliably map the user ID to your host one while doing bind-mounts. Because if the daemon is configured to use user-namespace, or if it runs rootless, the IDs will mismatch. It is always easier when the containers use "root", because it makes more setups viable. But because some images may decide otherwise, user-namespace brings too many constraints over the filesystem. Podman is the more appropriate solution to the rootless way. First because it implements it from a longer time, so we can expect a better support. But also because it provides `podman unshare`, so that the user never need root privileges to manipulate the filesystem too. And to conclude to the introduction passive-aggressive hot-takes with more details. Linux is a multi-user operating system. Docker is in no way a black-box that can abstract, or iron out, the Linux ACLs. We have to deal with them, so let's do it in a correct and secure way. </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/git-super/</id> <title>Git Super - a tiny script for the stacked diff workflow</title> <updated>2024-05-30T00:00:00Z</updated> <link href="gemini://missbanal.net/git-super/" rel="alternate"/> <content type="html">Huya, I discovered today that the git workflow I've been using for years have a name. Some folks on the internet call this: The stacked diff workflow The idea is to commit over the default branch. And to forget that branches have ever existed.
$ git rebase -i origin/main
Open your text editor for you to re-order, drop, reword the commits that are not upstream.
$ git pull --rebase origin main
Pull the applied commits. Will eventually move your own commits when they get upstreamed. (btw: you should probably make `--rebase` the default).
$ git push origin <commit>:refs/heads/<branch> [-f]
Create (or replace) the remote `<branch>` with the pushed `<commit>`. This last one is the verbose version of `git-push`. It is really not difficult to work with, when you get used to it. The main problem is that you have to remember which branch name you used, to update it… For this, I wrote a simple POSIX Shell script named `git-super`. It will store the branch name in dedicated `git-notes` references. You can pass it a `<commit>` reference, or it will use `HEAD` by default. It can also be used in the middle of an interactive rebase
$ git rebase -i origin/main
... editor fires
pick a679c8d makefile: improve logging
exec git super
pick 6b75321 docker-compose: fix service declaration
pick fc9467e src: fix memory leaks
Here we re-ordered the commit `a679c8d` right after `origin/main`, and then git will execute `git super`. The script will prompt for the branch name, and will push for us. Next time we'll use super with this commit, the push will update the same remote branch. (The first time, `git super` will prompt for the remote it should use while pushing. `origin` is the default value, but you might have to use your writable forge "fork") Now we can just use `git super a679c8d` to update the same remote reference. We don't need to remember the branch name anymore. The script can be found here: => https://git.sr.ht/~stacyharper/dotfiles/tree/master/item/bin/git-super git-super </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/another-cron/</id> <title>Did I write another cron job scheduler?</title> <updated>2024-05-01T00:00:00Z</updated> <link href="gemini://missbanal.net/another-cron/" rel="alternate"/> <content type="html">Sxmo is a Desktop Environment that primarily target embedded devices with not-so-tiny screens we will name here "Smartphones". It is based on a common Linux software stack, and in a more structuring way Tiling Windows Managers (at the moment sway, dwm). => https://sxmo.org Sxmo - Simple X Mobile Today to improve battery longevity, we rely a lot on System Suspension. Which means the OS will shut down most of the hardware, and only some subsystems as Modem and RAM Memory will be kept running. It means that the system is unusable until it woke up again. This happens of course when the user presses the power hardware button. But the system can also be woken up by the modem, on incoming calls or SMS. But then come a common problem: How the user can schedule a task to run periodically? This is a solved issue in a Linux world. Most of the time the system is always alive, so let's just wait for the correct moment to comes. A simple script could just wait for some time, run the user command, and then re-do. But if the user need a more complex scheduler, they generally use a Cronjob Scheduler. If you need to play a song every week-day at 07 AM to wake YOU up: write a crontab entry. In Sxmo we tried to preserve some control over the system suspension to use Cronjob Schedulers. We wrote mnc which is a simple software that parse crontab files, and output the time in second until the next crontab entry (My Next Cron). Then we use this duration to prepare the suspension to sleep until this next job. The system would then sleep, and wake up just in time for the scheduler to trigger the task. => https://git.sr.ht/~anjan/mnc mnc - find seconds to next cronjob Yes! Yes? It never worked… Here is the ticket I wrote, and updated over time to track this: => https://todo.sr.ht/~mil/sxmo-tickets/384 #384: Still unreliable rtc wake with cronjobs It looks like the scheduler loose track of the passed time, while the device was sleeping. With chronie, the job will just never trigger. With fcron, a theoretically more safe with suspension cron scheduler, it can take up to 45 minutes, or more, for the task to actually start. Those Cronjobs Scheduler was just not implemented with suspension in mind. Working around them does not work. But there was a simpler way. I started to implement Mcron, a mobile cron job scheduler. => https://sr.ht/~stacyharper/mcron/ mcron: a sleeping Cron Job Scheduler Mcron does job scheduling in a sleeping way. Instead of tracking time, and checking periodically if the job moments are now, it computes the duration until the next job moments. It creates timer file descriptors in the kernel space, and then it just waits for them to expires, with a simple read system call. And to make the system to wake up when it does, it uses the CLOCK_REALTIME_ALARM system clock.
CLOCK_REALTIME_ALARM (since Linux 3.11)
This clock is like CLOCK_REALTIME, but will wake the system if
it is suspended.
Designed this way, Sxmo does not have to do anything. It will work on any Linux operating system. I program with the Hare programming language for some time now, and I recently used a lot the hare-ev event loop. I knew this was really trivial to implement with. => https://harelang.org The Hare programming language => https://git.sr.ht/~sircmpwn/hare-ev hare-ev - Event loop for Hare Mcron is not packaged yet, because it still depends on some Hare edge patches. But everything has been upstreamed now. And I will package it with the next Hare release. I had to send to the upstream stdlib a tiny patch to help with reading system group. And I worked with Byron Torres, that maintains the Hare date/time support, to fill a hole when creating date time object while switching to different timezone offset. But, It just works. I probably spent a whole weekend time implementing it, writing man pages documentation, and improving the duration computation algorithm. It makes sure the users belongs to the mcron group, and start the task with the correct user authorizations. I expect it is safe to use. => https://sr.ht/~stacyharper/mcron/ mcron - a sleeping Cron Job Scheduler </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/status-update-2024-03/</id> <title>Status update March 2024</title> <updated>2024-03-19T00:00:00Z</updated> <link href="gemini://missbanal.net/status-update-2024-03/" rel="alternate"/> <content type="html">Hello, it's been a long time. Let's try to recap some of the things I have done the last few months. ## Sxmo We continue to improve, to re-factorize, and to fix bugs as they come. Since October, we released 1.15.0 which include the hook unification. What it means is that we now have one "version" of the script hooks for all devices, which include the desktop mode, and the e-reader mode with the new Kobo Clara support. A lot of changes was required for that to land. Also, since the latest Sway 1.9 release, I have dropped our sxmo-sway fork. A lot of discuss was needed on the Alpine packaging side to make this as smooth, transparent, and secure as possible. I tried to avoid the issues we had last time, when we moved to this fork. ## Wvkbd and Bemenu Wayland optimizations Since sometimes I am trying to minimize the cost, and the visual aspect of the first frame rendering. To make this short, it is currently difficult to render the first frame correctly, with the correct scale value. Before that point, bemenu and Wvkbd was blurry on the first frame. This was specially visible on a low-tech device as the Pinephone. Also, Wvkbd adapt the layout, and the height dimension if it detects it is in a landscape mode. It means it was at first taking both of its needed space on the first frame. It was not elegant at all on a tiny screen as a smartphone, because both Wvkbd and other programs have to update their dimension two times while opening the keyboard when landscaped. The problem is that to receive those data from the compositor, both of these programs have to create an initial Wayland surface without knowing anything about the current context. This also depends a lot on the compositor. Some of them would send output data first, some of them would wait for a surface to be created and assigned a role. The Wlroots scene API would eventually continue to change how Sway behave about this on the next release. With my recent patches, and on Sway 1.9, both of these programs render correctly, pixel perfectly, and does not make the other programs to dance too much while landscaped or not. But this will continue to change over time, and releases. So I'll continue to keep an eye on this. ## Hare speak HTTP? I really want to be able to use Hare to build things for the web. One of my plan is to write an IRC-v3 to <less-good-chat-platform-as-Mattermost-or-Slack> single user bridge. For this to happen, first we have to add HTTP support to a Hare library first. I sent some patches, and worked with Drew to push this topic forward. An initial hare-http server API should be merged in a close window. I am now working on a hare-ev HTTP support, because we can't really use a blocking event loop in a real-world web service. What I need first is an easy way to scan the received UTF-8 buffer, while receiving it. At the moment there is no way to distinguish a matched token (an HTTP line), or the end of the current buffer. ## Himitsu remembering consentement Today I am still using my own pass implementation (based on age, and not GPG) as password manager. I'd like to move to Himitsu at some point, but some important features are needed for this to eventually happen: - Synchronization between multiple devices - Consentement remembering for some time The first point could be mitigated with a Syncthing shared folder between device, I guess. But there is currently no work-around for the second point. I have a lot of periodic scripts or programs that are configured to read password from my password manager. I don't want to be prompted every fifteen minutes while synchronizing my emails, calendars, whatever. Ideally I want for Himitsu to prompt me one time for every script, and I would check a "don't ask me again for those entries for a week" mark. That what I started to implement, and sent to the Himitsu mailing list. At the moment it isn't persisted on disks, so it means it does not survive system reboot or daemon restarts yet. But I'll work on this next! Hope I do not forget something important… Well, enough for today! </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/unification-of-my-website/</id> <title>Unification of my website</title> <updated>2023-11-02T00:00:00Z</updated> <link href="gemini://missbanal.net/unification-of-my-website/" rel="alternate"/> <content type="html">Hello! This is a very short message to notice that I squashed both my `www.` and `blog.` domains into one single web site, based on `www.`. I changed the feed entry ids to match the urls, so you probably got double entries for previous posts. Sorry about that! See you soon. </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/status-update-2023-10/</id> <title>Status update July 2023</title> <updated>2023-10-02T00:00:00Z</updated> <link href="gemini://missbanal.net/status-update-2023-10/" rel="alternate"/> <content type="html">Hey there, it's been a while! I've had much fun those months. Let's dig in. ## Wvkbd With Marteen we worked a lot to improve Wvkbd, the virtual keyboard we use on Sxmo. We had a look at existing layers, and we cleaned up a lot of them. Our goal was to reduce the miss-input frequency. We limited the number of keys per layers, and placed them in consistent positions. To reduce miss-inputs, we had to give more feedbacks to the user. When you press a key, you don't really know if your finger touched the correct square, until you look at the typed key in the focused surface. To help on this, I added a new popup surface that display the typed key on top of your finger. This wasn't as easy as it looks like, because I had to figure out how to use xdg_popups with layer_shells. It feels very pleasant to use, and we hope it will help typing overhaul. I also re-worked the Wayland surface initialization flows, and added fractional-scaling-v1 support. Now I expect for Wvkbd to appear perfect on the first frame. We still are waiting for a release of Sway for this problem to be fully closed. ## Hare I have spent most of the last month coding time with Hare. First to bump my personal projects to fix recent Hare API breaking changes. But also to clean up third-party libraries that I use, or that I want to use on new projects. ## Splitter I am working on a Wayland GUI speed-running program in Hare. I mean a GUI program to time runs and splits, display gold splits, display time deltas, or compute the best possible time. This is the kind of program that the speed-runners use when they live streams, or record their tries. The program is very simple and efficient, and need a single input data file INI formatted. Most aspects of the GUI are configurable like the font, colors, transparency. It is also possible to map global key-binds using the command line client. Both client and GUI communicate through a Unix socket. The code is almost done, and just need a bit of cleanup at this point. This is one of the first serious Hare GUI program with a that broad scope. It is the result of the work of many developers, from Hare itself, to Hare libraries and sub-projects: - hare-wayland give the interfaces to talks to the Wayland compositor. It depends on hare-xml. - hare-cairo is the Cairo library bindings and allow us to draw colors and text on the buffers. - hare-xkb is a library binding I wrote myself to interpret correctly keyboard typed key symbols. - hare-ev as event-loop, because we need to redraw periodically the time values. We also need to connect the socket communications to it. It takes a village! I have contributed on those projects as I noticed missing features, or issues. I am very proud of this, cause it proves I understand Wayland as much as I thought, and that I can write a full GUI program from scratch by myself. See you next time, in a month or two, or more :) </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/status-update-2023-07/</id> <title>Status update July 2023</title> <updated>2023-08-02T00:00:00Z</updated> <link href="gemini://missbanal.net/status-update-2023-07/" rel="alternate"/> <content type="html">Hello you, I've been busy, so let's start this status update! ## Fossbill Over the last months I developed the features that was necessary from a freelancer perspective. Last developments concern bill style customization, brand logos URLs, and minor workflow simplification. The installation and update workflows are spotless, and I wrote a documentation companion website to help newcomers. The first stable versions had been released, the test coverage please me and will help me for a long time maintenance, the database migration process is simple. Now I feel like I pushed this project forward enough. I don't expect much from it, but I would like for it to find its users. Also, it was very interesting to develop a Flask application from scratch, with every aspect of a fully working SaaS product. => https://fossbill.org fossbill.org This is the kind of project I like to works for. I would be very happy if I could live from those projects in the long run. ## Sxmo Over the typical maintainer work, I also did a bit for Sxmo by myself. We refactorized the Alpine packaging a lot. Before that point, Sxmo relied on sxmo-utils from aports, and on some meta packages from pmaports. We moved every dependency to new meta packages on aports itself. So now, installing sxmo-utils-common is enough to install everything needed to run a Sxmo + Sway + Pipewire Desktop Environment. Updating packages is now more clean and safe, and it helps to install Sxmo on every Alpine Os machine. => https://lists.sr.ht/~mil/sxmo-devel/%3CCTYCDNHQP7GV.GKM858USWC4K%40yellow-orcess%3E More details here Recently I upstreamed some of the configuration I had from my non-mobile machines. I use Sxmo on every personal computer I have, and feel like some of the glue I use are common enough for general use cases. In the long run I'd like for Sxmo to works decently on every machine out of the box. If you ask why should I use Sxmo and not Sway directly, I would reply that Sxmo embark the needed configurations you'll need anyway. ## Bonsai and Sxmobar bump Recent Hare development caused Bonsai and Sxmobar to fails while building. This is caused by more strict checks on some structure initialization, and minor changes in stdlib APIs. I had to dig into those issues, but fortunately I don't have to detail further. Hare is designed strongly typed, and so as soon as the builds passes, the software behave as correctly as before. Boring! ## Personal life This is summer! I went to the sea, ate mussels, drank some Ricards, and walked overnight on the beaches. This is the first time I wore a swimsuit from about 3 years, and I felt fine. My life is pleasant, but I'll soon have to review again my professional situation. If I can't build a decent income, I'll may have to look at regular job offers. At least to look at jobs on mainstream platforms If I can't advertise myself enough. </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/status-update-2023-06/</id> <title>Status update June 2023</title> <updated>2023-06-14T00:00:00Z</updated> <link href="gemini://missbanal.net/status-update-2023-06/" rel="alternate"/> <content type="html">Hey there! It's been a while. Two months ago I quit my job, and from that moment, I did other stuff than coding. I neglected some aspects of my life for way too long. I developed friendships, took care of my health, felt in love. But while I invested less time in coding than I thought I would, I still did some things. ## Sxmo - regular maintenance Nothing very particular here, but I still flagged a release to sxmo-utils. Main goal was to bump the nerd-fonts icons with the new 3.0.0 release. The Alpine Linux aarch64 pipeline was down for a bit, but the root issue is solved, and it should land soon enough (I hope). ## Fossbill - feature complete I continued to work on Fossbill with an unregular velocity. Still I think the core feature set is now complete. My to-do list for this project now is: - UI style overhaul - Dark theme - Data import/export - SaaS feature scope (disableable feature) I also would like to make the installation process easier. It still needs too much manual step to my tastes. ## Hare/Helios Two months ago I had much fun coding for Hare and Mercury driver. I actually made a working RTC driver, my very first driver! Next step was to implement CPU frequency determination to the Helios kernel, but at this point I think it was too much for me. Anyway I learned a lot while doing so, and I still plan to continue this way. Good surprise was when Drew proposed to me to join the Hare maintainer team. I still feel illegitimate, but I should be better when I will actually make some aarch64 failing tests to pass. ## Professional situation I took time to set up my freelance situation. Now I have the microstructure to actually work as a developer freelance. I still need customers, but I didn't advertise myself anywhere yet. My budget still allow me to keep living for months. At some point, if I still lack the marketing aspect to make it to works, I would eventually fall back to regular job looking. Now I feel I'm back to my computer. There is lot to do, and time pass fast. Take care of yourself. </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/status-update-2023-03/</id> <title>Status update mar 2023</title> <updated>2023-04-01T00:00:00Z</updated> <link href="gemini://missbanal.net/status-update-2023-03/" rel="alternate"/> <content type="html">Hello you. Time to recap what happened to me this month. This should be quick. I don't know if the clock change broke something, but this month passed fast! ## Professional situation In short: 20 days to freedom! I'll have plenty of time to finalize Fossbill. This will be my very first focus because I want a reliable, and working project that I could be proud of. I really don't expect too much of it. If it becomes just a proof of my values, and a tool I can rely on, it would be enough to me. Next I would like to help as I can hire.sr.ht. This is a work in progress SourceHut subspace to seek at hackers. I would prefer to not advertise myself on some rival headhunter platforms. I wish to work on FOSS projects as much as possible. And depending on the situation, I also plan to study kernel driver development. I'll probably finally take time to dig into Helios. I expect the whole code base to be lighter than reading Linux code directly. Hoping the learning curves would be softer, as I will be more fluent with Hare than with Linux C specific ecosystem. ## Sxmo released Some days ago we took some time to release Sxmo, and all subprojects. It went as expected, and we didn't encounter much unplanned edge cases. I just fixed and flagged some minor patches into a 1.14.1 sxmo-utils, to cover a really specific cases where sxmo wasn't checking wakelocks as expected, if an idle inhibiter programs was running. Example if mpv was playing something while the device went in screen-off with a user manual action. ## Fun with NFS + FS-Cache + Cachefiles + OpenVPN Before today, I used a simple Syncthing shared folder to sync my musics between all my devices. The problem is that this music folder now weight ~50 Go, which is a problem for my lightest devices (rockpro64, pinephones). From years and years, I looked at solutions or alternatives to avoid this problem. But today I think I found a way. To quote kernel.org: FS-Cache is a module that provides a caching facility to a network filesystem such that the cache is transparent to the user. The more obvious, and FS-Cache supported network filesystem is NFS. Mhh, I have to set up a bunch of things before I could listen to my musics again... In my Alpine client machines, running the cachefilesd daemon is all I have to do for the FS-cache/Cachefiles part. I can optionally edit the config file /etc/cachefilesd.conf to change the fscache folder path, or the culling limits. Next I have to prepare my server machine to offer the music folder as a NFS. Install nfs-utils, and edit /etc/exports so that the client machines can mount the music path. Then start the NFS daemon and it is done. I initially used read only export rules, but now I have to find a better way. NFS doesn't offer authentication, nor encryption by itself. To have a secured and private NFS, I have to set up a VPN. I avoided this as much as possible through years. But now, it is time. I am ready. And in fact, setting up a self-hosted OpenVPN server isn't that bad. The most tricky part is to understand, prepare, and sign carefully the certificates. The basic idea is to give to OpenVPN the CA certificate, so that it can check that the client use signed ones, with the same CA. On Alpine, we can install easy-rsa to help on this step. Then we rsync the folder /usr/share/easy-rsa/ to a specific folder, one for each client, and one for the CA. Ideally this should be done on all different systems, so that the private keys never leaks. I'll not dig into too many details, here is a good step-by-step: => https://github.com/OpenVPN/easy-rsa/blob/v3.0.0-rc1/README.quickstart.md With all signed client and CA certificates, I am pleased to discover that the rest of the OpenVPN config is very simple. Configuring clients is also very straightforward. Start every daemon, and check with `ip a` that it works. Now that all of my machines talks to each other in a secured way, I can mount my NFS folder through this VPN. The FS-cache works as expected and the cache growths as my system read the files. If I never listen to a music, it never gets downloaded. If storage become rare, the less used cached files will be culled out of the local storage. It is perfect! That's all for this month! Have a nice weekend! Thanks for reading me. </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/status-update-2023-02/</id> <title>Status update feb 2023</title> <updated>2023-02-25T00:00:00Z</updated> <link href="gemini://missbanal.net/status-update-2023-02/" rel="alternate"/> <content type="html">Hey there! Let's try to recap what I've done this month. ## Professional situation I'll keep it short this time, promised! I finally resigned. This situation was painful to me, and unnoticeable for my employers. This was going nowhere better, so I decided I'll choose how and when it will end. I still got a two-month prior until my contract actually ends. It will continue to be painful but at least, I see the end now. Fortunately to me, my lifestyle and personal situation don't require important revenues. So I will have months, maybe a year before it really become precarious. I'll have even more time if I manage to obtain unemployment revenue dues. And if nothing works, well I would just knock at to some company doors, and see if they need another developer, for another proprietary ERP web suite. I would say my mental health is way better :) ## Sxmo support Sway upstream! My monthly spam on the channel #sway-devel finally worked! Two Sway folks reviewed the touch seat operation implementation, and after some iteration, we had it merged. => https://github.com/swaywm/sway/pull/6455 Sway Merge Request - Implement seatop_touch To close this topic, let's recap what it does, and why we needed it that much: On Wayland compositors, the applications only receive events that concern their own surface. A program that is not currently focused don't receive keyboard key press, nor that they receive touch or pointer events outside their "window territory". When I worked on sxmo to support Sway, I had to choose which dmenu like program we will use on this compositor. I chose bemenu because it was the more mature, and the more complete solution. But bemenu was not supporting pointer nor touch events yet. I had to implement those! While coding it, I quickly noticed that the bemenu Wayland backend stopped receiving my touch motion events as soon as I was leaving its surface. It was a problem because the behaviors I was intended to implement would require those events. On sxmo menus, if you hold a touch contact, and leave the surface by the top/bottom edge, it should ask you to go to the previous/next page if you release. What was missing: If you initiate a touch from a surface, the futures events related to this touch (motion or release), should continue to be noticed to the initial surface. Touch position should be relative to the surface. Also, x and y could be negatives or higher than the surface weight or height. In the Sway nomenclature, it is called a seat operation. Touching a surface should initiate this kind of operation, and make next events to behave differently. This is what the Sway merge request is all about! ## About bemenu This week I also took time to test the master branch of bemenu. I saw they implemented two features that we will really appreciate on sxmo, border and fixed height. I haven't much to say about borders. This make the bemenu surface more visible while above other terminals. I just noticed they somehow failed to render correctly the right border. It took me some minutes to figure out they forgot to compute the width using the correct scaling value. It means the right border actually was far away outside the surface. Now let's speak about the fixed height. Previously, bemenu height was recomputed while the entries count was shrinking with filters. It was unpractical on desktops cause the filter line and results was moving on almost every keystroke. And then on mobile it was also unpractical cause filtering was shrinking the height so that it became painful to use touches to select an entry. Enforcing a fixed height made the bemenu positions predictable. While trying this on my Pinephone sxmo, I noticed that the newly generated blank space above the last entry was causing behavior issues with the pointer and touches. I pushed a fix to make it more pleasant to use on mobile. I am now waiting for bemenu to release, and I'll add the needed configuration in sxmo-utils. Peter is also working on stripping some part of the sxmo-dwm status bar so that it will "make dwm and sway look identical". I think he will be pleased to see that now bemenu looks almost exactly like dmenu. ## Sxmo suspension overhaul Aren, a prolific sxmo contributor, brought this topic some weeks ago. Thanks to him, long debates, implementation tentatives, and iterations, we re-implemented almost completely how and when we suspend in sxmo. A bit of context: In sxmo we got three state which are "unlocked", "locked", and "screenoff". While in screenoff, we want to suspend basically as soon as possible. But some rules could restraint this. If an ssh session is connected, a player is running, a modem related action is in progress, we have to hold suspension until there is no more "reason". We had a script named `sxmo_mutex.sh` which was serving this purpose. It could `lock` or `unlock` to maintain the list of reason, and `hold` until the reason list is empty. Additionally, we have an extendable hook to check periodically a bunch of condition, and update the reasons (ssh, mpris player, etc). The fun part is that we could actually rely on the kernel itself to implement this. If Linux is compiled with the enabled capability (CONFIG_PM_WAKELOCKS), it will expose to the user space some interfaces to manipulate wake locks. Reading `/sys/power/wake_lock` give the list of the current wake locks. Writing to this file register a new one, with a conditional argument <timeout> in nanosecond after which the wake lock will automatically expire. Writing to `/sys/power/wake_unlock` remove a wake lock. We replaced our `sxmo_mutex.sh` calls to a `sxmo_wakelock.sh` new script that expose a simple API to manage wake locks. Then we had to choose how we should use this to actually suspend. First option was to write "mem" to `/sys/power/autosleep`. It would enable opportunistic suspension. When no wake locks remains, the kernel will suspend by itself. To keep some kind of control we just have to toggle a kind of "not_screenoff" wake lock while switching from one state to another. Unfortunately we still got some edge cases features that prevent us from relying on this. In sxmo we make it possible to ask for a specific suspension time. It is mostly useful to wake up on time for a cronjob by example. We chose for now to keep some kind of control over suspensions. Instead, we chose to use `/sys/power/wakeup_count`. Reading this file block until there is no remaining wake lock. Writing an integer to this would fail if the number is not the current wake lock count. If writing succeed, it will make the kernel to abort the following suspension if new wake locks has been registered in between. With this, we implemented a very simple `sxmo_autosuspend.sh` daemon that will just loop over and try to suspend when no wake lock remains: => https://git.sr.ht/~mil/sxmo-utils/tree/master/item/scripts/core/sxmo_autosuspend.sh sxmo_autosuspend.sh More documentation here: => https://github.com/torvalds/linux/blob/db77b8502a4071a59c9424d95f87fe20bdb52c3a/Documentation/ABI/testing/sysfs-power Linux ABI - sysfs-power List of the benefits: - Less code on our side to manage the list (and hopefully a more robust code from the kernel) - We decoupled suspension from the screenoff hook itself. `sxmo_autosleep.sh` now is a daemon supervised by superd. - We used wake locks <timeout> values everywhere except in some specific cases ("not_screenoff" by example). Hopefully, it will fix all "my phone was awake when I found it" issues. - The kernel gives useful wake lock statistics with `/sys/kernel/debug/wakeup_sources` - This open possibilities to other programs and daemons to manage their own wake locks so that sxmo does not suspend while they are busy. We should now implement this on eg25-manager and ModemManager, additionally to their elogind support. ## The other stuff I have done a bunch of other stuff, mostly for sxmo this month. I'll not cover everything with deep explanations but here some tl;dr: Peter initiated some status bar icon improvement. Recent releases of Nerd Font added a lot of new cool icons that we really needed. Say "bye bye" to the thermometer that display the modem signal strength. We are waiting for nerd-font update to be merged in aports so that we could merge everything in sxmo-utils. Peter also got additional patches ready to be applied later. I worked on sxmo-dwm to drop the patch to support multi-key, so that I could write a new one to support key-up and key-down events. It now allows us to connect sxmo-dwm to Bonsai and so, unify both our Sway and Dwm environments. Now I can grow more complex Bonsai tree, to handle more complex situations than "sequential hardware button clicks" Fossbill didn't have much of my attention this month. Still, I took some time to adapt the bills workflow and manage an extra "quote" state between "draft" and "bill". I also configured and integrated SQL migrations with Alembic, so that futures changes will be easier to do. And finally, I managed to configure automatic builds of my personal aports. There is also a recipe to cross-compile aarch64 packages using qemu-user. It allows me to skip compiling software on my poor devices. It is such a pleasure to drop nightly recipes, and then upgrade on all my devices to install them. I took more time, and used tools to help me to write this. Hopefully with less english mistakes! If you notice some remaining problems, feels free to contact me. Thanks for reading! </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/status-update-2023-01/</id> <title>Status update jan 2023</title> <updated>2023-01-31T00:00:00Z</updated> <link href="gemini://missbanal.net/status-update-2023-01/" rel="alternate"/> <content type="html">Hello there! I expected that this status update could be shorter than the previous one, but then I started to tell the my life's tale. So, let's get started! ## Personal situation and backstory In those early 2023 days, I went to my ex-boss and explained that I had to leave. That my values are too disaligned with those of the company. That was the tl;dr: I have been working for Synbioz for three years, a french web-development company that focuses on Ruby on Rails development. The company markets some values that are aligned to mine. Things weren't perfect, but it was fine enough. We were using the Google toolsuite for everything, from mails to meets, but were also self-hosting Mattermost and some other okay-tier programs. We were hosting client services under AWS, but were using GitLab and signing our emails with gpg. It was barely good enough for me to stay, but I had other concerns in my personal agenda that were more important. This company has recently been sold to Ouidou, another French company that was founded just 4 years ago. This company already staffs 150 employees around every corner of France. Its fast growth already worried me, because I didn't choose to work for a company with a headcount of about 10 just to end up working for a mega-corporation. The toolset rapidly and dramatically changed, moving from Google (already bad) to Microsoft… Outlook never allowed me to use emails in my setup . Our GitLab plan has been stopped, breaking some CI jobs and removing some features. Our access to our password solution has been closed. Even in the marketing corner, no place for some remaining Synbioz values. So, I knew I would have to leave at some point. I asked politely to leave; I planned to start my own self business. To help me with that project, the safest approach was for me to finish my work contract with what we call in France a "Rupture conventionnelle". Both the employee and the company agree that they should split. This isn't a fire nor a resignation and it allows the employee to earn some unemployement assurance. It also would grant me some financial stability to start a fresh project. My ex-boss agreed, but explained that he isn't the one that making this kind of decision anymore. He asked the HRM, who rapidly refused. The answer was that it would cut into their margins. I could leave anytime cause they basically don't need me. I just have to resign. I felt betrayed because I has been put in a precarious situation without any notice. This made me angry, sad and frustrated, and really affected my mental health. At this point, I am still unsure of what I should do and how. In a perfect world, I would begin my self-employment and work for projects I love. I code for good software that will last, and I build a stable ecosystem of partnership and self-hostable SaaS solutions. I do some consulting and missions on the condition these concern FOSS projects. I take more time to seriously study the Linux kernel and low-level language development (I have more appetite for those than for web development today). I work from home, on my own schedule and rely on a FOSS toolsuite of self-hosted or partnered solutions that I share values with. I'm terrified that I might not be capable of building this stable lifestyle, but I know that I should at least try to! ## Fossbill I was thinking about software I would need as a freelancer, and the most missing part to me was be a billing tool. I asked the Fediverse what FOSS freelancers used, and found no clear answers. This was a perfect occasion to play with Flask again! I started to code for fossbill.org, a simple and fast billing solution with a very tight scope. I need to be able to: - generate drafts and bills easily - compute invoice amounts and taxes - send drafts and bills by email - keep a log of activity (creation date, sent date) - mark bills as paid I think this should cover most of my micro-freelancer needs, at least while starting. It is a great occasion for me to try to build a SaaS service and to gain some experience in that business model. Even if it doesnt take roots, this made me build a real world Flask + SQLAlchemy tool from scratch. This project still is under development and some domain features are still lacking. Some other features I still have to implement cover the business plan: - data import/export - user payment registration - customer invoice generation (for the SaaS service itself) - user customisation configuration ## Following sxmobar - Sxmo status reforged Last status I wrote I initiated an overhaul of the sxmo status bar component displaying. This works is now complete and is waiting for its dependencies to be released. Here are some details: The design is simple: sxmobar only manages the bar components. There is no battery nor network nor any kind of embarked monitoring. You can use it like so:
sxmobar -w -o pango|tty|plain # display and follow the bar on updates
sxmobar -a a-component-name 10 "My component" # add (and override) a component "My component" with order priority 10
sxmobar -d a-component-name # Delete the component
You then use monitoring tools that trigger updates to bar components. This implementation has to be robust and keep a consistent state of the components. Both processes do NOT communicate through IPC nor sockets. Concurrent addition, update or deletion shares a single state file. Re-writing this state file triggers a redraw of the status bar in every sxmobar process that watches. The bar should be displayable as plaintext, tty or pango markup. Which means that the bar can be displayed as swaybar content and as a ssh tmux status line at the same time. Bar components have a foreground and background color, a style and a weight that is specified when adding them. I had to add some missing syscall glue code to Hare for inotify and flock to respectively watch for file rewrite, and prevent concurrent reads and writes. ## See yaa Mhh, and I think this covers my productive time this month. I was less active than usual, as I had difficulties preventing me to focus on interesting problems. I still don't have the structure or freedom I want yet, but if you want to hire me for some cool projects, I am ever open to propositions! Willow, out. </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/status-update-2022-12/</id> <title>Status update dec 2022</title> <updated>2023-01-03T00:00:00Z</updated> <link href="gemini://missbanal.net/status-update-2022-12/" rel="alternate"/> <content type="html">Here my first status update post. I would like to write some of those from now. Just to have a periodic public report of topics I'm working on and things I've done. ## Personal situation This end of year was a perfect occasion for me to take holidays. It's been some years I didn't gone 3 weeks free. This was a perfect moment to clear my todo list of things, to apply some important sxmo patchs and to code for fun. ## sxmo-sway rebased over 1.8 Unfortunately we have to continue rebasing the touch seat operation patch above sway release for some time. I periodically ping sway folks for it to be reviewed and to land in master. The rebase wasn't hard and just some minor fixups was necessary. Nothing broke in the process and now some weeks has passed without issues. ## Hare developments The development of hare-ev arrived in a perfect moment for me to play with it. As I wrote bonsai, an final state machine we use on sxmo to trigger multikey actions, I learnt to hate polling over a list of file descriptor. I still lack some understanding of kernel basics but I slowly close the gap. Hare-ev allow to write hare programs that responds to events, requests, responses in a very easy way. It basically does what you would expect. Register files, connect actions on writes / reads. Plus it arrived with some sugars to handle socket connections, timer triggers, etc. Still I struggled with some issues. It took me some time to report them in a clean enough way to be analysed upstream. Now that most problems are fixed and merged I was able to re-implement some things in bonsai. => https://git.sr.ht/~sircmpwn/hare-ev hare-ev ## Bonsai improvements Bonsai daemon and clients communicate over a unix socket. The daemon also had to handle delay transitions in an asynchronous way. I was using a very ugly way, forking to a sleeping process that would eventually be killed, or woke up to notice to the main process the state had to be updated. Noticing through a pipe I was barelly cleaning up afterward. Rewriting all of this with hare-ev was a real pleasure and simplified all of that crap. I also took time to learn more in detail how to manage more cleanly some memory allocations. The v1 was full of big memory leaks… I still have to wait for some dependency to be released to finalize this work. Until that point, I continue to run master on my local pinephone and didn't noticed problems for days now. The daemon is way more stable and light so I'm very impatient to release it. => https://sr.ht/~stacyharper/bonsai/ Bonsai ## Sxmo status reforged In sxmo we used a very simple script sxmo_status.sh to show the bar, manage components, or to tail it to the Sway bar. Over time we added some pango markups to show some colors or font style. Pango markup doesn't works yet on the dwm bar, nor on plain tty. I initially tried to handle it in with special components nomenclature, that would be stripped accordingly in those environments. The problem is that it make sxmo_status.sh too complex for a shell script. And worsely, the hook that compute the components became horrible to write and to maintain. It was very easy to forget some pango components and to break the global structure. It also broke the simple separator logic. In all ways, it wasn't the good approach. Some days ago I initated a Hare program (again) to manage those use cases cleanly. The component structure got a name, priority, content, style enum, fg and bg color enums. The tail daemon will output in plain, tty or pango. Multiple daemons will be able to tail accordingly in Sway bar, tmux status line or wathever. I hope to finish this work this week so that I can try it on sxmo very soon. I'll have to beta test it a lot cause a crash on the daemon would break completly the status bar without easy way to restart it. ## Conky 1.16 released with Wayland support A very surprising news came from the Conky folks recently. I received a mail noticing activities on a 2014 old ticket about Wayland support for conky. On sxmo we built a dedicated solution to display things on Sway desktop cause we wasn't expecting for it to arrive never. I immediatly tried master to give early feedbacks. One of the main dev took time to cleanup builds and I updated the recipe in the Alpine side for it to land correctly. There still is some minor problems with colors and rescalling but the team seems very responsive to my tickets. I think this could be stable in a very short time. => https://github.com/brndnmtthws/conky/releases/tag/v1.16.0 Conky 1.16.0 release message ## Plans for future This year will not be easy for me. I'm planning to quit my job because I would like to live from foss development. Or at least to try to. It's been years now I'm doing this in my free time and I now feel a real dichotomy with my professional life. My current company has be bought recently and I'm now in a structure I really don't like. Using tools I never would have used before. This is also why I took time to cleanup my websites and to refresh this blog. I must start to give public feedback of what I'm doing. And to detail why I think those matter. Happy new year to you :) see ya! </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/how-to-manage-shell-daemons/</id> <title>How to manage shell daemons</title> <updated>2022-01-14T00:00:00Z</updated> <link href="gemini://missbanal.net/how-to-manage-shell-daemons/" rel="alternate"/> <content type="html">While writing shell script, it is pretty common to need to manage some daemons. Example inspired from sxmo-utils where we got a sxmo_modemmonitor.sh script that listen to dbus signals to dispatch notifications.
dbus-monitor --system "interface='org.freedesktop.ModemManager1.Modem.Voice',type='signal',member='CallAdded'" | \
while read -r line; do
notify-send "$line"
done &
dbus-monitor --system "interface='org.freedesktop.ModemManager1.Modem.Messaging',type='signal',member='Added'" | \
while read -r line; do
notify-send "$line"
done &
This script got a huge issue. It will exit itself after reaching the end of the file. That mean you cannot control the two dbus-monitor subprocess anymore. You'll have to kill each of them manually.
dbus-monitor --system "interface='org.freedesktop.ModemManager1.Modem.Voice',type='signal',member='CallAdded'" | \
while read -r line; do
notify-send "$line"
done &
dbus-monitor --system "interface='org.freedesktop.ModemManager1.Modem.Messaging',type='signal',member='Added'" | \
while read -r line; do
notify-send "$line"
done &
wait
wait
This is a better idea. The two wait will make the script to wait for subjobs to finish. But we still doesnt manage the subprocesses. If you want to be able to clear subprocesses with Ctrl+c or with a kill signal you will do something like this:
dbus-monitor --system "interface='org.freedesktop.ModemManager1.Modem.Voice',type='signal',member='CallAdded'" | \
while read -r line; do
notify-send "$line"
done &
PID1=$!
dbus-monitor --system "interface='org.freedesktop.ModemManager1.Modem.Messaging',type='signal',member='Added'" | \
while read -r line; do
notify-send "$line"
done &
PID2=$!
gracefulexit() {
kill "$PID1"
kill "$PID2"
exit 0
}
trap "gracefulexit" INT TERM
wait "$PID1"
wait "$PID2"
This is the most common way to handle subprocess in shell scripts. But it got one main big issue: `$!` is the pid of the while loop only, not the `dbus-monitor`, not the both of them. In consequence, killing those PID in the trap handler will leave alone the dbus-monitors subprocesses unmanaged. So how to manage those? This is the clean way:
FIFO1="/tmp/fifo1"
mkfifo "$FIFO1"
dbus-monitor --system "interface='org.freedesktop.ModemManager1.Modem.Voice',type='signal',member='CallAdded'" \
>> "$FIFO1" &
PID1=$!
while read -r line; do
notify-send "$line"
done < "$FIFO1" &
PID2=$!
FIFO2="/tmp/fifo2"
mkfifo "$FIFO2"
dbus-monitor --system "interface='org.freedesktop.ModemManager1.Modem.Messaging',type='signal',member='Added'" \
>> "$FIFO2" &
PID3=$!
while read -r line; do
notify-send "$line"
done < "$FIFO2" &
PID4=$!
gracefulexit() {
kill "$PID1"
kill "$PID2"
kill "$PID3"
kill "$PID4"
rm "$FIFO1"
rm "$FIFO2"
exit 0
}
trap "gracefulexit" INT TERM EXIT
wait "$PID1"
wait "$PID2"
wait "$PID3"
wait "$PID4"
This use named pipe fifo files to separate both commands and to grab each pids. Here is two tips to make it simple and clean:
daemon_pids_cache="$(mktemp)"
start_daemon() {
"$@" &
printf "%s\n" "$!" >> "$daemon_pids_cache"
}
stop_daemons() {
while read -r PID; do
kill "$PID"
done < "$daemon_pids_cache"
rm "$daemon_pids_cache"
}
PIDS=""
start_daemon dbus-monitor --system "interface='org.freedesktop.ModemManager1.Modem.Voice',type='signal',member='CallAdded'" | \
while read -r line; do
notify-send "$line"
done &
PIDS="$PIDS $!"
start_daemon dbus-monitor --system "interface='org.freedesktop.ModemManager1.Modem.Messaging',type='signal',member='Added'" | \
while read -r line; do
notify-send "$line"
done &
PIDS="$PIDS $!"
gracefulexit() {
stop_daemons
for PID in $PIDS; do
kill "$PID"
done
exit 0
}
trap "gracefulexit" INT TERM EXIT
for PID in $PIDS; do
wait "$PID"
done
</content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/perfect-znc-setup/</id> <title>Perfect ZNC Multi-Client Setup</title> <updated>2021-05-28T00:00:00Z</updated> <link href="gemini://missbanal.net/perfect-znc-setup/" rel="alternate"/> <content type="html">By default, ZNC handle the playback. When no client is connected, it will store missed messages and play them back when you log in with an IRC client. But if you got multiple IRC client in multiple device, login with one of them will make the others to never receive the messages. clientbuffer is a module to fix that! It will track what message all of your IRC clients received. ## Configure clientbuffer We have to compile it as it is not a base module.
$ apt install unzip znc-dev
$ curl -o v1.0.48.zip https://github.com/CyberShadow/znc-clientbuffer/archive/refs/tags/v1.0.48.zip
$ unzip v1.0.48.zip
$ cd znc-clientbuffer-1.0.48/
$ znc-buildmod clientbuffer.cpp
$ mkdir -p /var/lib/znc/modules/
$ cp clientbuffer.so /var/lib/znc/modules/
## Connect to ZNC Use this as username: "username@CLIENTNAME/network" Here CLIENTNAME will be used by clientbuffer to identify this client. Make it unique per client. ## Enable clientbuffer on each network
/msg *controlpanel set AutoClearChanBuffer $me False
/msg *controlpanel set AutoClearQueryBuffer $me False
/msg *status LoadMod clientbuffer autoadd timelimit=86400
git push origin d575e61a:a-super-dev -fn
You can notice the `-fn`. The distant repository will then give you something like
To git.sr.ht:~stacyharper/a-good-project.git
+ cfc907c4...d575e61a d575e61a -> a-super-dev (forced update)
You now can `git diff cfc907c4..d575e61a` (removing one dot) to display the difference. If it seems correct, you then can use the same git push command, removing the last `n` argument. </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/why-gemini/</id> <title>The web is dead</title> <updated>2020-09-19T00:00:00Z</updated> <link href="gemini://missbanal.net/why-gemini/" rel="alternate"/> <content type="html">Mozilla Firefox is falling and becoming a sponsorship showcase, only subsist in the mainstream line Google Chrome and other Chromium derivates, Safari which has never been a concurrent, and other minor alternatives as Webengine ones. At writing time, Chrome owns 81% of the web browser usage statistics. This huge usage monopoly give Google a real power over the web evolutions. Pushing new features as standards forces concurrent to follow implementations or to become obsoletes. WWW tend towards complexity. A this time, it is no longer possible for someone or worse some company to build a new web browser. The scope of feature a web browser have to provide is now way to large to be developed, worsly to be defined. So the only web browser that exists and will exists in the future are the ones that already exists at the moment. Here was a rapid part of the state of the world wide web at this writing time. However, the WWW firstly was a way to easily share contents based on a simple HTTP markup language. A simple but complete web browser could be wrote by a small group in a pretty decent amount of time. This gave the web its decentralized, not owned and XXX spirit. Somehow people lost the control over the web and we are now in a state where:
=> /foo An url
=> gemini://my.capsule.com/foo Another url
'''
a pre-formated
content
'''
Everything not listed here is not allowed by the language. As you can see, only 3 title levels exists. The way to display it is up to the client choice. This is not the content owner that choose how to display it. ## Conclusion The Gemini community still is pretty new but very active. People take pleasure to write personal capsules (the Gemini way to refer to websites) and other blog related content. People use this environment to share thoughts easily. There already is two search engine and aggregated feeds to browse content from the Geminiverse. </content> <author><name>Willow Barraco</name></author> </entry> <entry> <id>gemini://missbanal.net/unit-tests-the-curse-worse-than-the-causes/</id> <title>Unit tests, the curse worse than the cause</title> <updated>2020-08-12T00:00:00Z</updated> <link href="gemini://missbanal.net/unit-tests-the-curse-worse-than-the-causes/" rel="alternate"/> <content type="html">Criticizing unit tests is uncommon. Anyway I'll try to explain why I think we should stop writing them. Unit testing is a practice that generally follow when you learning about the SOLID principle. Having a single responsibility per subject is commonly narrated to simplify testing.
class FooRepository
def get_foos
...
end
end
class GetFoosUseCase
def initialize(foo_repo)
@foo_repo = foo_repo
end
def call
...
end
end
One of the approach to test this code is to write unit tests that will check every class independently. The idea is that if every tests passes, then the whole project should be fine. This structure, with injected dependency truly give the hand to the testes to create dedicated contexts around tested subjects.
class TestGetFoosUseCase
mocked_repo = Mock.new.to("get_foos").reply(["a mocked foo"])
subject = GetFoosUseCase.new(mocked_repo)
def test_get_foos
assert subject.get_foos == ["a mocked foo"]
end
end
Do you think this test is stupid and tautological ? I think most of contextual tests actually are. Anyway, to write this kind of tests you got to know how the `GetFoosUseCase` works as you got to know that a call to `@foo_repo.get_foos` is done somewhere. That why I think the ideological "write tests first" is a myth in the unit test world. So now my point is: You though very hard to write SOLID classes and method, limiting coupling as much as you can, and THEN you wrote a completely coupled test suite, as the tests got to know how the context around the subject is working.
class TestGetFoosUseCase
def test_get_foos
assert container("GetFoosUseCase").get_foos == ["a fixtured foo"]
end
end
I think this test code got a huge value, way more than the previous one. It cover way more code as it will go through the `GetFoosUseCase` and the `FooRepository` classes. It will stay the same if you re-factorise both those classes so it is easier to maintain. You can add features in the `GetFoosUseCase` and this test will still be valid and tells you if it still return the fixtured foo. Does this functional test is perfect? Not at all. But it will perfectly serve the automatic test suite purpose: