commit 7dd11dfe217322aba9d3a8c1af87cc97faf98ad4 Author: balkian Date: Mon Feb 17 23:23:44 2025 +0000 Deploying to gh-pages from @ balkian/balkian.github.com@746dc0142812ad493a6a8be4670ddd840548295a 🚀 diff --git a/404.html b/404.html new file mode 100644 index 0000000..cf79805 --- /dev/null +++ b/404.html @@ -0,0 +1,16 @@ +404 Page not found +

Not Found

This page does not exist

\ No newline at end of file diff --git a/CNAME b/CNAME new file mode 100644 index 0000000..acfba47 --- /dev/null +++ b/CNAME @@ -0,0 +1 @@ +balkian.com \ No newline at end of file diff --git a/archives/index.html b/archives/index.html new file mode 100644 index 0000000..e6a1171 --- /dev/null +++ b/archives/index.html @@ -0,0 +1,14 @@ +Archives +

Programming

Linux

2025

uv - One rust tool to rule all pythons

2023

Nix Recipe for Python Projects

Kanata: advanced keyboard configuration

2021

Logitech MB850 combi in linux

Logitech MX Keys for Mac on Linux

2019

Linux on the Microsoft Surface Go

Controlling Zigbee devices with MQTT

2016

Progress bars in python

2015

Sharing dotfiles

2014

Zotero

Proxies with Apache and python

Publishing on PyPi

Updating EuroLoveMap

2013

Remove git files with globbing

Creating my web

\ No newline at end of file diff --git a/categories/index.html b/categories/index.html new file mode 100644 index 0000000..f0ae71e --- /dev/null +++ b/categories/index.html @@ -0,0 +1,31 @@ +Categories +

Section

2 pages

Posts related to installing, maintaining and running GNU/Linux

Linux on the Microsoft Surface Go

Linux

\ No newline at end of file diff --git a/categories/linux/index.xml b/categories/linux/index.xml new file mode 100644 index 0000000..15f2353 --- /dev/null +++ b/categories/linux/index.xml @@ -0,0 +1,230 @@ +Linux on J. Fernando Sánchezhttps://balkian.com/categories/linux/Recent content in Linux on J. Fernando SánchezHugo -- gohugo.ioen-usSat, 01 Jun 2019 00:00:01 +0000Linux on the Microsoft Surface Gohttps://balkian.com/p/linux-on-the-microsoft-surface-go/Sat, 01 Jun 2019 00:00:01 +0000https://balkian.com/p/linux-on-the-microsoft-surface-go/Believe it or not, Surface tablets have pretty good linux support, except for the webcams in newer models. +These are some useful notes to get Ubuntu installed in your surface go, as of Summer 2019. +<h2 id="installing-the-kernel">Installing the kernel +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">git clone --depth 1 https://github.com/jakeday/linux-surface.git ~/linux-surface +cp -a ~/linux-surface /media/<your usb> +</code></pre></td></tr></table> +</div> +</div><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">cp -a /media/<your usb>/linux-surface ~/ +cd ~/linux-surface/ +sudo sh setup.sh +</code></pre></td></tr></table> +</div> +</div><h2 id="booting-ubuntu-first">Booting ubuntu first +</h2>Switch out of Windows S mode. +Boot into the “Command Prompt”. +From Windows go to “change advanced startup options” and select “restart now”. +When it reboots, choose the “Troubleshoot” option, then choose the “Advanced options” option, and finally choose the “Command Prompt” option. +After the device reboots, login to the command prompt and then you should see a terminal with X:\windows\system32> +At the prompt, check your UEFI entries: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /enum firmware +</code></pre></td></tr></table> +</div> +</div>Copy UEFI entry of “Windows Boot Manager” to create a new entry for Ubuntu: bcdedit /copy {bootmgr} /d “Ubuntu” +Copy the printed GUID number including the braces {} using Ctrl+C +Set file path for the new Ubuntu entry. Replace {guid} with the returned GUID of the previous command (Ctrl+V). bcdedit /set {guid} path \EFI\ubuntu\grubx64.efi +Set Ubuntu as the first/ entry in the boot sequence. Again replace {guid} with the returned GUID of the copy command. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /set {fwbootmgr} displayorder {guid} /addfirst +</code></pre></td></tr></table> +</div> +</div>Check your UEFI entries again: bcdedit /enum firmware You should see something like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"> +Firmware Boot Manager +--------------------- +identifier {fwbootmgr} +displayorder {3510232e-f8eb-e811-95ce-9ecab3f9d1c4} + {bootmgr} + {2148799b-f8eb-e811-95ce-9ecab3f9d1c4} + {312e8a67-c2f6-e811-95ce-3c1ab3f9d1de} + {312e8a68-c2f6-e811-95ce-3c1ab3f9d1de} +timeout 0 +</code></pre></td></tr></table> +</div> +</div>Make sure the GUID you copied is the first one listed in displayorder. Then type exit, turn off the PC and turn it back on. After this my surface go is automatically booting to the grub bootloader which lets me choose between Windows and Ubuntu but defaults to Ubuntu after ten seconds.Linuxhttps://balkian.com/linux/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/linux/<img src="https://balkian.com/img/linux.png" alt="Featured image of post Linux" /><h2 id="black-screen-and-lightdm-doesnt-unlock">Black screen and LightDM doesn’t unlock +</h2>Add this to your /etc/lightdm/lightdm.conf file: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[LightDM] +logind-check-graphical=true +</code></pre></td></tr></table> +</div> +</div>##Edit previous commands +<code>fc</code> is a shell builtin to list and edit previous commands in an editor. +In addition to editing a single line (which you can also do with <code>C-x C-e</code>), it also allows you to edit and run several lines at the same time. +You use it like this: +List previous commands +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -l +10259 nvim deploy.sh +10260* cd .. +10261* nvim content/cheatsheet/linux.md +10262 cd +</code></pre></td></tr></table> +</div> +</div>List commands with date (in zsh) +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -ld +10260* 19:38 cd .. +10261* 19:38 nvim content/cheatsheet/linux.md +10262 19:40 cd +10263 19:40 fc -l +</code></pre></td></tr></table> +</div> +</div>You can add the date too: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -fld +10262 1/10/2019 19:40 cd +10263 1/10/2019 19:40 fc -l +10264 1/10/2019 19:40 fc -ld +</code></pre></td></tr></table> +</div> +</div>You can edit a range of commands +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc 10262 10264 +</code></pre></td></tr></table> +</div> +</div>The range can be relative to the current position, so the previous command is equivalent to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -3 -1 +</code></pre></td></tr></table> +</div> +</div>If you save and exit, all commands are executed as a script, and it will be added to your history. +Source: <a class="link" href="https://shapeshed.com/unix-fc/" target="_blank" rel="noopener" +>https://shapeshed.com/unix-fc/</a> +<h2 id="prevent-logoff-from-killing-tmux-sessions">Prevent logoff from killing tmux sessions +</h2>Lately I’ve noticed that logging out of i3, intentionally or when i3 fails, would also kill any tmux or emacs sessions. +This is extremely annoying. +This is caused by a new default in logind (systemd’s login) to kill user process on logoff. +You can revert this setting in your logind.conf (<code>/etc/systemd/logind.conf</code>): +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">KillUserProcesses=no +</code></pre></td></tr></table> +</div> +</div>Or only for a specific process (e.g., tmux): +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">systemd-run --scope --user tmux +</code></pre></td></tr></table> +</div> +</div>Source: <a class="link" href="https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session" target="_blank" rel="noopener" +>https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session</a> +<h2 id="upload-a-temporary-file">Upload a temporary file +</h2>Sometimes you just need to copy/paste a file from a server, and copying from the terminal can be a hassle. +These two services are command-line “pastebins” just one curl away: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +8 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><command> | curl -F 'sprunge=<-' http://sprunge.us +# OR + +<command> 2>&1 | curl -F 'f:1=<-' ix.io + +# OR + +<command> | curl -F"file=@-" https://ttm.sh +</code></pre></td></tr></table> +</div> +</div><h1 id="install-fortinet-sslvpn-support-for-networkmanager">Install Fortinet SSLVPN support for NetworkManager +</h1>UPM (Universidad Politécnica de Madrid) uses a propriatary VPN solution. +The instructions for GNU/Linux on their website involve downloading a specific client (<code>.tar.gz</code>) and manually running it. +That works, but it is kind of a hassle. +A much more convenient alternative is installing this NetworkManager plugin: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">pacman -Sy networkmanager-fortisslvpn +# Or apt get install networkmanager-fortisslvpn +</code></pre></td></tr></table> +</div> +</div>Now you can simply add a new VPN connection in NetworkManager and manage it as you would any other connection. \ No newline at end of file diff --git a/categories/linux/page/1/index.html b/categories/linux/page/1/index.html new file mode 100644 index 0000000..205d05b --- /dev/null +++ b/categories/linux/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/categories/linux/ + \ No newline at end of file diff --git a/categories/page/1/index.html b/categories/page/1/index.html new file mode 100644 index 0000000..32e2c10 --- /dev/null +++ b/categories/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/categories/ + \ No newline at end of file diff --git a/categories/programming/index.html b/categories/programming/index.html new file mode 100644 index 0000000..cffd5fa --- /dev/null +++ b/categories/programming/index.html @@ -0,0 +1,31 @@ +Category: Programming - J. Fernando Sánchez +

2 pages

Programming

Posts related to programming languages

uv - One rust tool to rule all pythons

Python

\ No newline at end of file diff --git a/categories/programming/index.xml b/categories/programming/index.xml new file mode 100644 index 0000000..d5e2c43 --- /dev/null +++ b/categories/programming/index.xml @@ -0,0 +1,147 @@ +Programming on J. Fernando Sánchezhttps://balkian.com/categories/programming/Recent content in Programming on J. Fernando SánchezHugo -- gohugo.ioen-usMon, 17 Feb 2025 23:02:47 +0100uv - One rust tool to rule all pythonshttps://balkian.com/p/uv-one-rust-tool-to-rule-all-pythons/Mon, 17 Feb 2025 23:02:47 +0100https://balkian.com/p/uv-one-rust-tool-to-rule-all-pythons/<img src="https://balkian.com/img/uv.png" alt="Featured image of post uv - One rust tool to rule all pythons" />Long story short: I’m now using <a class="link" href="https://github.com/astral-sh/uv" target="_blank" rel="noopener" +>uv</a>, and so should you. +It is a great replacement for pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +<h2 id="context">Context +</h2>For years, my strategy to manage python projects has been a mix of a custom <code>setup.py</code>, several hand-crafted <code>requirements.txt</code> files (through <code>pip freeze</code>), a custom virtualenv per project, and multiple tools to upload to PyPI. +Although this works, this setup has many drawbacks: +<ul> +<li>It requires user intervention (creating a venv, sourcing it, handling new deps). This isn’t ideal if you want new (probably inexperienced) users to use your projects.</li> +<li>On a similar note, the whole process needs to be well documented if you want other users to contribute or maintain the code.</li> +<li>Pinning dependency versions is finicky, and I’ve run into problems beause of that.</li> +<li>Creating a new project involves a template, or copying files from an older project.</li> +</ul> +Of course, this is nothing new. +There is a whole site dedicated to <a class="link" href="https://packaging.python.org/en/latest/" target="_blank" rel="noopener" +>packaging your Python project</a>. +A plethora of different projects have come and go, with varying degrees of success. +<h2 id="alternatives-poetry">Alternatives (poetry) +</h2>About a year before trying <code>uv</code>, I tried to catch up with the ecosystem and get to know the <code>blessed new way</code>. +However, the task proved to be a little more difficult, as the landscape is filled with a myriad of alternatives, each with their own set of drawbacks and detractors. +Packaging has historically been a weak spot, in ironical contradiction to the Zen of Python’s “There should be one– and preferably only one –obvious way to do it”, +I eventually settled on <a class="link" href="https://python-poetry.org/" target="_blank" rel="noopener" +>poetry</a>. +Mostly because it seemed like the most popular alternative. +There are many things I liked about it. +First of all, having a convention for dependencies (<code>pyproject.toml</code>) and a tool that properly handles them was nice. +It also removed the need to remember specific incantations to build and publish my Python projects. +Lastly, I mixed it <code>poetry2nix</code> to create reproducible python environments using nix. +This makes for a very powerful experience. +However, there were multiple hiccups. +First of all, it took me some time to figure out which specific fields to use (each tool can define ad-hoc properties in a the <code>pyproject.toml</code> file), and some of them seemed redundant with the more generic ones. +Full disclosure, this specific point might be a mistake on my side, and I do not remember the details. +The second one is speed. +(Re-)creating an environment took a non-negligible amount of time. +<h2 id="enter-light-uv">Enter <del>light</del> <code>uv</code> +</h2>According to its repository, <code>uv </code>can replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +Not only that, but it also claims to do that 10-100 times faster than pip. +I must admit that it being written in rust was a another selling point for me, as I’m looking for excuses to collaborate in a decently-sized rust projejct. +Installing it is dead simple: simply download the binary (e.g., with curl) or run <code>pip install uv</code>. +You won’t need much more: <code>uv</code> seems to just do the right thing out of the box. +And it does it really, really fast. +The rest of the time it gets out of the way. +My only gripe so far is that I don’t seem to find a built-in command to drop into a shell, but that is nothing that <code>uv run $SHELL</code> cannot fix. +<h2 id="common-operations">Common operations +</h2><h3 id="initialize-a-repository">Initialize a repository +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv init +</code></pre></td></tr></table> +</div> +</div><h3 id="adding-dependencies">Adding dependencies +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv add senpy +</code></pre></td></tr></table> +</div> +</div><h3 id="running-commands-inside-the-environment">Running commands inside the environment +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv run <COMMAND> + +# e.g., run a shell using your python version and dependencies +uv run $SHELL +</code></pre></td></tr></table> +</div> +</div><h3 id="dependency-tree">Dependency tree +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv shell +Resolved 44 packages in 1ms +my-project v0.1.0 +├── fastapi[standard] v0.115.8 +│ ├── pydantic v2.10.6 +│ │ ├── annotated-types v0.7.0 +│ │ ├── pydantic-core v2.27.2 +│ │ │ └── typing-extensions v4.12.2 +│ │ └── typing-extensions v4.12.2 +│ ├── starlette v0.45.3 +│ │ └── anyio v4.8.0 +│ │ ├── exceptiongroup v1.2.2 +│ │ ├── idna v3.10 +│ │ ├── sniffio v1.3.1 +│ │ └── typing-extensions v4.12.2 +│ ├── typing-extensions v4.12.2 +│ ├── email-validator v2.2.0 (extra: standard) +│ │ ├── dnspython v2.7.0 +... +</code></pre></td></tr></table> +</div> +</div>Pythonhttps://balkian.com/python/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/python/<img src="https://balkian.com/img/python.png" alt="Featured image of post Python" /><h2 id="interesting-libraries">Interesting libraries +</h2><h3 id="tqdm"><a class="link" href="https://github.com/tqdm/tqdm" target="_blank" rel="noopener" +>TQDM</a> +</h3>From tqdm’s github repository: +<blockquote> +tqdm means “progress” in Arabic (taqadum, تقدّم) and an abbreviation for “I love you so much” in Spanish (te quiero demasiado).</blockquote> +<img src="https://raw.githubusercontent.com/tqdm/tqdm/master/images/tqdm.gif" +loading="lazy" +alt="TQDM in action" +> +<h2 id="tools">Tools +</h2><h3 id="uv"><a class="link" href="https://github.com/astral-sh/uv" target="_blank" rel="noopener" +>uv</a> +</h3>🚀 A single tool to replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +⚡️ 10-100x faster than pip. +<ul> +<li>Provides comprehensive project management, with a universal lockfile.</li> +<li>Runs scripts, with support for inline dependency metadata.</li> +<li>Installs and manages Python versions.</li> +<li>Runs and installs tools published as Python packages.</li> +<li>Includes a pip-compatible interface for a performance boost with a familiar CLI.</li> +<li>Supports Cargo-style workspaces for scalable projects.</li> +<li>Disk-space efficient, with a global cache for dependency deduplication.</li> +<li>Installable without Rust or Python via curl or pip.</li> +<li>Supports macOS, Linux, and Windows.</li> +</ul> \ No newline at end of file diff --git a/categories/programming/page/1/index.html b/categories/programming/page/1/index.html new file mode 100644 index 0000000..455331e --- /dev/null +++ b/categories/programming/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/categories/programming/ + \ No newline at end of file diff --git a/emacs/index.html b/emacs/index.html new file mode 100644 index 0000000..03e57f6 --- /dev/null +++ b/emacs/index.html @@ -0,0 +1,26 @@ +Emacs +

Emacs

Configuration files and tricks for emacs

Show plain text version

1
+(font-lock-mode)
+

\ No newline at end of file diff --git a/favicon.png b/favicon.png new file mode 100644 index 0000000..e53125d Binary files /dev/null and b/favicon.png differ diff --git a/img/2014/04/pic02.jpg b/img/2014/04/pic02.jpg new file mode 100644 index 0000000..385722d Binary files /dev/null and b/img/2014/04/pic02.jpg differ diff --git a/img/2014/04/pic03.jpg b/img/2014/04/pic03.jpg new file mode 100644 index 0000000..692fb88 Binary files /dev/null and b/img/2014/04/pic03.jpg differ diff --git a/img/2014/09/pic01.jpg b/img/2014/09/pic01.jpg new file mode 100644 index 0000000..3bd5296 Binary files /dev/null and b/img/2014/09/pic01.jpg differ diff --git a/img/emacs.png b/img/emacs.png new file mode 100644 index 0000000..4c7cd3b Binary files /dev/null and b/img/emacs.png differ diff --git a/img/linux.png b/img/linux.png new file mode 100644 index 0000000..199163c Binary files /dev/null and b/img/linux.png differ diff --git a/img/logo-origin.png b/img/logo-origin.png new file mode 100644 index 0000000..bd2017c Binary files /dev/null and b/img/logo-origin.png differ diff --git a/img/logo.jpeg b/img/logo.jpeg new file mode 100644 index 0000000..21e225f Binary files /dev/null and b/img/logo.jpeg differ diff --git a/img/main/logo.jpg b/img/main/logo.jpg new file mode 100644 index 0000000..3098370 Binary files /dev/null and b/img/main/logo.jpg differ diff --git a/img/me-bat.png b/img/me-bat.png new file mode 100644 index 0000000..bd2017c Binary files /dev/null and b/img/me-bat.png differ diff --git a/img/me.png b/img/me.png new file mode 100644 index 0000000..691023e Binary files /dev/null and b/img/me.png differ diff --git a/img/me_hu_caa0902d7ae4598e.png b/img/me_hu_caa0902d7ae4598e.png new file mode 100644 index 0000000..9a09a75 Binary files /dev/null and b/img/me_hu_caa0902d7ae4598e.png differ diff --git a/img/python.png b/img/python.png new file mode 100644 index 0000000..3b63931 Binary files /dev/null and b/img/python.png differ diff --git a/img/rpi.png b/img/rpi.png new file mode 100644 index 0000000..58bd721 Binary files /dev/null and b/img/rpi.png differ diff --git a/img/uv.png b/img/uv.png new file mode 100644 index 0000000..bca946e Binary files /dev/null and b/img/uv.png differ diff --git a/index.html b/index.html new file mode 100644 index 0000000..15999e7 --- /dev/null +++ b/index.html @@ -0,0 +1,43 @@ +J. Fernando Sánchez +

Programming

uv - One rust tool to rule all pythons

Nix Recipe for Python Projects

Kanata: advanced keyboard configuration

Logitech MB850 combi in linux

Logitech MX Keys for Mac on Linux

\ No newline at end of file diff --git a/index.xml b/index.xml new file mode 100644 index 0000000..0de6616 --- /dev/null +++ b/index.xml @@ -0,0 +1,1602 @@ +J. Fernando Sánchezhttps://balkian.com/Recent content on J. Fernando SánchezHugo -- gohugo.ioen-usMon, 17 Feb 2025 23:02:47 +0100uv - One rust tool to rule all pythonshttps://balkian.com/p/uv-one-rust-tool-to-rule-all-pythons/Mon, 17 Feb 2025 23:02:47 +0100https://balkian.com/p/uv-one-rust-tool-to-rule-all-pythons/<img src="https://balkian.com/img/uv.png" alt="Featured image of post uv - One rust tool to rule all pythons" />Long story short: I’m now using <a class="link" href="https://github.com/astral-sh/uv" target="_blank" rel="noopener" +>uv</a>, and so should you. +It is a great replacement for pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +<h2 id="context">Context +</h2>For years, my strategy to manage python projects has been a mix of a custom <code>setup.py</code>, several hand-crafted <code>requirements.txt</code> files (through <code>pip freeze</code>), a custom virtualenv per project, and multiple tools to upload to PyPI. +Although this works, this setup has many drawbacks: +<ul> +<li>It requires user intervention (creating a venv, sourcing it, handling new deps). This isn’t ideal if you want new (probably inexperienced) users to use your projects.</li> +<li>On a similar note, the whole process needs to be well documented if you want other users to contribute or maintain the code.</li> +<li>Pinning dependency versions is finicky, and I’ve run into problems beause of that.</li> +<li>Creating a new project involves a template, or copying files from an older project.</li> +</ul> +Of course, this is nothing new. +There is a whole site dedicated to <a class="link" href="https://packaging.python.org/en/latest/" target="_blank" rel="noopener" +>packaging your Python project</a>. +A plethora of different projects have come and go, with varying degrees of success. +<h2 id="alternatives-poetry">Alternatives (poetry) +</h2>About a year before trying <code>uv</code>, I tried to catch up with the ecosystem and get to know the <code>blessed new way</code>. +However, the task proved to be a little more difficult, as the landscape is filled with a myriad of alternatives, each with their own set of drawbacks and detractors. +Packaging has historically been a weak spot, in ironical contradiction to the Zen of Python’s “There should be one– and preferably only one –obvious way to do it”, +I eventually settled on <a class="link" href="https://python-poetry.org/" target="_blank" rel="noopener" +>poetry</a>. +Mostly because it seemed like the most popular alternative. +There are many things I liked about it. +First of all, having a convention for dependencies (<code>pyproject.toml</code>) and a tool that properly handles them was nice. +It also removed the need to remember specific incantations to build and publish my Python projects. +Lastly, I mixed it <code>poetry2nix</code> to create reproducible python environments using nix. +This makes for a very powerful experience. +However, there were multiple hiccups. +First of all, it took me some time to figure out which specific fields to use (each tool can define ad-hoc properties in a the <code>pyproject.toml</code> file), and some of them seemed redundant with the more generic ones. +Full disclosure, this specific point might be a mistake on my side, and I do not remember the details. +The second one is speed. +(Re-)creating an environment took a non-negligible amount of time. +<h2 id="enter-light-uv">Enter <del>light</del> <code>uv</code> +</h2>According to its repository, <code>uv </code>can replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +Not only that, but it also claims to do that 10-100 times faster than pip. +I must admit that it being written in rust was a another selling point for me, as I’m looking for excuses to collaborate in a decently-sized rust projejct. +Installing it is dead simple: simply download the binary (e.g., with curl) or run <code>pip install uv</code>. +You won’t need much more: <code>uv</code> seems to just do the right thing out of the box. +And it does it really, really fast. +The rest of the time it gets out of the way. +My only gripe so far is that I don’t seem to find a built-in command to drop into a shell, but that is nothing that <code>uv run $SHELL</code> cannot fix. +<h2 id="common-operations">Common operations +</h2><h3 id="initialize-a-repository">Initialize a repository +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv init +</code></pre></td></tr></table> +</div> +</div><h3 id="adding-dependencies">Adding dependencies +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv add senpy +</code></pre></td></tr></table> +</div> +</div><h3 id="running-commands-inside-the-environment">Running commands inside the environment +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv run <COMMAND> + +# e.g., run a shell using your python version and dependencies +uv run $SHELL +</code></pre></td></tr></table> +</div> +</div><h3 id="dependency-tree">Dependency tree +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv shell +Resolved 44 packages in 1ms +my-project v0.1.0 +├── fastapi[standard] v0.115.8 +│ ├── pydantic v2.10.6 +│ │ ├── annotated-types v0.7.0 +│ │ ├── pydantic-core v2.27.2 +│ │ │ └── typing-extensions v4.12.2 +│ │ └── typing-extensions v4.12.2 +│ ├── starlette v0.45.3 +│ │ └── anyio v4.8.0 +│ │ ├── exceptiongroup v1.2.2 +│ │ ├── idna v3.10 +│ │ ├── sniffio v1.3.1 +│ │ └── typing-extensions v4.12.2 +│ ├── typing-extensions v4.12.2 +│ ├── email-validator v2.2.0 (extra: standard) +│ │ ├── dnspython v2.7.0 +... +</code></pre></td></tr></table> +</div> +</div>Nix Recipe for Python Projectshttps://balkian.com/p/nix-recipe-for-python-projects/Mon, 13 Nov 2023 18:21:46 +0100https://balkian.com/p/nix-recipe-for-python-projects/This is a quick and easy recipe to add a <code>default.nix</code> to any Python project with a <code>requirements.txt</code> file: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-nix" data-lang="nix">with import <nixpkgs> { }; + +let + pythonPackages = python311Packages; +in pkgs.mkShell rec { + name = "impurePythonEnv"; + venvDir = "./.venv"; + buildInputs = [ + # A python interpreter including the 'venv' module is required to bootstrap + # the environment. + pythonPackages.python + + # This execute some shell code to initialize a venv in $venvDir before + # dropping into the shell + pythonPackages.venvShellHook + + # Those are dependencies that we would like to use from nixpkgs, which will + # add them to PYTHONPATH and thus make them accessible from within the venv. + pythonPackages.numpy + pythonPackages.requests + + # In this particular example, in order to compile any binary extensions they may + # require, the python modules listed in the hypothetical requirements.txt need + # the following packages to be installed locally: + taglib + openssl + git + libxml2 + libxslt + libzip + zlib + ]; + + # Now we can execute any commands within the virtual environment. + # This is optional and can be left out to run pip manually. + postShellHook = '' + pip install -r requirements.txt + ''; + +} +</code></pre></td></tr></table> +</div> +</div>Now, you will get a clean environment by running: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">nix-shell +</code></pre></td></tr></table> +</div> +</div>Kanata: advanced keyboard configurationhttps://balkian.com/p/kanata-advanced-keyboard-configuration/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/p/kanata-advanced-keyboard-configuration/<a class="link" href="https://github.com/jtroo/kanata/" target="_blank" rel="noopener" +>Kanata</a> is a software keyboard remapper that aims to improve keyboard comfort and usability with advanced customization. +Keyboard remappers are a good alternative to running a custom keyboard with QMK/ZMK, and have two main advantages: they work on any keyboard, and you can configure them to launch any command or program you want, not just key presses. +On the other hand, you need to configure them on every PC/OS you’re using your keyboard with, and all the processing is done on software on top of the OS, so there may be glitches and performance issues. +The project was inspired by the more popular <a class="link" href="https://github.com/kmonad/kmonad" target="_blank" rel="noopener" +>KMonad</a>, and the author cites some of the <a class="link" href="https://github.com/jtroo/kanata/blob/main/docs/kmonad_comparison.md" target="_blank" rel="noopener" +>differences</a>. +Both projects use a very similar configuration format based on lisp. +The configuration consists of a set of general options, a base key configuration, a series of layers, and macros that can be used within those layers. +<a class="link" href="https://github.com/jtroo/kanata/blob/main/cfg_samples/kanata.kbd" target="_blank" rel="noopener" +>Here’s a very complete config that serves as documentation</a>. +One big disadvantage of the lispy configuration is that you need to specify your hardware layout/all your keys, and repeat that every time you define a new layer. +The result visually maps to your keyboard, but can be very verbose/big if you need really few changes. +<a class="link" href="https://github.com/rvaiya/keyd/" target="_blank" rel="noopener" +>Keyd</a> is another alternative with a more declarative configuration format, which might lend itself to smaller. +For now I’m just trying it out, and getting a feel for using fewer keys before I build my own ZMK keyboard. +I particularly like the option of using mod-keys on the home row (e.g., having A work as a CTRL when held). +Mod-tap, tap-dancing and the like are very common techniques in sub-40% layouts, where there simply aren’t enough keys for all the letters and symbols. +In a regular-sized keyboard, these techniques can also help you stay on the home row and type more comfortably. +At least, that’s the idea. +We’ll see if I like it enough to stick with it. +For now, here’s my very simple config: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(defcfg + ;; Your keyboard device will likely differ from this. + linux-dev /dev/input/by-id/usb-Logitech_USB_Receiver-if02-event-mouse + + ;; Windows doesn't need any input/output configuration entries; however, there + ;; must still be a defcfg entry. You can keep the linux-dev entry or delete + ;; it and leave it empty. +) + +(defsrc + grv 1 2 3 4 5 6 7 8 9 0 - = bspc + tab q w e r t y u i o p [ ] + caps a s d f g h j k l ; ' ret + lsft \ z x c v b n m , . / rsft + lctl lmet lalt spc ralt rmet rctl +) + + +(deflayer qwerty + grv _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ @warrows _ _ _ _ _ _ _ _ _ _ + lctrl @alctrl @slsft @dlalt @flmet _ _ @jrmet @kralt @lrsft @;rctrl _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer arrows + _ _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ @flmet _ left down up rght _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer colemak + grv XX XX XX XX XX XX XX XX XX XX XX XX _ + tab q w f p b j l u y ; [ ] + lctrl @alctrl @rlsft @slalt @tlmet g m @nrmet @eralt @irsft @orctrl ' ret + lsft XX z x c d v k h , . / rsft + XX XX XX @smartspace XX XX XX +) + +(deflayer magic + _ @clmk @qwerty _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ tab A-tab _ _ _ _ bspc esc _ ret _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ +) + +(defalias + warrows (tap-hold 200 200 w (layer-toggle arrows)) + + alctrl (tap-hold 200 200 a lctrl) + slsft (tap-hold 200 200 s lsft) + dlalt (tap-hold 200 200 d lalt) + flmet (tap-hold 200 200 f lmet) + + jrmet (tap-hold 200 200 j rmet) + kralt (tap-hold 200 200 k ralt) + lrsft (tap-hold 200 200 l rsft) + ;rctrl (tap-hold 200 200 ; rctrl) + + rlsft (tap-hold 200 200 r lsft) + slalt (tap-hold 200 200 s lalt) + tlmet (tap-hold 200 200 t lmet) + nrmet (tap-hold 200 200 n rmet) + eralt (tap-hold 200 200 e ralt) + irsft (tap-hold 200 200 i rsft) + orctrl (tap-hold 200 200 o rctrl) + clmk (layer-switch colemak) + qwerty (layer-switch qwerty) + + smartspace (tap-dance 200 ( + (tap-hold 300 300 spc (layer-toggle magic)) + (tap-hold 300 300 (one-shot 300 lalt) spc) + a + )) + + ) +</code></pre></td></tr></table> +</div> +</div>Archiveshttps://balkian.com/archives/Sun, 06 Mar 2022 00:00:00 +0000https://balkian.com/archives/Logitech MB850 combi in linuxhttps://balkian.com/p/logitech-mb850-combi-in-linux/Sat, 30 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mb850-combi-in-linux/As a follow-up to my last post, I’ve decided to also configure my mk850 combo (k850 + m720 triathlon). +Some notes: +<ul> +<li>The keyboard is usually connected to this PC through bluetooth. Since this is a change I usually do in the system for every keyboard, I added a rule for any bus (usb, bluetooth, etc)</li> +<li>The mouse has an additional button that registers as a keyboard. Every press maps to three key events. I’ve disabled two of them and mapped the action to F19, in case I want to use it in my DE/WM.</li> +</ul> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">evdev:input:* + KEYBOARD_KEY_70039=leftctrl # bind capslock to w + +evdev:input:b0005v046DpB015* + KEYBOARD_KEY_700e0=f19 + KEYBOARD_KEY_700e2=unknown + KEYBOARD_KEY_7002b=unknown +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div>Make sure the settings have been applied by running <code>evemu-describe</code>: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"> sudo /sbin/evemu-describe /dev/input/event<id of your device> | grep KEY_ +</code></pre></td></tr></table> +</div> +</div>Logitech MX Keys for Mac on Linuxhttps://balkian.com/p/logitech-mx-keys-for-mac-on-linux/Fri, 29 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mx-keys-for-mac-on-linux/I recently got Logitech MX Keys for Mac keyboard at work. +The German version, to be more precise. +This version was three times cheaper than the Windows equivalent with either US or ES layout. +Since I touch type anyway, I thought it was a bargain. +As soon as I plugged it in, I realized there were some glaring issues with the keyboard. +First of all, the Meta/Super and Alt keys are reversed in this keyboard. +In the normal/full version of this keyboard, Logitech gives an option to choose between Mac, Windows and iOS host, and that changes the behavior of the keys. +In this version, tho, only iOS and Mac are available. +Besides that, there’s the issue of the grave (tilde) and angle keys switched as well. +Switching these keys around would be very easy with Xorg, but Wayland once again complicates things… +These issues almost made me return the keyboard. +Luckily, tho, there is another option: configuring the keys one level lower than wayland (and X11), through hwdb. +Long story short, this will configure any Logitech keyboard with the same product id (0x4092) to use a saner configuration: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">#File: /etc/udev/hwdb.d/90-logitech-keyboard.hwdb + +evdev:input:b0003v046Dp4092* + KEYBOARD_KEY_700e2=leftmeta + KEYBOARD_KEY_700e3=leftalt + KEYBOARD_KEY_70039=leftctrl + KEYBOARD_KEY_70064=102nd + KEYBOARD_KEY_70035=grave + KEYBOARD_KEY_700e7=rightalt + KEYBOARD_KEY_700e6=rightmeta + KEYBOARD_KEY_7006d=compose +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div>Linux on the Microsoft Surface Gohttps://balkian.com/p/linux-on-the-microsoft-surface-go/Sat, 01 Jun 2019 00:00:01 +0000https://balkian.com/p/linux-on-the-microsoft-surface-go/Believe it or not, Surface tablets have pretty good linux support, except for the webcams in newer models. +These are some useful notes to get Ubuntu installed in your surface go, as of Summer 2019. +<h2 id="installing-the-kernel">Installing the kernel +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">git clone --depth 1 https://github.com/jakeday/linux-surface.git ~/linux-surface +cp -a ~/linux-surface /media/<your usb> +</code></pre></td></tr></table> +</div> +</div><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">cp -a /media/<your usb>/linux-surface ~/ +cd ~/linux-surface/ +sudo sh setup.sh +</code></pre></td></tr></table> +</div> +</div><h2 id="booting-ubuntu-first">Booting ubuntu first +</h2>Switch out of Windows S mode. +Boot into the “Command Prompt”. +From Windows go to “change advanced startup options” and select “restart now”. +When it reboots, choose the “Troubleshoot” option, then choose the “Advanced options” option, and finally choose the “Command Prompt” option. +After the device reboots, login to the command prompt and then you should see a terminal with X:\windows\system32> +At the prompt, check your UEFI entries: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /enum firmware +</code></pre></td></tr></table> +</div> +</div>Copy UEFI entry of “Windows Boot Manager” to create a new entry for Ubuntu: bcdedit /copy {bootmgr} /d “Ubuntu” +Copy the printed GUID number including the braces {} using Ctrl+C +Set file path for the new Ubuntu entry. Replace {guid} with the returned GUID of the previous command (Ctrl+V). bcdedit /set {guid} path \EFI\ubuntu\grubx64.efi +Set Ubuntu as the first/ entry in the boot sequence. Again replace {guid} with the returned GUID of the copy command. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /set {fwbootmgr} displayorder {guid} /addfirst +</code></pre></td></tr></table> +</div> +</div>Check your UEFI entries again: bcdedit /enum firmware You should see something like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"> +Firmware Boot Manager +--------------------- +identifier {fwbootmgr} +displayorder {3510232e-f8eb-e811-95ce-9ecab3f9d1c4} + {bootmgr} + {2148799b-f8eb-e811-95ce-9ecab3f9d1c4} + {312e8a67-c2f6-e811-95ce-3c1ab3f9d1de} + {312e8a68-c2f6-e811-95ce-3c1ab3f9d1de} +timeout 0 +</code></pre></td></tr></table> +</div> +</div>Make sure the GUID you copied is the first one listed in displayorder. Then type exit, turn off the PC and turn it back on. After this my surface go is automatically booting to the grub bootloader which lets me choose between Windows and Ubuntu but defaults to Ubuntu after ten seconds.Controlling Zigbee devices with MQTThttps://balkian.com/p/controlling-zigbee-devices-with-mqtt/Sun, 06 Jan 2019 10:00:00 +0000https://balkian.com/p/controlling-zigbee-devices-with-mqtt/This is a short tutorial on connecting a zigbee device (an Aqara cube) +to an MQTT server, so you can control your zigbee devices from the +network. +If you’re anything like me, you’re probably a sucker for IoT devices. +For a long time, I’ve been using WiFi-enabled lights, and Amazon dash +buttons to control them. To keep these (cheap Chinese) internet enabled +devices away from your network and their respective cloud services, +you’ll probably want to set up a dedicated network in your router (more +on this on a future post, maybe). Another disadvantage of WiFi devices +is that they’re relatively power hungry. +A popular alternative is using ZigBee for communication. It is a +dedicated protocol similar to bluetooth (BLE), with lower power +requirements and bitrate. +Take the (super cute) aqara cube as an example. It is a small cube that +detects rotation on all of its axes, and tapping events. Here’s a +video: +<div class="video-wrapper"> +<iframe loading="lazy" +src="https://www.youtube.com/embed/5YtqG1wEnng" +allowfullscreen +title="YouTube Video" +> +</iframe> +</div> +To connect to zigbee devices you will need a zigbee enabled gateway +(a.k.a. hub), which connects to your WiFi network and your zigbee +devices. Once again, this means adding an internet-enabled device to +your home, and probably a couple of cloud services. +As an alternative, you can set up your own zigbee gateway, and control +it to your home automation platform of choice (e.g. home assistant). We +will cover how to set up a zigbee2mqtt gateway that is also connected to +an MQTT server, so you can use MQTT to control your devices and get +notifications. +What you need: +<ul> +<li><a class="link" href="https://www.aliexpress.com/item/Original-Xiaomi-Mi-Aqara-Cube-Smart-Home-Controller-6-Action-Operation-Fr-Home-Device-Zigbee-Version/32892947622.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>Aqara +cube</a>.</li> +<li><a class="link" href="https://www.aliexpress.com/item/Wireless-Zigbee-CC2531-CC2540-Zigbee-Sniffer-Bluetooth-BLE-4-0-Dongle-Capture-Module-USB-Programmer-Downloader/32907587711.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>CC2531 zigbee +sniffer</a>.</li> +<li><a class="link" href="https://www.aliexpress.com/item/CFSUNBIRD-CC-DEBUGGER-Debugger-and-Programmer-for-RF-System-on-Chips-TI-ORIGINAL-Fast-hipping/32813122315.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>CC-debugger</a>.</li> +</ul> +You will need to flash your sniffer. For that, you only need to follow +the instructions from the <a class="link" href="https://koenkk.github.io/zigbee2mqtt/" target="_blank" rel="noopener" +>zigbee2mqtt +documentation</a>. +Once you’re done flashing, you’re ready to set up the zigbee2mqtt +server. For convenience, I wrote a simple docker-compose to deploy a +zigbee2mqtt server and a test mosquitto server: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">version: '2.1' +services: + zigbee2mqtt: + image: koenkk/zigbee2mqtt + container_name: zigbee2mqtt + restart: always + volumes: + - ./z2m-data/:/app/data/ + devices: + - "/dev/ttyACM0" + networks: + - hass + mqtt: + image: eclipse-mosquitto + ports: + - 1883:1883 + - 9001:9001 + networks: + - hass + volumes: + - ./mosquitto.conf:/mosquitto/config/mosquitto.conf +networks: + hass: + driver: overlay +</code></pre></td></tr></table> +</div> +</div>You can test your installation with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">❯ mosquitto_sub -h localhost -p 1883 -t 'zigbee2mqtt/#' +online +{"battery":17,"voltage":2925,"linkquality":149,"action":"rotate_right","angle":12.8} +{"battery":17,"voltage":2925,"linkquality":141,"action":"slide","side":2} +{"battery":17,"voltage":2925,"linkquality":120} +{"battery":17,"voltage":2925,"linkquality":141,"action":"wakeup"}</code></pre></td></tr></table> +</div> +</div> +zigbee2mqtt supports the following events for the aqara cube: shake, +wakeup, fall, tap, slide, flip180, flip90, rotate_left and +rotate_right. Every event has additional information, such as the sides +involved, or the degrees turned. +Now you are ready to set up home assistant support in zigbee2mqtt +following <a class="link" href="https://koenkk.github.io/zigbee2mqtt/integration/home_assistant.html" target="_blank" rel="noopener" +>this +guide</a>.Progress bars in pythonhttps://balkian.com/p/progress-bars-in-python/Wed, 28 Sep 2016 18:47:00 +0000https://balkian.com/p/progress-bars-in-python/<a class="link" href="https://github.com/noamraph/tqdm" target="_blank" rel="noopener" +>tqdm</a> is a nice way to add progress +bars in the command line or in a jupyter notebook. +<img src="https://camo.githubusercontent.com/48838faaa8d00ea297f18e5bf55d3c6bb4e0ba6b/68747470733a2f2f692e696d6775722e636f6d2f686539417735432e676966" +loading="lazy" +alt="image" +> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from tqdm import tqdm +import time + +for i in tqdm(range(100)): + time.sleep(1) +</code></pre></td></tr></table> +</div> +</div>Sharing dotfileshttps://balkian.com/p/sharing-dotfiles/Fri, 10 Apr 2015 17:47:00 +0000https://balkian.com/p/sharing-dotfiles/Today’s post is half a quick note, half public shaming. In other words, +it is a reminder to be very careful with OAuth tokens and passwords. +As part of moving to emacs, I starting using the incredibly useful +<a class="link" href="https://github.com/defunkt/gist.el" target="_blank" rel="noopener" +>gh.el</a>. When you first use it, the +extension saves either your password or an OAuth token in your +.gitconfig file. This is cool and convenient, unless you <a class="link" href="https://github.com/balkian/dotfiles" target="_blank" rel="noopener" +>happen to be +publishing your .gitconfig file in a public +repo</a>. +So, how can you still share your gitconfig without sharing your +password/token with the rest of the world? Since Git 1.7.0, you can +<a class="link" href="http://stackoverflow.com/questions/1557183/is-it-possible-to-include-a-file-in-your-gitconfig" target="_blank" rel="noopener" +>include other files in your +gitconfig</a>. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">[include] + path = ~/.gitconfig_secret +</code></pre></td></tr></table> +</div> +</div>And now, in your .gitconfig_secret file, you just have to add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">[github] + user = balkian + token = "< Your secret token >" +</code></pre></td></tr></table> +</div> +</div>Zoterohttps://balkian.com/p/zotero/Tue, 09 Dec 2014 12:12:12 +0000https://balkian.com/p/zotero/<a class="link" href="https://www.zotero.org/" target="_blank" rel="noopener" +>Zotero</a> is an Open Source tool that lets you +organise your bibliography, syncing it with the cloud. Unlike other +alternatives such as <a class="link" href="http://www.mendeley.com" target="_blank" rel="noopener" +>Mendeley</a>, Zotero can +upload the attachments and data to a private cloud via WebDav. +If you use nginx as your web server, know that even though it provides +partial support for webdav, Zotero needs more than that. Hence, you will +need another webdav server, and optionally let nginx proxy to it. This +short post provides the basics to get that set-up working under +Debian/Ubuntu. +<h2 id="setting-up-apache">Setting up Apache +</h2>First we need to install Apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo apt-get install apache2 +</code></pre></td></tr></table> +</div> +</div>Change the head of “/etc/apache2/sites-enabled/000-default” to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><VirtualHost *:880> +</code></pre></td></tr></table> +</div> +</div>Then, create a file /etc/apache2/sites-available/webdav: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache">Alias /dav /home/webdav/dav +<Location /dav> + Dav on + Order Allow,Deny + Allow from all + Dav On + Options +Indexes + AuthType Basic + AuthName DAV + AuthBasicProvider file + AuthUserFile /home/webdav/.htpasswd + Require valid-user +</Location> +</code></pre></td></tr></table> +</div> +</div>Ideally, you want your webdav folders to be private, adding +authentication to them. So you need to create the webdav and zotero +users and add the passwords to an htpasswd file. Even though you could +use a single user, since you will be configuring several clients with +your credentials I encourage you to create the zotero user as well. This +way you can always change the password for zotero without affecting any +other application using webdav. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo adduser webdav +sudo htpasswd -c /home/webdav/.htpasswd webdav +sudo htpasswd /home/webdav/.htpasswd zotero +sudo mkdir -p /home/webdav/dav/zotero +</code></pre></td></tr></table> +</div> +</div>Enable the site and restart apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo a2enmod webdav +sudo a2enmod dav_fs +sudo a2ensite webdav +sudo service apache2 restart +</code></pre></td></tr></table> +</div> +</div>At this point everything should be working at +<a class="link" href="http://" target="_blank" rel="noopener" +>http://</a><your_host>:880/dav/zotero +<h2 id="setting-up-nginx">Setting up NGINX +</h2>After the Apache side is working, we can use nginx as a proxy to get +cleaner URIs. In your desired site/location, add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-nginx" data-lang="nginx">location /dav { + client_max_body_size 20M; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $remote_addr; + proxy_set_header Host $host; + proxy_pass http://127.0.0.1:880; +} +</code></pre></td></tr></table> +</div> +</div>Now just reload nginx: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo service nginx force-reload +</code></pre></td></tr></table> +</div> +</div><h2 id="extras">Extras +</h2><ul> +<li><a class="link" href="http://zoteroreader.com/" target="_blank" rel="noopener" +>Zotero Reader</a> - HTML5 client</li> +<li><a class="link" href="https://github.com/ajlyon/zandy" target="_blank" rel="noopener" +>Zandy</a> - Android Open Source +client</li> +</ul>Proxies with Apache and pythonhttps://balkian.com/p/proxies-with-apache-and-python/Thu, 09 Oct 2014 10:00:00 +0000https://balkian.com/p/proxies-with-apache-and-python/This is a quick note on proxying a local python application (e.g. flask) +to a subdirectory in Apache. This assumes that the file wsgi.py contains +a WSGI application with the name application. Hence, wsgi:application. +<h2 id="gunicorn">Gunicorn +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + ProxyPass http://127.0.0.1:8888/myapp/ + ProxyPassReverse http://127.0.0.1:8888/myapp/ + RequestHeader set SCRIPT_NAME "/myapp/" +</Location> +</code></pre></td></tr></table> +</div> +</div>Important: SCRIPT_NAME and the end of ProxyPass URL MUST BE +THE SAME. Otherwise, Gunicorn will fail miserably. +Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">venv/bin/gunicorn -w 4 -b 127.0.0.1:8888 --log-file - --access-logfile - wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="uwsgi">UWSGI +</h2>This is a very simple configuration. I will try to upload one with more +options for uwsgi (in a .ini file). +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + SetHandler uwsgi_handler + uWSGISocker 127.0.0.1:8888 +</Location> +</code></pre></td></tr></table> +</div> +</div>Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">uwsgi --socket 127.0.0.1:8888 -w wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="extra-supervisor">Extra: Supervisor +</h2>If everything went as expected, you can wrap your command in a +supervisor config file and let it handle the server for you. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini">[unix_http_server] +file=/tmp/myapp.sock ; path to your socket file + +[supervisord] +logfile = %(here)s/logs/supervisor.log +childlogdir = %(here)s/logs/ + +[rpcinterface:supervisor] +supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface + +[supervisorctl] +logfile = %(here)s/logs/supervisorctl.log +serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket + +[program:myapp] +command = venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 --log-file %(here)s/logs/gunicorn.log --access-logfile - wsgi:application +directory = %(here)s +environment = PATH=%(here)s/venv/bin/ +logfile = %(here)s/logs/myapp.log +</code></pre></td></tr></table> +</div> +</div>Publishing on PyPihttps://balkian.com/p/publishing-on-pypi/Sat, 27 Sep 2014 10:00:00 +0000https://balkian.com/p/publishing-on-pypi/Developing a python module and publishing it on Github is cool, but most +of the times you want others to download and use it easily. That is the +role of PyPi, the python package repository. In this post I show you how +to publish your package in less than 10 minutes. +<h2 id="choose-a-fancy-name">Choose a fancy name +</h2>If you haven’t done so yet, take a minute or two to think about this. +To publish on PyPi you need a name for your package that isn’t taken. +What’s more, a catchy and unique name will help people remember your +module and feel more inclined to at least try it. +The package name should hint what your module does, but that’s not +always the case. That’s your call. I personally put uniqueness and +memorability over describing the functionality. +<h2 id="create-a-pypirc-configuration-file">Create a .pypirc configuration file +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[distutils] # this tells distutils what package indexes you can push to +index-servers = + pypi # the live PyPI + pypitest # test PyPI + +[pypi] # authentication details for live PyPI +repository = https://pypi.python.org/pypi +username = { your_username } +password = { your_password } # not necessary + +[pypitest] # authentication details for test PyPI +repository = https://testpypi.python.org/pypi +username = { your_username } +</code></pre></td></tr></table> +</div> +</div>As you can see, you need to register both in the <a class="link" href="https://pypi.python.org/pypi?%3Aaction=register_form" target="_blank" rel="noopener" +>main pypi +repository</a> and +the <a class="link" href="https://testpypi.python.org/pypi?%3Aaction=register_form" target="_blank" rel="noopener" +>testing +server</a>. The +usernames and passwords might be different, that is up to you! +<h2 id="prepare-your-package">Prepare your package +</h2>This should be the structure: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">root-dir/ # Any name you want + setup.py + setup.cfg + LICENSE.txt + README.md + mypackage/ + __init__.py + foo.py + bar.py + baz.py +</code></pre></td></tr></table> +</div> +</div><h3 id="setupcfg">setup.cfg +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[metadata] +description-file = README.md +</code></pre></td></tr></table> +</div> +</div>The markdown README is the de facto standard in Github, but you can +also use rST (reStructuredText), the standard in the python community. +<h3 id="setuppy">setup.py +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from distutils.core import setup + +setup(name = 'mypackage', + packages = ['mypackage'], # this must be the same as the name above + version = '{ version }', + description = '{ description }', + author = '{ name }', + email = '{ email }', + url = 'https://github.com/{user}/{package}', # URL to the github repo + download_url = 'https://github.com/{user}/{repo}/tarball/{version}', + keywords = ['websockets', 'display', 'd3'], # list of keywords that represent your package + classifiers = [], ) +</code></pre></td></tr></table> +</div> +</div>You might notice that the download_url points to a Github URL. We could +host our package anywhere, but Github is a convenient option. To create +the tarball and the zip packages, you only need to tag a tag in your +repository and push it to github: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git tag {version} -m "{ Description of this tag/version}" +git push --tags origin master +</code></pre></td></tr></table> +</div> +</div><h2 id="push-to-the-testingmain-pypi-server">Push to the testing/main pypi server +</h2>It is advisable that you try your package on the test repository and fix +any problems first. The process is simple: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">python setup.py register -r {pypitest/pypi} python setup.py sdist upload -r {pypitest/pypi} +</code></pre></td></tr></table> +</div> +</div>If everything went as expected, you can now install your package through +pip and browse your package’s page. For instance, check my senpy +package: <a class="link" href="https://pypi.python.org/pypi/senpy" target="_blank" rel="noopener" +>https://pypi.python.org/pypi/senpy</a> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">pip install senpy +</code></pre></td></tr></table> +</div> +</div>Updating EuroLoveMaphttps://balkian.com/p/updating-eurolovemap/Thu, 27 Mar 2014 14:00:00 +0000https://balkian.com/p/updating-eurolovemap/As part of the <a class="link" href="http://www.opener-project.org/2013/07/18/opener-hackathon-in-amsterdam/" target="_blank" rel="noopener" +>OpeNER +hackathon</a> +we decided to build a prototype that would allow us to compare how +different countries feel about several topics. We used the OpeNER +pipeline to get the sentiment from a set of newspaper articles we +gathered from media in several languages. Then we aggregated those +articles by category and country (using the source of the article or the +language it was written in), obtaining the “overall feeling” of each +country about each topic. Then, we used some fancy JavaScript to make +sense out of the raw information. +It didn’t go too bad, it turns out <a class="link" href="http://eurosentiment.eu/wp-content/uploads/2013/07/BOLv9qnCIAAJEek.jpg" target="_blank" rel="noopener" +>we +won</a>. +Now, it was time for a face-lift. I used this opportunity to play with +new technologies and improve it: +<ul> +<li>Using Flask, this time using python 3.3 and Bootstrap 3.0</li> +<li>Cool HTML5+JS cards (thanks to +<a class="link" href="http://pastetophone.com" target="_blank" rel="noopener" +>pastetophone</a>)</li> +<li>Automatic generation of fake personal data to test the interface</li> +<li>Obfuscation of personal emails</li> +</ul> +The result can be <a class="link" href="http://eurolovemap.herokuapp.com/" target="_blank" rel="noopener" +>seen here</a>. +<h2 id="publishing-a-python-3-app-on-heroku">Publishing a Python 3 app on Heroku +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">mkvirtualenv -p /usr/bin/python3.3 eurolovemap +</code></pre></td></tr></table> +</div> +</div>Since Heroku uses python 2.7 by default, we have to tell it which +version we want, although it supports python 3.4 as well. I couldn’t +get python 3.4 working using the +<a class="link" href="https://launchpad.net/~fkrull/+archive/deadsnakes" target="_blank" rel="noopener" +>deadsnakes</a> ppa, so +I used python 3.3 instead, which works fine but is not officially +supported. Just create a file named runtime.txt in your project root, +with the python version you want to use: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">python-3.3.1 +</code></pre></td></tr></table> +</div> +</div>Don’t forget to freeze your dependencies so Heroku can install them: +<code>bash pip freze > requirements.txt</code> +<h2 id="publishing-personal-emails">Publishing personal emails +</h2>There are really sophisticated and effective ways to obfuscate personal +emails so that spammers cannot easily grab yours. However, this time I +needed something really simple to hide our emails from the simplest form +of crawlers. Most of the team are in academia somehow, so in the end all +our emails are available in sites like Google Scholar. Anyway, nobody +likes getting spammed so I settled for a custom <a class="link" href="http://en.wikipedia.org/wiki/Caesar_cipher" target="_blank" rel="noopener" +>Caesar +cipher</a>. Please, don’t use +it for any serious application if you are concerned about being spammed. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">def blur_email(email): + return "".join([chr(ord(i)+5) for i in email]) +</code></pre></td></tr></table> +</div> +</div>And this is the client side: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-javascript" data-lang="javascript">window.onload = function(){ + elems = document.getElementsByClassName('profile-email'); + for(var e in elems){ + var blur = elems[e].innerHTML; + var email = ""; + for(var s in blur){ + var a = blur.charCodeAt(s) + email = email+String.fromCharCode(a-5); + } + elems[e].innerHTML = email; + } +} +</code></pre></td></tr></table> +</div> +</div>Unfortunately, this approach does not hide your email from anyone using +<a class="link" href="http://phantomjs.org/" target="_blank" rel="noopener" +>PhantomJS</a>, +<a class="link" href="http://zombie.labnotes.org/" target="_blank" rel="noopener" +>ZombieJS</a> or similar. For that, other +approaches like generating a picture with the address would be +necessary. Nevertheless, it is overkill for a really simple ad-hoc +application with custom formatting and just a bunch of emails that would +easily be grabbed manually. +<h2 id="generation-of-fake-data">Generation of fake data +</h2>To test the contact section of the site, I wanted to populate it with +fake data. <a class="link" href="https://github.com/joke2k/faker" target="_blank" rel="noopener" +>Fake-Factory</a> is an amazing +library that can generate fake data of almost any kind: emails, +association names, acronyms… It even lets you localise the results +(get Spanish names, for instance) and generate factories for certain +classes (à la Django). +But I also wanted pictures, enter <a class="link" href="http://lorempixel.com/" target="_blank" rel="noopener" +>Lorem Pixel</a>. +With its API you can generate pictures of almost any size, for different +topics (e.g. nightlife, people) and with a custom text. You can even use +an index, so it will always show the same picture. +For instance, the picture below is served through Lorem Pixel. +<img src="http://lorempixel.com/400/200/nightlife/" +loading="lazy" +> +By the way, if you only want cat pictures, take a look at +<a class="link" href="http://placekitten.com/" target="_blank" rel="noopener" +>Placekitten</a>. And for NSFW text, there’s the +<a class="link" href="http://slipsum.com/" target="_blank" rel="noopener" +>Samuel L. Jackson Ipsum</a>Remove git files with globbinghttps://balkian.com/p/remove-git-files-with-globbing/Thu, 22 Aug 2013 23:14:00 +0000https://balkian.com/p/remove-git-files-with-globbing/A simple trick. If you want to remove all the ‘.swp’ files from a git +repository, just use: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git rm --cached '**.swp' +</code></pre></td></tr></table> +</div> +</div>Creating my webhttps://balkian.com/p/creating-my-web/Thu, 22 Aug 2013 14:14:22 +0000https://balkian.com/p/creating-my-web/I’ve finally decided to set up a decent personal page. I have settled +for github-pages because I like the idea of keeping my site in a +repository and having someone else host and deploy it for me. The site +will be really simple, mostly static files. Thanks to Github, +<a class="link" href="http://jekyllrb.com" target="_blank" rel="noopener" +>Jekyll</a> will automatically generate static pages +for my posts every time I commit anything new to this repository. +But Jekyll can be used independently, so if I ever choose to host the +site myself, I can do it quite easily. Another thing that I liked about +this approach is that the generated html files can be used in the +future, and I will not need Jekyll to serve it. Jekyll is really simple +and most of the things are written in plain html. That means that +everything could be easily reused if I ever choose to change to another +blogging framework (e.g. pelical). But, for the time being, I like the +fact that Github takes care of the compilation as well, so I can simply +modify or add files through the web interface should I need to. +I hadn’t played with HTML and CSS for a while now, so I also wanted to +use this site as a playground. At some point, I realised I was doing +mostly everything in plain HTML and CSS, and decided to keep it like +that for as long as possible. As of this writing, I haven’t included +any Javascript code in the page. Probably I will use some to add my +<a class="link" href="http://gist.github.com/balkian" target="_blank" rel="noopener" +>gists</a> and +<a class="link" href="http://github.com/balkian" target="_blank" rel="noopener" +>repositories</a>, but we will see about that. +I think the code speaks for itself, so you can check out <a class="link" href="http://github.com/balkian/balkian.github.com" target="_blank" rel="noopener" +>my repository +on Github</a>. You can clone +and deploy it easily like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git clone +https://github.com/balkian/balkian.github.com cd balkian.github.com +jekyll serve -w +</code></pre></td></tr></table> +</div> +</div>I will keep updating this post with information about: +<ul> +<li>Some Jekyll plugins that might be useful</li> +<li>What CSS tricks I learnt</li> +<li>The webfonts I used</li> +<li>The badge on the left side of the page</li> +</ul>Emacshttps://balkian.com/emacs/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/emacs/<img src="https://balkian.com/img/emacs.png" alt="Featured image of post Emacs" /><h2 id="show-plain-text-version">Show plain text version +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(font-lock-mode) +</code></pre></td></tr></table> +</div> +</div>Linkshttps://balkian.com/links/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/links/Linuxhttps://balkian.com/linux/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/linux/<img src="https://balkian.com/img/linux.png" alt="Featured image of post Linux" /><h2 id="black-screen-and-lightdm-doesnt-unlock">Black screen and LightDM doesn’t unlock +</h2>Add this to your /etc/lightdm/lightdm.conf file: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[LightDM] +logind-check-graphical=true +</code></pre></td></tr></table> +</div> +</div>##Edit previous commands +<code>fc</code> is a shell builtin to list and edit previous commands in an editor. +In addition to editing a single line (which you can also do with <code>C-x C-e</code>), it also allows you to edit and run several lines at the same time. +You use it like this: +List previous commands +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -l +10259 nvim deploy.sh +10260* cd .. +10261* nvim content/cheatsheet/linux.md +10262 cd +</code></pre></td></tr></table> +</div> +</div>List commands with date (in zsh) +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -ld +10260* 19:38 cd .. +10261* 19:38 nvim content/cheatsheet/linux.md +10262 19:40 cd +10263 19:40 fc -l +</code></pre></td></tr></table> +</div> +</div>You can add the date too: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -fld +10262 1/10/2019 19:40 cd +10263 1/10/2019 19:40 fc -l +10264 1/10/2019 19:40 fc -ld +</code></pre></td></tr></table> +</div> +</div>You can edit a range of commands +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc 10262 10264 +</code></pre></td></tr></table> +</div> +</div>The range can be relative to the current position, so the previous command is equivalent to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -3 -1 +</code></pre></td></tr></table> +</div> +</div>If you save and exit, all commands are executed as a script, and it will be added to your history. +Source: <a class="link" href="https://shapeshed.com/unix-fc/" target="_blank" rel="noopener" +>https://shapeshed.com/unix-fc/</a> +<h2 id="prevent-logoff-from-killing-tmux-sessions">Prevent logoff from killing tmux sessions +</h2>Lately I’ve noticed that logging out of i3, intentionally or when i3 fails, would also kill any tmux or emacs sessions. +This is extremely annoying. +This is caused by a new default in logind (systemd’s login) to kill user process on logoff. +You can revert this setting in your logind.conf (<code>/etc/systemd/logind.conf</code>): +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">KillUserProcesses=no +</code></pre></td></tr></table> +</div> +</div>Or only for a specific process (e.g., tmux): +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">systemd-run --scope --user tmux +</code></pre></td></tr></table> +</div> +</div>Source: <a class="link" href="https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session" target="_blank" rel="noopener" +>https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session</a> +<h2 id="upload-a-temporary-file">Upload a temporary file +</h2>Sometimes you just need to copy/paste a file from a server, and copying from the terminal can be a hassle. +These two services are command-line “pastebins” just one curl away: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +8 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><command> | curl -F 'sprunge=<-' http://sprunge.us +# OR + +<command> 2>&1 | curl -F 'f:1=<-' ix.io + +# OR + +<command> | curl -F"file=@-" https://ttm.sh +</code></pre></td></tr></table> +</div> +</div><h1 id="install-fortinet-sslvpn-support-for-networkmanager">Install Fortinet SSLVPN support for NetworkManager +</h1>UPM (Universidad Politécnica de Madrid) uses a propriatary VPN solution. +The instructions for GNU/Linux on their website involve downloading a specific client (<code>.tar.gz</code>) and manually running it. +That works, but it is kind of a hassle. +A much more convenient alternative is installing this NetworkManager plugin: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">pacman -Sy networkmanager-fortisslvpn +# Or apt get install networkmanager-fortisslvpn +</code></pre></td></tr></table> +</div> +</div>Now you can simply add a new VPN connection in NetworkManager and manage it as you would any other connection.Projectshttps://balkian.com/projects/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/projects/<h1 id="ongoing-projects">Ongoing Projects +</h1><ul> +<li><a class="link" href="https://soilsim.readthedocs.io" target="_blank" rel="noopener" +>Soil</a>: an agent-based simulator for social networks based on nx-sim and networkx.</li> +<li><a class="link" href="https://github.com/balkian/soilent" target="_blank" rel="noopener" +>Soilent</a>: an efficient scheduler for soil using rust and pyo3.</li> +<li><a class="link" href="https://senpy.readthedocs.io" target="_blank" rel="noopener" +>Senpy</a>: a framework for semantic sentiment and emotion analysis services.</li> +</ul> +<h1 id="past-projects">Past Projects +</h1><ul> +<li><a class="link" href="http://gsi.dit.upm.es/ontologies/onyx" target="_blank" rel="noopener" +>Onyx</a>: an ontology for emotion analysis that includes concepts from W3C’s provenance.</li> +<li><a class="link" href="https://github.com/balkian/ESP8266_Clock_NTP" target="_blank" rel="noopener" +>ESP8266 Clock NTP</a>: a simple clock display using arduino, the ESP8266 and NTP (network time protocol).</li> +<li><a class="link" href="https://github.com/balkian/shinesp" target="_blank" rel="noopener" +>Shine ESP</a>: control an ws2812b LED strip over the network with an ESP8266.</li> +<li><a class="link" href="https://github.com/balkian/bitter" target="_blank" rel="noopener" +>Bitter</a>: a wrapper and CLI over the (now defunct) Twitter API to researchers to download Twitter data much faster using multiple accounts.</li> +<li><a class="link" href="http://gsi.dit.upm.es/ontologies/marl" target="_blank" rel="noopener" +>Marl</a>: I updated this ontology, originally created by Adam Westerski, to make it compatible with the W3C’s provenance ontology.</li> +<li><a class="link" href="http://github.com/balkian/hermes" target="_blank" rel="noopener" +>Hermes</a>: one of my first projects, developed together with David Pérez as the special custom assignment in one of our courses. Hermes is an affective bot designed to mimic the behavour of humans. It included a plug-in system for its sensors and actuators. The information from its sensors changed its emotional state, which was shown via its actuators. Among others, it could fetch inforation from Twitter or its host system and change the expressions of an external Face made with servo motors or speak via its Text-To-Speech software. For instance, it could detect it was running out of battery, showing a sad face and sending an alerting tweet. You can see it in action in these two youtube videos: <a class="link" href="http://www.youtube.com/watch?v=KnEYahPD9z4" target="_blank" rel="noopener" +>Part 1</a> and <a class="link" href="http://www.youtube.com/watch?v=lQZldCTPEJc" target="_blank" rel="noopener" +>Part 2</a>.</li> +<li><a class="link" href="http://github.com/gsi-upm/maia" target="_blank" rel="noopener" +>Maia</a>: the Modular Architecture for Intelligent Agents is an evented agent architecture that aims to update the classical frameworks for intelligent agents with the concepts emerged from the Live Web.</li> +<li><a class="link" href="http://github.com/eestec/eestec.portal" target="_blank" rel="noopener" +>EESTEC.net</a>: the Plone based official portal of EESTEC. It has been my first and only experience with Plone. I fixed some bugs and implemented basic features.</li> +</ul> +For more information, check my list of public repositories in <a href="http://github.com/balkian"> Github</a>.Pythonhttps://balkian.com/python/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/python/<img src="https://balkian.com/img/python.png" alt="Featured image of post Python" /><h2 id="interesting-libraries">Interesting libraries +</h2><h3 id="tqdm"><a class="link" href="https://github.com/tqdm/tqdm" target="_blank" rel="noopener" +>TQDM</a> +</h3>From tqdm’s github repository: +<blockquote> +tqdm means “progress” in Arabic (taqadum, تقدّم) and an abbreviation for “I love you so much” in Spanish (te quiero demasiado).</blockquote> +<img src="https://raw.githubusercontent.com/tqdm/tqdm/master/images/tqdm.gif" +loading="lazy" +alt="TQDM in action" +> +<h2 id="tools">Tools +</h2><h3 id="uv"><a class="link" href="https://github.com/astral-sh/uv" target="_blank" rel="noopener" +>uv</a> +</h3>🚀 A single tool to replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +⚡️ 10-100x faster than pip. +<ul> +<li>Provides comprehensive project management, with a universal lockfile.</li> +<li>Runs scripts, with support for inline dependency metadata.</li> +<li>Installs and manages Python versions.</li> +<li>Runs and installs tools published as Python packages.</li> +<li>Includes a pip-compatible interface for a performance boost with a familiar CLI.</li> +<li>Supports Cargo-style workspaces for scalable projects.</li> +<li>Disk-space efficient, with a global cache for dependency deduplication.</li> +<li>Installable without Rust or Python via curl or pip.</li> +<li>Supports macOS, Linux, and Windows.</li> +</ul>Raspberry Pihttps://balkian.com/raspberry-pi/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/raspberry-pi/<img src="https://balkian.com/img/rpi.png" alt="Featured image of post Raspberry Pi" /><h2 id="hdmi-flickering">HDMI flickering +</h2>Avoid HDMI flickering/intermittent blanking on RPI with a 1400x1050 VGA monitor. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"> + hdmi_drive=2 + hdmi_group=2 + hdmi_mode=42 + disable_overscan=1 + config_hdmi_boost=7 +</code></pre></td></tr></table> +</div> +</div>Searchhttps://balkian.com/search/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/search/ \ No newline at end of file diff --git a/links/index.html b/links/index.html new file mode 100644 index 0000000..40775fa --- /dev/null +++ b/links/index.html @@ -0,0 +1,21 @@ +Links +

GitHub

gitea

\ No newline at end of file diff --git a/linux/index.html b/linux/index.html new file mode 100644 index 0000000..dcee400 --- /dev/null +++ b/linux/index.html @@ -0,0 +1,90 @@ +Linux +

Linux

Tips and tricks for GNU/Linux and Unix

Black screen and LightDM doesn’t unlock

Add this to your /etc/lightdm/lightdm.conf file:

1
+2
+[LightDM]
+logind-check-graphical=true
+

##Edit previous commands

fc is a shell builtin to list and edit previous commands in an editor. +In addition to editing a single line (which you can also do with C-x C-e), it also allows you to edit and run several lines at the same time. +You use it like this:

List previous commands

1
+2
+3
+4
+5
+$ fc -l
+10259  nvim deploy.sh
+10260* cd ..
+10261* nvim content/cheatsheet/linux.md
+10262  cd
+

List commands with date (in zsh)

1
+2
+3
+4
+5
+$ fc -ld
+10260* 19:38  cd ..
+10261* 19:38  nvim content/cheatsheet/linux.md
+10262  19:40  cd
+10263  19:40  fc -l
+

You can add the date too:

1
+2
+3
+4
+$ fc -fld
+10262  1/10/2019 19:40  cd
+10263  1/10/2019 19:40  fc -l
+10264  1/10/2019 19:40  fc -ld
+

You can edit a range of commands

1
+$ fc 10262 10264
+

The range can be relative to the current position, so the previous command is equivalent to:

1
+$ fc -3 -1
+

If you save and exit, all commands are executed as a script, and it will be added to your history.

Source: https://shapeshed.com/unix-fc/

Prevent logoff from killing tmux sessions

Lately I’ve noticed that logging out of i3, intentionally or when i3 fails, would also kill any tmux or emacs sessions. +This is extremely annoying.

This is caused by a new default in logind (systemd’s login) to kill user process on logoff. +You can revert this setting in your logind.conf (/etc/systemd/logind.conf):

1
+KillUserProcesses=no
+

Or only for a specific process (e.g., tmux):

1
+systemd-run --scope --user tmux
+

Source: https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session

Upload a temporary file

Sometimes you just need to copy/paste a file from a server, and copying from the terminal can be a hassle. +These two services are command-line “pastebins” just one curl away:

1
+2
+3
+4
+5
+6
+7
+8
+<command> | curl -F 'sprunge=<-' http://sprunge.us
+# OR
+
+<command> 2>&1 | curl -F 'f:1=<-' ix.io
+
+# OR
+
+<command> | curl -F"file=@-" https://ttm.sh
+

Install Fortinet SSLVPN support for NetworkManager

UPM (Universidad Politécnica de Madrid) uses a propriatary VPN solution. +The instructions for GNU/Linux on their website involve downloading a specific client (.tar.gz) and manually running it. +That works, but it is kind of a hassle. +A much more convenient alternative is installing this NetworkManager plugin:

1
+2
+pacman -Sy networkmanager-fortisslvpn 
+# Or apt get install networkmanager-fortisslvpn 
+

Now you can simply add a new VPN connection in NetworkManager and manage it as you would any other connection.

\ No newline at end of file diff --git a/p/controlling-zigbee-devices-with-mqtt/index.html b/p/controlling-zigbee-devices-with-mqtt/index.html new file mode 100644 index 0000000..aefed74 --- /dev/null +++ b/p/controlling-zigbee-devices-with-mqtt/index.html @@ -0,0 +1,113 @@ +Controlling Zigbee devices with MQTT +

Controlling Zigbee devices with MQTT

This is a short tutorial on connecting a zigbee device (an Aqara cube) +to an MQTT server, so you can control your zigbee devices from the +network.

If you’re anything like me, you’re probably a sucker for IoT devices. +For a long time, I’ve been using WiFi-enabled lights, and Amazon dash +buttons to control them. To keep these (cheap Chinese) internet enabled +devices away from your network and their respective cloud services, +you’ll probably want to set up a dedicated network in your router (more +on this on a future post, maybe). Another disadvantage of WiFi devices +is that they’re relatively power hungry.

A popular alternative is using ZigBee for communication. It is a +dedicated protocol similar to bluetooth (BLE), with lower power +requirements and bitrate.

Take the (super cute) aqara cube as an example. It is a small cube that +detects rotation on all of its axes, and tapping events. Here’s a +video:

To connect to zigbee devices you will need a zigbee enabled gateway +(a.k.a. hub), which connects to your WiFi network and your zigbee +devices. Once again, this means adding an internet-enabled device to +your home, and probably a couple of cloud services.

As an alternative, you can set up your own zigbee gateway, and control +it to your home automation platform of choice (e.g. home assistant). We +will cover how to set up a zigbee2mqtt gateway that is also connected to +an MQTT server, so you can use MQTT to control your devices and get +notifications.

What you need:

You will need to flash your sniffer. For that, you only need to follow +the instructions from the zigbee2mqtt +documentation.

Once you’re done flashing, you’re ready to set up the zigbee2mqtt +server. For convenience, I wrote a simple docker-compose to deploy a +zigbee2mqtt server and a test mosquitto server:

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+version: '2.1'
+services:
+  zigbee2mqtt:
+    image: koenkk/zigbee2mqtt
+    container_name: zigbee2mqtt 
+    restart: always
+    volumes:
+      - ./z2m-data/:/app/data/
+    devices:
+      - "/dev/ttyACM0"
+    networks:
+        - hass
+  mqtt:
+    image: eclipse-mosquitto
+    ports:
+       - 1883:1883
+       - 9001:9001 
+    networks:
+        - hass
+    volumes:
+      - ./mosquitto.conf:/mosquitto/config/mosquitto.conf
+networks:
+  hass:
+    driver: overlay
+

You can test your installation with:

1
+2
+3
+4
+5
+6
+❯ mosquitto_sub -h localhost -p 1883 -t 'zigbee2mqtt/#'
+online
+{"battery":17,"voltage":2925,"linkquality":149,"action":"rotate_right","angle":12.8}
+{"battery":17,"voltage":2925,"linkquality":141,"action":"slide","side":2}
+{"battery":17,"voltage":2925,"linkquality":120}
+{"battery":17,"voltage":2925,"linkquality":141,"action":"wakeup"}

zigbee2mqtt supports the following events for the aqara cube: shake, +wakeup, fall, tap, slide, flip180, flip90, rotate_left and +rotate_right. Every event has additional information, such as the sides +involved, or the degrees turned.

Now you are ready to set up home assistant support in zigbee2mqtt +following this +guide.

\ No newline at end of file diff --git a/p/creating-my-web/index.html b/p/creating-my-web/index.html new file mode 100644 index 0000000..754bf01 --- /dev/null +++ b/p/creating-my-web/index.html @@ -0,0 +1,53 @@ +Creating my web +

Creating my web

I’ve finally decided to set up a decent personal page. I have settled +for github-pages because I like the idea of keeping my site in a +repository and having someone else host and deploy it for me. The site +will be really simple, mostly static files. Thanks to Github, +Jekyll will automatically generate static pages +for my posts every time I commit anything new to this repository.

But Jekyll can be used independently, so if I ever choose to host the +site myself, I can do it quite easily. Another thing that I liked about +this approach is that the generated html files can be used in the +future, and I will not need Jekyll to serve it. Jekyll is really simple +and most of the things are written in plain html. That means that +everything could be easily reused if I ever choose to change to another +blogging framework (e.g. pelical). But, for the time being, I like the +fact that Github takes care of the compilation as well, so I can simply +modify or add files through the web interface should I need to.

I hadn’t played with HTML and CSS for a while now, so I also wanted to +use this site as a playground. At some point, I realised I was doing +mostly everything in plain HTML and CSS, and decided to keep it like +that for as long as possible. As of this writing, I haven’t included +any Javascript code in the page. Probably I will use some to add my +gists and +repositories, but we will see about that.

I think the code speaks for itself, so you can check out my repository +on Github. You can clone +and deploy it easily like this:

1
+2
+3
+git clone
+https://github.com/balkian/balkian.github.com cd balkian.github.com
+jekyll serve -w
+

I will keep updating this post with information about:

Some Jekyll plugins that might be useful
What CSS tricks I learnt
The webfonts I used
The badge on the left side of the page

\ No newline at end of file diff --git a/p/kanata-advanced-keyboard-configuration/index.html b/p/kanata-advanced-keyboard-configuration/index.html new file mode 100644 index 0000000..6ad4e2a --- /dev/null +++ b/p/kanata-advanced-keyboard-configuration/index.html @@ -0,0 +1,197 @@ +Kanata: advanced keyboard configuration +

Kanata: advanced keyboard configuration

Kanata is a software keyboard remapper that aims to improve keyboard comfort and usability with advanced customization. +Keyboard remappers are a good alternative to running a custom keyboard with QMK/ZMK, and have two main advantages: they work on any keyboard, and you can configure them to launch any command or program you want, not just key presses. +On the other hand, you need to configure them on every PC/OS you’re using your keyboard with, and all the processing is done on software on top of the OS, so there may be glitches and performance issues.

The project was inspired by the more popular KMonad, and the author cites some of the differences. +Both projects use a very similar configuration format based on lisp. +The configuration consists of a set of general options, a base key configuration, a series of layers, and macros that can be used within those layers. +Here’s a very complete config that serves as documentation.

One big disadvantage of the lispy configuration is that you need to specify your hardware layout/all your keys, and repeat that every time you define a new layer. +The result visually maps to your keyboard, but can be very verbose/big if you need really few changes.

Keyd is another alternative with a more declarative configuration format, which might lend itself to smaller.

For now I’m just trying it out, and getting a feel for using fewer keys before I build my own ZMK keyboard. +I particularly like the option of using mod-keys on the home row (e.g., having A work as a CTRL when held). +Mod-tap, tap-dancing and the like are very common techniques in sub-40% layouts, where there simply aren’t enough keys for all the letters and symbols. +In a regular-sized keyboard, these techniques can also help you stay on the home row and type more comfortably. +At least, that’s the idea. +We’ll see if I like it enough to stick with it.

For now, here’s my very simple config:

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+59
+60
+61
+62
+63
+64
+65
+66
+67
+68
+69
+70
+71
+72
+73
+74
+75
+76
+77
+78
+79
+80
+(defcfg
+  ;; Your keyboard device will likely differ from this.
+  linux-dev  /dev/input/by-id/usb-Logitech_USB_Receiver-if02-event-mouse
+
+  ;; Windows doesn't need any input/output configuration entries; however, there
+  ;; must still be a defcfg entry. You can keep the linux-dev entry or delete
+  ;; it and leave it empty.
+)
+
+(defsrc
+  grv  1    2    3    4    5    6    7    8    9    0    -    =    bspc
+  tab  q    w    e    r    t    y    u    i    o    p    [    ]    
+  caps a    s    d    f    g    h    j    k    l    ;    '    ret
+  lsft \ z    x    c    v    b    n    m    ,    .    /    rsft
+  lctl lmet lalt           spc            ralt rmet rctl
+)
+
+
+(deflayer qwerty
+  grv  _    _    _    _    _    _    _    _    _    _    _    _    _
+  _  _    @warrows    _    _    _    _    _    _    _    _    _    _    
+  lctrl     @alctrl    @slsft    @dlalt    @flmet    _    _    @jrmet    @kralt    @lrsft    @;rctrl    _ _
+  _ _ _    _    _    _    _    _    _    _    _    _    _
+  _ _ _           @smartspace            _ _ _
+)
+
+(deflayer arrows
+  _  _    _    _    _    _    _    _    _    _    _    _    _    _
+  _  _    _    _    _    _    _    _    _    _    _    _    _    
+  _     _    _    _    @flmet    _    left down up rght _ _ _
+  _ _ _    _    _    _    _    _    _    _    _    _    _
+  _ _ _           @smartspace            _ _ _
+)
+
+(deflayer colemak
+  grv XX    XX    XX    XX    XX    XX    XX    XX    XX    XX    XX    XX    _
+  tab         q       w       f       p       b       j       l       u       y       ;       [       ]    
+  lctrl   @alctrl @rlsft      @slalt      @tlmet      g       m       @nrmet      @eralt      @irsft      @orctrl      '       ret
+  lsft    XX z       x       c       d       v     k       h       ,       .       /       rsft
+  XX XX XX           @smartspace            XX XX XX
+)
+
+(deflayer magic
+  _  @clmk    @qwerty    _    _    _    _    _    _    _    _    _    _    _
+  _  _    _    _    _    _    _    _    _    _    _    _    _    
+  _     tab    A-tab    _    _    _    _    bspc  esc   _ ret    _  _
+  _ _ _    _    _    _    _    _    _    _    _    _    _
+  _ _ _           _            _ _ _
+)
+
+(defalias
+  warrows (tap-hold 200 200 w (layer-toggle arrows))
+
+  alctrl (tap-hold 200 200 a lctrl)
+  slsft (tap-hold 200 200 s lsft)
+  dlalt (tap-hold 200 200 d lalt)
+  flmet (tap-hold 200 200 f lmet)
+
+  jrmet (tap-hold 200 200 j rmet)
+  kralt (tap-hold 200 200 k ralt)
+  lrsft (tap-hold 200 200 l rsft)
+  ;rctrl (tap-hold 200 200 ; rctrl)
+
+  rlsft (tap-hold 200 200 r lsft)
+  slalt (tap-hold 200 200 s lalt)
+  tlmet (tap-hold 200 200 t lmet)
+  nrmet (tap-hold 200 200 n rmet)
+  eralt (tap-hold 200 200 e ralt)
+  irsft (tap-hold 200 200 i rsft)
+  orctrl (tap-hold 200 200 o rctrl)
+  clmk (layer-switch colemak)
+  qwerty (layer-switch qwerty)
+
+  smartspace (tap-dance 200 (
+      (tap-hold 300 300 spc (layer-toggle magic))
+      (tap-hold 300 300 (one-shot 300 lalt) spc)
+      a
+      ))
+
+  )
+

\ No newline at end of file diff --git a/p/linux-on-the-microsoft-surface-go/index.html b/p/linux-on-the-microsoft-surface-go/index.html new file mode 100644 index 0000000..1b36543 --- /dev/null +++ b/p/linux-on-the-microsoft-surface-go/index.html @@ -0,0 +1,59 @@ +Linux on the Microsoft Surface Go +

Linux

Linux on the Microsoft Surface Go

Believe it or not, Surface tablets have pretty good linux support, except for the webcams in newer models. +These are some useful notes to get Ubuntu installed in your surface go, as of Summer 2019.

Installing the kernel

1
+2
+git clone --depth 1 https://github.com/jakeday/linux-surface.git ~/linux-surface
+cp -a ~/linux-surface /media/<your usb>
+

1
+2
+3
+cp -a /media/<your usb>/linux-surface ~/
+cd ~/linux-surface/
+sudo sh setup.sh
+

Booting ubuntu first

Switch out of Windows S mode.

Boot into the “Command Prompt”.

From Windows go to “change advanced startup options” and select “restart now”.

When it reboots, choose the “Troubleshoot” option, then choose the “Advanced options” option, and finally choose the “Command Prompt” option.

After the device reboots, login to the command prompt and then you should see a terminal with X:\windows\system32>

At the prompt, check your UEFI entries:

1
+bcdedit /enum firmware
+

Copy UEFI entry of “Windows Boot Manager” to create a new entry for Ubuntu: bcdedit /copy {bootmgr} /d “Ubuntu”

Copy the printed GUID number including the braces {} using Ctrl+C

Set file path for the new Ubuntu entry. Replace {guid} with the returned GUID of the previous command (Ctrl+V). bcdedit /set {guid} path \EFI\ubuntu\grubx64.efi

Set Ubuntu as the first/ entry in the boot sequence. Again replace {guid} with the returned GUID of the copy command.

1
+bcdedit /set {fwbootmgr} displayorder {guid} /addfirst
+

Check your UEFI entries again: bcdedit /enum firmware You should see something like this:

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+
+Firmware Boot Manager
+---------------------
+identifier              {fwbootmgr}
+displayorder            {3510232e-f8eb-e811-95ce-9ecab3f9d1c4}
+                        {bootmgr}
+                        {2148799b-f8eb-e811-95ce-9ecab3f9d1c4}
+                        {312e8a67-c2f6-e811-95ce-3c1ab3f9d1de}
+                        {312e8a68-c2f6-e811-95ce-3c1ab3f9d1de}
+timeout                 0
+

Make sure the GUID you copied is the first one listed in displayorder. Then type exit, turn off the PC and turn it back on. After this my surface go is automatically booting to the grub bootloader which lets me choose between Windows and Ubuntu but defaults to Ubuntu after ten seconds.

\ No newline at end of file diff --git a/p/logitech-mb850-combi-in-linux/index.html b/p/logitech-mb850-combi-in-linux/index.html new file mode 100644 index 0000000..ceb406d --- /dev/null +++ b/p/logitech-mb850-combi-in-linux/index.html @@ -0,0 +1,43 @@ +Logitech MB850 combi in linux +

Logitech MB850 combi in linux

As a follow-up to my last post, I’ve decided to also configure my mk850 combo (k850 + m720 triathlon).

Some notes:

The keyboard is usually connected to this PC through bluetooth. Since this is a change I usually do in the system for every keyboard, I added a rule for any bus (usb, bluetooth, etc)
The mouse has an additional button that registers as a keyboard. Every press maps to three key events. I’ve disabled two of them and mapped the action to F19, in case I want to use it in my DE/WM.

1
+2
+3
+4
+5
+6
+7
+evdev:input:*                                                        
+ KEYBOARD_KEY_70039=leftctrl  # bind capslock to w 
+
+evdev:input:b0005v046DpB015*
+ KEYBOARD_KEY_700e0=f19
+ KEYBOARD_KEY_700e2=unknown
+ KEYBOARD_KEY_7002b=unknown
+

After that, simply run:

1
+ sudo udevadm hwdb --update && sudo udevadm trigger
+

Make sure the settings have been applied by running evemu-describe:

1
+ sudo /sbin/evemu-describe  /dev/input/event<id of your device> | grep KEY_  
+

\ No newline at end of file diff --git a/p/logitech-mx-keys-for-mac-on-linux/index.html b/p/logitech-mx-keys-for-mac-on-linux/index.html new file mode 100644 index 0000000..6e6b70b --- /dev/null +++ b/p/logitech-mx-keys-for-mac-on-linux/index.html @@ -0,0 +1,55 @@ +Logitech MX Keys for Mac on Linux +

Logitech MX Keys for Mac on Linux

I recently got Logitech MX Keys for Mac keyboard at work. +The German version, to be more precise. +This version was three times cheaper than the Windows equivalent with either US or ES layout. +Since I touch type anyway, I thought it was a bargain.

As soon as I plugged it in, I realized there were some glaring issues with the keyboard. +First of all, the Meta/Super and Alt keys are reversed in this keyboard. +In the normal/full version of this keyboard, Logitech gives an option to choose between Mac, Windows and iOS host, and that changes the behavior of the keys. +In this version, tho, only iOS and Mac are available.

Besides that, there’s the issue of the grave (tilde) and angle keys switched as well.

Switching these keys around would be very easy with Xorg, but Wayland once again complicates things…

These issues almost made me return the keyboard. +Luckily, tho, there is another option: configuring the keys one level lower than wayland (and X11), through hwdb.

Long story short, this will configure any Logitech keyboard with the same product id (0x4092) to use a saner configuration:

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+#File: /etc/udev/hwdb.d/90-logitech-keyboard.hwdb
+
+evdev:input:b0003v046Dp4092*
+ KEYBOARD_KEY_700e2=leftmeta
+ KEYBOARD_KEY_700e3=leftalt
+ KEYBOARD_KEY_70039=leftctrl
+ KEYBOARD_KEY_70064=102nd
+ KEYBOARD_KEY_70035=grave
+ KEYBOARD_KEY_700e7=rightalt
+ KEYBOARD_KEY_700e6=rightmeta
+ KEYBOARD_KEY_7006d=compose
+

After that, simply run:

1
+ sudo udevadm hwdb --update && sudo udevadm trigger
+

\ No newline at end of file diff --git a/p/nix-recipe-for-python-projects/index.html b/p/nix-recipe-for-python-projects/index.html new file mode 100644 index 0000000..9b180bd --- /dev/null +++ b/p/nix-recipe-for-python-projects/index.html @@ -0,0 +1,105 @@ +Nix Recipe for Python Projects +

Nix Recipe for Python Projects

This is a quick and easy recipe to add a default.nix to any Python project with a requirements.txt file:

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+with import <nixpkgs> { };
+
+let
+  pythonPackages = python311Packages;
+in pkgs.mkShell rec {
+  name = "impurePythonEnv";
+  venvDir = "./.venv";
+  buildInputs = [
+    # A python interpreter including the 'venv' module is required to bootstrap
+    # the environment.
+    pythonPackages.python
+
+    # This execute some shell code to initialize a venv in $venvDir before
+    # dropping into the shell
+    pythonPackages.venvShellHook
+
+    # Those are dependencies that we would like to use from nixpkgs, which will
+    # add them to PYTHONPATH and thus make them accessible from within the venv.
+    pythonPackages.numpy
+    pythonPackages.requests
+
+    # In this particular example, in order to compile any binary extensions they may
+    # require, the python modules listed in the hypothetical requirements.txt need
+    # the following packages to be installed locally:
+    taglib
+    openssl
+    git
+    libxml2
+    libxslt
+    libzip
+    zlib
+  ];
+
+  # Now we can execute any commands within the virtual environment.
+  # This is optional and can be left out to run pip manually.
+  postShellHook = ''
+    pip install -r requirements.txt
+  '';
+
+}
+

Now, you will get a clean environment by running:

1
+nix-shell
+

\ No newline at end of file diff --git a/p/progress-bars-in-python/index.html b/p/progress-bars-in-python/index.html new file mode 100644 index 0000000..ba974be --- /dev/null +++ b/p/progress-bars-in-python/index.html @@ -0,0 +1,33 @@ +Progress bars in python +

Progress bars in python

tqdm is a nice way to add progress +bars in the command line or in a jupyter notebook.

1
+2
+3
+4
+5
+from tqdm import tqdm
+import time
+
+for i in tqdm(range(100)):
+    time.sleep(1)
+

\ No newline at end of file diff --git a/p/proxies-with-apache-and-python/index.html b/p/proxies-with-apache-and-python/index.html new file mode 100644 index 0000000..68e14e1 --- /dev/null +++ b/p/proxies-with-apache-and-python/index.html @@ -0,0 +1,91 @@ +Proxies with Apache and python +

Proxies with Apache and python

This is a quick note on proxying a local python application (e.g. flask) +to a subdirectory in Apache. This assumes that the file wsgi.py contains +a WSGI application with the name application. Hence, wsgi:application.

Gunicorn

1
+2
+3
+4
+5
+<Location /myapp/>
+    ProxyPass http://127.0.0.1:8888/myapp/
+    ProxyPassReverse http://127.0.0.1:8888/myapp/
+    RequestHeader set SCRIPT_NAME "/myapp/"
+</Location>
+

Important: SCRIPT_NAME and the end of ProxyPass URL MUST BE +THE SAME. Otherwise, Gunicorn will fail miserably.

Try it with:

1
+venv/bin/gunicorn -w 4 -b 127.0.0.1:8888 --log-file - --access-logfile - wsgi:application
+

UWSGI

This is a very simple configuration. I will try to upload one with more +options for uwsgi (in a .ini file).

1
+2
+3
+4
+<Location /myapp/>
+    SetHandler uwsgi_handler
+    uWSGISocker 127.0.0.1:8888
+</Location>
+

Try it with:

1
+uwsgi --socket 127.0.0.1:8888 -w wsgi:application
+

Extra: Supervisor

If everything went as expected, you can wrap your command in a +supervisor config file and let it handle the server for you.

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+[unix_http_server]
+file=/tmp/myapp.sock ; path to your socket file
+
+[supervisord]
+logfile = %(here)s/logs/supervisor.log
+childlogdir = %(here)s/logs/
+
+[rpcinterface:supervisor]
+supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
+
+[supervisorctl]
+logfile = %(here)s/logs/supervisorctl.log
+serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket
+
+[program:myapp]
+command = venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 --log-file %(here)s/logs/gunicorn.log --access-logfile - wsgi:application
+directory = %(here)s
+environment = PATH=%(here)s/venv/bin/
+logfile = %(here)s/logs/myapp.log
+

\ No newline at end of file diff --git a/p/publishing-on-pypi/index.html b/p/publishing-on-pypi/index.html new file mode 100644 index 0000000..907c762 --- /dev/null +++ b/p/publishing-on-pypi/index.html @@ -0,0 +1,125 @@ +Publishing on PyPi +

Publishing on PyPi

Developing a python module and publishing it on Github is cool, but most +of the times you want others to download and use it easily. That is the +role of PyPi, the python package repository. In this post I show you how +to publish your package in less than 10 minutes.

Choose a fancy name

If you haven’t done so yet, take a minute or two to think about this. +To publish on PyPi you need a name for your package that isn’t taken. +What’s more, a catchy and unique name will help people remember your +module and feel more inclined to at least try it.

The package name should hint what your module does, but that’s not +always the case. That’s your call. I personally put uniqueness and +memorability over describing the functionality.

Create a .pypirc configuration file

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+[distutils] # this tells distutils what package indexes you can push to
+index-servers =
+    pypi # the live PyPI
+    pypitest # test PyPI
+
+[pypi] # authentication details for live PyPI
+repository = https://pypi.python.org/pypi
+username = { your_username }
+password = { your_password } # not necessary
+
+[pypitest] # authentication details for test PyPI
+repository = https://testpypi.python.org/pypi
+username = { your_username }
+

As you can see, you need to register both in the main pypi +repository and +the testing +server. The +usernames and passwords might be different, that is up to you!

Prepare your package

This should be the structure:

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+root-dir/    # Any name you want
+    setup.py
+    setup.cfg
+    LICENSE.txt
+    README.md
+    mypackage/
+        __init__.py
+        foo.py
+        bar.py
+        baz.py
+

setup.cfg

1
+2
+[metadata]
+description-file = README.md
+

The markdown README is the de facto standard in Github, but you can +also use rST (reStructuredText), the standard in the python community.

setup.py

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+from distutils.core import setup
+
+setup(name = 'mypackage',
+      packages = ['mypackage'], # this must be the same as the name above
+      version = '{ version }',
+      description = '{ description }',
+      author = '{ name }',
+      email = '{ email }',
+      url = 'https://github.com/{user}/{package}', # URL to the github repo
+      download_url = 'https://github.com/{user}/{repo}/tarball/{version}',
+      keywords = ['websockets', 'display', 'd3'], # list of keywords that represent your package
+      classifiers = [], )
+

You might notice that the download_url points to a Github URL. We could +host our package anywhere, but Github is a convenient option. To create +the tarball and the zip packages, you only need to tag a tag in your +repository and push it to github:

1
+2
+git tag {version} -m "{ Description of this tag/version}"
+git push --tags origin master
+

Push to the testing/main pypi server

It is advisable that you try your package on the test repository and fix +any problems first. The process is simple:

1
+python setup.py register -r {pypitest/pypi} python setup.py sdist upload -r {pypitest/pypi}
+

If everything went as expected, you can now install your package through +pip and browse your package’s page. For instance, check my senpy +package: https://pypi.python.org/pypi/senpy

1
+pip install senpy
+

\ No newline at end of file diff --git a/p/remove-git-files-with-globbing/index.html b/p/remove-git-files-with-globbing/index.html new file mode 100644 index 0000000..a108d13 --- /dev/null +++ b/p/remove-git-files-with-globbing/index.html @@ -0,0 +1,25 @@ +Remove git files with globbing +

Remove git files with globbing

A simple trick. If you want to remove all the ‘.swp’ files from a git +repository, just use:

1
+git rm --cached '**.swp'
+

\ No newline at end of file diff --git a/p/sharing-dotfiles/index.html b/p/sharing-dotfiles/index.html new file mode 100644 index 0000000..15dec43 --- /dev/null +++ b/p/sharing-dotfiles/index.html @@ -0,0 +1,43 @@ +Sharing dotfiles +

Sharing dotfiles

Today’s post is half a quick note, half public shaming. In other words, +it is a reminder to be very careful with OAuth tokens and passwords.

As part of moving to emacs, I starting using the incredibly useful +gh.el. When you first use it, the +extension saves either your password or an OAuth token in your +.gitconfig file. This is cool and convenient, unless you happen to be +publishing your .gitconfig file in a public +repo.

So, how can you still share your gitconfig without sharing your +password/token with the rest of the world? Since Git 1.7.0, you can +include other files in your +gitconfig.

1
+2
+[include]
+    path = ~/.gitconfig_secret
+

And now, in your .gitconfig_secret file, you just have to add this:

1
+2
+3
+[github]
+    user = balkian 
+    token = "< Your secret token >" 
+

\ No newline at end of file diff --git a/p/updating-eurolovemap/index.html b/p/updating-eurolovemap/index.html new file mode 100644 index 0000000..a08df59 --- /dev/null +++ b/p/updating-eurolovemap/index.html @@ -0,0 +1,98 @@ +Updating EuroLoveMap +

Updating EuroLoveMap

As part of the OpeNER +hackathon +we decided to build a prototype that would allow us to compare how +different countries feel about several topics. We used the OpeNER +pipeline to get the sentiment from a set of newspaper articles we +gathered from media in several languages. Then we aggregated those +articles by category and country (using the source of the article or the +language it was written in), obtaining the “overall feeling” of each +country about each topic. Then, we used some fancy JavaScript to make +sense out of the raw information.

It didn’t go too bad, it turns out we +won.

Now, it was time for a face-lift. I used this opportunity to play with +new technologies and improve it:

Using Flask, this time using python 3.3 and Bootstrap 3.0
Cool HTML5+JS cards (thanks to +pastetophone)
Automatic generation of fake personal data to test the interface
Obfuscation of personal emails

The result can be seen here.

Publishing a Python 3 app on Heroku

1
+mkvirtualenv -p /usr/bin/python3.3 eurolovemap
+

Since Heroku uses python 2.7 by default, we have to tell it which +version we want, although it supports python 3.4 as well. I couldn’t +get python 3.4 working using the +deadsnakes ppa, so +I used python 3.3 instead, which works fine but is not officially +supported. Just create a file named runtime.txt in your project root, +with the python version you want to use:

1
+python-3.3.1
+

Don’t forget to freeze your dependencies so Heroku can install them: +bash pip freze > requirements.txt

Publishing personal emails

There are really sophisticated and effective ways to obfuscate personal +emails so that spammers cannot easily grab yours. However, this time I +needed something really simple to hide our emails from the simplest form +of crawlers. Most of the team are in academia somehow, so in the end all +our emails are available in sites like Google Scholar. Anyway, nobody +likes getting spammed so I settled for a custom Caesar +cipher. Please, don’t use +it for any serious application if you are concerned about being spammed.

1
+2
+def blur_email(email):
+    return "".join([chr(ord(i)+5) for i in email])
+

And this is the client side:

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+window.onload = function(){
+     elems = document.getElementsByClassName('profile-email');
+     for(var e in elems){
+        var blur = elems[e].innerHTML;
+        var email = "";
+        for(var s in blur){
+            var a = blur.charCodeAt(s)
+            email = email+String.fromCharCode(a-5);
+        }
+        elems[e].innerHTML = email;
+     }
+}
+

Unfortunately, this approach does not hide your email from anyone using +PhantomJS, +ZombieJS or similar. For that, other +approaches like generating a picture with the address would be +necessary. Nevertheless, it is overkill for a really simple ad-hoc +application with custom formatting and just a bunch of emails that would +easily be grabbed manually.

Generation of fake data

To test the contact section of the site, I wanted to populate it with +fake data. Fake-Factory is an amazing +library that can generate fake data of almost any kind: emails, +association names, acronyms… It even lets you localise the results +(get Spanish names, for instance) and generate factories for certain +classes (à la Django).

But I also wanted pictures, enter Lorem Pixel. +With its API you can generate pictures of almost any size, for different +topics (e.g. nightlife, people) and with a custom text. You can even use +an index, so it will always show the same picture.

For instance, the picture below is served through Lorem Pixel.

By the way, if you only want cat pictures, take a look at +Placekitten. And for NSFW text, there’s the +Samuel L. Jackson Ipsum

\ No newline at end of file diff --git a/p/uv-one-rust-tool-to-rule-all-pythons/index.html b/p/uv-one-rust-tool-to-rule-all-pythons/index.html new file mode 100644 index 0000000..e84f594 --- /dev/null +++ b/p/uv-one-rust-tool-to-rule-all-pythons/index.html @@ -0,0 +1,92 @@ +uv - One rust tool to rule all pythons +

Programming

uv - One rust tool to rule all pythons

Long story short: I’m now using uv, and so should you. +It is a great replacement for pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more.

Context

For years, my strategy to manage python projects has been a mix of a custom setup.py, several hand-crafted requirements.txt files (through pip freeze), a custom virtualenv per project, and multiple tools to upload to PyPI. +Although this works, this setup has many drawbacks:

It requires user intervention (creating a venv, sourcing it, handling new deps). This isn’t ideal if you want new (probably inexperienced) users to use your projects.
On a similar note, the whole process needs to be well documented if you want other users to contribute or maintain the code.
Pinning dependency versions is finicky, and I’ve run into problems beause of that.
Creating a new project involves a template, or copying files from an older project.

Of course, this is nothing new. +There is a whole site dedicated to packaging your Python project. +A plethora of different projects have come and go, with varying degrees of success.

Alternatives (poetry)

About a year before trying uv, I tried to catch up with the ecosystem and get to know the blessed new way. +However, the task proved to be a little more difficult, as the landscape is filled with a myriad of alternatives, each with their own set of drawbacks and detractors. +Packaging has historically been a weak spot, in ironical contradiction to the Zen of Python’s “There should be one– and preferably only one –obvious way to do it”,

I eventually settled on poetry. +Mostly because it seemed like the most popular alternative.

There are many things I liked about it. +First of all, having a convention for dependencies (pyproject.toml) and a tool that properly handles them was nice. +It also removed the need to remember specific incantations to build and publish my Python projects. +Lastly, I mixed it poetry2nix to create reproducible python environments using nix. +This makes for a very powerful experience.

However, there were multiple hiccups. +First of all, it took me some time to figure out which specific fields to use (each tool can define ad-hoc properties in a the pyproject.toml file), and some of them seemed redundant with the more generic ones. +Full disclosure, this specific point might be a mistake on my side, and I do not remember the details. +The second one is speed. +(Re-)creating an environment took a non-negligible amount of time.

Enter light `uv`

According to its repository, uv can replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +Not only that, but it also claims to do that 10-100 times faster than pip. +I must admit that it being written in rust was a another selling point for me, as I’m looking for excuses to collaborate in a decently-sized rust projejct.

Installing it is dead simple: simply download the binary (e.g., with curl) or run pip install uv. +You won’t need much more: uv seems to just do the right thing out of the box. +And it does it really, really fast. +The rest of the time it gets out of the way.

My only gripe so far is that I don’t seem to find a built-in command to drop into a shell, but that is nothing that uv run $SHELL cannot fix.

Common operations

Initialize a repository

1
+uv init
+

Adding dependencies

1
+uv add senpy
+

Running commands inside the environment

1
+2
+3
+4
+uv run <COMMAND>
+
+# e.g., run a shell using your python version and dependencies
+uv run $SHELL
+

Dependency tree

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+uv shell
+Resolved 44 packages in 1ms                                            
+my-project v0.1.0                                             
+├── fastapi[standard] v0.115.8                                         
+│   ├── pydantic v2.10.6                                               
+│   │   ├── annotated-types v0.7.0                                     
+│   │   ├── pydantic-core v2.27.2                                      
+│   │   │   └── typing-extensions v4.12.2                              
+│   │   └── typing-extensions v4.12.2                                  
+│   ├── starlette v0.45.3                                              
+│   │   └── anyio v4.8.0                                               
+│   │       ├── exceptiongroup v1.2.2                                  
+│   │       ├── idna v3.10                                             
+│   │       ├── sniffio v1.3.1                                         
+│   │       └── typing-extensions v4.12.2                              
+│   ├── typing-extensions v4.12.2                                      
+│   ├── email-validator v2.2.0 (extra: standard)                       
+│   │   ├── dnspython v2.7.0
+...
+

\ No newline at end of file diff --git a/p/zotero/index.html b/p/zotero/index.html new file mode 100644 index 0000000..0caa8cd --- /dev/null +++ b/p/zotero/index.html @@ -0,0 +1,103 @@ +Zotero +

Zotero

Zotero is an Open Source tool that lets you +organise your bibliography, syncing it with the cloud. Unlike other +alternatives such as Mendeley, Zotero can +upload the attachments and data to a private cloud via WebDav.

If you use nginx as your web server, know that even though it provides +partial support for webdav, Zotero needs more than that. Hence, you will +need another webdav server, and optionally let nginx proxy to it. This +short post provides the basics to get that set-up working under +Debian/Ubuntu.

Setting up Apache

First we need to install Apache:

1
+sudo apt-get install apache2
+

Change the head of “/etc/apache2/sites-enabled/000-default” to:

1
+<VirtualHost *:880>
+

Then, create a file /etc/apache2/sites-available/webdav:

 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+Alias /dav /home/webdav/dav
+<Location /dav>
+    Dav on
+    Order Allow,Deny
+    Allow from all
+    Dav On
+    Options +Indexes
+    AuthType Basic
+    AuthName DAV
+    AuthBasicProvider file
+    AuthUserFile /home/webdav/.htpasswd
+    Require valid-user
+</Location>
+

Ideally, you want your webdav folders to be private, adding +authentication to them. So you need to create the webdav and zotero +users and add the passwords to an htpasswd file. Even though you could +use a single user, since you will be configuring several clients with +your credentials I encourage you to create the zotero user as well. This +way you can always change the password for zotero without affecting any +other application using webdav.

1
+2
+3
+4
+sudo adduser webdav
+sudo htpasswd -c /home/webdav/.htpasswd webdav
+sudo htpasswd /home/webdav/.htpasswd zotero
+sudo mkdir -p /home/webdav/dav/zotero
+

Enable the site and restart apache:

1
+2
+3
+4
+sudo a2enmod webdav
+sudo a2enmod dav_fs
+sudo a2ensite webdav
+sudo service apache2 restart
+

At this point everything should be working at +http://<your_host>:880/dav/zotero

Setting up NGINX

After the Apache side is working, we can use nginx as a proxy to get +cleaner URIs. In your desired site/location, add this:

1
+2
+3
+4
+5
+6
+7
+location /dav {
+    client_max_body_size 20M;
+    proxy_set_header X-Real-IP  $remote_addr;
+    proxy_set_header X-Forwarded-For $remote_addr;
+    proxy_set_header Host $host;
+    proxy_pass http://127.0.0.1:880;
+}
+

Now just reload nginx:

1
+sudo service nginx force-reload
+

Extras

Zotero Reader - HTML5 client
Zandy - Android Open Source +client

\ No newline at end of file diff --git a/page/1/index.html b/page/1/index.html new file mode 100644 index 0000000..19a2ffe --- /dev/null +++ b/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/ + \ No newline at end of file diff --git a/page/2/index.html b/page/2/index.html new file mode 100644 index 0000000..eae395e --- /dev/null +++ b/page/2/index.html @@ -0,0 +1,43 @@ +Pager 2 - J. Fernando Sánchez +

Linux

Linux on the Microsoft Surface Go

Controlling Zigbee devices with MQTT

Progress bars in python

Sharing dotfiles

Zotero

\ No newline at end of file diff --git a/page/3/index.html b/page/3/index.html new file mode 100644 index 0000000..e96b77d --- /dev/null +++ b/page/3/index.html @@ -0,0 +1,43 @@ +Pager 3 - J. Fernando Sánchez +

Proxies with Apache and python

Publishing on PyPi

Updating EuroLoveMap

Remove git files with globbing

Creating my web

\ No newline at end of file diff --git a/page/cheatsheet/index.html b/page/cheatsheet/index.html new file mode 100644 index 0000000..c49b9be --- /dev/null +++ b/page/cheatsheet/index.html @@ -0,0 +1,31 @@ +Cheatsheets +

4 pages

Cheatsheets

Emacs

Linux

Python

Raspberry Pi

\ No newline at end of file diff --git a/page/cheatsheet/index.xml b/page/cheatsheet/index.xml new file mode 100644 index 0000000..70db055 --- /dev/null +++ b/page/cheatsheet/index.xml @@ -0,0 +1,205 @@ +Cheatsheets on J. Fernando Sánchezhttps://balkian.com/page/cheatsheet/Recent content in Cheatsheets on J. Fernando SánchezHugo -- gohugo.ioen-usEmacshttps://balkian.com/emacs/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/emacs/<img src="https://balkian.com/img/emacs.png" alt="Featured image of post Emacs" /><h2 id="show-plain-text-version">Show plain text version +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(font-lock-mode) +</code></pre></td></tr></table> +</div> +</div>Linuxhttps://balkian.com/linux/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/linux/<img src="https://balkian.com/img/linux.png" alt="Featured image of post Linux" /><h2 id="black-screen-and-lightdm-doesnt-unlock">Black screen and LightDM doesn’t unlock +</h2>Add this to your /etc/lightdm/lightdm.conf file: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[LightDM] +logind-check-graphical=true +</code></pre></td></tr></table> +</div> +</div>##Edit previous commands +<code>fc</code> is a shell builtin to list and edit previous commands in an editor. +In addition to editing a single line (which you can also do with <code>C-x C-e</code>), it also allows you to edit and run several lines at the same time. +You use it like this: +List previous commands +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -l +10259 nvim deploy.sh +10260* cd .. +10261* nvim content/cheatsheet/linux.md +10262 cd +</code></pre></td></tr></table> +</div> +</div>List commands with date (in zsh) +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -ld +10260* 19:38 cd .. +10261* 19:38 nvim content/cheatsheet/linux.md +10262 19:40 cd +10263 19:40 fc -l +</code></pre></td></tr></table> +</div> +</div>You can add the date too: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -fld +10262 1/10/2019 19:40 cd +10263 1/10/2019 19:40 fc -l +10264 1/10/2019 19:40 fc -ld +</code></pre></td></tr></table> +</div> +</div>You can edit a range of commands +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc 10262 10264 +</code></pre></td></tr></table> +</div> +</div>The range can be relative to the current position, so the previous command is equivalent to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -3 -1 +</code></pre></td></tr></table> +</div> +</div>If you save and exit, all commands are executed as a script, and it will be added to your history. +Source: <a class="link" href="https://shapeshed.com/unix-fc/" target="_blank" rel="noopener" +>https://shapeshed.com/unix-fc/</a> +<h2 id="prevent-logoff-from-killing-tmux-sessions">Prevent logoff from killing tmux sessions +</h2>Lately I’ve noticed that logging out of i3, intentionally or when i3 fails, would also kill any tmux or emacs sessions. +This is extremely annoying. +This is caused by a new default in logind (systemd’s login) to kill user process on logoff. +You can revert this setting in your logind.conf (<code>/etc/systemd/logind.conf</code>): +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">KillUserProcesses=no +</code></pre></td></tr></table> +</div> +</div>Or only for a specific process (e.g., tmux): +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">systemd-run --scope --user tmux +</code></pre></td></tr></table> +</div> +</div>Source: <a class="link" href="https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session" target="_blank" rel="noopener" +>https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session</a> +<h2 id="upload-a-temporary-file">Upload a temporary file +</h2>Sometimes you just need to copy/paste a file from a server, and copying from the terminal can be a hassle. +These two services are command-line “pastebins” just one curl away: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +8 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><command> | curl -F 'sprunge=<-' http://sprunge.us +# OR + +<command> 2>&1 | curl -F 'f:1=<-' ix.io + +# OR + +<command> | curl -F"file=@-" https://ttm.sh +</code></pre></td></tr></table> +</div> +</div><h1 id="install-fortinet-sslvpn-support-for-networkmanager">Install Fortinet SSLVPN support for NetworkManager +</h1>UPM (Universidad Politécnica de Madrid) uses a propriatary VPN solution. +The instructions for GNU/Linux on their website involve downloading a specific client (<code>.tar.gz</code>) and manually running it. +That works, but it is kind of a hassle. +A much more convenient alternative is installing this NetworkManager plugin: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">pacman -Sy networkmanager-fortisslvpn +# Or apt get install networkmanager-fortisslvpn +</code></pre></td></tr></table> +</div> +</div>Now you can simply add a new VPN connection in NetworkManager and manage it as you would any other connection.Pythonhttps://balkian.com/python/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/python/<img src="https://balkian.com/img/python.png" alt="Featured image of post Python" /><h2 id="interesting-libraries">Interesting libraries +</h2><h3 id="tqdm"><a class="link" href="https://github.com/tqdm/tqdm" target="_blank" rel="noopener" +>TQDM</a> +</h3>From tqdm’s github repository: +<blockquote> +tqdm means “progress” in Arabic (taqadum, تقدّم) and an abbreviation for “I love you so much” in Spanish (te quiero demasiado).</blockquote> +<img src="https://raw.githubusercontent.com/tqdm/tqdm/master/images/tqdm.gif" +loading="lazy" +alt="TQDM in action" +> +<h2 id="tools">Tools +</h2><h3 id="uv"><a class="link" href="https://github.com/astral-sh/uv" target="_blank" rel="noopener" +>uv</a> +</h3>🚀 A single tool to replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +⚡️ 10-100x faster than pip. +<ul> +<li>Provides comprehensive project management, with a universal lockfile.</li> +<li>Runs scripts, with support for inline dependency metadata.</li> +<li>Installs and manages Python versions.</li> +<li>Runs and installs tools published as Python packages.</li> +<li>Includes a pip-compatible interface for a performance boost with a familiar CLI.</li> +<li>Supports Cargo-style workspaces for scalable projects.</li> +<li>Disk-space efficient, with a global cache for dependency deduplication.</li> +<li>Installable without Rust or Python via curl or pip.</li> +<li>Supports macOS, Linux, and Windows.</li> +</ul>Raspberry Pihttps://balkian.com/raspberry-pi/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/raspberry-pi/<img src="https://balkian.com/img/rpi.png" alt="Featured image of post Raspberry Pi" /><h2 id="hdmi-flickering">HDMI flickering +</h2>Avoid HDMI flickering/intermittent blanking on RPI with a 1400x1050 VGA monitor. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"> + hdmi_drive=2 + hdmi_group=2 + hdmi_mode=42 + disable_overscan=1 + config_hdmi_boost=7 +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/page/cheatsheet/page/1/index.html b/page/cheatsheet/page/1/index.html new file mode 100644 index 0000000..192d6ae --- /dev/null +++ b/page/cheatsheet/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/page/cheatsheet/ + \ No newline at end of file diff --git a/page/index.html b/page/index.html new file mode 100644 index 0000000..6e32384 --- /dev/null +++ b/page/index.html @@ -0,0 +1,31 @@ +Pages +

Section

5 pages

Pages

Links

Projects

Search

\ No newline at end of file diff --git a/page/index.xml b/page/index.xml new file mode 100644 index 0000000..e349b00 --- /dev/null +++ b/page/index.xml @@ -0,0 +1,31 @@ +Pages on J. Fernando Sánchezhttps://balkian.com/page/Recent content in Pages on J. Fernando SánchezHugo -- gohugo.ioen-usSun, 06 Mar 2022 00:00:00 +0000Archiveshttps://balkian.com/archives/Sun, 06 Mar 2022 00:00:00 +0000https://balkian.com/archives/Linkshttps://balkian.com/links/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/links/Projectshttps://balkian.com/projects/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/projects/<h1 id="ongoing-projects">Ongoing Projects +</h1><ul> +<li><a class="link" href="https://soilsim.readthedocs.io" target="_blank" rel="noopener" +>Soil</a>: an agent-based simulator for social networks based on nx-sim and networkx.</li> +<li><a class="link" href="https://github.com/balkian/soilent" target="_blank" rel="noopener" +>Soilent</a>: an efficient scheduler for soil using rust and pyo3.</li> +<li><a class="link" href="https://senpy.readthedocs.io" target="_blank" rel="noopener" +>Senpy</a>: a framework for semantic sentiment and emotion analysis services.</li> +</ul> +<h1 id="past-projects">Past Projects +</h1><ul> +<li><a class="link" href="http://gsi.dit.upm.es/ontologies/onyx" target="_blank" rel="noopener" +>Onyx</a>: an ontology for emotion analysis that includes concepts from W3C’s provenance.</li> +<li><a class="link" href="https://github.com/balkian/ESP8266_Clock_NTP" target="_blank" rel="noopener" +>ESP8266 Clock NTP</a>: a simple clock display using arduino, the ESP8266 and NTP (network time protocol).</li> +<li><a class="link" href="https://github.com/balkian/shinesp" target="_blank" rel="noopener" +>Shine ESP</a>: control an ws2812b LED strip over the network with an ESP8266.</li> +<li><a class="link" href="https://github.com/balkian/bitter" target="_blank" rel="noopener" +>Bitter</a>: a wrapper and CLI over the (now defunct) Twitter API to researchers to download Twitter data much faster using multiple accounts.</li> +<li><a class="link" href="http://gsi.dit.upm.es/ontologies/marl" target="_blank" rel="noopener" +>Marl</a>: I updated this ontology, originally created by Adam Westerski, to make it compatible with the W3C’s provenance ontology.</li> +<li><a class="link" href="http://github.com/balkian/hermes" target="_blank" rel="noopener" +>Hermes</a>: one of my first projects, developed together with David Pérez as the special custom assignment in one of our courses. Hermes is an affective bot designed to mimic the behavour of humans. It included a plug-in system for its sensors and actuators. The information from its sensors changed its emotional state, which was shown via its actuators. Among others, it could fetch inforation from Twitter or its host system and change the expressions of an external Face made with servo motors or speak via its Text-To-Speech software. For instance, it could detect it was running out of battery, showing a sad face and sending an alerting tweet. You can see it in action in these two youtube videos: <a class="link" href="http://www.youtube.com/watch?v=KnEYahPD9z4" target="_blank" rel="noopener" +>Part 1</a> and <a class="link" href="http://www.youtube.com/watch?v=lQZldCTPEJc" target="_blank" rel="noopener" +>Part 2</a>.</li> +<li><a class="link" href="http://github.com/gsi-upm/maia" target="_blank" rel="noopener" +>Maia</a>: the Modular Architecture for Intelligent Agents is an evented agent architecture that aims to update the classical frameworks for intelligent agents with the concepts emerged from the Live Web.</li> +<li><a class="link" href="http://github.com/eestec/eestec.portal" target="_blank" rel="noopener" +>EESTEC.net</a>: the Plone based official portal of EESTEC. It has been my first and only experience with Plone. I fixed some bugs and implemented basic features.</li> +</ul> +For more information, check my list of public repositories in <a href="http://github.com/balkian"> Github</a>.Searchhttps://balkian.com/search/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/search/ \ No newline at end of file diff --git a/page/page/1/index.html b/page/page/1/index.html new file mode 100644 index 0000000..4b5de75 --- /dev/null +++ b/page/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/page/ + \ No newline at end of file diff --git a/post/index.html b/post/index.html new file mode 100644 index 0000000..0e7f72d --- /dev/null +++ b/post/index.html @@ -0,0 +1,33 @@ +Posts +

Section

15 pages

Posts

uv - One rust tool to rule all pythons

Nix Recipe for Python Projects

Kanata: advanced keyboard configuration

Logitech MB850 combi in linux

Logitech MX Keys for Mac on Linux

\ No newline at end of file diff --git a/post/index.xml b/post/index.xml new file mode 100644 index 0000000..bde2488 --- /dev/null +++ b/post/index.xml @@ -0,0 +1,1368 @@ +Posts on J. Fernando Sánchezhttps://balkian.com/post/Recent content in Posts on J. Fernando SánchezHugo -- gohugo.ioen-usMon, 17 Feb 2025 23:02:47 +0100uv - One rust tool to rule all pythonshttps://balkian.com/p/uv-one-rust-tool-to-rule-all-pythons/Mon, 17 Feb 2025 23:02:47 +0100https://balkian.com/p/uv-one-rust-tool-to-rule-all-pythons/<img src="https://balkian.com/img/uv.png" alt="Featured image of post uv - One rust tool to rule all pythons" />Long story short: I’m now using <a class="link" href="https://github.com/astral-sh/uv" target="_blank" rel="noopener" +>uv</a>, and so should you. +It is a great replacement for pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +<h2 id="context">Context +</h2>For years, my strategy to manage python projects has been a mix of a custom <code>setup.py</code>, several hand-crafted <code>requirements.txt</code> files (through <code>pip freeze</code>), a custom virtualenv per project, and multiple tools to upload to PyPI. +Although this works, this setup has many drawbacks: +<ul> +<li>It requires user intervention (creating a venv, sourcing it, handling new deps). This isn’t ideal if you want new (probably inexperienced) users to use your projects.</li> +<li>On a similar note, the whole process needs to be well documented if you want other users to contribute or maintain the code.</li> +<li>Pinning dependency versions is finicky, and I’ve run into problems beause of that.</li> +<li>Creating a new project involves a template, or copying files from an older project.</li> +</ul> +Of course, this is nothing new. +There is a whole site dedicated to <a class="link" href="https://packaging.python.org/en/latest/" target="_blank" rel="noopener" +>packaging your Python project</a>. +A plethora of different projects have come and go, with varying degrees of success. +<h2 id="alternatives-poetry">Alternatives (poetry) +</h2>About a year before trying <code>uv</code>, I tried to catch up with the ecosystem and get to know the <code>blessed new way</code>. +However, the task proved to be a little more difficult, as the landscape is filled with a myriad of alternatives, each with their own set of drawbacks and detractors. +Packaging has historically been a weak spot, in ironical contradiction to the Zen of Python’s “There should be one– and preferably only one –obvious way to do it”, +I eventually settled on <a class="link" href="https://python-poetry.org/" target="_blank" rel="noopener" +>poetry</a>. +Mostly because it seemed like the most popular alternative. +There are many things I liked about it. +First of all, having a convention for dependencies (<code>pyproject.toml</code>) and a tool that properly handles them was nice. +It also removed the need to remember specific incantations to build and publish my Python projects. +Lastly, I mixed it <code>poetry2nix</code> to create reproducible python environments using nix. +This makes for a very powerful experience. +However, there were multiple hiccups. +First of all, it took me some time to figure out which specific fields to use (each tool can define ad-hoc properties in a the <code>pyproject.toml</code> file), and some of them seemed redundant with the more generic ones. +Full disclosure, this specific point might be a mistake on my side, and I do not remember the details. +The second one is speed. +(Re-)creating an environment took a non-negligible amount of time. +<h2 id="enter-light-uv">Enter <del>light</del> <code>uv</code> +</h2>According to its repository, <code>uv </code>can replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +Not only that, but it also claims to do that 10-100 times faster than pip. +I must admit that it being written in rust was a another selling point for me, as I’m looking for excuses to collaborate in a decently-sized rust projejct. +Installing it is dead simple: simply download the binary (e.g., with curl) or run <code>pip install uv</code>. +You won’t need much more: <code>uv</code> seems to just do the right thing out of the box. +And it does it really, really fast. +The rest of the time it gets out of the way. +My only gripe so far is that I don’t seem to find a built-in command to drop into a shell, but that is nothing that <code>uv run $SHELL</code> cannot fix. +<h2 id="common-operations">Common operations +</h2><h3 id="initialize-a-repository">Initialize a repository +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv init +</code></pre></td></tr></table> +</div> +</div><h3 id="adding-dependencies">Adding dependencies +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv add senpy +</code></pre></td></tr></table> +</div> +</div><h3 id="running-commands-inside-the-environment">Running commands inside the environment +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv run <COMMAND> + +# e.g., run a shell using your python version and dependencies +uv run $SHELL +</code></pre></td></tr></table> +</div> +</div><h3 id="dependency-tree">Dependency tree +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv shell +Resolved 44 packages in 1ms +my-project v0.1.0 +├── fastapi[standard] v0.115.8 +│ ├── pydantic v2.10.6 +│ │ ├── annotated-types v0.7.0 +│ │ ├── pydantic-core v2.27.2 +│ │ │ └── typing-extensions v4.12.2 +│ │ └── typing-extensions v4.12.2 +│ ├── starlette v0.45.3 +│ │ └── anyio v4.8.0 +│ │ ├── exceptiongroup v1.2.2 +│ │ ├── idna v3.10 +│ │ ├── sniffio v1.3.1 +│ │ └── typing-extensions v4.12.2 +│ ├── typing-extensions v4.12.2 +│ ├── email-validator v2.2.0 (extra: standard) +│ │ ├── dnspython v2.7.0 +... +</code></pre></td></tr></table> +</div> +</div>Nix Recipe for Python Projectshttps://balkian.com/p/nix-recipe-for-python-projects/Mon, 13 Nov 2023 18:21:46 +0100https://balkian.com/p/nix-recipe-for-python-projects/This is a quick and easy recipe to add a <code>default.nix</code> to any Python project with a <code>requirements.txt</code> file: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-nix" data-lang="nix">with import <nixpkgs> { }; + +let + pythonPackages = python311Packages; +in pkgs.mkShell rec { + name = "impurePythonEnv"; + venvDir = "./.venv"; + buildInputs = [ + # A python interpreter including the 'venv' module is required to bootstrap + # the environment. + pythonPackages.python + + # This execute some shell code to initialize a venv in $venvDir before + # dropping into the shell + pythonPackages.venvShellHook + + # Those are dependencies that we would like to use from nixpkgs, which will + # add them to PYTHONPATH and thus make them accessible from within the venv. + pythonPackages.numpy + pythonPackages.requests + + # In this particular example, in order to compile any binary extensions they may + # require, the python modules listed in the hypothetical requirements.txt need + # the following packages to be installed locally: + taglib + openssl + git + libxml2 + libxslt + libzip + zlib + ]; + + # Now we can execute any commands within the virtual environment. + # This is optional and can be left out to run pip manually. + postShellHook = '' + pip install -r requirements.txt + ''; + +} +</code></pre></td></tr></table> +</div> +</div>Now, you will get a clean environment by running: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">nix-shell +</code></pre></td></tr></table> +</div> +</div>Kanata: advanced keyboard configurationhttps://balkian.com/p/kanata-advanced-keyboard-configuration/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/p/kanata-advanced-keyboard-configuration/<a class="link" href="https://github.com/jtroo/kanata/" target="_blank" rel="noopener" +>Kanata</a> is a software keyboard remapper that aims to improve keyboard comfort and usability with advanced customization. +Keyboard remappers are a good alternative to running a custom keyboard with QMK/ZMK, and have two main advantages: they work on any keyboard, and you can configure them to launch any command or program you want, not just key presses. +On the other hand, you need to configure them on every PC/OS you’re using your keyboard with, and all the processing is done on software on top of the OS, so there may be glitches and performance issues. +The project was inspired by the more popular <a class="link" href="https://github.com/kmonad/kmonad" target="_blank" rel="noopener" +>KMonad</a>, and the author cites some of the <a class="link" href="https://github.com/jtroo/kanata/blob/main/docs/kmonad_comparison.md" target="_blank" rel="noopener" +>differences</a>. +Both projects use a very similar configuration format based on lisp. +The configuration consists of a set of general options, a base key configuration, a series of layers, and macros that can be used within those layers. +<a class="link" href="https://github.com/jtroo/kanata/blob/main/cfg_samples/kanata.kbd" target="_blank" rel="noopener" +>Here’s a very complete config that serves as documentation</a>. +One big disadvantage of the lispy configuration is that you need to specify your hardware layout/all your keys, and repeat that every time you define a new layer. +The result visually maps to your keyboard, but can be very verbose/big if you need really few changes. +<a class="link" href="https://github.com/rvaiya/keyd/" target="_blank" rel="noopener" +>Keyd</a> is another alternative with a more declarative configuration format, which might lend itself to smaller. +For now I’m just trying it out, and getting a feel for using fewer keys before I build my own ZMK keyboard. +I particularly like the option of using mod-keys on the home row (e.g., having A work as a CTRL when held). +Mod-tap, tap-dancing and the like are very common techniques in sub-40% layouts, where there simply aren’t enough keys for all the letters and symbols. +In a regular-sized keyboard, these techniques can also help you stay on the home row and type more comfortably. +At least, that’s the idea. +We’ll see if I like it enough to stick with it. +For now, here’s my very simple config: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(defcfg + ;; Your keyboard device will likely differ from this. + linux-dev /dev/input/by-id/usb-Logitech_USB_Receiver-if02-event-mouse + + ;; Windows doesn't need any input/output configuration entries; however, there + ;; must still be a defcfg entry. You can keep the linux-dev entry or delete + ;; it and leave it empty. +) + +(defsrc + grv 1 2 3 4 5 6 7 8 9 0 - = bspc + tab q w e r t y u i o p [ ] + caps a s d f g h j k l ; ' ret + lsft \ z x c v b n m , . / rsft + lctl lmet lalt spc ralt rmet rctl +) + + +(deflayer qwerty + grv _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ @warrows _ _ _ _ _ _ _ _ _ _ + lctrl @alctrl @slsft @dlalt @flmet _ _ @jrmet @kralt @lrsft @;rctrl _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer arrows + _ _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ @flmet _ left down up rght _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer colemak + grv XX XX XX XX XX XX XX XX XX XX XX XX _ + tab q w f p b j l u y ; [ ] + lctrl @alctrl @rlsft @slalt @tlmet g m @nrmet @eralt @irsft @orctrl ' ret + lsft XX z x c d v k h , . / rsft + XX XX XX @smartspace XX XX XX +) + +(deflayer magic + _ @clmk @qwerty _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ tab A-tab _ _ _ _ bspc esc _ ret _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ +) + +(defalias + warrows (tap-hold 200 200 w (layer-toggle arrows)) + + alctrl (tap-hold 200 200 a lctrl) + slsft (tap-hold 200 200 s lsft) + dlalt (tap-hold 200 200 d lalt) + flmet (tap-hold 200 200 f lmet) + + jrmet (tap-hold 200 200 j rmet) + kralt (tap-hold 200 200 k ralt) + lrsft (tap-hold 200 200 l rsft) + ;rctrl (tap-hold 200 200 ; rctrl) + + rlsft (tap-hold 200 200 r lsft) + slalt (tap-hold 200 200 s lalt) + tlmet (tap-hold 200 200 t lmet) + nrmet (tap-hold 200 200 n rmet) + eralt (tap-hold 200 200 e ralt) + irsft (tap-hold 200 200 i rsft) + orctrl (tap-hold 200 200 o rctrl) + clmk (layer-switch colemak) + qwerty (layer-switch qwerty) + + smartspace (tap-dance 200 ( + (tap-hold 300 300 spc (layer-toggle magic)) + (tap-hold 300 300 (one-shot 300 lalt) spc) + a + )) + + ) +</code></pre></td></tr></table> +</div> +</div>Logitech MB850 combi in linuxhttps://balkian.com/p/logitech-mb850-combi-in-linux/Sat, 30 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mb850-combi-in-linux/As a follow-up to my last post, I’ve decided to also configure my mk850 combo (k850 + m720 triathlon). +Some notes: +<ul> +<li>The keyboard is usually connected to this PC through bluetooth. Since this is a change I usually do in the system for every keyboard, I added a rule for any bus (usb, bluetooth, etc)</li> +<li>The mouse has an additional button that registers as a keyboard. Every press maps to three key events. I’ve disabled two of them and mapped the action to F19, in case I want to use it in my DE/WM.</li> +</ul> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">evdev:input:* + KEYBOARD_KEY_70039=leftctrl # bind capslock to w + +evdev:input:b0005v046DpB015* + KEYBOARD_KEY_700e0=f19 + KEYBOARD_KEY_700e2=unknown + KEYBOARD_KEY_7002b=unknown +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div>Make sure the settings have been applied by running <code>evemu-describe</code>: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"> sudo /sbin/evemu-describe /dev/input/event<id of your device> | grep KEY_ +</code></pre></td></tr></table> +</div> +</div>Logitech MX Keys for Mac on Linuxhttps://balkian.com/p/logitech-mx-keys-for-mac-on-linux/Fri, 29 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mx-keys-for-mac-on-linux/I recently got Logitech MX Keys for Mac keyboard at work. +The German version, to be more precise. +This version was three times cheaper than the Windows equivalent with either US or ES layout. +Since I touch type anyway, I thought it was a bargain. +As soon as I plugged it in, I realized there were some glaring issues with the keyboard. +First of all, the Meta/Super and Alt keys are reversed in this keyboard. +In the normal/full version of this keyboard, Logitech gives an option to choose between Mac, Windows and iOS host, and that changes the behavior of the keys. +In this version, tho, only iOS and Mac are available. +Besides that, there’s the issue of the grave (tilde) and angle keys switched as well. +Switching these keys around would be very easy with Xorg, but Wayland once again complicates things… +These issues almost made me return the keyboard. +Luckily, tho, there is another option: configuring the keys one level lower than wayland (and X11), through hwdb. +Long story short, this will configure any Logitech keyboard with the same product id (0x4092) to use a saner configuration: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">#File: /etc/udev/hwdb.d/90-logitech-keyboard.hwdb + +evdev:input:b0003v046Dp4092* + KEYBOARD_KEY_700e2=leftmeta + KEYBOARD_KEY_700e3=leftalt + KEYBOARD_KEY_70039=leftctrl + KEYBOARD_KEY_70064=102nd + KEYBOARD_KEY_70035=grave + KEYBOARD_KEY_700e7=rightalt + KEYBOARD_KEY_700e6=rightmeta + KEYBOARD_KEY_7006d=compose +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div>Linux on the Microsoft Surface Gohttps://balkian.com/p/linux-on-the-microsoft-surface-go/Sat, 01 Jun 2019 00:00:01 +0000https://balkian.com/p/linux-on-the-microsoft-surface-go/Believe it or not, Surface tablets have pretty good linux support, except for the webcams in newer models. +These are some useful notes to get Ubuntu installed in your surface go, as of Summer 2019. +<h2 id="installing-the-kernel">Installing the kernel +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">git clone --depth 1 https://github.com/jakeday/linux-surface.git ~/linux-surface +cp -a ~/linux-surface /media/<your usb> +</code></pre></td></tr></table> +</div> +</div><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">cp -a /media/<your usb>/linux-surface ~/ +cd ~/linux-surface/ +sudo sh setup.sh +</code></pre></td></tr></table> +</div> +</div><h2 id="booting-ubuntu-first">Booting ubuntu first +</h2>Switch out of Windows S mode. +Boot into the “Command Prompt”. +From Windows go to “change advanced startup options” and select “restart now”. +When it reboots, choose the “Troubleshoot” option, then choose the “Advanced options” option, and finally choose the “Command Prompt” option. +After the device reboots, login to the command prompt and then you should see a terminal with X:\windows\system32> +At the prompt, check your UEFI entries: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /enum firmware +</code></pre></td></tr></table> +</div> +</div>Copy UEFI entry of “Windows Boot Manager” to create a new entry for Ubuntu: bcdedit /copy {bootmgr} /d “Ubuntu” +Copy the printed GUID number including the braces {} using Ctrl+C +Set file path for the new Ubuntu entry. Replace {guid} with the returned GUID of the previous command (Ctrl+V). bcdedit /set {guid} path \EFI\ubuntu\grubx64.efi +Set Ubuntu as the first/ entry in the boot sequence. Again replace {guid} with the returned GUID of the copy command. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /set {fwbootmgr} displayorder {guid} /addfirst +</code></pre></td></tr></table> +</div> +</div>Check your UEFI entries again: bcdedit /enum firmware You should see something like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"> +Firmware Boot Manager +--------------------- +identifier {fwbootmgr} +displayorder {3510232e-f8eb-e811-95ce-9ecab3f9d1c4} + {bootmgr} + {2148799b-f8eb-e811-95ce-9ecab3f9d1c4} + {312e8a67-c2f6-e811-95ce-3c1ab3f9d1de} + {312e8a68-c2f6-e811-95ce-3c1ab3f9d1de} +timeout 0 +</code></pre></td></tr></table> +</div> +</div>Make sure the GUID you copied is the first one listed in displayorder. Then type exit, turn off the PC and turn it back on. After this my surface go is automatically booting to the grub bootloader which lets me choose between Windows and Ubuntu but defaults to Ubuntu after ten seconds.Controlling Zigbee devices with MQTThttps://balkian.com/p/controlling-zigbee-devices-with-mqtt/Sun, 06 Jan 2019 10:00:00 +0000https://balkian.com/p/controlling-zigbee-devices-with-mqtt/This is a short tutorial on connecting a zigbee device (an Aqara cube) +to an MQTT server, so you can control your zigbee devices from the +network. +If you’re anything like me, you’re probably a sucker for IoT devices. +For a long time, I’ve been using WiFi-enabled lights, and Amazon dash +buttons to control them. To keep these (cheap Chinese) internet enabled +devices away from your network and their respective cloud services, +you’ll probably want to set up a dedicated network in your router (more +on this on a future post, maybe). Another disadvantage of WiFi devices +is that they’re relatively power hungry. +A popular alternative is using ZigBee for communication. It is a +dedicated protocol similar to bluetooth (BLE), with lower power +requirements and bitrate. +Take the (super cute) aqara cube as an example. It is a small cube that +detects rotation on all of its axes, and tapping events. Here’s a +video: +<div class="video-wrapper"> +<iframe loading="lazy" +src="https://www.youtube.com/embed/5YtqG1wEnng" +allowfullscreen +title="YouTube Video" +> +</iframe> +</div> +To connect to zigbee devices you will need a zigbee enabled gateway +(a.k.a. hub), which connects to your WiFi network and your zigbee +devices. Once again, this means adding an internet-enabled device to +your home, and probably a couple of cloud services. +As an alternative, you can set up your own zigbee gateway, and control +it to your home automation platform of choice (e.g. home assistant). We +will cover how to set up a zigbee2mqtt gateway that is also connected to +an MQTT server, so you can use MQTT to control your devices and get +notifications. +What you need: +<ul> +<li><a class="link" href="https://www.aliexpress.com/item/Original-Xiaomi-Mi-Aqara-Cube-Smart-Home-Controller-6-Action-Operation-Fr-Home-Device-Zigbee-Version/32892947622.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>Aqara +cube</a>.</li> +<li><a class="link" href="https://www.aliexpress.com/item/Wireless-Zigbee-CC2531-CC2540-Zigbee-Sniffer-Bluetooth-BLE-4-0-Dongle-Capture-Module-USB-Programmer-Downloader/32907587711.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>CC2531 zigbee +sniffer</a>.</li> +<li><a class="link" href="https://www.aliexpress.com/item/CFSUNBIRD-CC-DEBUGGER-Debugger-and-Programmer-for-RF-System-on-Chips-TI-ORIGINAL-Fast-hipping/32813122315.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>CC-debugger</a>.</li> +</ul> +You will need to flash your sniffer. For that, you only need to follow +the instructions from the <a class="link" href="https://koenkk.github.io/zigbee2mqtt/" target="_blank" rel="noopener" +>zigbee2mqtt +documentation</a>. +Once you’re done flashing, you’re ready to set up the zigbee2mqtt +server. For convenience, I wrote a simple docker-compose to deploy a +zigbee2mqtt server and a test mosquitto server: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">version: '2.1' +services: + zigbee2mqtt: + image: koenkk/zigbee2mqtt + container_name: zigbee2mqtt + restart: always + volumes: + - ./z2m-data/:/app/data/ + devices: + - "/dev/ttyACM0" + networks: + - hass + mqtt: + image: eclipse-mosquitto + ports: + - 1883:1883 + - 9001:9001 + networks: + - hass + volumes: + - ./mosquitto.conf:/mosquitto/config/mosquitto.conf +networks: + hass: + driver: overlay +</code></pre></td></tr></table> +</div> +</div>You can test your installation with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">❯ mosquitto_sub -h localhost -p 1883 -t 'zigbee2mqtt/#' +online +{"battery":17,"voltage":2925,"linkquality":149,"action":"rotate_right","angle":12.8} +{"battery":17,"voltage":2925,"linkquality":141,"action":"slide","side":2} +{"battery":17,"voltage":2925,"linkquality":120} +{"battery":17,"voltage":2925,"linkquality":141,"action":"wakeup"}</code></pre></td></tr></table> +</div> +</div> +zigbee2mqtt supports the following events for the aqara cube: shake, +wakeup, fall, tap, slide, flip180, flip90, rotate_left and +rotate_right. Every event has additional information, such as the sides +involved, or the degrees turned. +Now you are ready to set up home assistant support in zigbee2mqtt +following <a class="link" href="https://koenkk.github.io/zigbee2mqtt/integration/home_assistant.html" target="_blank" rel="noopener" +>this +guide</a>.Progress bars in pythonhttps://balkian.com/p/progress-bars-in-python/Wed, 28 Sep 2016 18:47:00 +0000https://balkian.com/p/progress-bars-in-python/<a class="link" href="https://github.com/noamraph/tqdm" target="_blank" rel="noopener" +>tqdm</a> is a nice way to add progress +bars in the command line or in a jupyter notebook. +<img src="https://camo.githubusercontent.com/48838faaa8d00ea297f18e5bf55d3c6bb4e0ba6b/68747470733a2f2f692e696d6775722e636f6d2f686539417735432e676966" +loading="lazy" +alt="image" +> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from tqdm import tqdm +import time + +for i in tqdm(range(100)): + time.sleep(1) +</code></pre></td></tr></table> +</div> +</div>Sharing dotfileshttps://balkian.com/p/sharing-dotfiles/Fri, 10 Apr 2015 17:47:00 +0000https://balkian.com/p/sharing-dotfiles/Today’s post is half a quick note, half public shaming. In other words, +it is a reminder to be very careful with OAuth tokens and passwords. +As part of moving to emacs, I starting using the incredibly useful +<a class="link" href="https://github.com/defunkt/gist.el" target="_blank" rel="noopener" +>gh.el</a>. When you first use it, the +extension saves either your password or an OAuth token in your +.gitconfig file. This is cool and convenient, unless you <a class="link" href="https://github.com/balkian/dotfiles" target="_blank" rel="noopener" +>happen to be +publishing your .gitconfig file in a public +repo</a>. +So, how can you still share your gitconfig without sharing your +password/token with the rest of the world? Since Git 1.7.0, you can +<a class="link" href="http://stackoverflow.com/questions/1557183/is-it-possible-to-include-a-file-in-your-gitconfig" target="_blank" rel="noopener" +>include other files in your +gitconfig</a>. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">[include] + path = ~/.gitconfig_secret +</code></pre></td></tr></table> +</div> +</div>And now, in your .gitconfig_secret file, you just have to add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">[github] + user = balkian + token = "< Your secret token >" +</code></pre></td></tr></table> +</div> +</div>Zoterohttps://balkian.com/p/zotero/Tue, 09 Dec 2014 12:12:12 +0000https://balkian.com/p/zotero/<a class="link" href="https://www.zotero.org/" target="_blank" rel="noopener" +>Zotero</a> is an Open Source tool that lets you +organise your bibliography, syncing it with the cloud. Unlike other +alternatives such as <a class="link" href="http://www.mendeley.com" target="_blank" rel="noopener" +>Mendeley</a>, Zotero can +upload the attachments and data to a private cloud via WebDav. +If you use nginx as your web server, know that even though it provides +partial support for webdav, Zotero needs more than that. Hence, you will +need another webdav server, and optionally let nginx proxy to it. This +short post provides the basics to get that set-up working under +Debian/Ubuntu. +<h2 id="setting-up-apache">Setting up Apache +</h2>First we need to install Apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo apt-get install apache2 +</code></pre></td></tr></table> +</div> +</div>Change the head of “/etc/apache2/sites-enabled/000-default” to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><VirtualHost *:880> +</code></pre></td></tr></table> +</div> +</div>Then, create a file /etc/apache2/sites-available/webdav: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache">Alias /dav /home/webdav/dav +<Location /dav> + Dav on + Order Allow,Deny + Allow from all + Dav On + Options +Indexes + AuthType Basic + AuthName DAV + AuthBasicProvider file + AuthUserFile /home/webdav/.htpasswd + Require valid-user +</Location> +</code></pre></td></tr></table> +</div> +</div>Ideally, you want your webdav folders to be private, adding +authentication to them. So you need to create the webdav and zotero +users and add the passwords to an htpasswd file. Even though you could +use a single user, since you will be configuring several clients with +your credentials I encourage you to create the zotero user as well. This +way you can always change the password for zotero without affecting any +other application using webdav. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo adduser webdav +sudo htpasswd -c /home/webdav/.htpasswd webdav +sudo htpasswd /home/webdav/.htpasswd zotero +sudo mkdir -p /home/webdav/dav/zotero +</code></pre></td></tr></table> +</div> +</div>Enable the site and restart apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo a2enmod webdav +sudo a2enmod dav_fs +sudo a2ensite webdav +sudo service apache2 restart +</code></pre></td></tr></table> +</div> +</div>At this point everything should be working at +<a class="link" href="http://" target="_blank" rel="noopener" +>http://</a><your_host>:880/dav/zotero +<h2 id="setting-up-nginx">Setting up NGINX +</h2>After the Apache side is working, we can use nginx as a proxy to get +cleaner URIs. In your desired site/location, add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-nginx" data-lang="nginx">location /dav { + client_max_body_size 20M; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $remote_addr; + proxy_set_header Host $host; + proxy_pass http://127.0.0.1:880; +} +</code></pre></td></tr></table> +</div> +</div>Now just reload nginx: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo service nginx force-reload +</code></pre></td></tr></table> +</div> +</div><h2 id="extras">Extras +</h2><ul> +<li><a class="link" href="http://zoteroreader.com/" target="_blank" rel="noopener" +>Zotero Reader</a> - HTML5 client</li> +<li><a class="link" href="https://github.com/ajlyon/zandy" target="_blank" rel="noopener" +>Zandy</a> - Android Open Source +client</li> +</ul>Proxies with Apache and pythonhttps://balkian.com/p/proxies-with-apache-and-python/Thu, 09 Oct 2014 10:00:00 +0000https://balkian.com/p/proxies-with-apache-and-python/This is a quick note on proxying a local python application (e.g. flask) +to a subdirectory in Apache. This assumes that the file wsgi.py contains +a WSGI application with the name application. Hence, wsgi:application. +<h2 id="gunicorn">Gunicorn +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + ProxyPass http://127.0.0.1:8888/myapp/ + ProxyPassReverse http://127.0.0.1:8888/myapp/ + RequestHeader set SCRIPT_NAME "/myapp/" +</Location> +</code></pre></td></tr></table> +</div> +</div>Important: SCRIPT_NAME and the end of ProxyPass URL MUST BE +THE SAME. Otherwise, Gunicorn will fail miserably. +Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">venv/bin/gunicorn -w 4 -b 127.0.0.1:8888 --log-file - --access-logfile - wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="uwsgi">UWSGI +</h2>This is a very simple configuration. I will try to upload one with more +options for uwsgi (in a .ini file). +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + SetHandler uwsgi_handler + uWSGISocker 127.0.0.1:8888 +</Location> +</code></pre></td></tr></table> +</div> +</div>Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">uwsgi --socket 127.0.0.1:8888 -w wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="extra-supervisor">Extra: Supervisor +</h2>If everything went as expected, you can wrap your command in a +supervisor config file and let it handle the server for you. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini">[unix_http_server] +file=/tmp/myapp.sock ; path to your socket file + +[supervisord] +logfile = %(here)s/logs/supervisor.log +childlogdir = %(here)s/logs/ + +[rpcinterface:supervisor] +supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface + +[supervisorctl] +logfile = %(here)s/logs/supervisorctl.log +serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket + +[program:myapp] +command = venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 --log-file %(here)s/logs/gunicorn.log --access-logfile - wsgi:application +directory = %(here)s +environment = PATH=%(here)s/venv/bin/ +logfile = %(here)s/logs/myapp.log +</code></pre></td></tr></table> +</div> +</div>Publishing on PyPihttps://balkian.com/p/publishing-on-pypi/Sat, 27 Sep 2014 10:00:00 +0000https://balkian.com/p/publishing-on-pypi/Developing a python module and publishing it on Github is cool, but most +of the times you want others to download and use it easily. That is the +role of PyPi, the python package repository. In this post I show you how +to publish your package in less than 10 minutes. +<h2 id="choose-a-fancy-name">Choose a fancy name +</h2>If you haven’t done so yet, take a minute or two to think about this. +To publish on PyPi you need a name for your package that isn’t taken. +What’s more, a catchy and unique name will help people remember your +module and feel more inclined to at least try it. +The package name should hint what your module does, but that’s not +always the case. That’s your call. I personally put uniqueness and +memorability over describing the functionality. +<h2 id="create-a-pypirc-configuration-file">Create a .pypirc configuration file +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[distutils] # this tells distutils what package indexes you can push to +index-servers = + pypi # the live PyPI + pypitest # test PyPI + +[pypi] # authentication details for live PyPI +repository = https://pypi.python.org/pypi +username = { your_username } +password = { your_password } # not necessary + +[pypitest] # authentication details for test PyPI +repository = https://testpypi.python.org/pypi +username = { your_username } +</code></pre></td></tr></table> +</div> +</div>As you can see, you need to register both in the <a class="link" href="https://pypi.python.org/pypi?%3Aaction=register_form" target="_blank" rel="noopener" +>main pypi +repository</a> and +the <a class="link" href="https://testpypi.python.org/pypi?%3Aaction=register_form" target="_blank" rel="noopener" +>testing +server</a>. The +usernames and passwords might be different, that is up to you! +<h2 id="prepare-your-package">Prepare your package +</h2>This should be the structure: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">root-dir/ # Any name you want + setup.py + setup.cfg + LICENSE.txt + README.md + mypackage/ + __init__.py + foo.py + bar.py + baz.py +</code></pre></td></tr></table> +</div> +</div><h3 id="setupcfg">setup.cfg +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[metadata] +description-file = README.md +</code></pre></td></tr></table> +</div> +</div>The markdown README is the de facto standard in Github, but you can +also use rST (reStructuredText), the standard in the python community. +<h3 id="setuppy">setup.py +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from distutils.core import setup + +setup(name = 'mypackage', + packages = ['mypackage'], # this must be the same as the name above + version = '{ version }', + description = '{ description }', + author = '{ name }', + email = '{ email }', + url = 'https://github.com/{user}/{package}', # URL to the github repo + download_url = 'https://github.com/{user}/{repo}/tarball/{version}', + keywords = ['websockets', 'display', 'd3'], # list of keywords that represent your package + classifiers = [], ) +</code></pre></td></tr></table> +</div> +</div>You might notice that the download_url points to a Github URL. We could +host our package anywhere, but Github is a convenient option. To create +the tarball and the zip packages, you only need to tag a tag in your +repository and push it to github: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git tag {version} -m "{ Description of this tag/version}" +git push --tags origin master +</code></pre></td></tr></table> +</div> +</div><h2 id="push-to-the-testingmain-pypi-server">Push to the testing/main pypi server +</h2>It is advisable that you try your package on the test repository and fix +any problems first. The process is simple: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">python setup.py register -r {pypitest/pypi} python setup.py sdist upload -r {pypitest/pypi} +</code></pre></td></tr></table> +</div> +</div>If everything went as expected, you can now install your package through +pip and browse your package’s page. For instance, check my senpy +package: <a class="link" href="https://pypi.python.org/pypi/senpy" target="_blank" rel="noopener" +>https://pypi.python.org/pypi/senpy</a> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">pip install senpy +</code></pre></td></tr></table> +</div> +</div>Updating EuroLoveMaphttps://balkian.com/p/updating-eurolovemap/Thu, 27 Mar 2014 14:00:00 +0000https://balkian.com/p/updating-eurolovemap/As part of the <a class="link" href="http://www.opener-project.org/2013/07/18/opener-hackathon-in-amsterdam/" target="_blank" rel="noopener" +>OpeNER +hackathon</a> +we decided to build a prototype that would allow us to compare how +different countries feel about several topics. We used the OpeNER +pipeline to get the sentiment from a set of newspaper articles we +gathered from media in several languages. Then we aggregated those +articles by category and country (using the source of the article or the +language it was written in), obtaining the “overall feeling” of each +country about each topic. Then, we used some fancy JavaScript to make +sense out of the raw information. +It didn’t go too bad, it turns out <a class="link" href="http://eurosentiment.eu/wp-content/uploads/2013/07/BOLv9qnCIAAJEek.jpg" target="_blank" rel="noopener" +>we +won</a>. +Now, it was time for a face-lift. I used this opportunity to play with +new technologies and improve it: +<ul> +<li>Using Flask, this time using python 3.3 and Bootstrap 3.0</li> +<li>Cool HTML5+JS cards (thanks to +<a class="link" href="http://pastetophone.com" target="_blank" rel="noopener" +>pastetophone</a>)</li> +<li>Automatic generation of fake personal data to test the interface</li> +<li>Obfuscation of personal emails</li> +</ul> +The result can be <a class="link" href="http://eurolovemap.herokuapp.com/" target="_blank" rel="noopener" +>seen here</a>. +<h2 id="publishing-a-python-3-app-on-heroku">Publishing a Python 3 app on Heroku +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">mkvirtualenv -p /usr/bin/python3.3 eurolovemap +</code></pre></td></tr></table> +</div> +</div>Since Heroku uses python 2.7 by default, we have to tell it which +version we want, although it supports python 3.4 as well. I couldn’t +get python 3.4 working using the +<a class="link" href="https://launchpad.net/~fkrull/+archive/deadsnakes" target="_blank" rel="noopener" +>deadsnakes</a> ppa, so +I used python 3.3 instead, which works fine but is not officially +supported. Just create a file named runtime.txt in your project root, +with the python version you want to use: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">python-3.3.1 +</code></pre></td></tr></table> +</div> +</div>Don’t forget to freeze your dependencies so Heroku can install them: +<code>bash pip freze > requirements.txt</code> +<h2 id="publishing-personal-emails">Publishing personal emails +</h2>There are really sophisticated and effective ways to obfuscate personal +emails so that spammers cannot easily grab yours. However, this time I +needed something really simple to hide our emails from the simplest form +of crawlers. Most of the team are in academia somehow, so in the end all +our emails are available in sites like Google Scholar. Anyway, nobody +likes getting spammed so I settled for a custom <a class="link" href="http://en.wikipedia.org/wiki/Caesar_cipher" target="_blank" rel="noopener" +>Caesar +cipher</a>. Please, don’t use +it for any serious application if you are concerned about being spammed. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">def blur_email(email): + return "".join([chr(ord(i)+5) for i in email]) +</code></pre></td></tr></table> +</div> +</div>And this is the client side: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-javascript" data-lang="javascript">window.onload = function(){ + elems = document.getElementsByClassName('profile-email'); + for(var e in elems){ + var blur = elems[e].innerHTML; + var email = ""; + for(var s in blur){ + var a = blur.charCodeAt(s) + email = email+String.fromCharCode(a-5); + } + elems[e].innerHTML = email; + } +} +</code></pre></td></tr></table> +</div> +</div>Unfortunately, this approach does not hide your email from anyone using +<a class="link" href="http://phantomjs.org/" target="_blank" rel="noopener" +>PhantomJS</a>, +<a class="link" href="http://zombie.labnotes.org/" target="_blank" rel="noopener" +>ZombieJS</a> or similar. For that, other +approaches like generating a picture with the address would be +necessary. Nevertheless, it is overkill for a really simple ad-hoc +application with custom formatting and just a bunch of emails that would +easily be grabbed manually. +<h2 id="generation-of-fake-data">Generation of fake data +</h2>To test the contact section of the site, I wanted to populate it with +fake data. <a class="link" href="https://github.com/joke2k/faker" target="_blank" rel="noopener" +>Fake-Factory</a> is an amazing +library that can generate fake data of almost any kind: emails, +association names, acronyms… It even lets you localise the results +(get Spanish names, for instance) and generate factories for certain +classes (à la Django). +But I also wanted pictures, enter <a class="link" href="http://lorempixel.com/" target="_blank" rel="noopener" +>Lorem Pixel</a>. +With its API you can generate pictures of almost any size, for different +topics (e.g. nightlife, people) and with a custom text. You can even use +an index, so it will always show the same picture. +For instance, the picture below is served through Lorem Pixel. +<img src="http://lorempixel.com/400/200/nightlife/" +loading="lazy" +> +By the way, if you only want cat pictures, take a look at +<a class="link" href="http://placekitten.com/" target="_blank" rel="noopener" +>Placekitten</a>. And for NSFW text, there’s the +<a class="link" href="http://slipsum.com/" target="_blank" rel="noopener" +>Samuel L. Jackson Ipsum</a>Remove git files with globbinghttps://balkian.com/p/remove-git-files-with-globbing/Thu, 22 Aug 2013 23:14:00 +0000https://balkian.com/p/remove-git-files-with-globbing/A simple trick. If you want to remove all the ‘.swp’ files from a git +repository, just use: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git rm --cached '**.swp' +</code></pre></td></tr></table> +</div> +</div>Creating my webhttps://balkian.com/p/creating-my-web/Thu, 22 Aug 2013 14:14:22 +0000https://balkian.com/p/creating-my-web/I’ve finally decided to set up a decent personal page. I have settled +for github-pages because I like the idea of keeping my site in a +repository and having someone else host and deploy it for me. The site +will be really simple, mostly static files. Thanks to Github, +<a class="link" href="http://jekyllrb.com" target="_blank" rel="noopener" +>Jekyll</a> will automatically generate static pages +for my posts every time I commit anything new to this repository. +But Jekyll can be used independently, so if I ever choose to host the +site myself, I can do it quite easily. Another thing that I liked about +this approach is that the generated html files can be used in the +future, and I will not need Jekyll to serve it. Jekyll is really simple +and most of the things are written in plain html. That means that +everything could be easily reused if I ever choose to change to another +blogging framework (e.g. pelical). But, for the time being, I like the +fact that Github takes care of the compilation as well, so I can simply +modify or add files through the web interface should I need to. +I hadn’t played with HTML and CSS for a while now, so I also wanted to +use this site as a playground. At some point, I realised I was doing +mostly everything in plain HTML and CSS, and decided to keep it like +that for as long as possible. As of this writing, I haven’t included +any Javascript code in the page. Probably I will use some to add my +<a class="link" href="http://gist.github.com/balkian" target="_blank" rel="noopener" +>gists</a> and +<a class="link" href="http://github.com/balkian" target="_blank" rel="noopener" +>repositories</a>, but we will see about that. +I think the code speaks for itself, so you can check out <a class="link" href="http://github.com/balkian/balkian.github.com" target="_blank" rel="noopener" +>my repository +on Github</a>. You can clone +and deploy it easily like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git clone +https://github.com/balkian/balkian.github.com cd balkian.github.com +jekyll serve -w +</code></pre></td></tr></table> +</div> +</div>I will keep updating this post with information about: +<ul> +<li>Some Jekyll plugins that might be useful</li> +<li>What CSS tricks I learnt</li> +<li>The webfonts I used</li> +<li>The badge on the left side of the page</li> +</ul> \ No newline at end of file diff --git a/post/page/1/index.html b/post/page/1/index.html new file mode 100644 index 0000000..e4423a3 --- /dev/null +++ b/post/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/post/ + \ No newline at end of file diff --git a/post/page/2/index.html b/post/page/2/index.html new file mode 100644 index 0000000..899d892 --- /dev/null +++ b/post/page/2/index.html @@ -0,0 +1,33 @@ +Posts +

Section

15 pages

Posts

Linux on the Microsoft Surface Go

Controlling Zigbee devices with MQTT

Progress bars in python

Sharing dotfiles

Zotero

\ No newline at end of file diff --git a/post/page/3/index.html b/post/page/3/index.html new file mode 100644 index 0000000..3e854eb --- /dev/null +++ b/post/page/3/index.html @@ -0,0 +1,33 @@ +Posts +

Section

15 pages

Posts

Proxies with Apache and python

Publishing on PyPi

Updating EuroLoveMap

Remove git files with globbing

Creating my web

\ No newline at end of file diff --git a/post/scripts/pxe.sh b/post/scripts/pxe.sh new file mode 100644 index 0000000..ea766f8 --- /dev/null +++ b/post/scripts/pxe.sh @@ -0,0 +1,9 @@ +#/bin/bash +USER=j +IFNAME=enp62s0u1u3 +BINARY=test-tftp.bin +ip address flush dev $IFNAME +ip address add 10.1.1.10/24 dev $IFNAME +dnsmasq -i $IFNAME --dhcp-range=10.1.1.50,10.1.1.100 \ + --dhcp-boot=$BINARY \ + --enable-tftp --tftp-root=/home/$USER/Downloads/pxe -d -u $USER -p0 -K --log-dhcp --bootp-dynamic diff --git a/projects/index.html b/projects/index.html new file mode 100644 index 0000000..81de7f9 --- /dev/null +++ b/projects/index.html @@ -0,0 +1,21 @@ +Projects +

Projects

Ongoing Projects

Soil: an agent-based simulator for social networks based on nx-sim and networkx.
Soilent: an efficient scheduler for soil using rust and pyo3.
Senpy: a framework for semantic sentiment and emotion analysis services.

Past Projects

Onyx: an ontology for emotion analysis that includes concepts from W3C’s provenance.
ESP8266 Clock NTP: a simple clock display using arduino, the ESP8266 and NTP (network time protocol).
Shine ESP: control an ws2812b LED strip over the network with an ESP8266.
Bitter: a wrapper and CLI over the (now defunct) Twitter API to researchers to download Twitter data much faster using multiple accounts.
Marl: I updated this ontology, originally created by Adam Westerski, to make it compatible with the W3C’s provenance ontology.
Hermes: one of my first projects, developed together with David Pérez as the special custom assignment in one of our courses. Hermes is an affective bot designed to mimic the behavour of humans. It included a plug-in system for its sensors and actuators. The information from its sensors changed its emotional state, which was shown via its actuators. Among others, it could fetch inforation from Twitter or its host system and change the expressions of an external Face made with servo motors or speak via its Text-To-Speech software. For instance, it could detect it was running out of battery, showing a sad face and sending an alerting tweet. You can see it in action in these two youtube videos: Part 1 and Part 2.
Maia: the Modular Architecture for Intelligent Agents is an evented agent architecture that aims to update the classical frameworks for intelligent agents with the concepts emerged from the Live Web.
EESTEC.net: the Plone based official portal of EESTEC. It has been my first and only experience with Plone. I fixed some bugs and implemented basic features.

For more information, check my list of public repositories in .

\ No newline at end of file diff --git a/python/index.html b/python/index.html new file mode 100644 index 0000000..a7a4e2b --- /dev/null +++ b/python/index.html @@ -0,0 +1,23 @@ +Python +

Programming

Python

Tips and useful libraries for python developers

Interesting libraries

TQDM

From tqdm’s github repository:

tqdm means “progress” in Arabic (taqadum, تقدّم) and an abbreviation for “I love you so much” in Spanish (te quiero demasiado).

TQDM in action

Tools

uv

🚀 A single tool to replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +⚡️ 10-100x faster than pip.

Provides comprehensive project management, with a universal lockfile.
Runs scripts, with support for inline dependency metadata.
Installs and manages Python versions.
Runs and installs tools published as Python packages.
Includes a pip-compatible interface for a performance boost with a familiar CLI.
Supports Cargo-style workspaces for scalable projects.
Disk-space efficient, with a global cache for dependency deduplication.
Installable without Rust or Python via curl or pip.
Supports macOS, Linux, and Windows.

\ No newline at end of file diff --git a/raspberry-pi/index.html b/raspberry-pi/index.html new file mode 100644 index 0000000..62cb708 --- /dev/null +++ b/raspberry-pi/index.html @@ -0,0 +1,33 @@ +Raspberry Pi +

Raspberry Pi

Tools, links and configuration for your Raspberry Pi

HDMI flickering

Avoid HDMI flickering/intermittent blanking on RPI with a 1400x1050 VGA monitor.

1
+2
+3
+4
+5
+6
+
+   hdmi_drive=2
+   hdmi_group=2
+   hdmi_mode=42
+   disable_overscan=1
+   config_hdmi_boost=7
+

\ No newline at end of file diff --git a/scss/style.min.663803bebe609202d5b39d848f2d7c2dc8b598a2d879efa079fa88893d29c49c.css b/scss/style.min.663803bebe609202d5b39d848f2d7c2dc8b598a2d879efa079fa88893d29c49c.css new file mode 100644 index 0000000..9b90269 --- /dev/null +++ b/scss/style.min.663803bebe609202d5b39d848f2d7c2dc8b598a2d879efa079fa88893d29c49c.css @@ -0,0 +1,10 @@ +/*!* Hugo Theme Stack +* +* @author: Jimmy Cai +* @website: https://jimmycai.com +* @link: https://github.com/CaiJimmy/hugo-theme-stack*/:root{--main-top-padding:35px;--body-background:#f5f5fa;--accent-color:#34495e;--accent-color-darker:#2c3e50;--accent-color-text:#fff;--body-text-color:#707070;--tag-border-radius:4px;--section-separation:40px;--scrollbar-thumb:hsl(0, 0%, 85%);--scrollbar-track:var(--body-background)}@media(min-width:1280px){:root{--main-top-padding:50px}}:root[data-scheme=dark]{--body-background:#303030;--accent-color:#ecf0f1;--accent-color-darker:#bdc3c7;--accent-color-text:#000;--body-text-color:rgba(255, 255, 255, 0.7);--scrollbar-thumb:hsl(0, 0%, 40%);--scrollbar-track:var(--body-background)}:root{--sys-font-family:-apple-system, BlinkMacSystemFont, "Segoe UI", "Droid Sans", "Helvetica Neue";--zh-font-family:"PingFang SC", "Hiragino Sans GB", "Droid Sans Fallback", "Microsoft YaHei";--base-font-family:"Lato", var(--sys-font-family), var(--zh-font-family), sans-serif;--code-font-family:Menlo, Monaco, Consolas, "Courier New", var(--zh-font-family), monospace}:root{--card-background:#fff;--card-background-selected:#eaeaea;--card-text-color-main:#000;--card-text-color-secondary:#747474;--card-text-color-tertiary:#767676;--card-separator-color:rgba(218, 218, 218, 0.5);--card-border-radius:10px;--card-padding:20px;--small-card-padding:25px 20px}@media(min-width:768px){:root{--card-padding:25px}}@media(min-width:1280px){:root{--card-padding:30px}}@media(min-width:768px){:root{--small-card-padding:25px}}:root[data-scheme=dark]{--card-background:#424242;--card-background-selected:rgba(255, 255, 255, 0.16);--card-text-color-main:rgba(255, 255, 255, 0.9);--card-text-color-secondary:rgba(255, 255, 255, 0.7);--card-text-color-tertiary:rgba(255, 255, 255, 0.5);--card-separator-color:rgba(255, 255, 255, 0.12)}:root{--article-font-family:var(--base-font-family);--article-font-size:1.6rem;--article-line-height:1.85}@media(min-width:768px){:root{--article-font-size:1.7rem}}:root{--blockquote-border-size:4px;--blockquote-background-color:rgb(248 248 248);--heading-border-size:4px;--link-background-color:189, 195, 199;--link-background-opacity:0.5;--link-background-opacity-hover:0.7;--pre-background-color:#272822;--pre-text-color:#f8f8f2;--code-background-color:rgba(0, 0, 0, 0.12);--code-text-color:#808080;--table-border-color:#dadada;--tr-even-background-color:#efefee;--kbd-border-color:#dadada}:root[data-scheme=dark]{--code-background-color:#272822;--code-text-color:rgba(255, 255, 255, 0.9);--table-border-color:#717171;--tr-even-background-color:#545454;--blockquote-background-color:rgb(75 75 75)}:root{--shadow-l1:0px 4px 8px rgba(0, 0, 0, 0.04), 0px 0px 2px rgba(0, 0, 0, 0.06), 0px 0px 1px rgba(0, 0, 0, 0.04);--shadow-l2:0px 10px 20px rgba(0, 0, 0, 0.04), 0px 2px 6px rgba(0, 0, 0, 0.04), 0px 0px 1px rgba(0, 0, 0, 0.04);--shadow-l3:0px 10px 20px rgba(0, 0, 0, 0.04), 0px 2px 6px rgba(0, 0, 0, 0.04), 0px 0px 1px rgba(0, 0, 0, 0.04);--shadow-l4:0px 24px 32px rgba(0, 0, 0, 0.04), 0px 16px 24px rgba(0, 0, 0, 0.04), 0px 4px 8px rgba(0, 0, 0, 0.04), + 0px 0px 1px rgba(0, 0, 0, 0.04)}[data-scheme=light]{--pre-text-color:#272822;--pre-background-color:#fafafa}[data-scheme=light] .chroma{color:#272822;background-color:#fafafa}[data-scheme=light] .chroma .err{color:#960050}[data-scheme=light] .chroma .lntd{vertical-align:top;padding:0;margin:0;border:0}[data-scheme=light] .chroma .lntable{border-spacing:0;padding:0;margin:0;border:0;width:100%;display:block}[data-scheme=light] .chroma .lntable>tbody{display:block;width:100%}[data-scheme=light] .chroma .lntable>tbody>tr{display:flex;width:100%}[data-scheme=light] .chroma .lntable>tbody>tr>td:last-child{overflow-x:auto}[data-scheme=light] .chroma .hl{display:block;width:100%;background-color:#ffc}[data-scheme=light] .chroma .lnt{margin-right:.4em;padding:0 .4em;color:#7f7f7f;display:block}[data-scheme=light] .chroma .ln{margin-right:.4em;padding:0 .4em;color:#7f7f7f}[data-scheme=light] .chroma .k{color:#00a8c8}[data-scheme=light] .chroma .kc{color:#00a8c8}[data-scheme=light] .chroma .kd{color:#00a8c8}[data-scheme=light] .chroma .kn{color:#f92672}[data-scheme=light] .chroma .kp{color:#00a8c8}[data-scheme=light] .chroma .kr{color:#00a8c8}[data-scheme=light] .chroma .kt{color:#00a8c8}[data-scheme=light] .chroma .n{color:#111}[data-scheme=light] .chroma .na{color:#75af00}[data-scheme=light] .chroma .nb{color:#111}[data-scheme=light] .chroma .bp{color:#111}[data-scheme=light] .chroma .nc{color:#75af00}[data-scheme=light] .chroma .no{color:#00a8c8}[data-scheme=light] .chroma .nd{color:#75af00}[data-scheme=light] .chroma .ni{color:#111}[data-scheme=light] .chroma .ne{color:#75af00}[data-scheme=light] .chroma .nf{color:#75af00}[data-scheme=light] .chroma .fm{color:#111}[data-scheme=light] .chroma .nl{color:#111}[data-scheme=light] .chroma .nn{color:#111}[data-scheme=light] .chroma .nx{color:#75af00}[data-scheme=light] .chroma .py{color:#111}[data-scheme=light] .chroma .nt{color:#f92672}[data-scheme=light] .chroma .nv{color:#111}[data-scheme=light] .chroma .vc{color:#111}[data-scheme=light] .chroma .vg{color:#111}[data-scheme=light] .chroma .vi{color:#111}[data-scheme=light] .chroma .vm{color:#111}[data-scheme=light] .chroma .l{color:#ae81ff}[data-scheme=light] .chroma .ld{color:#d88200}[data-scheme=light] .chroma .s{color:#d88200}[data-scheme=light] .chroma .sa{color:#d88200}[data-scheme=light] .chroma .sb{color:#d88200}[data-scheme=light] .chroma .sc{color:#d88200}[data-scheme=light] .chroma .dl{color:#d88200}[data-scheme=light] .chroma .sd{color:#d88200}[data-scheme=light] .chroma .s2{color:#d88200}[data-scheme=light] .chroma .se{color:#ae81ff}[data-scheme=light] .chroma .sh{color:#d88200}[data-scheme=light] .chroma .si{color:#d88200}[data-scheme=light] .chroma .sx{color:#d88200}[data-scheme=light] .chroma .sr{color:#d88200}[data-scheme=light] .chroma .s1{color:#d88200}[data-scheme=light] .chroma .ss{color:#d88200}[data-scheme=light] .chroma .m{color:#ae81ff}[data-scheme=light] .chroma .mb{color:#ae81ff}[data-scheme=light] .chroma .mf{color:#ae81ff}[data-scheme=light] .chroma .mh{color:#ae81ff}[data-scheme=light] .chroma .mi{color:#ae81ff}[data-scheme=light] .chroma .il{color:#ae81ff}[data-scheme=light] .chroma .mo{color:#ae81ff}[data-scheme=light] .chroma .o{color:#f92672}[data-scheme=light] .chroma .ow{color:#f92672}[data-scheme=light] .chroma .p{color:#111}[data-scheme=light] .chroma .c{color:#75715e}[data-scheme=light] .chroma .ch{color:#75715e}[data-scheme=light] .chroma .cm{color:#75715e}[data-scheme=light] .chroma .c1{color:#75715e}[data-scheme=light] .chroma .cs{color:#75715e}[data-scheme=light] .chroma .cp{color:#75715e}[data-scheme=light] .chroma .cpf{color:#75715e}[data-scheme=light] .chroma .gd{color:#f92672}[data-scheme=light] .chroma .ge{font-style:italic}[data-scheme=light] .chroma .gi{color:#75af00}[data-scheme=light] .chroma .gs{font-weight:700}[data-scheme=light] .chroma .gu{color:#75715e}[data-scheme=dark]{--pre-text-color:#f8f8f2;--pre-background-color:#272822}[data-scheme=dark] .chroma{color:#f8f8f2;background-color:#272822}[data-scheme=dark] .chroma .err{color:#bb0064}[data-scheme=dark] .chroma .lntd{vertical-align:top;padding:0;margin:0;border:0}[data-scheme=dark] .chroma .lntable{border-spacing:0;padding:0;margin:0;border:0;width:100%;display:block}[data-scheme=dark] .chroma .lntable>tbody{display:block;width:100%}[data-scheme=dark] .chroma .lntable>tbody>tr{display:flex;width:100%}[data-scheme=dark] .chroma .lntable>tbody>tr>td:last-child{overflow-x:auto}[data-scheme=dark] .chroma .hl{display:block;width:100%;background-color:#ffc}[data-scheme=dark] .chroma .lnt{margin-right:.4em;padding:0 .4em;color:#7f7f7f;display:block}[data-scheme=dark] .chroma .ln{margin-right:.4em;padding:0 .4em;color:#7f7f7f}[data-scheme=dark] .chroma .k{color:#66d9ef}[data-scheme=dark] .chroma .kc{color:#66d9ef}[data-scheme=dark] .chroma .kd{color:#66d9ef}[data-scheme=dark] .chroma .kn{color:#f92672}[data-scheme=dark] .chroma .kp{color:#66d9ef}[data-scheme=dark] .chroma .kr{color:#66d9ef}[data-scheme=dark] .chroma .kt{color:#66d9ef}[data-scheme=dark] .chroma .n{color:#f8f8f2}[data-scheme=dark] .chroma .na{color:#a6e22e}[data-scheme=dark] .chroma .nb{color:#f8f8f2}[data-scheme=dark] .chroma .bp{color:#f8f8f2}[data-scheme=dark] .chroma .nc{color:#a6e22e}[data-scheme=dark] .chroma .no{color:#66d9ef}[data-scheme=dark] .chroma .nd{color:#a6e22e}[data-scheme=dark] .chroma .ni{color:#f8f8f2}[data-scheme=dark] .chroma .ne{color:#a6e22e}[data-scheme=dark] .chroma .nf{color:#a6e22e}[data-scheme=dark] .chroma .fm{color:#f8f8f2}[data-scheme=dark] .chroma .nl{color:#f8f8f2}[data-scheme=dark] .chroma .nn{color:#f8f8f2}[data-scheme=dark] .chroma .nx{color:#a6e22e}[data-scheme=dark] .chroma .py{color:#f8f8f2}[data-scheme=dark] .chroma .nt{color:#f92672}[data-scheme=dark] .chroma .nv{color:#f8f8f2}[data-scheme=dark] .chroma .vc{color:#f8f8f2}[data-scheme=dark] .chroma .vg{color:#f8f8f2}[data-scheme=dark] .chroma .vi{color:#f8f8f2}[data-scheme=dark] .chroma .vm{color:#f8f8f2}[data-scheme=dark] .chroma .l{color:#ae81ff}[data-scheme=dark] .chroma .ld{color:#e6db74}[data-scheme=dark] .chroma .s{color:#e6db74}[data-scheme=dark] .chroma .sa{color:#e6db74}[data-scheme=dark] .chroma .sb{color:#e6db74}[data-scheme=dark] .chroma .sc{color:#e6db74}[data-scheme=dark] .chroma .dl{color:#e6db74}[data-scheme=dark] .chroma .sd{color:#e6db74}[data-scheme=dark] .chroma .s2{color:#e6db74}[data-scheme=dark] .chroma .se{color:#ae81ff}[data-scheme=dark] .chroma .sh{color:#e6db74}[data-scheme=dark] .chroma .si{color:#e6db74}[data-scheme=dark] .chroma .sx{color:#e6db74}[data-scheme=dark] .chroma .sr{color:#e6db74}[data-scheme=dark] .chroma .s1{color:#e6db74}[data-scheme=dark] .chroma .ss{color:#e6db74}[data-scheme=dark] .chroma .m{color:#ae81ff}[data-scheme=dark] .chroma .mb{color:#ae81ff}[data-scheme=dark] .chroma .mf{color:#ae81ff}[data-scheme=dark] .chroma .mh{color:#ae81ff}[data-scheme=dark] .chroma .mi{color:#ae81ff}[data-scheme=dark] .chroma .il{color:#ae81ff}[data-scheme=dark] .chroma .mo{color:#ae81ff}[data-scheme=dark] .chroma .o{color:#f92672}[data-scheme=dark] .chroma .ow{color:#f92672}[data-scheme=dark] .chroma .p{color:#f8f8f2}[data-scheme=dark] .chroma .c{color:#75715e}[data-scheme=dark] .chroma .ch{color:#75715e}[data-scheme=dark] .chroma .cm{color:#75715e}[data-scheme=dark] .chroma .c1{color:#75715e}[data-scheme=dark] .chroma .cs{color:#75715e}[data-scheme=dark] .chroma .cp{color:#75715e}[data-scheme=dark] .chroma .cpf{color:#75715e}[data-scheme=dark] .chroma .gd{color:#f92672}[data-scheme=dark] .chroma .ge{font-style:italic}[data-scheme=dark] .chroma .gi{color:#a6e22e}[data-scheme=dark] .chroma .gs{font-weight:700}[data-scheme=dark] .chroma .gu{color:#75715e}:root{--menu-icon-separation:40px;--container-padding:15px;--widget-separation:var(--section-separation)}.container{margin-left:auto;margin-right:auto}.container .left-sidebar{order:-3;max-width:var(--left-sidebar-max-width)}.container .right-sidebar{order:-1;max-width:var(--right-sidebar-max-width)}@media(min-width:1024px){.container .right-sidebar{display:flex}}@media(min-width:768px){.container.extended{max-width:1024px;--left-sidebar-max-width:25%;--right-sidebar-max-width:30%}}@media(min-width:1024px){.container.extended{max-width:1280px;--left-sidebar-max-width:20%;--right-sidebar-max-width:30%}}@media(min-width:1280px){.container.extended{max-width:1536px;--left-sidebar-max-width:15%;--right-sidebar-max-width:25%}}@media(min-width:768px){.container.compact{--left-sidebar-max-width:25%;max-width:768px}}@media(min-width:1024px){.container.compact{max-width:1024px;--left-sidebar-max-width:20%}}@media(min-width:1280px){.container.compact{max-width:1280px}}.flex{display:flex;flex-direction:row}.flex.column{flex-direction:column}.flex.on-phone--column{flex-direction:column}@media(min-width:768px){.flex.on-phone--column{flex-direction:unset}}.flex .full-width{width:100%}main.main{order:-2;min-width:0;max-width:100%;flex-grow:1;display:flex;flex-direction:column;gap:var(--section-separation)}@media(min-width:768px){main.main{padding-top:var(--main-top-padding)}}.main-container{min-height:100vh;align-items:flex-start;padding:0 15px;gap:var(--section-separation);padding-top:var(--main-top-padding)}@media(min-width:768px){.main-container{padding:0 20px}}/*!normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css*/html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{-webkit-appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}/*!* Hamburgers +* @description Tasty CSS-animated hamburgers +* @author Jonathan Suh @jonsuh +* @site https://jonsuh.com/hamburgers +* @link https://github.com/jonsuh/hamburgers*/.hamburger{padding-top:10px;display:inline-block;cursor:pointer;transition-property:opacity,filter;transition-duration:.15s;transition-timing-function:linear;font:inherit;color:inherit;text-transform:none;background-color:transparent;border:0;margin:0;overflow:visible}.hamburger:hover{opacity:.7}.hamburger.is-active:hover{opacity:.7}.hamburger.is-active .hamburger-inner,.hamburger.is-active .hamburger-inner::before,.hamburger.is-active .hamburger-inner::after{background-color:#000}.hamburger-box{width:30px;height:24px;display:inline-block;position:relative}.hamburger-inner{display:block;top:50%;margin-top:-2px}.hamburger-inner,.hamburger-inner::before,.hamburger-inner::after{width:30px;height:2px;background-color:var(--card-text-color-main);border-radius:4px;position:absolute;transition-property:transform;transition-duration:.15s;transition-timing-function:ease}.hamburger-inner::before,.hamburger-inner::after{content:"";display:block}.hamburger-inner::before{top:-10px}.hamburger-inner::after{bottom:-10px}.hamburger--spin .hamburger-inner{transition-duration:.22s;transition-timing-function:cubic-bezier(.55,.055,.675,.19)}.hamburger--spin .hamburger-inner::before{transition:top .1s .25s ease-in,opacity .1s ease-in}.hamburger--spin .hamburger-inner::after{transition:bottom .1s .25s ease-in,transform .22s cubic-bezier(.55,.055,.675,.19)}.hamburger--spin.is-active .hamburger-inner{transform:rotate(225deg);transition-delay:.12s;transition-timing-function:cubic-bezier(.215,.61,.355,1)}.hamburger--spin.is-active .hamburger-inner::before{top:0;opacity:0;transition:top .1s ease-out,opacity .1s .12s ease-out}.hamburger--spin.is-active .hamburger-inner::after{bottom:0;transform:rotate(-90deg);transition:bottom .1s ease-out,transform .22s .12s cubic-bezier(.215,.61,.355,1)}#toggle-menu{background:0 0;border:none;position:absolute;right:0;top:0;z-index:2;cursor:pointer;outline:none}[dir=rtl] #toggle-menu{left:0;right:auto}@media(min-width:768px){#toggle-menu{display:none}}#toggle-menu.is-active .hamburger-inner,#toggle-menu.is-active .hamburger-inner::before,#toggle-menu.is-active .hamburger-inner::after{background-color:var(--accent-color)}#main-menu{list-style:none;overflow-y:auto;flex-grow:1;font-size:1.4rem;background-color:var(--card-background);box-shadow:var(--shadow-l1);display:none;margin:0 calc(var(--container-padding) * -1);padding:30px}@media(min-width:1280px){#main-menu{padding:15px 0}}#main-menu,#main-menu .menu-bottom-section ol{flex-direction:column;gap:30px}@media(min-width:1280px){#main-menu,#main-menu .menu-bottom-section ol{gap:25px}}#main-menu.show{display:flex}@media(min-width:768px){#main-menu{align-items:flex-end;display:flex;background-color:transparent;padding:0;box-shadow:none;margin:0}}#main-menu li{position:relative;vertical-align:middle;padding:0}@media(min-width:768px){#main-menu li{width:100%}}#main-menu li svg{stroke:currentColor;stroke-width:1.33;width:20px;height:20px}#main-menu li a{height:100%;display:inline-flex;align-items:center;color:var(--body-text-color);gap:var(--menu-icon-separation)}#main-menu li span{flex:1}#main-menu li.current a{color:var(--accent-color);font-weight:700}#main-menu li.menu-bottom-section{margin-top:auto}#main-menu li.menu-bottom-section ol{display:flex;padding-left:0}.menu-social{list-style:none;padding:0;margin:0;display:flex;flex-direction:row;gap:10px}.menu-social svg{width:24px;height:24px;stroke:var(--body-text-color);stroke-width:1.33}.article-list{display:flex;flex-direction:column;gap:var(--section-separation)}.article-list article{display:flex;flex-direction:column;background-color:var(--card-background);box-shadow:var(--shadow-l1);border-radius:var(--card-border-radius);overflow:hidden;transition:box-shadow .3s ease}.article-list article:hover{box-shadow:var(--shadow-l2)}.article-list article .article-image img{width:100%;height:150px;object-fit:cover}@media(min-width:768px){.article-list article .article-image img{height:200px}}@media(min-width:1280px){.article-list article .article-image img{height:250px}}.article-list article:nth-child(5n+1) .article-category a{background:#8ea885;color:#fff}.article-list article:nth-child(5n+2) .article-category a{background:#df7988;color:#fff}.article-list article:nth-child(5n+3) .article-category a{background:#0177b8;color:#fff}.article-list article:nth-child(5n+4) .article-category a{background:#ffb900;color:#fff}.article-list article:nth-child(5n+5) .article-category a{background:#6b69d6;color:#fff}.article-details{display:flex;flex-direction:column;justify-content:center;padding:var(--card-padding);gap:15px}.article-title{font-family:var(--article-font-family);font-weight:600;margin:0;color:var(--card-text-color-main);font-size:2.2rem}@media(min-width:1280px){.article-title{font-size:2.4rem}}.article-title a{color:var(--card-text-color-main)}.article-title a:hover{color:var(--card-text-color-main)}.article-subtitle{font-weight:400;color:var(--card-text-color-secondary);line-height:1.5;margin:0;font-size:1.75rem}@media(min-width:1280px){.article-subtitle{font-size:2rem}}.article-title-wrapper{display:flex;flex-direction:column;gap:8px}.article-time,.article-translations{display:flex;color:var(--card-text-color-tertiary);gap:15px}.article-time svg,.article-translations svg{vertical-align:middle;width:20px;height:20px;stroke-width:1.33;flex-shrink:0}.article-time time,.article-time a,.article-translations time,.article-translations a{font-size:1.4rem;color:var(--card-text-color-tertiary)}.article-time>div,.article-translations>div{display:inline-flex;align-items:center;gap:15px}.article-time{flex-wrap:wrap}.article-translations>div{flex-wrap:wrap}.article-category,.article-tags{display:flex;gap:10px;flex-wrap:wrap}.article-category a,.article-tags a{color:var(--accent-color-text);background-color:var(--accent-color);padding:8px 16px;border-radius:var(--tag-border-radius);display:inline-block;font-size:1.4rem;transition:background-color .5s ease}.article-category a:hover,.article-tags a:hover{color:var(--accent-color-text);background-color:var(--accent-color-darker)}.article-list--compact{border-radius:var(--card-border-radius);box-shadow:var(--shadow-l1);background-color:var(--card-background);--image-size:50px}@media(min-width:768px){.article-list--compact{--image-size:60px}}.article-list--compact article>a{display:flex;align-items:center;padding:var(--small-card-padding);gap:15px}.article-list--compact article:not(:last-of-type){border-bottom:1.5px solid var(--card-separator-color)}.article-list--compact article .article-details{flex-grow:1;padding:0;min-height:var(--image-size);gap:10px}.article-list--compact article .article-title{margin:0;font-size:1.6rem}@media(min-width:768px){.article-list--compact article .article-title{font-size:1.8rem}}.article-list--compact article .article-image img{width:var(--image-size);height:var(--image-size);object-fit:cover}.article-list--compact article .article-time{font-size:1.4rem}.article-list--compact article .article-preview{font-size:1.4rem;color:var(--card-text-color-tertiary);margin-top:10px;line-height:1.5}.article-list--tile article{border-radius:var(--card-border-radius);overflow:hidden;position:relative;height:350px;width:250px;box-shadow:var(--shadow-l1);transition:box-shadow .3s ease;background-color:var(--card-background)}.article-list--tile article:hover{box-shadow:var(--shadow-l2)}.article-list--tile article.has-image .article-details{background-color:rgba(0,0,0,.25)}.article-list--tile article.has-image .article-title{color:#fff}.article-list--tile article .article-image{position:absolute;top:0;left:0;width:100%;height:100%}.article-list--tile article .article-image img{width:100%;height:100%;object-fit:cover}.article-list--tile article .article-details{border-radius:var(--card-border-radius);position:relative;height:100%;width:100%;display:flex;flex-direction:column;justify-content:flex-end;z-index:2;padding:15px}@media(min-width:640px){.article-list--tile article .article-details{padding:20px}}.article-list--tile article .article-title{font-size:2rem;font-weight:500;color:var(--card-text-color-main)}@media(min-width:640px){.article-list--tile article .article-title{font-size:2.2rem}}.widget{display:flex;flex-direction:column}.widget .widget-icon svg{width:32px;height:32px;stroke-width:1.6;color:var(--body-text-color)}.tagCloud .tagCloud-tags{display:flex;flex-wrap:wrap;gap:10px}.tagCloud .tagCloud-tags a{background:var(--card-background);box-shadow:var(--shadow-l1);border-radius:var(--tag-border-radius);padding:8px 20px;color:var(--card-text-color-main);font-size:1.4rem;transition:box-shadow .3s ease}.tagCloud .tagCloud-tags a:hover{box-shadow:var(--shadow-l2)}.widget.archives .widget-archive--list{border-radius:var(--card-border-radius);box-shadow:var(--shadow-l1);background-color:var(--card-background)}.widget.archives .archives-year:not(:last-of-type){border-bottom:1.5px solid var(--card-separator-color)}.widget.archives .archives-year a{font-size:1.4rem;padding:18px 25px;display:flex}.widget.archives .archives-year a span.year{flex:1;color:var(--card-text-color-main);font-weight:700}.widget.archives .archives-year a span.count{color:var(--card-text-color-tertiary)}footer.site-footer{padding:20px 0 var(--section-separation);font-size:1.4rem;line-height:1.75}footer.site-footer:before{content:"";display:block;height:3px;width:50px;background:var(--body-text-color);margin-bottom:20px}footer.site-footer .copyright{color:var(--accent-color);font-weight:700;margin-bottom:5px}footer.site-footer .powerby{color:var(--body-text-color);font-weight:400;font-size:1.2rem}footer.site-footer .powerby a{color:var(--body-text-color)}.pagination{display:flex;background-color:var(--card-background);box-shadow:var(--shadow-l1);border-radius:var(--card-border-radius);overflow:hidden;flex-wrap:wrap}.pagination .page-link{padding:16px 32px;display:inline-flex;color:var(--card-text-color-secondary)}.pagination .page-link.current{font-weight:700;background-color:var(--card-background-selected);color:var(--card-text-color-main)}@media(min-width:768px){.sidebar.sticky{position:sticky}}.left-sidebar{display:flex;flex-direction:column;flex-shrink:0;align-self:stretch;gap:var(--sidebar-element-separation);max-width:none;width:100%;position:relative;--sidebar-avatar-size:100px;--sidebar-element-separation:20px;--emoji-size:40px;--emoji-font-size:20px}@media(min-width:768px){.left-sidebar{width:auto;padding-top:var(--main-top-padding);padding-bottom:var(--main-top-padding);max-height:100vh}}@media(min-width:1536px){.left-sidebar{--sidebar-avatar-size:120px;--sidebar-element-separation:25px;--emoji-size:40px}}.left-sidebar.sticky{top:0}.left-sidebar.compact{--sidebar-avatar-size:80px;--emoji-size:30px;--emoji-font-size:15px}@media(min-width:1024px){.left-sidebar.compact header{flex-direction:row}}.left-sidebar.compact header .site-meta{gap:5px}.left-sidebar.compact header .site-name{font-size:1.4rem}@media(min-width:1536px){.left-sidebar.compact header .site-name{font-size:1.75rem}}.left-sidebar.compact header .site-description{font-size:1.4rem}.right-sidebar{width:100%;display:none;flex-direction:column;gap:var(--widget-separation)}.right-sidebar.sticky{top:0}@media(min-width:1024px){.right-sidebar{padding-top:var(--main-top-padding);padding-bottom:var(--main-top-padding)}}.sidebar header{z-index:1;transition:box-shadow .5s ease;display:flex;flex-direction:column;gap:var(--sidebar-element-separation)}@media(min-width:768px){.sidebar header{padding:0}}.sidebar header .site-avatar{position:relative;margin:0;width:var(--sidebar-avatar-size);height:var(--sidebar-avatar-size);flex-shrink:0}.sidebar header .site-avatar .site-logo{width:100%;height:100%;border-radius:100%;box-shadow:var(--shadow-l1)}.sidebar header .site-avatar .emoji{position:absolute;width:var(--emoji-size);height:var(--emoji-size);line-height:var(--emoji-size);border-radius:100%;bottom:0;right:0;text-align:center;font-size:var(--emoji-font-size);background-color:var(--card-background);box-shadow:var(--shadow-l2)}.sidebar header .site-meta{display:flex;flex-direction:column;gap:10px;justify-content:center}.sidebar header .site-name{color:var(--accent-color);margin:0;font-size:1.6rem}@media(min-width:1536px){.sidebar header .site-name{font-size:1.8rem}}.sidebar header .site-description{color:var(--body-text-color);font-weight:400;margin:0;font-size:1.4rem}@media(min-width:1536px){.sidebar header .site-description{font-size:1.6rem}}[data-scheme=dark] #dark-mode-toggle{color:var(--accent-color);font-weight:700}[data-scheme=dark] #dark-mode-toggle .icon-tabler-toggle-left{display:none}[data-scheme=dark] #dark-mode-toggle .icon-tabler-toggle-right{display:unset}#dark-mode-toggle{margin-top:auto;color:var(--body-text-color);display:flex;align-items:center;cursor:pointer;gap:var(--menu-icon-separation)}#dark-mode-toggle .icon-tabler-toggle-right{display:none}#i18n-switch{color:var(--body-text-color);display:inline-flex;align-content:center;gap:var(--menu-icon-separation)}#i18n-switch select{border:0;background-color:transparent;color:var(--body-text-color)}#i18n-switch select option{color:var(--card-text-color-main);background-color:var(--card-background)}html{font-size:62.5%;overflow-y:scroll}*{box-sizing:border-box}body{background:var(--body-background);margin:0;font-family:var(--base-font-family);font-size:1.6rem;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}*{scrollbar-width:auto;scrollbar-color:var(--scrollbar-thumb)transparent}::-webkit-scrollbar{height:auto}::-webkit-scrollbar-thumb{background-color:var(--scrollbar-thumb)}::-webkit-scrollbar-track{background-color:transparent}.article-page.hide-sidebar-sm .left-sidebar{display:none}@media(min-width:768px){.article-page.hide-sidebar-sm .left-sidebar{display:inherit}}.article-page .main-article{background:var(--card-background);border-radius:var(--card-border-radius);box-shadow:var(--shadow-l1);overflow:hidden}.article-page .main-article .article-header .article-image img{height:auto;width:100%;max-height:50vh;object-fit:cover}.article-page .main-article .article-header .article-details{padding:var(--card-padding);padding-bottom:0}.article-page .main-article .article-content{margin:var(--card-padding)0;color:var(--card-text-color-main)}.article-page .main-article .article-content .footnotes{font-family:var(--base-font-family)}.article-page .main-article .article-content img{max-width:100%;height:auto}.article-page .main-article .article-footer{margin:var(--card-padding);margin-top:0}.article-page .main-article .article-footer section:not(:first-child){margin-top:var(--card-padding)}.article-page .main-article .article-footer section{color:var(--card-text-color-tertiary);text-transform:uppercase;display:flex;align-items:center;font-size:1.4rem;gap:15px}.article-page .main-article .article-footer section svg{width:20px;height:20px;stroke-width:1.33}.article-page .main-article .article-footer .article-tags{text-transform:unset}.article-page .main-article .article-footer .article-copyright a,.article-page .main-article .article-footer .article-lastmod a{color:var(--body-text-color)}.article-page .main-article .article-footer .article-copyright a.link,.article-page .main-article .article-footer .article-lastmod a.link{box-shadow:unset}.widget--toc{background-color:var(--card-background);border-radius:var(--card-border-radius);box-shadow:var(--shadow-l1);display:flex;flex-direction:column;color:var(--card-text-color-main);overflow:hidden}.widget--toc ::-webkit-scrollbar-thumb{background-color:var(--card-separator-color)}.widget--toc #TableOfContents{overflow-x:auto;max-height:75vh}.widget--toc #TableOfContents ol,.widget--toc #TableOfContents ul{margin:0;padding:0}.widget--toc #TableOfContents ol{list-style-type:none;counter-reset:item}.widget--toc #TableOfContents ol li a:first-of-type::before{counter-increment:item;content:counters(item,".")". ";font-weight:700;margin-right:5px}.widget--toc #TableOfContents>ul{padding:0 1em}.widget--toc #TableOfContents li{margin:15px 0 15px 20px;padding:5px}.widget--toc #TableOfContents li>ol,.widget--toc #TableOfContents li>ul{margin-top:10px;padding-left:10px;margin-bottom:-5px}.widget--toc #TableOfContents li>ol>li:last-child,.widget--toc #TableOfContents li>ul>li:last-child{margin-bottom:0}.widget--toc #TableOfContents li.active-class>a{border-left:var(--heading-border-size)solid var(--accent-color);font-weight:700}.widget--toc #TableOfContents ul li.active-class>a{display:block}.widget--toc #TableOfContents>ul>li.active-class>a{margin-left:calc(-25px - 1em);padding-left:calc(25px + 1em - var(--heading-border-size))}.widget--toc #TableOfContents>ol>li.active-class>a{margin-left:calc(-9px - 1em);padding-left:calc(9px + 1em - var(--heading-border-size));display:block}.widget--toc #TableOfContents>ul>li>ul>li.active-class>a{margin-left:calc(-60px - 1em);padding-left:calc(60px + 1em - var(--heading-border-size))}.widget--toc #TableOfContents>ol>li>ol>li.active-class>a{margin-left:calc(-44px - 1em);padding-left:calc(44px + 1em - var(--heading-border-size));display:block}.widget--toc #TableOfContents>ul>li>ul>li>ul>li.active-class>a{margin-left:calc(-95px - 1em);padding-left:calc(95px + 1em - var(--heading-border-size))}.widget--toc #TableOfContents>ol>li>ol>li>ol>li.active-class>a{margin-left:calc(-79px - 1em);padding-left:calc(79px + 1em - var(--heading-border-size));display:block}.widget--toc #TableOfContents>ul>li>ul>li>ul>li>ul>li.active-class>a{margin-left:calc(-130px - 1em);padding-left:calc(130px + 1em - var(--heading-border-size))}.widget--toc #TableOfContents>ol>li>ol>li>ol>li>ol>li.active-class>a{margin-left:calc(-114px - 1em);padding-left:calc(114px + 1em - var(--heading-border-size));display:block}.widget--toc #TableOfContents>ul>li>ul>li>ul>li>ul>li>ul>li.active-class>a{margin-left:calc(-165px - 1em);padding-left:calc(165px + 1em - var(--heading-border-size))}.widget--toc #TableOfContents>ol>li>ol>li>ol>li>ol>li>ol>li.active-class>a{margin-left:calc(-149px - 1em);padding-left:calc(149px + 1em - var(--heading-border-size));display:block}.related-content{overflow-x:auto;padding-bottom:15px}.related-content>.flex{float:left}.related-content article{margin-right:15px;flex-shrink:0;overflow:hidden;width:250px;height:150px}.related-content article .article-title{font-size:1.8rem;margin:0}.related-content article.has-image .article-details{padding:20px;background:linear-gradient(0deg,rgba(0,0,0,.25) 0%,rgba(0,0,0,.75) 100%)}.article-content{font-family:var(--article-font-family);font-size:var(--article-font-size);padding:0 var(--card-padding);line-height:var(--article-line-height)}.article-content>p{margin:1.5em 0}.article-content h1,.article-content h2,.article-content h3,.article-content h4,.article-content h5,.article-content h6{margin-inline-start:calc((var(--card-padding)) * -1);padding-inline-start:calc(var(--card-padding) - var(--heading-border-size));border-inline-start:var(--heading-border-size)solid var(--accent-color);position:relative}.article-content h1 a.header-anchor,.article-content h2 a.header-anchor,.article-content h3 a.header-anchor,.article-content h4 a.header-anchor,.article-content h5 a.header-anchor,.article-content h6 a.header-anchor{transition:opacity .3s ease;opacity:0;position:absolute;left:0;width:var(--card-padding);text-align:center;color:var(--accent-color)}.article-content h1 a.header-anchor:before,.article-content h2 a.header-anchor:before,.article-content h3 a.header-anchor:before,.article-content h4 a.header-anchor:before,.article-content h5 a.header-anchor:before,.article-content h6 a.header-anchor:before{content:"#"}.article-content h1:hover a.header-anchor,.article-content h1:focus a.header-anchor,.article-content h2:hover a.header-anchor,.article-content h2:focus a.header-anchor,.article-content h3:hover a.header-anchor,.article-content h3:focus a.header-anchor,.article-content h4:hover a.header-anchor,.article-content h4:focus a.header-anchor,.article-content h5:hover a.header-anchor,.article-content h5:focus a.header-anchor,.article-content h6:hover a.header-anchor,.article-content h6:focus a.header-anchor{opacity:1}.article-content figure{text-align:center}.article-content figure figcaption{font-size:1.4rem;color:var(--card-text-color-secondary)}.article-content blockquote{position:relative;margin:1.5em 0;border-inline-start:var(--blockquote-border-size)solid var(--card-separator-color);padding:15px calc(var(--card-padding) - var(--blockquote-border-size));background-color:var(--blockquote-background-color)}.article-content blockquote .cite{display:block;text-align:right;font-size:.75em}.article-content blockquote .cite a{text-decoration:underline}.article-content hr{width:100px;margin:40px auto;background:var(--card-text-color-tertiary);height:2px;border:0;opacity:.55}.article-content code{color:var(--code-text-color);background-color:var(--code-background-color);padding:2px 4px;border-radius:var(--tag-border-radius);font-family:var(--code-font-family)}.article-content a,.article-content code{word-break:break-word}.article-content .gallery{position:relative;display:flex;flex-direction:row;justify-content:center;margin:1.5em 0;gap:10px}.article-content .gallery figure{margin:0}.article-content pre{overflow-x:auto;display:block;background-color:var(--pre-background-color);color:var(--pre-text-color);font-family:var(--code-font-family);line-height:1.428571429;word-break:break-all;padding:var(--card-padding)}[dir=rtl] .article-content pre{direction:ltr}.article-content pre code{color:unset;border:none;background:0 0;padding:0}.article-content .highlight{background-color:var(--pre-background-color);padding:var(--card-padding);position:relative}.article-content .highlight:hover .copyCodeButton{opacity:1}[dir=rtl] .article-content .highlight{direction:ltr}.article-content .highlight pre{margin:initial;padding:0;margin:0;width:auto}.article-content .copyCodeButton{position:absolute;top:calc(var(--card-padding));right:calc(var(--card-padding));background:var(--card-background);border:none;box-shadow:var(--shadow-l2);border-radius:var(--tag-border-radius);padding:8px 16px;color:var(--card-text-color-main);cursor:pointer;font-size:14px;opacity:0;transition:opacity .3s ease}.article-content .table-wrapper{padding:0 var(--card-padding);overflow-x:auto;display:block}.article-content table{width:100%;border-collapse:collapse;border-spacing:0;margin-bottom:1.5em;font-size:.96em}.article-content th,.article-content td{text-align:left;padding:4px 8px 4px 10px;border:1px solid var(--table-border-color)}.article-content td{vertical-align:top}.article-content tr:nth-child(even){background-color:var(--tr-even-background-color)}.article-content .twitter-tweet{color:var(--card-text-color-main)}.article-content .video-wrapper{position:relative;width:100%;height:0;padding-bottom:56.25%;overflow:hidden}.article-content .video-wrapper>iframe,.article-content .video-wrapper>video{position:absolute;width:100%;height:100%;left:0;top:0;border:0}.article-content .gitlab-embed-snippets{margin:0!important}.article-content .gitlab-embed-snippets .file-holder.snippet-file-content{margin-block-end:0!important;margin-block-start:0!important;margin-left:calc((var(--card-padding)) * -1)!important;margin-right:calc((var(--card-padding)) * -1)!important;padding:0 var(--card-padding)!important}.article-content blockquote,.article-content figure,.article-content .highlight,.article-content pre,.article-content .gallery,.article-content .video-wrapper,.article-content .table-wrapper,.article-content .s_video_simple{margin-left:calc((var(--card-padding)) * -1);margin-right:calc((var(--card-padding)) * -1);width:calc(100% + var(--card-padding) * 2)}.article-content .katex-display>.katex{overflow-x:auto;overflow-y:hidden}.article-content kbd{border:1px solid var(--kbd-border-color);font-weight:700;font-size:.9em;line-height:1;padding:2px 4px;border-radius:4px;display:inline-block}.section-card{border-radius:var(--card-border-radius);background-color:var(--card-background);padding:var(--small-card-padding);box-shadow:var(--shadow-l1);display:flex;align-items:center;gap:20px;--separation:15px}.section-card .section-term{font-size:2.2rem;margin:0;color:var(--card-text-color-main)}.section-card .section-description{font-weight:400;color:var(--card-text-color-secondary);font-size:1.6rem;margin:0}.section-card .section-details{flex-grow:1;display:flex;flex-direction:column;gap:8px}.section-card .section-image img{width:60px;height:60px}.section-card .section-count{color:var(--card-text-color-tertiary);font-size:1.4rem;margin:0;font-weight:700;text-transform:uppercase}.subsection-list{overflow-x:auto}.subsection-list .article-list--tile{display:flex;padding-bottom:15px}.subsection-list .article-list--tile article{width:250px;height:150px;margin-right:20px;flex-shrink:0}.subsection-list .article-list--tile article .article-title{margin:0;font-size:1.8rem}.subsection-list .article-list--tile article .article-details{padding:20px}.not-found-card{background-color:var(--card-background);box-shadow:var(--shadow-l1);border-radius:var(--card-border-radius);padding:var(--card-padding)}.search-form{position:relative;--button-size:80px}.search-form.widget{--button-size:60px}.search-form.widget label{font-size:1.3rem;top:10px}.search-form.widget input{font-size:1.5rem;padding:30px 20px 15px}.search-form p{position:relative;margin:0}.search-form label{position:absolute;top:15px;inset-inline-start:20px;font-size:1.4rem;color:var(--card-text-color-tertiary)}.search-form input{padding:40px 20px 20px;border-radius:var(--card-border-radius);background-color:var(--card-background);box-shadow:var(--shadow-l1);color:var(--card-text-color-main);width:100%;border:0;-webkit-appearance:none;transition:box-shadow .3s ease;font-size:1.8rem}.search-form input:focus{outline:0;box-shadow:var(--shadow-l2)}.search-form button{position:absolute;inset-inline-end:0;top:0;height:100%;width:var(--button-size);cursor:pointer;background-color:transparent;border:0;padding:0 10px}.search-form button:focus{outline:0}.search-form button:focus svg{stroke-width:2;color:var(--accent-color)}.search-form button svg{color:var(--card-text-color-secondary);stroke-width:1.33;transition:all .3s ease;width:20px;height:20px}a{text-decoration:none;color:var(--accent-color)}a:hover{color:var(--accent-color-darker)}a.link{box-shadow:0 -2px rgba(var(--link-background-color),var(--link-background-opacity))inset;transition:all .3s ease}a.link:hover{box-shadow:0 calc(-1rem * var(--article-line-height))rgba(var(--link-background-color),var(--link-background-opacity-hover))inset}.section-title{text-transform:uppercase;margin-top:0;margin-bottom:10px;display:block;font-size:1.6rem;font-weight:700;color:var(--body-text-color)}.section-title a{color:var(--body-text-color)} \ No newline at end of file diff --git a/search/index.html b/search/index.html new file mode 100644 index 0000000..1c14526 --- /dev/null +++ b/search/index.html @@ -0,0 +1,15 @@ +Search +

\ No newline at end of file diff --git a/search/index.json b/search/index.json new file mode 100644 index 0000000..89a06b0 --- /dev/null +++ b/search/index.json @@ -0,0 +1 @@ +[{"content":"Long story short: I\u0026rsquo;m now using uv, and so should you. It is a great replacement for pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more.\nContext For years, my strategy to manage python projects has been a mix of a custom setup.py, several hand-crafted requirements.txt files (through pip freeze), a custom virtualenv per project, and multiple tools to upload to PyPI. Although this works, this setup has many drawbacks:\nIt requires user intervention (creating a venv, sourcing it, handling new deps). This isn\u0026rsquo;t ideal if you want new (probably inexperienced) users to use your projects. On a similar note, the whole process needs to be well documented if you want other users to contribute or maintain the code. Pinning dependency versions is finicky, and I\u0026rsquo;ve run into problems beause of that. Creating a new project involves a template, or copying files from an older project. Of course, this is nothing new. There is a whole site dedicated to packaging your Python project. A plethora of different projects have come and go, with varying degrees of success.\nAlternatives (poetry) About a year before trying uv, I tried to catch up with the ecosystem and get to know the blessed new way. However, the task proved to be a little more difficult, as the landscape is filled with a myriad of alternatives, each with their own set of drawbacks and detractors. Packaging has historically been a weak spot, in ironical contradiction to the Zen of Python\u0026rsquo;s \u0026ldquo;There should be one\u0026ndash; and preferably only one \u0026ndash;obvious way to do it\u0026rdquo;,\nI eventually settled on poetry. Mostly because it seemed like the most popular alternative.\nThere are many things I liked about it. First of all, having a convention for dependencies (pyproject.toml) and a tool that properly handles them was nice. It also removed the need to remember specific incantations to build and publish my Python projects. Lastly, I mixed it poetry2nix to create reproducible python environments using nix. This makes for a very powerful experience.\nHowever, there were multiple hiccups. First of all, it took me some time to figure out which specific fields to use (each tool can define ad-hoc properties in a the pyproject.toml file), and some of them seemed redundant with the more generic ones. Full disclosure, this specific point might be a mistake on my side, and I do not remember the details. The second one is speed. (Re-)creating an environment took a non-negligible amount of time.\nEnter light uv According to its repository, uv can replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. Not only that, but it also claims to do that 10-100 times faster than pip. I must admit that it being written in rust was a another selling point for me, as I\u0026rsquo;m looking for excuses to collaborate in a decently-sized rust projejct.\nInstalling it is dead simple: simply download the binary (e.g., with curl) or run pip install uv. You won\u0026rsquo;t need much more: uv seems to just do the right thing out of the box. And it does it really, really fast. The rest of the time it gets out of the way.\nMy only gripe so far is that I don\u0026rsquo;t seem to find a built-in command to drop into a shell, but that is nothing that uv run $SHELL cannot fix.\nCommon operations Initialize a repository 1 uv init Adding dependencies 1 uv add senpy Running commands inside the environment 1 2 3 4 uv run \u0026lt;COMMAND\u0026gt; # e.g., run a shell using your python version and dependencies uv run $SHELL Dependency tree 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 uv shell Resolved 44 packages in 1ms my-project v0.1.0 ├── fastapi[standard] v0.115.8 │ ├── pydantic v2.10.6 │ │ ├── annotated-types v0.7.0 │ │ ├── pydantic-core v2.27.2 │ │ │ └── typing-extensions v4.12.2 │ │ └── typing-extensions v4.12.2 │ ├── starlette v0.45.3 │ │ └── anyio v4.8.0 │ │ ├── exceptiongroup v1.2.2 │ │ ├── idna v3.10 │ │ ├── sniffio v1.3.1 │ │ └── typing-extensions v4.12.2 │ ├── typing-extensions v4.12.2 │ ├── email-validator v2.2.0 (extra: standard) │ │ ├── dnspython v2.7.0 ... ","date":"2025-02-17T23:02:47+01:00","image":"https://balkian.com/img/uv.png","permalink":"https://balkian.com/p/uv-one-rust-tool-to-rule-all-pythons/","title":"uv - One rust tool to rule all pythons"},{"content":"This is a quick and easy recipe to add a default.nix to any Python project with a requirements.txt file:\n1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 with import \u0026lt;nixpkgs\u0026gt; { }; let pythonPackages = python311Packages; in pkgs.mkShell rec { name = \u0026#34;impurePythonEnv\u0026#34;; venvDir = \u0026#34;./.venv\u0026#34;; buildInputs = [ # A python interpreter including the \u0026#39;venv\u0026#39; module is required to bootstrap # the environment. pythonPackages.python # This execute some shell code to initialize a venv in $venvDir before # dropping into the shell pythonPackages.venvShellHook # Those are dependencies that we would like to use from nixpkgs, which will # add them to PYTHONPATH and thus make them accessible from within the venv. pythonPackages.numpy pythonPackages.requests # In this particular example, in order to compile any binary extensions they may # require, the python modules listed in the hypothetical requirements.txt need # the following packages to be installed locally: taglib openssl git libxml2 libxslt libzip zlib ]; # Now we can execute any commands within the virtual environment. # This is optional and can be left out to run pip manually. postShellHook = \u0026#39;\u0026#39; pip install -r requirements.txt \u0026#39;\u0026#39;; } Now, you will get a clean environment by running:\n1 nix-shell ","date":"2023-11-13T18:21:46+01:00","permalink":"https://balkian.com/p/nix-recipe-for-python-projects/","title":"Nix Recipe for Python Projects"},{"content":"Kanata is a software keyboard remapper that aims to improve keyboard comfort and usability with advanced customization. Keyboard remappers are a good alternative to running a custom keyboard with QMK/ZMK, and have two main advantages: they work on any keyboard, and you can configure them to launch any command or program you want, not just key presses. On the other hand, you need to configure them on every PC/OS you\u0026rsquo;re using your keyboard with, and all the processing is done on software on top of the OS, so there may be glitches and performance issues.\nThe project was inspired by the more popular KMonad, and the author cites some of the differences. Both projects use a very similar configuration format based on lisp. The configuration consists of a set of general options, a base key configuration, a series of layers, and macros that can be used within those layers. Here\u0026rsquo;s a very complete config that serves as documentation.\nOne big disadvantage of the lispy configuration is that you need to specify your hardware layout/all your keys, and repeat that every time you define a new layer. The result visually maps to your keyboard, but can be very verbose/big if you need really few changes.\nKeyd is another alternative with a more declarative configuration format, which might lend itself to smaller.\nFor now I\u0026rsquo;m just trying it out, and getting a feel for using fewer keys before I build my own ZMK keyboard. I particularly like the option of using mod-keys on the home row (e.g., having A work as a CTRL when held). Mod-tap, tap-dancing and the like are very common techniques in sub-40% layouts, where there simply aren\u0026rsquo;t enough keys for all the letters and symbols. In a regular-sized keyboard, these techniques can also help you stay on the home row and type more comfortably. At least, that\u0026rsquo;s the idea. We\u0026rsquo;ll see if I like it enough to stick with it.\nFor now, here\u0026rsquo;s my very simple config:\n1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 (defcfg ;; Your keyboard device will likely differ from this. linux-dev /dev/input/by-id/usb-Logitech_USB_Receiver-if02-event-mouse ;; Windows doesn\u0026#39;t need any input/output configuration entries; however, there ;; must still be a defcfg entry. You can keep the linux-dev entry or delete ;; it and leave it empty. ) (defsrc grv 1 2 3 4 5 6 7 8 9 0 - = bspc tab q w e r t y u i o p [ ] caps a s d f g h j k l ; \u0026#39; ret lsft \\ z x c v b n m , . / rsft lctl lmet lalt spc ralt rmet rctl ) (deflayer qwerty grv _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ @warrows _ _ _ _ _ _ _ _ _ _ lctrl @alctrl @slsft @dlalt @flmet _ _ @jrmet @kralt @lrsft @;rctrl _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ @smartspace _ _ _ ) (deflayer arrows _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ @flmet _ left down up rght _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ @smartspace _ _ _ ) (deflayer colemak grv XX XX XX XX XX XX XX XX XX XX XX XX _ tab q w f p b j l u y ; [ ] lctrl @alctrl @rlsft @slalt @tlmet g m @nrmet @eralt @irsft @orctrl \u0026#39; ret lsft XX z x c d v k h , . / rsft XX XX XX @smartspace XX XX XX ) (deflayer magic _ @clmk @qwerty _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ tab A-tab _ _ _ _ bspc esc _ ret _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ ) (defalias warrows (tap-hold 200 200 w (layer-toggle arrows)) alctrl (tap-hold 200 200 a lctrl) slsft (tap-hold 200 200 s lsft) dlalt (tap-hold 200 200 d lalt) flmet (tap-hold 200 200 f lmet) jrmet (tap-hold 200 200 j rmet) kralt (tap-hold 200 200 k ralt) lrsft (tap-hold 200 200 l rsft) ;rctrl (tap-hold 200 200 ; rctrl) rlsft (tap-hold 200 200 r lsft) slalt (tap-hold 200 200 s lalt) tlmet (tap-hold 200 200 t lmet) nrmet (tap-hold 200 200 n rmet) eralt (tap-hold 200 200 e ralt) irsft (tap-hold 200 200 i rsft) orctrl (tap-hold 200 200 o rctrl) clmk (layer-switch colemak) qwerty (layer-switch qwerty) smartspace (tap-dance 200 ( (tap-hold 300 300 spc (layer-toggle magic)) (tap-hold 300 300 (one-shot 300 lalt) spc) a )) ) ","date":"2023-01-20T18:11:00Z","permalink":"https://balkian.com/p/kanata-advanced-keyboard-configuration/","title":"Kanata: advanced keyboard configuration"},{"content":"As a follow-up to my last post, I\u0026rsquo;ve decided to also configure my mk850 combo (k850 + m720 triathlon).\nSome notes:\nThe keyboard is usually connected to this PC through bluetooth. Since this is a change I usually do in the system for every keyboard, I added a rule for any bus (usb, bluetooth, etc) The mouse has an additional button that registers as a keyboard. Every press maps to three key events. I\u0026rsquo;ve disabled two of them and mapped the action to F19, in case I want to use it in my DE/WM. 1 2 3 4 5 6 7 evdev:input:* KEYBOARD_KEY_70039=leftctrl # bind capslock to w evdev:input:b0005v046DpB015* KEYBOARD_KEY_700e0=f19 KEYBOARD_KEY_700e2=unknown KEYBOARD_KEY_7002b=unknown After that, simply run:\n1 sudo udevadm hwdb --update \u0026amp;\u0026amp; sudo udevadm trigger Make sure the settings have been applied by running evemu-describe:\n1 sudo /sbin/evemu-describe /dev/input/event\u0026lt;id of your device\u0026gt; | grep KEY_ ","date":"2021-10-30T00:00:01Z","permalink":"https://balkian.com/p/logitech-mb850-combi-in-linux/","title":"Logitech MB850 combi in linux"},{"content":"I recently got Logitech MX Keys for Mac keyboard at work. The German version, to be more precise. This version was three times cheaper than the Windows equivalent with either US or ES layout. Since I touch type anyway, I thought it was a bargain.\nAs soon as I plugged it in, I realized there were some glaring issues with the keyboard. First of all, the Meta/Super and Alt keys are reversed in this keyboard. In the normal/full version of this keyboard, Logitech gives an option to choose between Mac, Windows and iOS host, and that changes the behavior of the keys. In this version, tho, only iOS and Mac are available.\nBesides that, there\u0026rsquo;s the issue of the grave (tilde) and angle keys switched as well.\nSwitching these keys around would be very easy with Xorg, but Wayland once again complicates things\u0026hellip;\nThese issues almost made me return the keyboard. Luckily, tho, there is another option: configuring the keys one level lower than wayland (and X11), through hwdb.\nLong story short, this will configure any Logitech keyboard with the same product id (0x4092) to use a saner configuration:\n1 2 3 4 5 6 7 8 9 10 11 #File: /etc/udev/hwdb.d/90-logitech-keyboard.hwdb evdev:input:b0003v046Dp4092* KEYBOARD_KEY_700e2=leftmeta KEYBOARD_KEY_700e3=leftalt KEYBOARD_KEY_70039=leftctrl KEYBOARD_KEY_70064=102nd KEYBOARD_KEY_70035=grave KEYBOARD_KEY_700e7=rightalt KEYBOARD_KEY_700e6=rightmeta KEYBOARD_KEY_7006d=compose After that, simply run:\n1 sudo udevadm hwdb --update \u0026amp;\u0026amp; sudo udevadm trigger ","date":"2021-10-29T00:00:01Z","permalink":"https://balkian.com/p/logitech-mx-keys-for-mac-on-linux/","title":"Logitech MX Keys for Mac on Linux"},{"content":"Believe it or not, Surface tablets have pretty good linux support, except for the webcams in newer models. These are some useful notes to get Ubuntu installed in your surface go, as of Summer 2019.\nInstalling the kernel 1 2 git clone --depth 1 https://github.com/jakeday/linux-surface.git ~/linux-surface cp -a ~/linux-surface /media/\u0026lt;your usb\u0026gt; 1 2 3 cp -a /media/\u0026lt;your usb\u0026gt;/linux-surface ~/ cd ~/linux-surface/ sudo sh setup.sh Booting ubuntu first Switch out of Windows S mode.\nBoot into the \u0026ldquo;Command Prompt\u0026rdquo;.\nFrom Windows go to \u0026ldquo;change advanced startup options\u0026rdquo; and select \u0026ldquo;restart now\u0026rdquo;.\nWhen it reboots, choose the \u0026ldquo;Troubleshoot\u0026rdquo; option, then choose the \u0026ldquo;Advanced options\u0026rdquo; option, and finally choose the \u0026ldquo;Command Prompt\u0026rdquo; option.\nAfter the device reboots, login to the command prompt and then you should see a terminal with X:\\windows\\system32\u0026gt;\nAt the prompt, check your UEFI entries:\n1 bcdedit /enum firmware Copy UEFI entry of \u0026ldquo;Windows Boot Manager\u0026rdquo; to create a new entry for Ubuntu: bcdedit /copy {bootmgr} /d \u0026ldquo;Ubuntu\u0026rdquo;\nCopy the printed GUID number including the braces {} using Ctrl+C\nSet file path for the new Ubuntu entry. Replace {guid} with the returned GUID of the previous command (Ctrl+V). bcdedit /set {guid} path \\EFI\\ubuntu\\grubx64.efi\nSet Ubuntu as the first/ entry in the boot sequence. Again replace {guid} with the returned GUID of the copy command.\n1 bcdedit /set {fwbootmgr} displayorder {guid} /addfirst Check your UEFI entries again: bcdedit /enum firmware You should see something like this:\n1 2 3 4 5 6 7 8 9 10 Firmware Boot Manager --------------------- identifier {fwbootmgr} displayorder {3510232e-f8eb-e811-95ce-9ecab3f9d1c4} {bootmgr} {2148799b-f8eb-e811-95ce-9ecab3f9d1c4} {312e8a67-c2f6-e811-95ce-3c1ab3f9d1de} {312e8a68-c2f6-e811-95ce-3c1ab3f9d1de} timeout 0 Make sure the GUID you copied is the first one listed in displayorder. Then type exit, turn off the PC and turn it back on. After this my surface go is automatically booting to the grub bootloader which lets me choose between Windows and Ubuntu but defaults to Ubuntu after ten seconds.\n","date":"2019-06-01T00:00:01Z","permalink":"https://balkian.com/p/linux-on-the-microsoft-surface-go/","title":"Linux on the Microsoft Surface Go"},{"content":"This is a short tutorial on connecting a zigbee device (an Aqara cube) to an MQTT server, so you can control your zigbee devices from the network.\nIf you\u0026rsquo;re anything like me, you\u0026rsquo;re probably a sucker for IoT devices. For a long time, I\u0026rsquo;ve been using WiFi-enabled lights, and Amazon dash buttons to control them. To keep these (cheap Chinese) internet enabled devices away from your network and their respective cloud services, you\u0026rsquo;ll probably want to set up a dedicated network in your router (more on this on a future post, maybe). Another disadvantage of WiFi devices is that they\u0026rsquo;re relatively power hungry.\nA popular alternative is using ZigBee for communication. It is a dedicated protocol similar to bluetooth (BLE), with lower power requirements and bitrate.\nTake the (super cute) aqara cube as an example. It is a small cube that detects rotation on all of its axes, and tapping events. Here\u0026rsquo;s a video:\nTo connect to zigbee devices you will need a zigbee enabled gateway (a.k.a. hub), which connects to your WiFi network and your zigbee devices. Once again, this means adding an internet-enabled device to your home, and probably a couple of cloud services.\nAs an alternative, you can set up your own zigbee gateway, and control it to your home automation platform of choice (e.g. home assistant). We will cover how to set up a zigbee2mqtt gateway that is also connected to an MQTT server, so you can use MQTT to control your devices and get notifications.\nWhat you need:\nAqara cube. CC2531 zigbee sniffer. CC-debugger. You will need to flash your sniffer. For that, you only need to follow the instructions from the zigbee2mqtt documentation.\nOnce you\u0026rsquo;re done flashing, you\u0026rsquo;re ready to set up the zigbee2mqtt server. For convenience, I wrote a simple docker-compose to deploy a zigbee2mqtt server and a test mosquitto server:\n1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 version: \u0026#39;2.1\u0026#39; services: zigbee2mqtt: image: koenkk/zigbee2mqtt container_name: zigbee2mqtt restart: always volumes: - ./z2m-data/:/app/data/ devices: - \u0026#34;/dev/ttyACM0\u0026#34; networks: - hass mqtt: image: eclipse-mosquitto ports: - 1883:1883 - 9001:9001 networks: - hass volumes: - ./mosquitto.conf:/mosquitto/config/mosquitto.conf networks: hass: driver: overlay You can test your installation with:\n1 2 3 4 5 6 ❯ mosquitto_sub -h localhost -p 1883 -t \u0026#39;zigbee2mqtt/#\u0026#39; online {\u0026#34;battery\u0026#34;:17,\u0026#34;voltage\u0026#34;:2925,\u0026#34;linkquality\u0026#34;:149,\u0026#34;action\u0026#34;:\u0026#34;rotate_right\u0026#34;,\u0026#34;angle\u0026#34;:12.8} {\u0026#34;battery\u0026#34;:17,\u0026#34;voltage\u0026#34;:2925,\u0026#34;linkquality\u0026#34;:141,\u0026#34;action\u0026#34;:\u0026#34;slide\u0026#34;,\u0026#34;side\u0026#34;:2} {\u0026#34;battery\u0026#34;:17,\u0026#34;voltage\u0026#34;:2925,\u0026#34;linkquality\u0026#34;:120} {\u0026#34;battery\u0026#34;:17,\u0026#34;voltage\u0026#34;:2925,\u0026#34;linkquality\u0026#34;:141,\u0026#34;action\u0026#34;:\u0026#34;wakeup\u0026#34;} zigbee2mqtt supports the following events for the aqara cube: shake, wakeup, fall, tap, slide, flip180, flip90, rotate_left and rotate_right. Every event has additional information, such as the sides involved, or the degrees turned.\nNow you are ready to set up home assistant support in zigbee2mqtt following this guide.\n","date":"2019-01-06T10:00:00Z","permalink":"https://balkian.com/p/controlling-zigbee-devices-with-mqtt/","title":"Controlling Zigbee devices with MQTT"},{"content":"tqdm is a nice way to add progress bars in the command line or in a jupyter notebook.\n1 2 3 4 5 from tqdm import tqdm import time for i in tqdm(range(100)): time.sleep(1) ","date":"2016-09-28T18:47:00Z","permalink":"https://balkian.com/p/progress-bars-in-python/","title":"Progress bars in python"},{"content":"Today\u0026rsquo;s post is half a quick note, half public shaming. In other words, it is a reminder to be very careful with OAuth tokens and passwords.\nAs part of moving to emacs, I starting using the incredibly useful gh.el. When you first use it, the extension saves either your password or an OAuth token in your .gitconfig file. This is cool and convenient, unless you happen to be publishing your .gitconfig file in a public repo.\nSo, how can you still share your gitconfig without sharing your password/token with the rest of the world? Since Git 1.7.0, you can include other files in your gitconfig.\n1 2 [include] path = ~/.gitconfig_secret And now, in your .gitconfig_secret file, you just have to add this:\n1 2 3 [github] user = balkian token = \u0026#34;\u0026lt; Your secret token \u0026gt;\u0026#34; ","date":"2015-04-10T17:47:00Z","permalink":"https://balkian.com/p/sharing-dotfiles/","title":"Sharing dotfiles"},{"content":"Zotero is an Open Source tool that lets you organise your bibliography, syncing it with the cloud. Unlike other alternatives such as Mendeley, Zotero can upload the attachments and data to a private cloud via WebDav.\nIf you use nginx as your web server, know that even though it provides partial support for webdav, Zotero needs more than that. Hence, you will need another webdav server, and optionally let nginx proxy to it. This short post provides the basics to get that set-up working under Debian/Ubuntu.\nSetting up Apache First we need to install Apache:\n1 sudo apt-get install apache2 Change the head of \u0026ldquo;/etc/apache2/sites-enabled/000-default\u0026rdquo; to:\n1 \u0026lt;VirtualHost *:880\u0026gt; Then, create a file /etc/apache2/sites-available/webdav:\n1 2 3 4 5 6 7 8 9 10 11 12 13 Alias /dav /home/webdav/dav \u0026lt;Location /dav\u0026gt; Dav on Order Allow,Deny Allow from all Dav On Options +Indexes AuthType Basic AuthName DAV AuthBasicProvider file AuthUserFile /home/webdav/.htpasswd Require valid-user \u0026lt;/Location\u0026gt; Ideally, you want your webdav folders to be private, adding authentication to them. So you need to create the webdav and zotero users and add the passwords to an htpasswd file. Even though you could use a single user, since you will be configuring several clients with your credentials I encourage you to create the zotero user as well. This way you can always change the password for zotero without affecting any other application using webdav.\n1 2 3 4 sudo adduser webdav sudo htpasswd -c /home/webdav/.htpasswd webdav sudo htpasswd /home/webdav/.htpasswd zotero sudo mkdir -p /home/webdav/dav/zotero Enable the site and restart apache:\n1 2 3 4 sudo a2enmod webdav sudo a2enmod dav_fs sudo a2ensite webdav sudo service apache2 restart At this point everything should be working at http://\u0026lt;your_host\u0026gt;:880/dav/zotero\nSetting up NGINX After the Apache side is working, we can use nginx as a proxy to get cleaner URIs. In your desired site/location, add this:\n1 2 3 4 5 6 7 location /dav { client_max_body_size 20M; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $remote_addr; proxy_set_header Host $host; proxy_pass http://127.0.0.1:880; } Now just reload nginx:\n1 sudo service nginx force-reload Extras Zotero Reader - HTML5 client Zandy - Android Open Source client ","date":"2014-12-09T12:12:12Z","permalink":"https://balkian.com/p/zotero/","title":"Zotero"},{"content":"This is a quick note on proxying a local python application (e.g. flask) to a subdirectory in Apache. This assumes that the file wsgi.py contains a WSGI application with the name application. Hence, wsgi:application.\nGunicorn 1 2 3 4 5 \u0026lt;Location /myapp/\u0026gt; ProxyPass http://127.0.0.1:8888/myapp/ ProxyPassReverse http://127.0.0.1:8888/myapp/ RequestHeader set SCRIPT_NAME \u0026#34;/myapp/\u0026#34; \u0026lt;/Location\u0026gt; Important: SCRIPT_NAME and the end of ProxyPass URL MUST BE THE SAME. Otherwise, Gunicorn will fail miserably.\nTry it with:\n1 venv/bin/gunicorn -w 4 -b 127.0.0.1:8888 --log-file - --access-logfile - wsgi:application UWSGI This is a very simple configuration. I will try to upload one with more options for uwsgi (in a .ini file).\n1 2 3 4 \u0026lt;Location /myapp/\u0026gt; SetHandler uwsgi_handler uWSGISocker 127.0.0.1:8888 \u0026lt;/Location\u0026gt; Try it with:\n1 uwsgi --socket 127.0.0.1:8888 -w wsgi:application Extra: Supervisor If everything went as expected, you can wrap your command in a supervisor config file and let it handle the server for you.\n1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 [unix_http_server] file=/tmp/myapp.sock ; path to your socket file [supervisord] logfile = %(here)s/logs/supervisor.log childlogdir = %(here)s/logs/ [rpcinterface:supervisor] supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface [supervisorctl] logfile = %(here)s/logs/supervisorctl.log serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket [program:myapp] command = venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 --log-file %(here)s/logs/gunicorn.log --access-logfile - wsgi:application directory = %(here)s environment = PATH=%(here)s/venv/bin/ logfile = %(here)s/logs/myapp.log ","date":"2014-10-09T10:00:00Z","permalink":"https://balkian.com/p/proxies-with-apache-and-python/","title":"Proxies with Apache and python"},{"content":"Developing a python module and publishing it on Github is cool, but most of the times you want others to download and use it easily. That is the role of PyPi, the python package repository. In this post I show you how to publish your package in less than 10 minutes.\nChoose a fancy name If you haven\u0026rsquo;t done so yet, take a minute or two to think about this. To publish on PyPi you need a name for your package that isn\u0026rsquo;t taken. What\u0026rsquo;s more, a catchy and unique name will help people remember your module and feel more inclined to at least try it.\nThe package name should hint what your module does, but that\u0026rsquo;s not always the case. That\u0026rsquo;s your call. I personally put uniqueness and memorability over describing the functionality.\nCreate a .pypirc configuration file 1 2 3 4 5 6 7 8 9 10 11 12 13 [distutils] # this tells distutils what package indexes you can push to index-servers = pypi # the live PyPI pypitest # test PyPI [pypi] # authentication details for live PyPI repository = https://pypi.python.org/pypi username = { your_username } password = { your_password } # not necessary [pypitest] # authentication details for test PyPI repository = https://testpypi.python.org/pypi username = { your_username } As you can see, you need to register both in the main pypi repository and the testing server. The usernames and passwords might be different, that is up to you!\nPrepare your package This should be the structure:\n1 2 3 4 5 6 7 8 9 10 root-dir/ # Any name you want setup.py setup.cfg LICENSE.txt README.md mypackage/ __init__.py foo.py bar.py baz.py setup.cfg 1 2 [metadata] description-file = README.md The markdown README is the de facto standard in Github, but you can also use rST (reStructuredText), the standard in the python community.\nsetup.py 1 2 3 4 5 6 7 8 9 10 11 12 from distutils.core import setup setup(name = \u0026#39;mypackage\u0026#39;, packages = [\u0026#39;mypackage\u0026#39;], # this must be the same as the name above version = \u0026#39;{ version }\u0026#39;, description = \u0026#39;{ description }\u0026#39;, author = \u0026#39;{ name }\u0026#39;, email = \u0026#39;{ email }\u0026#39;, url = \u0026#39;https://github.com/{user}/{package}\u0026#39;, # URL to the github repo download_url = \u0026#39;https://github.com/{user}/{repo}/tarball/{version}\u0026#39;, keywords = [\u0026#39;websockets\u0026#39;, \u0026#39;display\u0026#39;, \u0026#39;d3\u0026#39;], # list of keywords that represent your package classifiers = [], ) You might notice that the download_url points to a Github URL. We could host our package anywhere, but Github is a convenient option. To create the tarball and the zip packages, you only need to tag a tag in your repository and push it to github:\n1 2 git tag {version} -m \u0026#34;{ Description of this tag/version}\u0026#34; git push --tags origin master Push to the testing/main pypi server It is advisable that you try your package on the test repository and fix any problems first. The process is simple:\n1 python setup.py register -r {pypitest/pypi} python setup.py sdist upload -r {pypitest/pypi} If everything went as expected, you can now install your package through pip and browse your package\u0026rsquo;s page. For instance, check my senpy package: https://pypi.python.org/pypi/senpy\n1 pip install senpy ","date":"2014-09-27T10:00:00Z","permalink":"https://balkian.com/p/publishing-on-pypi/","title":"Publishing on PyPi"},{"content":"As part of the OpeNER hackathon we decided to build a prototype that would allow us to compare how different countries feel about several topics. We used the OpeNER pipeline to get the sentiment from a set of newspaper articles we gathered from media in several languages. Then we aggregated those articles by category and country (using the source of the article or the language it was written in), obtaining the \u0026ldquo;overall feeling\u0026rdquo; of each country about each topic. Then, we used some fancy JavaScript to make sense out of the raw information.\nIt didn\u0026rsquo;t go too bad, it turns out we won.\nNow, it was time for a face-lift. I used this opportunity to play with new technologies and improve it:\nUsing Flask, this time using python 3.3 and Bootstrap 3.0 Cool HTML5+JS cards (thanks to pastetophone) Automatic generation of fake personal data to test the interface Obfuscation of personal emails The result can be seen here.\nPublishing a Python 3 app on Heroku 1 mkvirtualenv -p /usr/bin/python3.3 eurolovemap Since Heroku uses python 2.7 by default, we have to tell it which version we want, although it supports python 3.4 as well. I couldn\u0026rsquo;t get python 3.4 working using the deadsnakes ppa, so I used python 3.3 instead, which works fine but is not officially supported. Just create a file named runtime.txt in your project root, with the python version you want to use:\n1 python-3.3.1 Don\u0026rsquo;t forget to freeze your dependencies so Heroku can install them: bash pip freze \u0026gt; requirements.txt\nPublishing personal emails There are really sophisticated and effective ways to obfuscate personal emails so that spammers cannot easily grab yours. However, this time I needed something really simple to hide our emails from the simplest form of crawlers. Most of the team are in academia somehow, so in the end all our emails are available in sites like Google Scholar. Anyway, nobody likes getting spammed so I settled for a custom Caesar cipher. Please, don\u0026rsquo;t use it for any serious application if you are concerned about being spammed.\n1 2 def blur_email(email): return \u0026#34;\u0026#34;.join([chr(ord(i)+5) for i in email]) And this is the client side:\n1 2 3 4 5 6 7 8 9 10 11 12 window.onload = function(){ elems = document.getElementsByClassName(\u0026#39;profile-email\u0026#39;); for(var e in elems){ var blur = elems[e].innerHTML; var email = \u0026#34;\u0026#34;; for(var s in blur){ var a = blur.charCodeAt(s) email = email+String.fromCharCode(a-5); } elems[e].innerHTML = email; } } Unfortunately, this approach does not hide your email from anyone using PhantomJS, ZombieJS or similar. For that, other approaches like generating a picture with the address would be necessary. Nevertheless, it is overkill for a really simple ad-hoc application with custom formatting and just a bunch of emails that would easily be grabbed manually.\nGeneration of fake data To test the contact section of the site, I wanted to populate it with fake data. Fake-Factory is an amazing library that can generate fake data of almost any kind: emails, association names, acronyms\u0026hellip; It even lets you localise the results (get Spanish names, for instance) and generate factories for certain classes (à la Django).\nBut I also wanted pictures, enter Lorem Pixel. With its API you can generate pictures of almost any size, for different topics (e.g. nightlife, people) and with a custom text. You can even use an index, so it will always show the same picture.\nFor instance, the picture below is served through Lorem Pixel.\nBy the way, if you only want cat pictures, take a look at Placekitten. And for NSFW text, there\u0026rsquo;s the Samuel L. Jackson Ipsum\n","date":"2014-03-27T14:00:00Z","permalink":"https://balkian.com/p/updating-eurolovemap/","title":"Updating EuroLoveMap"},{"content":"A simple trick. If you want to remove all the \u0026lsquo;.swp\u0026rsquo; files from a git repository, just use:\n1 git rm --cached \u0026#39;**.swp\u0026#39; ","date":"2013-08-22T23:14:00Z","permalink":"https://balkian.com/p/remove-git-files-with-globbing/","title":"Remove git files with globbing"},{"content":"I\u0026rsquo;ve finally decided to set up a decent personal page. I have settled for github-pages because I like the idea of keeping my site in a repository and having someone else host and deploy it for me. The site will be really simple, mostly static files. Thanks to Github, Jekyll will automatically generate static pages for my posts every time I commit anything new to this repository.\nBut Jekyll can be used independently, so if I ever choose to host the site myself, I can do it quite easily. Another thing that I liked about this approach is that the generated html files can be used in the future, and I will not need Jekyll to serve it. Jekyll is really simple and most of the things are written in plain html. That means that everything could be easily reused if I ever choose to change to another blogging framework (e.g. pelical). But, for the time being, I like the fact that Github takes care of the compilation as well, so I can simply modify or add files through the web interface should I need to.\nI hadn\u0026rsquo;t played with HTML and CSS for a while now, so I also wanted to use this site as a playground. At some point, I realised I was doing mostly everything in plain HTML and CSS, and decided to keep it like that for as long as possible. As of this writing, I haven\u0026rsquo;t included any Javascript code in the page. Probably I will use some to add my gists and repositories, but we will see about that.\nI think the code speaks for itself, so you can check out my repository on Github. You can clone and deploy it easily like this:\n1 2 3 git clone https://github.com/balkian/balkian.github.com cd balkian.github.com jekyll serve -w I will keep updating this post with information about:\nSome Jekyll plugins that might be useful What CSS tricks I learnt The webfonts I used The badge on the left side of the page ","date":"2013-08-22T14:14:22Z","permalink":"https://balkian.com/p/creating-my-web/","title":"Creating my web"}] \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml new file mode 100644 index 0000000..ddcfb18 --- /dev/null +++ b/sitemap.xml @@ -0,0 +1 @@ +https://balkian.com/2025-02-17T23:02:47+01:00https://balkian.com/categories/2025-02-17T23:02:47+01:00https://balkian.com/post/2025-02-17T23:02:47+01:00https://balkian.com/categories/programming/2025-02-17T23:02:47+01:00https://balkian.com/tags/python/2025-02-17T23:02:47+01:00https://balkian.com/tags/2025-02-17T23:02:47+01:00https://balkian.com/p/uv-one-rust-tool-to-rule-all-pythons/2025-02-17T23:02:47+01:00https://balkian.com/tags/nix/2023-11-13T18:21:46+01:00https://balkian.com/p/nix-recipe-for-python-projects/2023-11-13T18:21:46+01:00https://balkian.com/p/kanata-advanced-keyboard-configuration/2023-01-20T18:11:00+00:00https://balkian.com/tags/keyboard/2023-01-20T18:11:00+00:00https://balkian.com/tags/layout/2023-01-20T18:11:00+00:00https://balkian.com/tags/linux/2023-01-20T18:11:00+00:00https://balkian.com/tags/logitech/2023-01-20T18:11:00+00:00https://balkian.com/tags/rust/2023-01-20T18:11:00+00:00https://balkian.com/archives/2022-03-06T00:00:00+00:00https://balkian.com/page/2022-03-06T00:00:00+00:00https://balkian.com/p/logitech-mb850-combi-in-linux/2021-10-30T00:00:01+00:00https://balkian.com/tags/mouse/2021-10-30T00:00:01+00:00https://balkian.com/p/logitech-mx-keys-for-mac-on-linux/2021-10-29T00:00:01+00:00https://balkian.com/tags/config/2019-06-01T00:00:01+00:00https://balkian.com/categories/linux/2019-06-01T00:00:01+00:00https://balkian.com/p/linux-on-the-microsoft-surface-go/2019-06-01T00:00:01+00:00https://balkian.com/tags/surface-go/2019-06-01T00:00:01+00:00https://balkian.com/p/controlling-zigbee-devices-with-mqtt/2019-01-06T10:00:00+00:00https://balkian.com/tags/iot/2019-01-06T10:00:00+00:00https://balkian.com/tags/mqtt/2019-01-06T10:00:00+00:00https://balkian.com/tags/zigbee/2019-01-06T10:00:00+00:00https://balkian.com/p/progress-bars-in-python/2016-09-28T18:47:00+00:00https://balkian.com/tags/dotfiles/2015-04-10T17:47:00+00:00https://balkian.com/tags/git/2015-04-10T17:47:00+00:00https://balkian.com/tags/github/2015-04-10T17:47:00+00:00https://balkian.com/p/sharing-dotfiles/2015-04-10T17:47:00+00:00https://balkian.com/tags/apache/2014-12-09T12:12:12+00:00https://balkian.com/tags/nginx/2014-12-09T12:12:12+00:00https://balkian.com/tags/webdav/2014-12-09T12:12:12+00:00https://balkian.com/tags/zotero/2014-12-09T12:12:12+00:00https://balkian.com/p/zotero/2014-12-09T12:12:12+00:00https://balkian.com/tags/gunicorn/2014-10-09T10:00:00+00:00https://balkian.com/p/proxies-with-apache-and-python/2014-10-09T10:00:00+00:00https://balkian.com/tags/proxy/2014-10-09T10:00:00+00:00https://balkian.com/tags/uwsgi/2014-10-09T10:00:00+00:00https://balkian.com/p/publishing-on-pypi/2014-09-27T10:00:00+00:00https://balkian.com/tags/pypi/2014-09-27T10:00:00+00:00https://balkian.com/tags/heroku/2014-03-27T14:00:00+00:00https://balkian.com/tags/javascript/2014-03-27T14:00:00+00:00https://balkian.com/p/updating-eurolovemap/2014-03-27T14:00:00+00:00https://balkian.com/p/remove-git-files-with-globbing/2013-08-22T23:14:00+00:00https://balkian.com/p/creating-my-web/2013-08-22T14:14:22+00:00https://balkian.com/tags/ruby/2013-08-22T14:14:22+00:00https://balkian.com/tags/starters/2013-08-22T14:14:22+00:00https://balkian.com/tags/arch/https://balkian.com/page/cheatsheet/https://balkian.com/tags/emacs/https://balkian.com/emacs/https://balkian.com/links/https://balkian.com/linux/https://balkian.com/tags/lisp/https://balkian.com/tags/org/https://balkian.com/tags/productivity/https://balkian.com/tags/programming/https://balkian.com/projects/https://balkian.com/python/https://balkian.com/raspberry-pi/https://balkian.com/tags/rpi/https://balkian.com/search/ \ No newline at end of file diff --git a/tags/apache/index.html b/tags/apache/index.html new file mode 100644 index 0000000..005f986 --- /dev/null +++ b/tags/apache/index.html @@ -0,0 +1,31 @@ +Tag: Apache - J. Fernando Sánchez +

2 pages

Apache

Zotero

Proxies with Apache and python

\ No newline at end of file diff --git a/tags/apache/index.xml b/tags/apache/index.xml new file mode 100644 index 0000000..18f5669 --- /dev/null +++ b/tags/apache/index.xml @@ -0,0 +1,246 @@ +Apache on J. Fernando Sánchezhttps://balkian.com/tags/apache/Recent content in Apache on J. Fernando SánchezHugo -- gohugo.ioen-usTue, 09 Dec 2014 12:12:12 +0000Zoterohttps://balkian.com/p/zotero/Tue, 09 Dec 2014 12:12:12 +0000https://balkian.com/p/zotero/<a class="link" href="https://www.zotero.org/" target="_blank" rel="noopener" +>Zotero</a> is an Open Source tool that lets you +organise your bibliography, syncing it with the cloud. Unlike other +alternatives such as <a class="link" href="http://www.mendeley.com" target="_blank" rel="noopener" +>Mendeley</a>, Zotero can +upload the attachments and data to a private cloud via WebDav. +If you use nginx as your web server, know that even though it provides +partial support for webdav, Zotero needs more than that. Hence, you will +need another webdav server, and optionally let nginx proxy to it. This +short post provides the basics to get that set-up working under +Debian/Ubuntu. +<h2 id="setting-up-apache">Setting up Apache +</h2>First we need to install Apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo apt-get install apache2 +</code></pre></td></tr></table> +</div> +</div>Change the head of “/etc/apache2/sites-enabled/000-default” to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><VirtualHost *:880> +</code></pre></td></tr></table> +</div> +</div>Then, create a file /etc/apache2/sites-available/webdav: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache">Alias /dav /home/webdav/dav +<Location /dav> + Dav on + Order Allow,Deny + Allow from all + Dav On + Options +Indexes + AuthType Basic + AuthName DAV + AuthBasicProvider file + AuthUserFile /home/webdav/.htpasswd + Require valid-user +</Location> +</code></pre></td></tr></table> +</div> +</div>Ideally, you want your webdav folders to be private, adding +authentication to them. So you need to create the webdav and zotero +users and add the passwords to an htpasswd file. Even though you could +use a single user, since you will be configuring several clients with +your credentials I encourage you to create the zotero user as well. This +way you can always change the password for zotero without affecting any +other application using webdav. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo adduser webdav +sudo htpasswd -c /home/webdav/.htpasswd webdav +sudo htpasswd /home/webdav/.htpasswd zotero +sudo mkdir -p /home/webdav/dav/zotero +</code></pre></td></tr></table> +</div> +</div>Enable the site and restart apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo a2enmod webdav +sudo a2enmod dav_fs +sudo a2ensite webdav +sudo service apache2 restart +</code></pre></td></tr></table> +</div> +</div>At this point everything should be working at +<a class="link" href="http://" target="_blank" rel="noopener" +>http://</a><your_host>:880/dav/zotero +<h2 id="setting-up-nginx">Setting up NGINX +</h2>After the Apache side is working, we can use nginx as a proxy to get +cleaner URIs. In your desired site/location, add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-nginx" data-lang="nginx">location /dav { + client_max_body_size 20M; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $remote_addr; + proxy_set_header Host $host; + proxy_pass http://127.0.0.1:880; +} +</code></pre></td></tr></table> +</div> +</div>Now just reload nginx: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo service nginx force-reload +</code></pre></td></tr></table> +</div> +</div><h2 id="extras">Extras +</h2><ul> +<li><a class="link" href="http://zoteroreader.com/" target="_blank" rel="noopener" +>Zotero Reader</a> - HTML5 client</li> +<li><a class="link" href="https://github.com/ajlyon/zandy" target="_blank" rel="noopener" +>Zandy</a> - Android Open Source +client</li> +</ul>Proxies with Apache and pythonhttps://balkian.com/p/proxies-with-apache-and-python/Thu, 09 Oct 2014 10:00:00 +0000https://balkian.com/p/proxies-with-apache-and-python/This is a quick note on proxying a local python application (e.g. flask) +to a subdirectory in Apache. This assumes that the file wsgi.py contains +a WSGI application with the name application. Hence, wsgi:application. +<h2 id="gunicorn">Gunicorn +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + ProxyPass http://127.0.0.1:8888/myapp/ + ProxyPassReverse http://127.0.0.1:8888/myapp/ + RequestHeader set SCRIPT_NAME "/myapp/" +</Location> +</code></pre></td></tr></table> +</div> +</div>Important: SCRIPT_NAME and the end of ProxyPass URL MUST BE +THE SAME. Otherwise, Gunicorn will fail miserably. +Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">venv/bin/gunicorn -w 4 -b 127.0.0.1:8888 --log-file - --access-logfile - wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="uwsgi">UWSGI +</h2>This is a very simple configuration. I will try to upload one with more +options for uwsgi (in a .ini file). +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + SetHandler uwsgi_handler + uWSGISocker 127.0.0.1:8888 +</Location> +</code></pre></td></tr></table> +</div> +</div>Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">uwsgi --socket 127.0.0.1:8888 -w wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="extra-supervisor">Extra: Supervisor +</h2>If everything went as expected, you can wrap your command in a +supervisor config file and let it handle the server for you. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini">[unix_http_server] +file=/tmp/myapp.sock ; path to your socket file + +[supervisord] +logfile = %(here)s/logs/supervisor.log +childlogdir = %(here)s/logs/ + +[rpcinterface:supervisor] +supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface + +[supervisorctl] +logfile = %(here)s/logs/supervisorctl.log +serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket + +[program:myapp] +command = venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 --log-file %(here)s/logs/gunicorn.log --access-logfile - wsgi:application +directory = %(here)s +environment = PATH=%(here)s/venv/bin/ +logfile = %(here)s/logs/myapp.log +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/apache/page/1/index.html b/tags/apache/page/1/index.html new file mode 100644 index 0000000..e88dfd4 --- /dev/null +++ b/tags/apache/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/apache/ + \ No newline at end of file diff --git a/tags/arch/index.html b/tags/arch/index.html new file mode 100644 index 0000000..f25363b --- /dev/null +++ b/tags/arch/index.html @@ -0,0 +1,31 @@ +Tag: Arch - J. Fernando Sánchez +

1 page

Arch

Linux

\ No newline at end of file diff --git a/tags/arch/index.xml b/tags/arch/index.xml new file mode 100644 index 0000000..4fe6b36 --- /dev/null +++ b/tags/arch/index.xml @@ -0,0 +1,151 @@ +Arch on J. Fernando Sánchezhttps://balkian.com/tags/arch/Recent content in Arch on J. Fernando SánchezHugo -- gohugo.ioen-usLinuxhttps://balkian.com/linux/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/linux/<img src="https://balkian.com/img/linux.png" alt="Featured image of post Linux" /><h2 id="black-screen-and-lightdm-doesnt-unlock">Black screen and LightDM doesn’t unlock +</h2>Add this to your /etc/lightdm/lightdm.conf file: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[LightDM] +logind-check-graphical=true +</code></pre></td></tr></table> +</div> +</div>##Edit previous commands +<code>fc</code> is a shell builtin to list and edit previous commands in an editor. +In addition to editing a single line (which you can also do with <code>C-x C-e</code>), it also allows you to edit and run several lines at the same time. +You use it like this: +List previous commands +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -l +10259 nvim deploy.sh +10260* cd .. +10261* nvim content/cheatsheet/linux.md +10262 cd +</code></pre></td></tr></table> +</div> +</div>List commands with date (in zsh) +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -ld +10260* 19:38 cd .. +10261* 19:38 nvim content/cheatsheet/linux.md +10262 19:40 cd +10263 19:40 fc -l +</code></pre></td></tr></table> +</div> +</div>You can add the date too: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -fld +10262 1/10/2019 19:40 cd +10263 1/10/2019 19:40 fc -l +10264 1/10/2019 19:40 fc -ld +</code></pre></td></tr></table> +</div> +</div>You can edit a range of commands +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc 10262 10264 +</code></pre></td></tr></table> +</div> +</div>The range can be relative to the current position, so the previous command is equivalent to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -3 -1 +</code></pre></td></tr></table> +</div> +</div>If you save and exit, all commands are executed as a script, and it will be added to your history. +Source: <a class="link" href="https://shapeshed.com/unix-fc/" target="_blank" rel="noopener" +>https://shapeshed.com/unix-fc/</a> +<h2 id="prevent-logoff-from-killing-tmux-sessions">Prevent logoff from killing tmux sessions +</h2>Lately I’ve noticed that logging out of i3, intentionally or when i3 fails, would also kill any tmux or emacs sessions. +This is extremely annoying. +This is caused by a new default in logind (systemd’s login) to kill user process on logoff. +You can revert this setting in your logind.conf (<code>/etc/systemd/logind.conf</code>): +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">KillUserProcesses=no +</code></pre></td></tr></table> +</div> +</div>Or only for a specific process (e.g., tmux): +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">systemd-run --scope --user tmux +</code></pre></td></tr></table> +</div> +</div>Source: <a class="link" href="https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session" target="_blank" rel="noopener" +>https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session</a> +<h2 id="upload-a-temporary-file">Upload a temporary file +</h2>Sometimes you just need to copy/paste a file from a server, and copying from the terminal can be a hassle. +These two services are command-line “pastebins” just one curl away: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +8 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><command> | curl -F 'sprunge=<-' http://sprunge.us +# OR + +<command> 2>&1 | curl -F 'f:1=<-' ix.io + +# OR + +<command> | curl -F"file=@-" https://ttm.sh +</code></pre></td></tr></table> +</div> +</div><h1 id="install-fortinet-sslvpn-support-for-networkmanager">Install Fortinet SSLVPN support for NetworkManager +</h1>UPM (Universidad Politécnica de Madrid) uses a propriatary VPN solution. +The instructions for GNU/Linux on their website involve downloading a specific client (<code>.tar.gz</code>) and manually running it. +That works, but it is kind of a hassle. +A much more convenient alternative is installing this NetworkManager plugin: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">pacman -Sy networkmanager-fortisslvpn +# Or apt get install networkmanager-fortisslvpn +</code></pre></td></tr></table> +</div> +</div>Now you can simply add a new VPN connection in NetworkManager and manage it as you would any other connection. \ No newline at end of file diff --git a/tags/arch/page/1/index.html b/tags/arch/page/1/index.html new file mode 100644 index 0000000..1ed9e13 --- /dev/null +++ b/tags/arch/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/arch/ + \ No newline at end of file diff --git a/tags/config/index.html b/tags/config/index.html new file mode 100644 index 0000000..e73f144 --- /dev/null +++ b/tags/config/index.html @@ -0,0 +1,31 @@ +Tag: Config - J. Fernando Sánchez +

1 page

Config

Linux on the Microsoft Surface Go

\ No newline at end of file diff --git a/tags/config/index.xml b/tags/config/index.xml new file mode 100644 index 0000000..720364f --- /dev/null +++ b/tags/config/index.xml @@ -0,0 +1,80 @@ +Config on J. Fernando Sánchezhttps://balkian.com/tags/config/Recent content in Config on J. Fernando SánchezHugo -- gohugo.ioen-usSat, 01 Jun 2019 00:00:01 +0000Linux on the Microsoft Surface Gohttps://balkian.com/p/linux-on-the-microsoft-surface-go/Sat, 01 Jun 2019 00:00:01 +0000https://balkian.com/p/linux-on-the-microsoft-surface-go/Believe it or not, Surface tablets have pretty good linux support, except for the webcams in newer models. +These are some useful notes to get Ubuntu installed in your surface go, as of Summer 2019. +<h2 id="installing-the-kernel">Installing the kernel +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">git clone --depth 1 https://github.com/jakeday/linux-surface.git ~/linux-surface +cp -a ~/linux-surface /media/<your usb> +</code></pre></td></tr></table> +</div> +</div><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">cp -a /media/<your usb>/linux-surface ~/ +cd ~/linux-surface/ +sudo sh setup.sh +</code></pre></td></tr></table> +</div> +</div><h2 id="booting-ubuntu-first">Booting ubuntu first +</h2>Switch out of Windows S mode. +Boot into the “Command Prompt”. +From Windows go to “change advanced startup options” and select “restart now”. +When it reboots, choose the “Troubleshoot” option, then choose the “Advanced options” option, and finally choose the “Command Prompt” option. +After the device reboots, login to the command prompt and then you should see a terminal with X:\windows\system32> +At the prompt, check your UEFI entries: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /enum firmware +</code></pre></td></tr></table> +</div> +</div>Copy UEFI entry of “Windows Boot Manager” to create a new entry for Ubuntu: bcdedit /copy {bootmgr} /d “Ubuntu” +Copy the printed GUID number including the braces {} using Ctrl+C +Set file path for the new Ubuntu entry. Replace {guid} with the returned GUID of the previous command (Ctrl+V). bcdedit /set {guid} path \EFI\ubuntu\grubx64.efi +Set Ubuntu as the first/ entry in the boot sequence. Again replace {guid} with the returned GUID of the copy command. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /set {fwbootmgr} displayorder {guid} /addfirst +</code></pre></td></tr></table> +</div> +</div>Check your UEFI entries again: bcdedit /enum firmware You should see something like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"> +Firmware Boot Manager +--------------------- +identifier {fwbootmgr} +displayorder {3510232e-f8eb-e811-95ce-9ecab3f9d1c4} + {bootmgr} + {2148799b-f8eb-e811-95ce-9ecab3f9d1c4} + {312e8a67-c2f6-e811-95ce-3c1ab3f9d1de} + {312e8a68-c2f6-e811-95ce-3c1ab3f9d1de} +timeout 0 +</code></pre></td></tr></table> +</div> +</div>Make sure the GUID you copied is the first one listed in displayorder. Then type exit, turn off the PC and turn it back on. After this my surface go is automatically booting to the grub bootloader which lets me choose between Windows and Ubuntu but defaults to Ubuntu after ten seconds. \ No newline at end of file diff --git a/tags/config/page/1/index.html b/tags/config/page/1/index.html new file mode 100644 index 0000000..69d923e --- /dev/null +++ b/tags/config/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/config/ + \ No newline at end of file diff --git a/tags/dotfiles/index.html b/tags/dotfiles/index.html new file mode 100644 index 0000000..21c08f5 --- /dev/null +++ b/tags/dotfiles/index.html @@ -0,0 +1,31 @@ +Tag: Dotfiles - J. Fernando Sánchez +

1 page

Dotfiles

Sharing dotfiles

\ No newline at end of file diff --git a/tags/dotfiles/index.xml b/tags/dotfiles/index.xml new file mode 100644 index 0000000..57ed4c5 --- /dev/null +++ b/tags/dotfiles/index.xml @@ -0,0 +1,39 @@ +Dotfiles on J. Fernando Sánchezhttps://balkian.com/tags/dotfiles/Recent content in Dotfiles on J. Fernando SánchezHugo -- gohugo.ioen-usFri, 10 Apr 2015 17:47:00 +0000Sharing dotfileshttps://balkian.com/p/sharing-dotfiles/Fri, 10 Apr 2015 17:47:00 +0000https://balkian.com/p/sharing-dotfiles/Today’s post is half a quick note, half public shaming. In other words, +it is a reminder to be very careful with OAuth tokens and passwords. +As part of moving to emacs, I starting using the incredibly useful +<a class="link" href="https://github.com/defunkt/gist.el" target="_blank" rel="noopener" +>gh.el</a>. When you first use it, the +extension saves either your password or an OAuth token in your +.gitconfig file. This is cool and convenient, unless you <a class="link" href="https://github.com/balkian/dotfiles" target="_blank" rel="noopener" +>happen to be +publishing your .gitconfig file in a public +repo</a>. +So, how can you still share your gitconfig without sharing your +password/token with the rest of the world? Since Git 1.7.0, you can +<a class="link" href="http://stackoverflow.com/questions/1557183/is-it-possible-to-include-a-file-in-your-gitconfig" target="_blank" rel="noopener" +>include other files in your +gitconfig</a>. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">[include] + path = ~/.gitconfig_secret +</code></pre></td></tr></table> +</div> +</div>And now, in your .gitconfig_secret file, you just have to add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">[github] + user = balkian + token = "< Your secret token >" +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/dotfiles/page/1/index.html b/tags/dotfiles/page/1/index.html new file mode 100644 index 0000000..c3babd8 --- /dev/null +++ b/tags/dotfiles/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/dotfiles/ + \ No newline at end of file diff --git a/tags/emacs/index.html b/tags/emacs/index.html new file mode 100644 index 0000000..df5e498 --- /dev/null +++ b/tags/emacs/index.html @@ -0,0 +1,31 @@ +Tag: Emacs - J. Fernando Sánchez +

1 page

Emacs

\ No newline at end of file diff --git a/tags/emacs/index.xml b/tags/emacs/index.xml new file mode 100644 index 0000000..e414e22 --- /dev/null +++ b/tags/emacs/index.xml @@ -0,0 +1,10 @@ +Emacs on J. Fernando Sánchezhttps://balkian.com/tags/emacs/Recent content in Emacs on J. Fernando SánchezHugo -- gohugo.ioen-usEmacshttps://balkian.com/emacs/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/emacs/<img src="https://balkian.com/img/emacs.png" alt="Featured image of post Emacs" /><h2 id="show-plain-text-version">Show plain text version +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(font-lock-mode) +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/emacs/page/1/index.html b/tags/emacs/page/1/index.html new file mode 100644 index 0000000..a2fa578 --- /dev/null +++ b/tags/emacs/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/emacs/ + \ No newline at end of file diff --git a/tags/git/index.html b/tags/git/index.html new file mode 100644 index 0000000..e87179f --- /dev/null +++ b/tags/git/index.html @@ -0,0 +1,31 @@ +Tag: Git - J. Fernando Sánchez +

3 pages

Git

Sharing dotfiles

Remove git files with globbing

Creating my web

\ No newline at end of file diff --git a/tags/git/index.xml b/tags/git/index.xml new file mode 100644 index 0000000..9ede261 --- /dev/null +++ b/tags/git/index.xml @@ -0,0 +1,96 @@ +Git on J. Fernando Sánchezhttps://balkian.com/tags/git/Recent content in Git on J. Fernando SánchezHugo -- gohugo.ioen-usFri, 10 Apr 2015 17:47:00 +0000Sharing dotfileshttps://balkian.com/p/sharing-dotfiles/Fri, 10 Apr 2015 17:47:00 +0000https://balkian.com/p/sharing-dotfiles/Today’s post is half a quick note, half public shaming. In other words, +it is a reminder to be very careful with OAuth tokens and passwords. +As part of moving to emacs, I starting using the incredibly useful +<a class="link" href="https://github.com/defunkt/gist.el" target="_blank" rel="noopener" +>gh.el</a>. When you first use it, the +extension saves either your password or an OAuth token in your +.gitconfig file. This is cool and convenient, unless you <a class="link" href="https://github.com/balkian/dotfiles" target="_blank" rel="noopener" +>happen to be +publishing your .gitconfig file in a public +repo</a>. +So, how can you still share your gitconfig without sharing your +password/token with the rest of the world? Since Git 1.7.0, you can +<a class="link" href="http://stackoverflow.com/questions/1557183/is-it-possible-to-include-a-file-in-your-gitconfig" target="_blank" rel="noopener" +>include other files in your +gitconfig</a>. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">[include] + path = ~/.gitconfig_secret +</code></pre></td></tr></table> +</div> +</div>And now, in your .gitconfig_secret file, you just have to add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">[github] + user = balkian + token = "< Your secret token >" +</code></pre></td></tr></table> +</div> +</div>Remove git files with globbinghttps://balkian.com/p/remove-git-files-with-globbing/Thu, 22 Aug 2013 23:14:00 +0000https://balkian.com/p/remove-git-files-with-globbing/A simple trick. If you want to remove all the ‘.swp’ files from a git +repository, just use: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git rm --cached '**.swp' +</code></pre></td></tr></table> +</div> +</div>Creating my webhttps://balkian.com/p/creating-my-web/Thu, 22 Aug 2013 14:14:22 +0000https://balkian.com/p/creating-my-web/I’ve finally decided to set up a decent personal page. I have settled +for github-pages because I like the idea of keeping my site in a +repository and having someone else host and deploy it for me. The site +will be really simple, mostly static files. Thanks to Github, +<a class="link" href="http://jekyllrb.com" target="_blank" rel="noopener" +>Jekyll</a> will automatically generate static pages +for my posts every time I commit anything new to this repository. +But Jekyll can be used independently, so if I ever choose to host the +site myself, I can do it quite easily. Another thing that I liked about +this approach is that the generated html files can be used in the +future, and I will not need Jekyll to serve it. Jekyll is really simple +and most of the things are written in plain html. That means that +everything could be easily reused if I ever choose to change to another +blogging framework (e.g. pelical). But, for the time being, I like the +fact that Github takes care of the compilation as well, so I can simply +modify or add files through the web interface should I need to. +I hadn’t played with HTML and CSS for a while now, so I also wanted to +use this site as a playground. At some point, I realised I was doing +mostly everything in plain HTML and CSS, and decided to keep it like +that for as long as possible. As of this writing, I haven’t included +any Javascript code in the page. Probably I will use some to add my +<a class="link" href="http://gist.github.com/balkian" target="_blank" rel="noopener" +>gists</a> and +<a class="link" href="http://github.com/balkian" target="_blank" rel="noopener" +>repositories</a>, but we will see about that. +I think the code speaks for itself, so you can check out <a class="link" href="http://github.com/balkian/balkian.github.com" target="_blank" rel="noopener" +>my repository +on Github</a>. You can clone +and deploy it easily like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git clone +https://github.com/balkian/balkian.github.com cd balkian.github.com +jekyll serve -w +</code></pre></td></tr></table> +</div> +</div>I will keep updating this post with information about: +<ul> +<li>Some Jekyll plugins that might be useful</li> +<li>What CSS tricks I learnt</li> +<li>The webfonts I used</li> +<li>The badge on the left side of the page</li> +</ul> \ No newline at end of file diff --git a/tags/git/page/1/index.html b/tags/git/page/1/index.html new file mode 100644 index 0000000..c2c6727 --- /dev/null +++ b/tags/git/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/git/ + \ No newline at end of file diff --git a/tags/github/index.html b/tags/github/index.html new file mode 100644 index 0000000..87c2e35 --- /dev/null +++ b/tags/github/index.html @@ -0,0 +1,31 @@ +Tag: Github - J. Fernando Sánchez +

3 pages

Github

Sharing dotfiles

Publishing on PyPi

Creating my web

\ No newline at end of file diff --git a/tags/github/index.xml b/tags/github/index.xml new file mode 100644 index 0000000..61752ed --- /dev/null +++ b/tags/github/index.xml @@ -0,0 +1,247 @@ +Github on J. Fernando Sánchezhttps://balkian.com/tags/github/Recent content in Github on J. Fernando SánchezHugo -- gohugo.ioen-usFri, 10 Apr 2015 17:47:00 +0000Sharing dotfileshttps://balkian.com/p/sharing-dotfiles/Fri, 10 Apr 2015 17:47:00 +0000https://balkian.com/p/sharing-dotfiles/Today’s post is half a quick note, half public shaming. In other words, +it is a reminder to be very careful with OAuth tokens and passwords. +As part of moving to emacs, I starting using the incredibly useful +<a class="link" href="https://github.com/defunkt/gist.el" target="_blank" rel="noopener" +>gh.el</a>. When you first use it, the +extension saves either your password or an OAuth token in your +.gitconfig file. This is cool and convenient, unless you <a class="link" href="https://github.com/balkian/dotfiles" target="_blank" rel="noopener" +>happen to be +publishing your .gitconfig file in a public +repo</a>. +So, how can you still share your gitconfig without sharing your +password/token with the rest of the world? Since Git 1.7.0, you can +<a class="link" href="http://stackoverflow.com/questions/1557183/is-it-possible-to-include-a-file-in-your-gitconfig" target="_blank" rel="noopener" +>include other files in your +gitconfig</a>. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">[include] + path = ~/.gitconfig_secret +</code></pre></td></tr></table> +</div> +</div>And now, in your .gitconfig_secret file, you just have to add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">[github] + user = balkian + token = "< Your secret token >" +</code></pre></td></tr></table> +</div> +</div>Publishing on PyPihttps://balkian.com/p/publishing-on-pypi/Sat, 27 Sep 2014 10:00:00 +0000https://balkian.com/p/publishing-on-pypi/Developing a python module and publishing it on Github is cool, but most +of the times you want others to download and use it easily. That is the +role of PyPi, the python package repository. In this post I show you how +to publish your package in less than 10 minutes. +<h2 id="choose-a-fancy-name">Choose a fancy name +</h2>If you haven’t done so yet, take a minute or two to think about this. +To publish on PyPi you need a name for your package that isn’t taken. +What’s more, a catchy and unique name will help people remember your +module and feel more inclined to at least try it. +The package name should hint what your module does, but that’s not +always the case. That’s your call. I personally put uniqueness and +memorability over describing the functionality. +<h2 id="create-a-pypirc-configuration-file">Create a .pypirc configuration file +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[distutils] # this tells distutils what package indexes you can push to +index-servers = + pypi # the live PyPI + pypitest # test PyPI + +[pypi] # authentication details for live PyPI +repository = https://pypi.python.org/pypi +username = { your_username } +password = { your_password } # not necessary + +[pypitest] # authentication details for test PyPI +repository = https://testpypi.python.org/pypi +username = { your_username } +</code></pre></td></tr></table> +</div> +</div>As you can see, you need to register both in the <a class="link" href="https://pypi.python.org/pypi?%3Aaction=register_form" target="_blank" rel="noopener" +>main pypi +repository</a> and +the <a class="link" href="https://testpypi.python.org/pypi?%3Aaction=register_form" target="_blank" rel="noopener" +>testing +server</a>. The +usernames and passwords might be different, that is up to you! +<h2 id="prepare-your-package">Prepare your package +</h2>This should be the structure: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">root-dir/ # Any name you want + setup.py + setup.cfg + LICENSE.txt + README.md + mypackage/ + __init__.py + foo.py + bar.py + baz.py +</code></pre></td></tr></table> +</div> +</div><h3 id="setupcfg">setup.cfg +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[metadata] +description-file = README.md +</code></pre></td></tr></table> +</div> +</div>The markdown README is the de facto standard in Github, but you can +also use rST (reStructuredText), the standard in the python community. +<h3 id="setuppy">setup.py +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from distutils.core import setup + +setup(name = 'mypackage', + packages = ['mypackage'], # this must be the same as the name above + version = '{ version }', + description = '{ description }', + author = '{ name }', + email = '{ email }', + url = 'https://github.com/{user}/{package}', # URL to the github repo + download_url = 'https://github.com/{user}/{repo}/tarball/{version}', + keywords = ['websockets', 'display', 'd3'], # list of keywords that represent your package + classifiers = [], ) +</code></pre></td></tr></table> +</div> +</div>You might notice that the download_url points to a Github URL. We could +host our package anywhere, but Github is a convenient option. To create +the tarball and the zip packages, you only need to tag a tag in your +repository and push it to github: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git tag {version} -m "{ Description of this tag/version}" +git push --tags origin master +</code></pre></td></tr></table> +</div> +</div><h2 id="push-to-the-testingmain-pypi-server">Push to the testing/main pypi server +</h2>It is advisable that you try your package on the test repository and fix +any problems first. The process is simple: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">python setup.py register -r {pypitest/pypi} python setup.py sdist upload -r {pypitest/pypi} +</code></pre></td></tr></table> +</div> +</div>If everything went as expected, you can now install your package through +pip and browse your package’s page. For instance, check my senpy +package: <a class="link" href="https://pypi.python.org/pypi/senpy" target="_blank" rel="noopener" +>https://pypi.python.org/pypi/senpy</a> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">pip install senpy +</code></pre></td></tr></table> +</div> +</div>Creating my webhttps://balkian.com/p/creating-my-web/Thu, 22 Aug 2013 14:14:22 +0000https://balkian.com/p/creating-my-web/I’ve finally decided to set up a decent personal page. I have settled +for github-pages because I like the idea of keeping my site in a +repository and having someone else host and deploy it for me. The site +will be really simple, mostly static files. Thanks to Github, +<a class="link" href="http://jekyllrb.com" target="_blank" rel="noopener" +>Jekyll</a> will automatically generate static pages +for my posts every time I commit anything new to this repository. +But Jekyll can be used independently, so if I ever choose to host the +site myself, I can do it quite easily. Another thing that I liked about +this approach is that the generated html files can be used in the +future, and I will not need Jekyll to serve it. Jekyll is really simple +and most of the things are written in plain html. That means that +everything could be easily reused if I ever choose to change to another +blogging framework (e.g. pelical). But, for the time being, I like the +fact that Github takes care of the compilation as well, so I can simply +modify or add files through the web interface should I need to. +I hadn’t played with HTML and CSS for a while now, so I also wanted to +use this site as a playground. At some point, I realised I was doing +mostly everything in plain HTML and CSS, and decided to keep it like +that for as long as possible. As of this writing, I haven’t included +any Javascript code in the page. Probably I will use some to add my +<a class="link" href="http://gist.github.com/balkian" target="_blank" rel="noopener" +>gists</a> and +<a class="link" href="http://github.com/balkian" target="_blank" rel="noopener" +>repositories</a>, but we will see about that. +I think the code speaks for itself, so you can check out <a class="link" href="http://github.com/balkian/balkian.github.com" target="_blank" rel="noopener" +>my repository +on Github</a>. You can clone +and deploy it easily like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git clone +https://github.com/balkian/balkian.github.com cd balkian.github.com +jekyll serve -w +</code></pre></td></tr></table> +</div> +</div>I will keep updating this post with information about: +<ul> +<li>Some Jekyll plugins that might be useful</li> +<li>What CSS tricks I learnt</li> +<li>The webfonts I used</li> +<li>The badge on the left side of the page</li> +</ul> \ No newline at end of file diff --git a/tags/github/page/1/index.html b/tags/github/page/1/index.html new file mode 100644 index 0000000..48b370f --- /dev/null +++ b/tags/github/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/github/ + \ No newline at end of file diff --git a/tags/gunicorn/index.html b/tags/gunicorn/index.html new file mode 100644 index 0000000..d4f7d5d --- /dev/null +++ b/tags/gunicorn/index.html @@ -0,0 +1,31 @@ +Tag: Gunicorn - J. Fernando Sánchez +

1 page

Gunicorn

Proxies with Apache and python

\ No newline at end of file diff --git a/tags/gunicorn/index.xml b/tags/gunicorn/index.xml new file mode 100644 index 0000000..77cc49e --- /dev/null +++ b/tags/gunicorn/index.xml @@ -0,0 +1,105 @@ +Gunicorn on J. Fernando Sánchezhttps://balkian.com/tags/gunicorn/Recent content in Gunicorn on J. Fernando SánchezHugo -- gohugo.ioen-usThu, 09 Oct 2014 10:00:00 +0000Proxies with Apache and pythonhttps://balkian.com/p/proxies-with-apache-and-python/Thu, 09 Oct 2014 10:00:00 +0000https://balkian.com/p/proxies-with-apache-and-python/This is a quick note on proxying a local python application (e.g. flask) +to a subdirectory in Apache. This assumes that the file wsgi.py contains +a WSGI application with the name application. Hence, wsgi:application. +<h2 id="gunicorn">Gunicorn +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + ProxyPass http://127.0.0.1:8888/myapp/ + ProxyPassReverse http://127.0.0.1:8888/myapp/ + RequestHeader set SCRIPT_NAME "/myapp/" +</Location> +</code></pre></td></tr></table> +</div> +</div>Important: SCRIPT_NAME and the end of ProxyPass URL MUST BE +THE SAME. Otherwise, Gunicorn will fail miserably. +Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">venv/bin/gunicorn -w 4 -b 127.0.0.1:8888 --log-file - --access-logfile - wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="uwsgi">UWSGI +</h2>This is a very simple configuration. I will try to upload one with more +options for uwsgi (in a .ini file). +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + SetHandler uwsgi_handler + uWSGISocker 127.0.0.1:8888 +</Location> +</code></pre></td></tr></table> +</div> +</div>Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">uwsgi --socket 127.0.0.1:8888 -w wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="extra-supervisor">Extra: Supervisor +</h2>If everything went as expected, you can wrap your command in a +supervisor config file and let it handle the server for you. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini">[unix_http_server] +file=/tmp/myapp.sock ; path to your socket file + +[supervisord] +logfile = %(here)s/logs/supervisor.log +childlogdir = %(here)s/logs/ + +[rpcinterface:supervisor] +supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface + +[supervisorctl] +logfile = %(here)s/logs/supervisorctl.log +serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket + +[program:myapp] +command = venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 --log-file %(here)s/logs/gunicorn.log --access-logfile - wsgi:application +directory = %(here)s +environment = PATH=%(here)s/venv/bin/ +logfile = %(here)s/logs/myapp.log +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/gunicorn/page/1/index.html b/tags/gunicorn/page/1/index.html new file mode 100644 index 0000000..2fc5d94 --- /dev/null +++ b/tags/gunicorn/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/gunicorn/ + \ No newline at end of file diff --git a/tags/heroku/index.html b/tags/heroku/index.html new file mode 100644 index 0000000..d6c93de --- /dev/null +++ b/tags/heroku/index.html @@ -0,0 +1,31 @@ +Tag: Heroku - J. Fernando Sánchez +

1 page

Heroku

Updating EuroLoveMap

\ No newline at end of file diff --git a/tags/heroku/index.xml b/tags/heroku/index.xml new file mode 100644 index 0000000..b62f8cb --- /dev/null +++ b/tags/heroku/index.xml @@ -0,0 +1,135 @@ +Heroku on J. Fernando Sánchezhttps://balkian.com/tags/heroku/Recent content in Heroku on J. Fernando SánchezHugo -- gohugo.ioen-usThu, 27 Mar 2014 14:00:00 +0000Updating EuroLoveMaphttps://balkian.com/p/updating-eurolovemap/Thu, 27 Mar 2014 14:00:00 +0000https://balkian.com/p/updating-eurolovemap/As part of the <a class="link" href="http://www.opener-project.org/2013/07/18/opener-hackathon-in-amsterdam/" target="_blank" rel="noopener" +>OpeNER +hackathon</a> +we decided to build a prototype that would allow us to compare how +different countries feel about several topics. We used the OpeNER +pipeline to get the sentiment from a set of newspaper articles we +gathered from media in several languages. Then we aggregated those +articles by category and country (using the source of the article or the +language it was written in), obtaining the “overall feeling” of each +country about each topic. Then, we used some fancy JavaScript to make +sense out of the raw information. +It didn’t go too bad, it turns out <a class="link" href="http://eurosentiment.eu/wp-content/uploads/2013/07/BOLv9qnCIAAJEek.jpg" target="_blank" rel="noopener" +>we +won</a>. +Now, it was time for a face-lift. I used this opportunity to play with +new technologies and improve it: +<ul> +<li>Using Flask, this time using python 3.3 and Bootstrap 3.0</li> +<li>Cool HTML5+JS cards (thanks to +<a class="link" href="http://pastetophone.com" target="_blank" rel="noopener" +>pastetophone</a>)</li> +<li>Automatic generation of fake personal data to test the interface</li> +<li>Obfuscation of personal emails</li> +</ul> +The result can be <a class="link" href="http://eurolovemap.herokuapp.com/" target="_blank" rel="noopener" +>seen here</a>. +<h2 id="publishing-a-python-3-app-on-heroku">Publishing a Python 3 app on Heroku +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">mkvirtualenv -p /usr/bin/python3.3 eurolovemap +</code></pre></td></tr></table> +</div> +</div>Since Heroku uses python 2.7 by default, we have to tell it which +version we want, although it supports python 3.4 as well. I couldn’t +get python 3.4 working using the +<a class="link" href="https://launchpad.net/~fkrull/+archive/deadsnakes" target="_blank" rel="noopener" +>deadsnakes</a> ppa, so +I used python 3.3 instead, which works fine but is not officially +supported. Just create a file named runtime.txt in your project root, +with the python version you want to use: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">python-3.3.1 +</code></pre></td></tr></table> +</div> +</div>Don’t forget to freeze your dependencies so Heroku can install them: +<code>bash pip freze > requirements.txt</code> +<h2 id="publishing-personal-emails">Publishing personal emails +</h2>There are really sophisticated and effective ways to obfuscate personal +emails so that spammers cannot easily grab yours. However, this time I +needed something really simple to hide our emails from the simplest form +of crawlers. Most of the team are in academia somehow, so in the end all +our emails are available in sites like Google Scholar. Anyway, nobody +likes getting spammed so I settled for a custom <a class="link" href="http://en.wikipedia.org/wiki/Caesar_cipher" target="_blank" rel="noopener" +>Caesar +cipher</a>. Please, don’t use +it for any serious application if you are concerned about being spammed. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">def blur_email(email): + return "".join([chr(ord(i)+5) for i in email]) +</code></pre></td></tr></table> +</div> +</div>And this is the client side: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-javascript" data-lang="javascript">window.onload = function(){ + elems = document.getElementsByClassName('profile-email'); + for(var e in elems){ + var blur = elems[e].innerHTML; + var email = ""; + for(var s in blur){ + var a = blur.charCodeAt(s) + email = email+String.fromCharCode(a-5); + } + elems[e].innerHTML = email; + } +} +</code></pre></td></tr></table> +</div> +</div>Unfortunately, this approach does not hide your email from anyone using +<a class="link" href="http://phantomjs.org/" target="_blank" rel="noopener" +>PhantomJS</a>, +<a class="link" href="http://zombie.labnotes.org/" target="_blank" rel="noopener" +>ZombieJS</a> or similar. For that, other +approaches like generating a picture with the address would be +necessary. Nevertheless, it is overkill for a really simple ad-hoc +application with custom formatting and just a bunch of emails that would +easily be grabbed manually. +<h2 id="generation-of-fake-data">Generation of fake data +</h2>To test the contact section of the site, I wanted to populate it with +fake data. <a class="link" href="https://github.com/joke2k/faker" target="_blank" rel="noopener" +>Fake-Factory</a> is an amazing +library that can generate fake data of almost any kind: emails, +association names, acronyms… It even lets you localise the results +(get Spanish names, for instance) and generate factories for certain +classes (à la Django). +But I also wanted pictures, enter <a class="link" href="http://lorempixel.com/" target="_blank" rel="noopener" +>Lorem Pixel</a>. +With its API you can generate pictures of almost any size, for different +topics (e.g. nightlife, people) and with a custom text. You can even use +an index, so it will always show the same picture. +For instance, the picture below is served through Lorem Pixel. +<img src="http://lorempixel.com/400/200/nightlife/" +loading="lazy" +> +By the way, if you only want cat pictures, take a look at +<a class="link" href="http://placekitten.com/" target="_blank" rel="noopener" +>Placekitten</a>. And for NSFW text, there’s the +<a class="link" href="http://slipsum.com/" target="_blank" rel="noopener" +>Samuel L. Jackson Ipsum</a> \ No newline at end of file diff --git a/tags/heroku/page/1/index.html b/tags/heroku/page/1/index.html new file mode 100644 index 0000000..eb35a19 --- /dev/null +++ b/tags/heroku/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/heroku/ + \ No newline at end of file diff --git a/tags/index.html b/tags/index.html new file mode 100644 index 0000000..dcdfd56 --- /dev/null +++ b/tags/index.html @@ -0,0 +1,34 @@ +Tags +

Section

35 pages

Tags

Python

Nix

Keyboard

Layout

Linux

\ No newline at end of file diff --git a/tags/index.xml b/tags/index.xml new file mode 100644 index 0000000..2b19ccb --- /dev/null +++ b/tags/index.xml @@ -0,0 +1 @@ +Tags on J. Fernando Sánchezhttps://balkian.com/tags/Recent content in Tags on J. Fernando SánchezHugo -- gohugo.ioen-usMon, 17 Feb 2025 23:02:47 +0100Pythonhttps://balkian.com/tags/python/Mon, 17 Feb 2025 23:02:47 +0100https://balkian.com/tags/python/Nixhttps://balkian.com/tags/nix/Mon, 13 Nov 2023 18:21:46 +0100https://balkian.com/tags/nix/Keyboardhttps://balkian.com/tags/keyboard/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/tags/keyboard/Layouthttps://balkian.com/tags/layout/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/tags/layout/Linuxhttps://balkian.com/tags/linux/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/tags/linux/Logitechhttps://balkian.com/tags/logitech/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/tags/logitech/Rusthttps://balkian.com/tags/rust/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/tags/rust/Mousehttps://balkian.com/tags/mouse/Sat, 30 Oct 2021 00:00:01 +0000https://balkian.com/tags/mouse/Confighttps://balkian.com/tags/config/Sat, 01 Jun 2019 00:00:01 +0000https://balkian.com/tags/config/Surface Gohttps://balkian.com/tags/surface-go/Sat, 01 Jun 2019 00:00:01 +0000https://balkian.com/tags/surface-go/Iothttps://balkian.com/tags/iot/Sun, 06 Jan 2019 10:00:00 +0000https://balkian.com/tags/iot/Mqtthttps://balkian.com/tags/mqtt/Sun, 06 Jan 2019 10:00:00 +0000https://balkian.com/tags/mqtt/Zigbeehttps://balkian.com/tags/zigbee/Sun, 06 Jan 2019 10:00:00 +0000https://balkian.com/tags/zigbee/Dotfileshttps://balkian.com/tags/dotfiles/Fri, 10 Apr 2015 17:47:00 +0000https://balkian.com/tags/dotfiles/Githttps://balkian.com/tags/git/Fri, 10 Apr 2015 17:47:00 +0000https://balkian.com/tags/git/Githubhttps://balkian.com/tags/github/Fri, 10 Apr 2015 17:47:00 +0000https://balkian.com/tags/github/Apachehttps://balkian.com/tags/apache/Tue, 09 Dec 2014 12:12:12 +0000https://balkian.com/tags/apache/Nginxhttps://balkian.com/tags/nginx/Tue, 09 Dec 2014 12:12:12 +0000https://balkian.com/tags/nginx/Webdavhttps://balkian.com/tags/webdav/Tue, 09 Dec 2014 12:12:12 +0000https://balkian.com/tags/webdav/Zoterohttps://balkian.com/tags/zotero/Tue, 09 Dec 2014 12:12:12 +0000https://balkian.com/tags/zotero/Gunicornhttps://balkian.com/tags/gunicorn/Thu, 09 Oct 2014 10:00:00 +0000https://balkian.com/tags/gunicorn/Proxyhttps://balkian.com/tags/proxy/Thu, 09 Oct 2014 10:00:00 +0000https://balkian.com/tags/proxy/Uwsgihttps://balkian.com/tags/uwsgi/Thu, 09 Oct 2014 10:00:00 +0000https://balkian.com/tags/uwsgi/Pypihttps://balkian.com/tags/pypi/Sat, 27 Sep 2014 10:00:00 +0000https://balkian.com/tags/pypi/Herokuhttps://balkian.com/tags/heroku/Thu, 27 Mar 2014 14:00:00 +0000https://balkian.com/tags/heroku/Javascripthttps://balkian.com/tags/javascript/Thu, 27 Mar 2014 14:00:00 +0000https://balkian.com/tags/javascript/Rubyhttps://balkian.com/tags/ruby/Thu, 22 Aug 2013 14:14:22 +0000https://balkian.com/tags/ruby/Startershttps://balkian.com/tags/starters/Thu, 22 Aug 2013 14:14:22 +0000https://balkian.com/tags/starters/Archhttps://balkian.com/tags/arch/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/tags/arch/Emacshttps://balkian.com/tags/emacs/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/tags/emacs/Lisphttps://balkian.com/tags/lisp/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/tags/lisp/Orghttps://balkian.com/tags/org/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/tags/org/Productivityhttps://balkian.com/tags/productivity/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/tags/productivity/Programminghttps://balkian.com/tags/programming/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/tags/programming/Rpihttps://balkian.com/tags/rpi/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/tags/rpi/ \ No newline at end of file diff --git a/tags/iot/index.html b/tags/iot/index.html new file mode 100644 index 0000000..822d17e --- /dev/null +++ b/tags/iot/index.html @@ -0,0 +1,31 @@ +Tag: Iot - J. Fernando Sánchez +

Tags

1 page

Iot

Controlling Zigbee devices with MQTT

\ No newline at end of file diff --git a/tags/iot/index.xml b/tags/iot/index.xml new file mode 100644 index 0000000..488edba --- /dev/null +++ b/tags/iot/index.xml @@ -0,0 +1,132 @@ +Iot on J. Fernando Sánchezhttps://balkian.com/tags/iot/Recent content in Iot on J. Fernando SánchezHugo -- gohugo.ioen-usSun, 06 Jan 2019 10:00:00 +0000Controlling Zigbee devices with MQTThttps://balkian.com/p/controlling-zigbee-devices-with-mqtt/Sun, 06 Jan 2019 10:00:00 +0000https://balkian.com/p/controlling-zigbee-devices-with-mqtt/This is a short tutorial on connecting a zigbee device (an Aqara cube) +to an MQTT server, so you can control your zigbee devices from the +network. +If you’re anything like me, you’re probably a sucker for IoT devices. +For a long time, I’ve been using WiFi-enabled lights, and Amazon dash +buttons to control them. To keep these (cheap Chinese) internet enabled +devices away from your network and their respective cloud services, +you’ll probably want to set up a dedicated network in your router (more +on this on a future post, maybe). Another disadvantage of WiFi devices +is that they’re relatively power hungry. +A popular alternative is using ZigBee for communication. It is a +dedicated protocol similar to bluetooth (BLE), with lower power +requirements and bitrate. +Take the (super cute) aqara cube as an example. It is a small cube that +detects rotation on all of its axes, and tapping events. Here’s a +video: +<div class="video-wrapper"> +<iframe loading="lazy" +src="https://www.youtube.com/embed/5YtqG1wEnng" +allowfullscreen +title="YouTube Video" +> +</iframe> +</div> +To connect to zigbee devices you will need a zigbee enabled gateway +(a.k.a. hub), which connects to your WiFi network and your zigbee +devices. Once again, this means adding an internet-enabled device to +your home, and probably a couple of cloud services. +As an alternative, you can set up your own zigbee gateway, and control +it to your home automation platform of choice (e.g. home assistant). We +will cover how to set up a zigbee2mqtt gateway that is also connected to +an MQTT server, so you can use MQTT to control your devices and get +notifications. +What you need: +<ul> +<li><a class="link" href="https://www.aliexpress.com/item/Original-Xiaomi-Mi-Aqara-Cube-Smart-Home-Controller-6-Action-Operation-Fr-Home-Device-Zigbee-Version/32892947622.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>Aqara +cube</a>.</li> +<li><a class="link" href="https://www.aliexpress.com/item/Wireless-Zigbee-CC2531-CC2540-Zigbee-Sniffer-Bluetooth-BLE-4-0-Dongle-Capture-Module-USB-Programmer-Downloader/32907587711.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>CC2531 zigbee +sniffer</a>.</li> +<li><a class="link" href="https://www.aliexpress.com/item/CFSUNBIRD-CC-DEBUGGER-Debugger-and-Programmer-for-RF-System-on-Chips-TI-ORIGINAL-Fast-hipping/32813122315.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>CC-debugger</a>.</li> +</ul> +You will need to flash your sniffer. For that, you only need to follow +the instructions from the <a class="link" href="https://koenkk.github.io/zigbee2mqtt/" target="_blank" rel="noopener" +>zigbee2mqtt +documentation</a>. +Once you’re done flashing, you’re ready to set up the zigbee2mqtt +server. For convenience, I wrote a simple docker-compose to deploy a +zigbee2mqtt server and a test mosquitto server: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">version: '2.1' +services: + zigbee2mqtt: + image: koenkk/zigbee2mqtt + container_name: zigbee2mqtt + restart: always + volumes: + - ./z2m-data/:/app/data/ + devices: + - "/dev/ttyACM0" + networks: + - hass + mqtt: + image: eclipse-mosquitto + ports: + - 1883:1883 + - 9001:9001 + networks: + - hass + volumes: + - ./mosquitto.conf:/mosquitto/config/mosquitto.conf +networks: + hass: + driver: overlay +</code></pre></td></tr></table> +</div> +</div>You can test your installation with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">❯ mosquitto_sub -h localhost -p 1883 -t 'zigbee2mqtt/#' +online +{"battery":17,"voltage":2925,"linkquality":149,"action":"rotate_right","angle":12.8} +{"battery":17,"voltage":2925,"linkquality":141,"action":"slide","side":2} +{"battery":17,"voltage":2925,"linkquality":120} +{"battery":17,"voltage":2925,"linkquality":141,"action":"wakeup"}</code></pre></td></tr></table> +</div> +</div> +zigbee2mqtt supports the following events for the aqara cube: shake, +wakeup, fall, tap, slide, flip180, flip90, rotate_left and +rotate_right. Every event has additional information, such as the sides +involved, or the degrees turned. +Now you are ready to set up home assistant support in zigbee2mqtt +following <a class="link" href="https://koenkk.github.io/zigbee2mqtt/integration/home_assistant.html" target="_blank" rel="noopener" +>this +guide</a>. \ No newline at end of file diff --git a/tags/iot/page/1/index.html b/tags/iot/page/1/index.html new file mode 100644 index 0000000..05939df --- /dev/null +++ b/tags/iot/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/iot/ + \ No newline at end of file diff --git a/tags/javascript/index.html b/tags/javascript/index.html new file mode 100644 index 0000000..50144cf --- /dev/null +++ b/tags/javascript/index.html @@ -0,0 +1,31 @@ +Tag: Javascript - J. Fernando Sánchez +

2 pages

Javascript

Updating EuroLoveMap

Creating my web

\ No newline at end of file diff --git a/tags/javascript/index.xml b/tags/javascript/index.xml new file mode 100644 index 0000000..0257af5 --- /dev/null +++ b/tags/javascript/index.xml @@ -0,0 +1,182 @@ +Javascript on J. Fernando Sánchezhttps://balkian.com/tags/javascript/Recent content in Javascript on J. Fernando SánchezHugo -- gohugo.ioen-usThu, 27 Mar 2014 14:00:00 +0000Updating EuroLoveMaphttps://balkian.com/p/updating-eurolovemap/Thu, 27 Mar 2014 14:00:00 +0000https://balkian.com/p/updating-eurolovemap/As part of the <a class="link" href="http://www.opener-project.org/2013/07/18/opener-hackathon-in-amsterdam/" target="_blank" rel="noopener" +>OpeNER +hackathon</a> +we decided to build a prototype that would allow us to compare how +different countries feel about several topics. We used the OpeNER +pipeline to get the sentiment from a set of newspaper articles we +gathered from media in several languages. Then we aggregated those +articles by category and country (using the source of the article or the +language it was written in), obtaining the “overall feeling” of each +country about each topic. Then, we used some fancy JavaScript to make +sense out of the raw information. +It didn’t go too bad, it turns out <a class="link" href="http://eurosentiment.eu/wp-content/uploads/2013/07/BOLv9qnCIAAJEek.jpg" target="_blank" rel="noopener" +>we +won</a>. +Now, it was time for a face-lift. I used this opportunity to play with +new technologies and improve it: +<ul> +<li>Using Flask, this time using python 3.3 and Bootstrap 3.0</li> +<li>Cool HTML5+JS cards (thanks to +<a class="link" href="http://pastetophone.com" target="_blank" rel="noopener" +>pastetophone</a>)</li> +<li>Automatic generation of fake personal data to test the interface</li> +<li>Obfuscation of personal emails</li> +</ul> +The result can be <a class="link" href="http://eurolovemap.herokuapp.com/" target="_blank" rel="noopener" +>seen here</a>. +<h2 id="publishing-a-python-3-app-on-heroku">Publishing a Python 3 app on Heroku +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">mkvirtualenv -p /usr/bin/python3.3 eurolovemap +</code></pre></td></tr></table> +</div> +</div>Since Heroku uses python 2.7 by default, we have to tell it which +version we want, although it supports python 3.4 as well. I couldn’t +get python 3.4 working using the +<a class="link" href="https://launchpad.net/~fkrull/+archive/deadsnakes" target="_blank" rel="noopener" +>deadsnakes</a> ppa, so +I used python 3.3 instead, which works fine but is not officially +supported. Just create a file named runtime.txt in your project root, +with the python version you want to use: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">python-3.3.1 +</code></pre></td></tr></table> +</div> +</div>Don’t forget to freeze your dependencies so Heroku can install them: +<code>bash pip freze > requirements.txt</code> +<h2 id="publishing-personal-emails">Publishing personal emails +</h2>There are really sophisticated and effective ways to obfuscate personal +emails so that spammers cannot easily grab yours. However, this time I +needed something really simple to hide our emails from the simplest form +of crawlers. Most of the team are in academia somehow, so in the end all +our emails are available in sites like Google Scholar. Anyway, nobody +likes getting spammed so I settled for a custom <a class="link" href="http://en.wikipedia.org/wiki/Caesar_cipher" target="_blank" rel="noopener" +>Caesar +cipher</a>. Please, don’t use +it for any serious application if you are concerned about being spammed. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">def blur_email(email): + return "".join([chr(ord(i)+5) for i in email]) +</code></pre></td></tr></table> +</div> +</div>And this is the client side: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-javascript" data-lang="javascript">window.onload = function(){ + elems = document.getElementsByClassName('profile-email'); + for(var e in elems){ + var blur = elems[e].innerHTML; + var email = ""; + for(var s in blur){ + var a = blur.charCodeAt(s) + email = email+String.fromCharCode(a-5); + } + elems[e].innerHTML = email; + } +} +</code></pre></td></tr></table> +</div> +</div>Unfortunately, this approach does not hide your email from anyone using +<a class="link" href="http://phantomjs.org/" target="_blank" rel="noopener" +>PhantomJS</a>, +<a class="link" href="http://zombie.labnotes.org/" target="_blank" rel="noopener" +>ZombieJS</a> or similar. For that, other +approaches like generating a picture with the address would be +necessary. Nevertheless, it is overkill for a really simple ad-hoc +application with custom formatting and just a bunch of emails that would +easily be grabbed manually. +<h2 id="generation-of-fake-data">Generation of fake data +</h2>To test the contact section of the site, I wanted to populate it with +fake data. <a class="link" href="https://github.com/joke2k/faker" target="_blank" rel="noopener" +>Fake-Factory</a> is an amazing +library that can generate fake data of almost any kind: emails, +association names, acronyms… It even lets you localise the results +(get Spanish names, for instance) and generate factories for certain +classes (à la Django). +But I also wanted pictures, enter <a class="link" href="http://lorempixel.com/" target="_blank" rel="noopener" +>Lorem Pixel</a>. +With its API you can generate pictures of almost any size, for different +topics (e.g. nightlife, people) and with a custom text. You can even use +an index, so it will always show the same picture. +For instance, the picture below is served through Lorem Pixel. +<img src="http://lorempixel.com/400/200/nightlife/" +loading="lazy" +> +By the way, if you only want cat pictures, take a look at +<a class="link" href="http://placekitten.com/" target="_blank" rel="noopener" +>Placekitten</a>. And for NSFW text, there’s the +<a class="link" href="http://slipsum.com/" target="_blank" rel="noopener" +>Samuel L. Jackson Ipsum</a>Creating my webhttps://balkian.com/p/creating-my-web/Thu, 22 Aug 2013 14:14:22 +0000https://balkian.com/p/creating-my-web/I’ve finally decided to set up a decent personal page. I have settled +for github-pages because I like the idea of keeping my site in a +repository and having someone else host and deploy it for me. The site +will be really simple, mostly static files. Thanks to Github, +<a class="link" href="http://jekyllrb.com" target="_blank" rel="noopener" +>Jekyll</a> will automatically generate static pages +for my posts every time I commit anything new to this repository. +But Jekyll can be used independently, so if I ever choose to host the +site myself, I can do it quite easily. Another thing that I liked about +this approach is that the generated html files can be used in the +future, and I will not need Jekyll to serve it. Jekyll is really simple +and most of the things are written in plain html. That means that +everything could be easily reused if I ever choose to change to another +blogging framework (e.g. pelical). But, for the time being, I like the +fact that Github takes care of the compilation as well, so I can simply +modify or add files through the web interface should I need to. +I hadn’t played with HTML and CSS for a while now, so I also wanted to +use this site as a playground. At some point, I realised I was doing +mostly everything in plain HTML and CSS, and decided to keep it like +that for as long as possible. As of this writing, I haven’t included +any Javascript code in the page. Probably I will use some to add my +<a class="link" href="http://gist.github.com/balkian" target="_blank" rel="noopener" +>gists</a> and +<a class="link" href="http://github.com/balkian" target="_blank" rel="noopener" +>repositories</a>, but we will see about that. +I think the code speaks for itself, so you can check out <a class="link" href="http://github.com/balkian/balkian.github.com" target="_blank" rel="noopener" +>my repository +on Github</a>. You can clone +and deploy it easily like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git clone +https://github.com/balkian/balkian.github.com cd balkian.github.com +jekyll serve -w +</code></pre></td></tr></table> +</div> +</div>I will keep updating this post with information about: +<ul> +<li>Some Jekyll plugins that might be useful</li> +<li>What CSS tricks I learnt</li> +<li>The webfonts I used</li> +<li>The badge on the left side of the page</li> +</ul> \ No newline at end of file diff --git a/tags/javascript/page/1/index.html b/tags/javascript/page/1/index.html new file mode 100644 index 0000000..f6e377a --- /dev/null +++ b/tags/javascript/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/javascript/ + \ No newline at end of file diff --git a/tags/keyboard/index.html b/tags/keyboard/index.html new file mode 100644 index 0000000..4001685 --- /dev/null +++ b/tags/keyboard/index.html @@ -0,0 +1,31 @@ +Tag: Keyboard - J. Fernando Sánchez +

3 pages

Keyboard

Kanata: advanced keyboard configuration

Logitech MB850 combi in linux

Logitech MX Keys for Mac on Linux

\ No newline at end of file diff --git a/tags/keyboard/index.xml b/tags/keyboard/index.xml new file mode 100644 index 0000000..30b4f05 --- /dev/null +++ b/tags/keyboard/index.xml @@ -0,0 +1,283 @@ +Keyboard on J. Fernando Sánchezhttps://balkian.com/tags/keyboard/Recent content in Keyboard on J. Fernando SánchezHugo -- gohugo.ioen-usFri, 20 Jan 2023 18:11:00 +0000Kanata: advanced keyboard configurationhttps://balkian.com/p/kanata-advanced-keyboard-configuration/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/p/kanata-advanced-keyboard-configuration/<a class="link" href="https://github.com/jtroo/kanata/" target="_blank" rel="noopener" +>Kanata</a> is a software keyboard remapper that aims to improve keyboard comfort and usability with advanced customization. +Keyboard remappers are a good alternative to running a custom keyboard with QMK/ZMK, and have two main advantages: they work on any keyboard, and you can configure them to launch any command or program you want, not just key presses. +On the other hand, you need to configure them on every PC/OS you’re using your keyboard with, and all the processing is done on software on top of the OS, so there may be glitches and performance issues. +The project was inspired by the more popular <a class="link" href="https://github.com/kmonad/kmonad" target="_blank" rel="noopener" +>KMonad</a>, and the author cites some of the <a class="link" href="https://github.com/jtroo/kanata/blob/main/docs/kmonad_comparison.md" target="_blank" rel="noopener" +>differences</a>. +Both projects use a very similar configuration format based on lisp. +The configuration consists of a set of general options, a base key configuration, a series of layers, and macros that can be used within those layers. +<a class="link" href="https://github.com/jtroo/kanata/blob/main/cfg_samples/kanata.kbd" target="_blank" rel="noopener" +>Here’s a very complete config that serves as documentation</a>. +One big disadvantage of the lispy configuration is that you need to specify your hardware layout/all your keys, and repeat that every time you define a new layer. +The result visually maps to your keyboard, but can be very verbose/big if you need really few changes. +<a class="link" href="https://github.com/rvaiya/keyd/" target="_blank" rel="noopener" +>Keyd</a> is another alternative with a more declarative configuration format, which might lend itself to smaller. +For now I’m just trying it out, and getting a feel for using fewer keys before I build my own ZMK keyboard. +I particularly like the option of using mod-keys on the home row (e.g., having A work as a CTRL when held). +Mod-tap, tap-dancing and the like are very common techniques in sub-40% layouts, where there simply aren’t enough keys for all the letters and symbols. +In a regular-sized keyboard, these techniques can also help you stay on the home row and type more comfortably. +At least, that’s the idea. +We’ll see if I like it enough to stick with it. +For now, here’s my very simple config: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(defcfg + ;; Your keyboard device will likely differ from this. + linux-dev /dev/input/by-id/usb-Logitech_USB_Receiver-if02-event-mouse + + ;; Windows doesn't need any input/output configuration entries; however, there + ;; must still be a defcfg entry. You can keep the linux-dev entry or delete + ;; it and leave it empty. +) + +(defsrc + grv 1 2 3 4 5 6 7 8 9 0 - = bspc + tab q w e r t y u i o p [ ] + caps a s d f g h j k l ; ' ret + lsft \ z x c v b n m , . / rsft + lctl lmet lalt spc ralt rmet rctl +) + + +(deflayer qwerty + grv _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ @warrows _ _ _ _ _ _ _ _ _ _ + lctrl @alctrl @slsft @dlalt @flmet _ _ @jrmet @kralt @lrsft @;rctrl _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer arrows + _ _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ @flmet _ left down up rght _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer colemak + grv XX XX XX XX XX XX XX XX XX XX XX XX _ + tab q w f p b j l u y ; [ ] + lctrl @alctrl @rlsft @slalt @tlmet g m @nrmet @eralt @irsft @orctrl ' ret + lsft XX z x c d v k h , . / rsft + XX XX XX @smartspace XX XX XX +) + +(deflayer magic + _ @clmk @qwerty _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ tab A-tab _ _ _ _ bspc esc _ ret _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ +) + +(defalias + warrows (tap-hold 200 200 w (layer-toggle arrows)) + + alctrl (tap-hold 200 200 a lctrl) + slsft (tap-hold 200 200 s lsft) + dlalt (tap-hold 200 200 d lalt) + flmet (tap-hold 200 200 f lmet) + + jrmet (tap-hold 200 200 j rmet) + kralt (tap-hold 200 200 k ralt) + lrsft (tap-hold 200 200 l rsft) + ;rctrl (tap-hold 200 200 ; rctrl) + + rlsft (tap-hold 200 200 r lsft) + slalt (tap-hold 200 200 s lalt) + tlmet (tap-hold 200 200 t lmet) + nrmet (tap-hold 200 200 n rmet) + eralt (tap-hold 200 200 e ralt) + irsft (tap-hold 200 200 i rsft) + orctrl (tap-hold 200 200 o rctrl) + clmk (layer-switch colemak) + qwerty (layer-switch qwerty) + + smartspace (tap-dance 200 ( + (tap-hold 300 300 spc (layer-toggle magic)) + (tap-hold 300 300 (one-shot 300 lalt) spc) + a + )) + + ) +</code></pre></td></tr></table> +</div> +</div>Logitech MB850 combi in linuxhttps://balkian.com/p/logitech-mb850-combi-in-linux/Sat, 30 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mb850-combi-in-linux/As a follow-up to my last post, I’ve decided to also configure my mk850 combo (k850 + m720 triathlon). +Some notes: +<ul> +<li>The keyboard is usually connected to this PC through bluetooth. Since this is a change I usually do in the system for every keyboard, I added a rule for any bus (usb, bluetooth, etc)</li> +<li>The mouse has an additional button that registers as a keyboard. Every press maps to three key events. I’ve disabled two of them and mapped the action to F19, in case I want to use it in my DE/WM.</li> +</ul> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">evdev:input:* + KEYBOARD_KEY_70039=leftctrl # bind capslock to w + +evdev:input:b0005v046DpB015* + KEYBOARD_KEY_700e0=f19 + KEYBOARD_KEY_700e2=unknown + KEYBOARD_KEY_7002b=unknown +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div>Make sure the settings have been applied by running <code>evemu-describe</code>: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"> sudo /sbin/evemu-describe /dev/input/event<id of your device> | grep KEY_ +</code></pre></td></tr></table> +</div> +</div>Logitech MX Keys for Mac on Linuxhttps://balkian.com/p/logitech-mx-keys-for-mac-on-linux/Fri, 29 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mx-keys-for-mac-on-linux/I recently got Logitech MX Keys for Mac keyboard at work. +The German version, to be more precise. +This version was three times cheaper than the Windows equivalent with either US or ES layout. +Since I touch type anyway, I thought it was a bargain. +As soon as I plugged it in, I realized there were some glaring issues with the keyboard. +First of all, the Meta/Super and Alt keys are reversed in this keyboard. +In the normal/full version of this keyboard, Logitech gives an option to choose between Mac, Windows and iOS host, and that changes the behavior of the keys. +In this version, tho, only iOS and Mac are available. +Besides that, there’s the issue of the grave (tilde) and angle keys switched as well. +Switching these keys around would be very easy with Xorg, but Wayland once again complicates things… +These issues almost made me return the keyboard. +Luckily, tho, there is another option: configuring the keys one level lower than wayland (and X11), through hwdb. +Long story short, this will configure any Logitech keyboard with the same product id (0x4092) to use a saner configuration: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">#File: /etc/udev/hwdb.d/90-logitech-keyboard.hwdb + +evdev:input:b0003v046Dp4092* + KEYBOARD_KEY_700e2=leftmeta + KEYBOARD_KEY_700e3=leftalt + KEYBOARD_KEY_70039=leftctrl + KEYBOARD_KEY_70064=102nd + KEYBOARD_KEY_70035=grave + KEYBOARD_KEY_700e7=rightalt + KEYBOARD_KEY_700e6=rightmeta + KEYBOARD_KEY_7006d=compose +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/keyboard/page/1/index.html b/tags/keyboard/page/1/index.html new file mode 100644 index 0000000..142b133 --- /dev/null +++ b/tags/keyboard/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/keyboard/ + \ No newline at end of file diff --git a/tags/layout/index.html b/tags/layout/index.html new file mode 100644 index 0000000..19494fd --- /dev/null +++ b/tags/layout/index.html @@ -0,0 +1,31 @@ +Tag: Layout - J. Fernando Sánchez +

1 page

Layout

Kanata: advanced keyboard configuration

\ No newline at end of file diff --git a/tags/layout/index.xml b/tags/layout/index.xml new file mode 100644 index 0000000..1507917 --- /dev/null +++ b/tags/layout/index.xml @@ -0,0 +1,189 @@ +Layout on J. Fernando Sánchezhttps://balkian.com/tags/layout/Recent content in Layout on J. Fernando SánchezHugo -- gohugo.ioen-usFri, 20 Jan 2023 18:11:00 +0000Kanata: advanced keyboard configurationhttps://balkian.com/p/kanata-advanced-keyboard-configuration/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/p/kanata-advanced-keyboard-configuration/<a class="link" href="https://github.com/jtroo/kanata/" target="_blank" rel="noopener" +>Kanata</a> is a software keyboard remapper that aims to improve keyboard comfort and usability with advanced customization. +Keyboard remappers are a good alternative to running a custom keyboard with QMK/ZMK, and have two main advantages: they work on any keyboard, and you can configure them to launch any command or program you want, not just key presses. +On the other hand, you need to configure them on every PC/OS you’re using your keyboard with, and all the processing is done on software on top of the OS, so there may be glitches and performance issues. +The project was inspired by the more popular <a class="link" href="https://github.com/kmonad/kmonad" target="_blank" rel="noopener" +>KMonad</a>, and the author cites some of the <a class="link" href="https://github.com/jtroo/kanata/blob/main/docs/kmonad_comparison.md" target="_blank" rel="noopener" +>differences</a>. +Both projects use a very similar configuration format based on lisp. +The configuration consists of a set of general options, a base key configuration, a series of layers, and macros that can be used within those layers. +<a class="link" href="https://github.com/jtroo/kanata/blob/main/cfg_samples/kanata.kbd" target="_blank" rel="noopener" +>Here’s a very complete config that serves as documentation</a>. +One big disadvantage of the lispy configuration is that you need to specify your hardware layout/all your keys, and repeat that every time you define a new layer. +The result visually maps to your keyboard, but can be very verbose/big if you need really few changes. +<a class="link" href="https://github.com/rvaiya/keyd/" target="_blank" rel="noopener" +>Keyd</a> is another alternative with a more declarative configuration format, which might lend itself to smaller. +For now I’m just trying it out, and getting a feel for using fewer keys before I build my own ZMK keyboard. +I particularly like the option of using mod-keys on the home row (e.g., having A work as a CTRL when held). +Mod-tap, tap-dancing and the like are very common techniques in sub-40% layouts, where there simply aren’t enough keys for all the letters and symbols. +In a regular-sized keyboard, these techniques can also help you stay on the home row and type more comfortably. +At least, that’s the idea. +We’ll see if I like it enough to stick with it. +For now, here’s my very simple config: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(defcfg + ;; Your keyboard device will likely differ from this. + linux-dev /dev/input/by-id/usb-Logitech_USB_Receiver-if02-event-mouse + + ;; Windows doesn't need any input/output configuration entries; however, there + ;; must still be a defcfg entry. You can keep the linux-dev entry or delete + ;; it and leave it empty. +) + +(defsrc + grv 1 2 3 4 5 6 7 8 9 0 - = bspc + tab q w e r t y u i o p [ ] + caps a s d f g h j k l ; ' ret + lsft \ z x c v b n m , . / rsft + lctl lmet lalt spc ralt rmet rctl +) + + +(deflayer qwerty + grv _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ @warrows _ _ _ _ _ _ _ _ _ _ + lctrl @alctrl @slsft @dlalt @flmet _ _ @jrmet @kralt @lrsft @;rctrl _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer arrows + _ _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ @flmet _ left down up rght _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer colemak + grv XX XX XX XX XX XX XX XX XX XX XX XX _ + tab q w f p b j l u y ; [ ] + lctrl @alctrl @rlsft @slalt @tlmet g m @nrmet @eralt @irsft @orctrl ' ret + lsft XX z x c d v k h , . / rsft + XX XX XX @smartspace XX XX XX +) + +(deflayer magic + _ @clmk @qwerty _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ tab A-tab _ _ _ _ bspc esc _ ret _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ +) + +(defalias + warrows (tap-hold 200 200 w (layer-toggle arrows)) + + alctrl (tap-hold 200 200 a lctrl) + slsft (tap-hold 200 200 s lsft) + dlalt (tap-hold 200 200 d lalt) + flmet (tap-hold 200 200 f lmet) + + jrmet (tap-hold 200 200 j rmet) + kralt (tap-hold 200 200 k ralt) + lrsft (tap-hold 200 200 l rsft) + ;rctrl (tap-hold 200 200 ; rctrl) + + rlsft (tap-hold 200 200 r lsft) + slalt (tap-hold 200 200 s lalt) + tlmet (tap-hold 200 200 t lmet) + nrmet (tap-hold 200 200 n rmet) + eralt (tap-hold 200 200 e ralt) + irsft (tap-hold 200 200 i rsft) + orctrl (tap-hold 200 200 o rctrl) + clmk (layer-switch colemak) + qwerty (layer-switch qwerty) + + smartspace (tap-dance 200 ( + (tap-hold 300 300 spc (layer-toggle magic)) + (tap-hold 300 300 (one-shot 300 lalt) spc) + a + )) + + ) +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/layout/page/1/index.html b/tags/layout/page/1/index.html new file mode 100644 index 0000000..f9e8d0b --- /dev/null +++ b/tags/layout/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/layout/ + \ No newline at end of file diff --git a/tags/linux/index.html b/tags/linux/index.html new file mode 100644 index 0000000..fab66d5 --- /dev/null +++ b/tags/linux/index.html @@ -0,0 +1,31 @@ +Tag: Linux - J. Fernando Sánchez +

5 pages

Linux

Kanata: advanced keyboard configuration

Logitech MB850 combi in linux

Logitech MX Keys for Mac on Linux

Linux on the Microsoft Surface Go

Linux

\ No newline at end of file diff --git a/tags/linux/index.xml b/tags/linux/index.xml new file mode 100644 index 0000000..3c3ee1f --- /dev/null +++ b/tags/linux/index.xml @@ -0,0 +1,512 @@ +Linux on J. Fernando Sánchezhttps://balkian.com/tags/linux/Recent content in Linux on J. Fernando SánchezHugo -- gohugo.ioen-usFri, 20 Jan 2023 18:11:00 +0000Kanata: advanced keyboard configurationhttps://balkian.com/p/kanata-advanced-keyboard-configuration/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/p/kanata-advanced-keyboard-configuration/<a class="link" href="https://github.com/jtroo/kanata/" target="_blank" rel="noopener" +>Kanata</a> is a software keyboard remapper that aims to improve keyboard comfort and usability with advanced customization. +Keyboard remappers are a good alternative to running a custom keyboard with QMK/ZMK, and have two main advantages: they work on any keyboard, and you can configure them to launch any command or program you want, not just key presses. +On the other hand, you need to configure them on every PC/OS you’re using your keyboard with, and all the processing is done on software on top of the OS, so there may be glitches and performance issues. +The project was inspired by the more popular <a class="link" href="https://github.com/kmonad/kmonad" target="_blank" rel="noopener" +>KMonad</a>, and the author cites some of the <a class="link" href="https://github.com/jtroo/kanata/blob/main/docs/kmonad_comparison.md" target="_blank" rel="noopener" +>differences</a>. +Both projects use a very similar configuration format based on lisp. +The configuration consists of a set of general options, a base key configuration, a series of layers, and macros that can be used within those layers. +<a class="link" href="https://github.com/jtroo/kanata/blob/main/cfg_samples/kanata.kbd" target="_blank" rel="noopener" +>Here’s a very complete config that serves as documentation</a>. +One big disadvantage of the lispy configuration is that you need to specify your hardware layout/all your keys, and repeat that every time you define a new layer. +The result visually maps to your keyboard, but can be very verbose/big if you need really few changes. +<a class="link" href="https://github.com/rvaiya/keyd/" target="_blank" rel="noopener" +>Keyd</a> is another alternative with a more declarative configuration format, which might lend itself to smaller. +For now I’m just trying it out, and getting a feel for using fewer keys before I build my own ZMK keyboard. +I particularly like the option of using mod-keys on the home row (e.g., having A work as a CTRL when held). +Mod-tap, tap-dancing and the like are very common techniques in sub-40% layouts, where there simply aren’t enough keys for all the letters and symbols. +In a regular-sized keyboard, these techniques can also help you stay on the home row and type more comfortably. +At least, that’s the idea. +We’ll see if I like it enough to stick with it. +For now, here’s my very simple config: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(defcfg + ;; Your keyboard device will likely differ from this. + linux-dev /dev/input/by-id/usb-Logitech_USB_Receiver-if02-event-mouse + + ;; Windows doesn't need any input/output configuration entries; however, there + ;; must still be a defcfg entry. You can keep the linux-dev entry or delete + ;; it and leave it empty. +) + +(defsrc + grv 1 2 3 4 5 6 7 8 9 0 - = bspc + tab q w e r t y u i o p [ ] + caps a s d f g h j k l ; ' ret + lsft \ z x c v b n m , . / rsft + lctl lmet lalt spc ralt rmet rctl +) + + +(deflayer qwerty + grv _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ @warrows _ _ _ _ _ _ _ _ _ _ + lctrl @alctrl @slsft @dlalt @flmet _ _ @jrmet @kralt @lrsft @;rctrl _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer arrows + _ _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ @flmet _ left down up rght _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer colemak + grv XX XX XX XX XX XX XX XX XX XX XX XX _ + tab q w f p b j l u y ; [ ] + lctrl @alctrl @rlsft @slalt @tlmet g m @nrmet @eralt @irsft @orctrl ' ret + lsft XX z x c d v k h , . / rsft + XX XX XX @smartspace XX XX XX +) + +(deflayer magic + _ @clmk @qwerty _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ tab A-tab _ _ _ _ bspc esc _ ret _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ +) + +(defalias + warrows (tap-hold 200 200 w (layer-toggle arrows)) + + alctrl (tap-hold 200 200 a lctrl) + slsft (tap-hold 200 200 s lsft) + dlalt (tap-hold 200 200 d lalt) + flmet (tap-hold 200 200 f lmet) + + jrmet (tap-hold 200 200 j rmet) + kralt (tap-hold 200 200 k ralt) + lrsft (tap-hold 200 200 l rsft) + ;rctrl (tap-hold 200 200 ; rctrl) + + rlsft (tap-hold 200 200 r lsft) + slalt (tap-hold 200 200 s lalt) + tlmet (tap-hold 200 200 t lmet) + nrmet (tap-hold 200 200 n rmet) + eralt (tap-hold 200 200 e ralt) + irsft (tap-hold 200 200 i rsft) + orctrl (tap-hold 200 200 o rctrl) + clmk (layer-switch colemak) + qwerty (layer-switch qwerty) + + smartspace (tap-dance 200 ( + (tap-hold 300 300 spc (layer-toggle magic)) + (tap-hold 300 300 (one-shot 300 lalt) spc) + a + )) + + ) +</code></pre></td></tr></table> +</div> +</div>Logitech MB850 combi in linuxhttps://balkian.com/p/logitech-mb850-combi-in-linux/Sat, 30 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mb850-combi-in-linux/As a follow-up to my last post, I’ve decided to also configure my mk850 combo (k850 + m720 triathlon). +Some notes: +<ul> +<li>The keyboard is usually connected to this PC through bluetooth. Since this is a change I usually do in the system for every keyboard, I added a rule for any bus (usb, bluetooth, etc)</li> +<li>The mouse has an additional button that registers as a keyboard. Every press maps to three key events. I’ve disabled two of them and mapped the action to F19, in case I want to use it in my DE/WM.</li> +</ul> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">evdev:input:* + KEYBOARD_KEY_70039=leftctrl # bind capslock to w + +evdev:input:b0005v046DpB015* + KEYBOARD_KEY_700e0=f19 + KEYBOARD_KEY_700e2=unknown + KEYBOARD_KEY_7002b=unknown +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div>Make sure the settings have been applied by running <code>evemu-describe</code>: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"> sudo /sbin/evemu-describe /dev/input/event<id of your device> | grep KEY_ +</code></pre></td></tr></table> +</div> +</div>Logitech MX Keys for Mac on Linuxhttps://balkian.com/p/logitech-mx-keys-for-mac-on-linux/Fri, 29 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mx-keys-for-mac-on-linux/I recently got Logitech MX Keys for Mac keyboard at work. +The German version, to be more precise. +This version was three times cheaper than the Windows equivalent with either US or ES layout. +Since I touch type anyway, I thought it was a bargain. +As soon as I plugged it in, I realized there were some glaring issues with the keyboard. +First of all, the Meta/Super and Alt keys are reversed in this keyboard. +In the normal/full version of this keyboard, Logitech gives an option to choose between Mac, Windows and iOS host, and that changes the behavior of the keys. +In this version, tho, only iOS and Mac are available. +Besides that, there’s the issue of the grave (tilde) and angle keys switched as well. +Switching these keys around would be very easy with Xorg, but Wayland once again complicates things… +These issues almost made me return the keyboard. +Luckily, tho, there is another option: configuring the keys one level lower than wayland (and X11), through hwdb. +Long story short, this will configure any Logitech keyboard with the same product id (0x4092) to use a saner configuration: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">#File: /etc/udev/hwdb.d/90-logitech-keyboard.hwdb + +evdev:input:b0003v046Dp4092* + KEYBOARD_KEY_700e2=leftmeta + KEYBOARD_KEY_700e3=leftalt + KEYBOARD_KEY_70039=leftctrl + KEYBOARD_KEY_70064=102nd + KEYBOARD_KEY_70035=grave + KEYBOARD_KEY_700e7=rightalt + KEYBOARD_KEY_700e6=rightmeta + KEYBOARD_KEY_7006d=compose +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div>Linux on the Microsoft Surface Gohttps://balkian.com/p/linux-on-the-microsoft-surface-go/Sat, 01 Jun 2019 00:00:01 +0000https://balkian.com/p/linux-on-the-microsoft-surface-go/Believe it or not, Surface tablets have pretty good linux support, except for the webcams in newer models. +These are some useful notes to get Ubuntu installed in your surface go, as of Summer 2019. +<h2 id="installing-the-kernel">Installing the kernel +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">git clone --depth 1 https://github.com/jakeday/linux-surface.git ~/linux-surface +cp -a ~/linux-surface /media/<your usb> +</code></pre></td></tr></table> +</div> +</div><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">cp -a /media/<your usb>/linux-surface ~/ +cd ~/linux-surface/ +sudo sh setup.sh +</code></pre></td></tr></table> +</div> +</div><h2 id="booting-ubuntu-first">Booting ubuntu first +</h2>Switch out of Windows S mode. +Boot into the “Command Prompt”. +From Windows go to “change advanced startup options” and select “restart now”. +When it reboots, choose the “Troubleshoot” option, then choose the “Advanced options” option, and finally choose the “Command Prompt” option. +After the device reboots, login to the command prompt and then you should see a terminal with X:\windows\system32> +At the prompt, check your UEFI entries: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /enum firmware +</code></pre></td></tr></table> +</div> +</div>Copy UEFI entry of “Windows Boot Manager” to create a new entry for Ubuntu: bcdedit /copy {bootmgr} /d “Ubuntu” +Copy the printed GUID number including the braces {} using Ctrl+C +Set file path for the new Ubuntu entry. Replace {guid} with the returned GUID of the previous command (Ctrl+V). bcdedit /set {guid} path \EFI\ubuntu\grubx64.efi +Set Ubuntu as the first/ entry in the boot sequence. Again replace {guid} with the returned GUID of the copy command. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /set {fwbootmgr} displayorder {guid} /addfirst +</code></pre></td></tr></table> +</div> +</div>Check your UEFI entries again: bcdedit /enum firmware You should see something like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"> +Firmware Boot Manager +--------------------- +identifier {fwbootmgr} +displayorder {3510232e-f8eb-e811-95ce-9ecab3f9d1c4} + {bootmgr} + {2148799b-f8eb-e811-95ce-9ecab3f9d1c4} + {312e8a67-c2f6-e811-95ce-3c1ab3f9d1de} + {312e8a68-c2f6-e811-95ce-3c1ab3f9d1de} +timeout 0 +</code></pre></td></tr></table> +</div> +</div>Make sure the GUID you copied is the first one listed in displayorder. Then type exit, turn off the PC and turn it back on. After this my surface go is automatically booting to the grub bootloader which lets me choose between Windows and Ubuntu but defaults to Ubuntu after ten seconds.Linuxhttps://balkian.com/linux/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/linux/<img src="https://balkian.com/img/linux.png" alt="Featured image of post Linux" /><h2 id="black-screen-and-lightdm-doesnt-unlock">Black screen and LightDM doesn’t unlock +</h2>Add this to your /etc/lightdm/lightdm.conf file: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[LightDM] +logind-check-graphical=true +</code></pre></td></tr></table> +</div> +</div>##Edit previous commands +<code>fc</code> is a shell builtin to list and edit previous commands in an editor. +In addition to editing a single line (which you can also do with <code>C-x C-e</code>), it also allows you to edit and run several lines at the same time. +You use it like this: +List previous commands +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -l +10259 nvim deploy.sh +10260* cd .. +10261* nvim content/cheatsheet/linux.md +10262 cd +</code></pre></td></tr></table> +</div> +</div>List commands with date (in zsh) +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -ld +10260* 19:38 cd .. +10261* 19:38 nvim content/cheatsheet/linux.md +10262 19:40 cd +10263 19:40 fc -l +</code></pre></td></tr></table> +</div> +</div>You can add the date too: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -fld +10262 1/10/2019 19:40 cd +10263 1/10/2019 19:40 fc -l +10264 1/10/2019 19:40 fc -ld +</code></pre></td></tr></table> +</div> +</div>You can edit a range of commands +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc 10262 10264 +</code></pre></td></tr></table> +</div> +</div>The range can be relative to the current position, so the previous command is equivalent to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">$ fc -3 -1 +</code></pre></td></tr></table> +</div> +</div>If you save and exit, all commands are executed as a script, and it will be added to your history. +Source: <a class="link" href="https://shapeshed.com/unix-fc/" target="_blank" rel="noopener" +>https://shapeshed.com/unix-fc/</a> +<h2 id="prevent-logoff-from-killing-tmux-sessions">Prevent logoff from killing tmux sessions +</h2>Lately I’ve noticed that logging out of i3, intentionally or when i3 fails, would also kill any tmux or emacs sessions. +This is extremely annoying. +This is caused by a new default in logind (systemd’s login) to kill user process on logoff. +You can revert this setting in your logind.conf (<code>/etc/systemd/logind.conf</code>): +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">KillUserProcesses=no +</code></pre></td></tr></table> +</div> +</div>Or only for a specific process (e.g., tmux): +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">systemd-run --scope --user tmux +</code></pre></td></tr></table> +</div> +</div>Source: <a class="link" href="https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session" target="_blank" rel="noopener" +>https://unix.stackexchange.com/questions/490267/prevent-logoff-from-killing-tmux-session</a> +<h2 id="upload-a-temporary-file">Upload a temporary file +</h2>Sometimes you just need to copy/paste a file from a server, and copying from the terminal can be a hassle. +These two services are command-line “pastebins” just one curl away: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +8 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><command> | curl -F 'sprunge=<-' http://sprunge.us +# OR + +<command> 2>&1 | curl -F 'f:1=<-' ix.io + +# OR + +<command> | curl -F"file=@-" https://ttm.sh +</code></pre></td></tr></table> +</div> +</div><h1 id="install-fortinet-sslvpn-support-for-networkmanager">Install Fortinet SSLVPN support for NetworkManager +</h1>UPM (Universidad Politécnica de Madrid) uses a propriatary VPN solution. +The instructions for GNU/Linux on their website involve downloading a specific client (<code>.tar.gz</code>) and manually running it. +That works, but it is kind of a hassle. +A much more convenient alternative is installing this NetworkManager plugin: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">pacman -Sy networkmanager-fortisslvpn +# Or apt get install networkmanager-fortisslvpn +</code></pre></td></tr></table> +</div> +</div>Now you can simply add a new VPN connection in NetworkManager and manage it as you would any other connection. \ No newline at end of file diff --git a/tags/linux/page/1/index.html b/tags/linux/page/1/index.html new file mode 100644 index 0000000..ec22679 --- /dev/null +++ b/tags/linux/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/linux/ + \ No newline at end of file diff --git a/tags/lisp/index.html b/tags/lisp/index.html new file mode 100644 index 0000000..bf37b1a --- /dev/null +++ b/tags/lisp/index.html @@ -0,0 +1,31 @@ +Tag: Lisp - J. Fernando Sánchez +

1 page

Lisp

Emacs

\ No newline at end of file diff --git a/tags/lisp/index.xml b/tags/lisp/index.xml new file mode 100644 index 0000000..1c4c09c --- /dev/null +++ b/tags/lisp/index.xml @@ -0,0 +1,10 @@ +Lisp on J. Fernando Sánchezhttps://balkian.com/tags/lisp/Recent content in Lisp on J. Fernando SánchezHugo -- gohugo.ioen-usEmacshttps://balkian.com/emacs/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/emacs/<img src="https://balkian.com/img/emacs.png" alt="Featured image of post Emacs" /><h2 id="show-plain-text-version">Show plain text version +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(font-lock-mode) +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/lisp/page/1/index.html b/tags/lisp/page/1/index.html new file mode 100644 index 0000000..c156928 --- /dev/null +++ b/tags/lisp/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/lisp/ + \ No newline at end of file diff --git a/tags/logitech/index.html b/tags/logitech/index.html new file mode 100644 index 0000000..05ae2a1 --- /dev/null +++ b/tags/logitech/index.html @@ -0,0 +1,31 @@ +Tag: Logitech - J. Fernando Sánchez +

3 pages

Logitech

Kanata: advanced keyboard configuration

Logitech MB850 combi in linux

Logitech MX Keys for Mac on Linux

\ No newline at end of file diff --git a/tags/logitech/index.xml b/tags/logitech/index.xml new file mode 100644 index 0000000..9697aef --- /dev/null +++ b/tags/logitech/index.xml @@ -0,0 +1,283 @@ +Logitech on J. Fernando Sánchezhttps://balkian.com/tags/logitech/Recent content in Logitech on J. Fernando SánchezHugo -- gohugo.ioen-usFri, 20 Jan 2023 18:11:00 +0000Kanata: advanced keyboard configurationhttps://balkian.com/p/kanata-advanced-keyboard-configuration/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/p/kanata-advanced-keyboard-configuration/<a class="link" href="https://github.com/jtroo/kanata/" target="_blank" rel="noopener" +>Kanata</a> is a software keyboard remapper that aims to improve keyboard comfort and usability with advanced customization. +Keyboard remappers are a good alternative to running a custom keyboard with QMK/ZMK, and have two main advantages: they work on any keyboard, and you can configure them to launch any command or program you want, not just key presses. +On the other hand, you need to configure them on every PC/OS you’re using your keyboard with, and all the processing is done on software on top of the OS, so there may be glitches and performance issues. +The project was inspired by the more popular <a class="link" href="https://github.com/kmonad/kmonad" target="_blank" rel="noopener" +>KMonad</a>, and the author cites some of the <a class="link" href="https://github.com/jtroo/kanata/blob/main/docs/kmonad_comparison.md" target="_blank" rel="noopener" +>differences</a>. +Both projects use a very similar configuration format based on lisp. +The configuration consists of a set of general options, a base key configuration, a series of layers, and macros that can be used within those layers. +<a class="link" href="https://github.com/jtroo/kanata/blob/main/cfg_samples/kanata.kbd" target="_blank" rel="noopener" +>Here’s a very complete config that serves as documentation</a>. +One big disadvantage of the lispy configuration is that you need to specify your hardware layout/all your keys, and repeat that every time you define a new layer. +The result visually maps to your keyboard, but can be very verbose/big if you need really few changes. +<a class="link" href="https://github.com/rvaiya/keyd/" target="_blank" rel="noopener" +>Keyd</a> is another alternative with a more declarative configuration format, which might lend itself to smaller. +For now I’m just trying it out, and getting a feel for using fewer keys before I build my own ZMK keyboard. +I particularly like the option of using mod-keys on the home row (e.g., having A work as a CTRL when held). +Mod-tap, tap-dancing and the like are very common techniques in sub-40% layouts, where there simply aren’t enough keys for all the letters and symbols. +In a regular-sized keyboard, these techniques can also help you stay on the home row and type more comfortably. +At least, that’s the idea. +We’ll see if I like it enough to stick with it. +For now, here’s my very simple config: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(defcfg + ;; Your keyboard device will likely differ from this. + linux-dev /dev/input/by-id/usb-Logitech_USB_Receiver-if02-event-mouse + + ;; Windows doesn't need any input/output configuration entries; however, there + ;; must still be a defcfg entry. You can keep the linux-dev entry or delete + ;; it and leave it empty. +) + +(defsrc + grv 1 2 3 4 5 6 7 8 9 0 - = bspc + tab q w e r t y u i o p [ ] + caps a s d f g h j k l ; ' ret + lsft \ z x c v b n m , . / rsft + lctl lmet lalt spc ralt rmet rctl +) + + +(deflayer qwerty + grv _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ @warrows _ _ _ _ _ _ _ _ _ _ + lctrl @alctrl @slsft @dlalt @flmet _ _ @jrmet @kralt @lrsft @;rctrl _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer arrows + _ _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ @flmet _ left down up rght _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer colemak + grv XX XX XX XX XX XX XX XX XX XX XX XX _ + tab q w f p b j l u y ; [ ] + lctrl @alctrl @rlsft @slalt @tlmet g m @nrmet @eralt @irsft @orctrl ' ret + lsft XX z x c d v k h , . / rsft + XX XX XX @smartspace XX XX XX +) + +(deflayer magic + _ @clmk @qwerty _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ tab A-tab _ _ _ _ bspc esc _ ret _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ +) + +(defalias + warrows (tap-hold 200 200 w (layer-toggle arrows)) + + alctrl (tap-hold 200 200 a lctrl) + slsft (tap-hold 200 200 s lsft) + dlalt (tap-hold 200 200 d lalt) + flmet (tap-hold 200 200 f lmet) + + jrmet (tap-hold 200 200 j rmet) + kralt (tap-hold 200 200 k ralt) + lrsft (tap-hold 200 200 l rsft) + ;rctrl (tap-hold 200 200 ; rctrl) + + rlsft (tap-hold 200 200 r lsft) + slalt (tap-hold 200 200 s lalt) + tlmet (tap-hold 200 200 t lmet) + nrmet (tap-hold 200 200 n rmet) + eralt (tap-hold 200 200 e ralt) + irsft (tap-hold 200 200 i rsft) + orctrl (tap-hold 200 200 o rctrl) + clmk (layer-switch colemak) + qwerty (layer-switch qwerty) + + smartspace (tap-dance 200 ( + (tap-hold 300 300 spc (layer-toggle magic)) + (tap-hold 300 300 (one-shot 300 lalt) spc) + a + )) + + ) +</code></pre></td></tr></table> +</div> +</div>Logitech MB850 combi in linuxhttps://balkian.com/p/logitech-mb850-combi-in-linux/Sat, 30 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mb850-combi-in-linux/As a follow-up to my last post, I’ve decided to also configure my mk850 combo (k850 + m720 triathlon). +Some notes: +<ul> +<li>The keyboard is usually connected to this PC through bluetooth. Since this is a change I usually do in the system for every keyboard, I added a rule for any bus (usb, bluetooth, etc)</li> +<li>The mouse has an additional button that registers as a keyboard. Every press maps to three key events. I’ve disabled two of them and mapped the action to F19, in case I want to use it in my DE/WM.</li> +</ul> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">evdev:input:* + KEYBOARD_KEY_70039=leftctrl # bind capslock to w + +evdev:input:b0005v046DpB015* + KEYBOARD_KEY_700e0=f19 + KEYBOARD_KEY_700e2=unknown + KEYBOARD_KEY_7002b=unknown +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div>Make sure the settings have been applied by running <code>evemu-describe</code>: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"> sudo /sbin/evemu-describe /dev/input/event<id of your device> | grep KEY_ +</code></pre></td></tr></table> +</div> +</div>Logitech MX Keys for Mac on Linuxhttps://balkian.com/p/logitech-mx-keys-for-mac-on-linux/Fri, 29 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mx-keys-for-mac-on-linux/I recently got Logitech MX Keys for Mac keyboard at work. +The German version, to be more precise. +This version was three times cheaper than the Windows equivalent with either US or ES layout. +Since I touch type anyway, I thought it was a bargain. +As soon as I plugged it in, I realized there were some glaring issues with the keyboard. +First of all, the Meta/Super and Alt keys are reversed in this keyboard. +In the normal/full version of this keyboard, Logitech gives an option to choose between Mac, Windows and iOS host, and that changes the behavior of the keys. +In this version, tho, only iOS and Mac are available. +Besides that, there’s the issue of the grave (tilde) and angle keys switched as well. +Switching these keys around would be very easy with Xorg, but Wayland once again complicates things… +These issues almost made me return the keyboard. +Luckily, tho, there is another option: configuring the keys one level lower than wayland (and X11), through hwdb. +Long story short, this will configure any Logitech keyboard with the same product id (0x4092) to use a saner configuration: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">#File: /etc/udev/hwdb.d/90-logitech-keyboard.hwdb + +evdev:input:b0003v046Dp4092* + KEYBOARD_KEY_700e2=leftmeta + KEYBOARD_KEY_700e3=leftalt + KEYBOARD_KEY_70039=leftctrl + KEYBOARD_KEY_70064=102nd + KEYBOARD_KEY_70035=grave + KEYBOARD_KEY_700e7=rightalt + KEYBOARD_KEY_700e6=rightmeta + KEYBOARD_KEY_7006d=compose +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/logitech/page/1/index.html b/tags/logitech/page/1/index.html new file mode 100644 index 0000000..2f2d501 --- /dev/null +++ b/tags/logitech/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/logitech/ + \ No newline at end of file diff --git a/tags/mouse/index.html b/tags/mouse/index.html new file mode 100644 index 0000000..c70f843 --- /dev/null +++ b/tags/mouse/index.html @@ -0,0 +1,31 @@ +Tag: Mouse - J. Fernando Sánchez +

1 page

Mouse

Logitech MB850 combi in linux

\ No newline at end of file diff --git a/tags/mouse/index.xml b/tags/mouse/index.xml new file mode 100644 index 0000000..1781f5d --- /dev/null +++ b/tags/mouse/index.xml @@ -0,0 +1,45 @@ +Mouse on J. Fernando Sánchezhttps://balkian.com/tags/mouse/Recent content in Mouse on J. Fernando SánchezHugo -- gohugo.ioen-usSat, 30 Oct 2021 00:00:01 +0000Logitech MB850 combi in linuxhttps://balkian.com/p/logitech-mb850-combi-in-linux/Sat, 30 Oct 2021 00:00:01 +0000https://balkian.com/p/logitech-mb850-combi-in-linux/As a follow-up to my last post, I’ve decided to also configure my mk850 combo (k850 + m720 triathlon). +Some notes: +<ul> +<li>The keyboard is usually connected to this PC through bluetooth. Since this is a change I usually do in the system for every keyboard, I added a rule for any bus (usb, bluetooth, etc)</li> +<li>The mouse has an additional button that registers as a keyboard. Every press maps to three key events. I’ve disabled two of them and mapped the action to F19, in case I want to use it in my DE/WM.</li> +</ul> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">evdev:input:* + KEYBOARD_KEY_70039=leftctrl # bind capslock to w + +evdev:input:b0005v046DpB015* + KEYBOARD_KEY_700e0=f19 + KEYBOARD_KEY_700e2=unknown + KEYBOARD_KEY_7002b=unknown +</code></pre></td></tr></table> +</div> +</div>After that, simply run: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> sudo udevadm hwdb --update && sudo udevadm trigger +</code></pre></td></tr></table> +</div> +</div>Make sure the settings have been applied by running <code>evemu-describe</code>: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"> sudo /sbin/evemu-describe /dev/input/event<id of your device> | grep KEY_ +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/mouse/page/1/index.html b/tags/mouse/page/1/index.html new file mode 100644 index 0000000..5256810 --- /dev/null +++ b/tags/mouse/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/mouse/ + \ No newline at end of file diff --git a/tags/mqtt/index.html b/tags/mqtt/index.html new file mode 100644 index 0000000..c75dcd4 --- /dev/null +++ b/tags/mqtt/index.html @@ -0,0 +1,31 @@ +Tag: Mqtt - J. Fernando Sánchez +

1 page

Mqtt

Controlling Zigbee devices with MQTT

\ No newline at end of file diff --git a/tags/mqtt/index.xml b/tags/mqtt/index.xml new file mode 100644 index 0000000..76f6364 --- /dev/null +++ b/tags/mqtt/index.xml @@ -0,0 +1,132 @@ +Mqtt on J. Fernando Sánchezhttps://balkian.com/tags/mqtt/Recent content in Mqtt on J. Fernando SánchezHugo -- gohugo.ioen-usSun, 06 Jan 2019 10:00:00 +0000Controlling Zigbee devices with MQTThttps://balkian.com/p/controlling-zigbee-devices-with-mqtt/Sun, 06 Jan 2019 10:00:00 +0000https://balkian.com/p/controlling-zigbee-devices-with-mqtt/This is a short tutorial on connecting a zigbee device (an Aqara cube) +to an MQTT server, so you can control your zigbee devices from the +network. +If you’re anything like me, you’re probably a sucker for IoT devices. +For a long time, I’ve been using WiFi-enabled lights, and Amazon dash +buttons to control them. To keep these (cheap Chinese) internet enabled +devices away from your network and their respective cloud services, +you’ll probably want to set up a dedicated network in your router (more +on this on a future post, maybe). Another disadvantage of WiFi devices +is that they’re relatively power hungry. +A popular alternative is using ZigBee for communication. It is a +dedicated protocol similar to bluetooth (BLE), with lower power +requirements and bitrate. +Take the (super cute) aqara cube as an example. It is a small cube that +detects rotation on all of its axes, and tapping events. Here’s a +video: +<div class="video-wrapper"> +<iframe loading="lazy" +src="https://www.youtube.com/embed/5YtqG1wEnng" +allowfullscreen +title="YouTube Video" +> +</iframe> +</div> +To connect to zigbee devices you will need a zigbee enabled gateway +(a.k.a. hub), which connects to your WiFi network and your zigbee +devices. Once again, this means adding an internet-enabled device to +your home, and probably a couple of cloud services. +As an alternative, you can set up your own zigbee gateway, and control +it to your home automation platform of choice (e.g. home assistant). We +will cover how to set up a zigbee2mqtt gateway that is also connected to +an MQTT server, so you can use MQTT to control your devices and get +notifications. +What you need: +<ul> +<li><a class="link" href="https://www.aliexpress.com/item/Original-Xiaomi-Mi-Aqara-Cube-Smart-Home-Controller-6-Action-Operation-Fr-Home-Device-Zigbee-Version/32892947622.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>Aqara +cube</a>.</li> +<li><a class="link" href="https://www.aliexpress.com/item/Wireless-Zigbee-CC2531-CC2540-Zigbee-Sniffer-Bluetooth-BLE-4-0-Dongle-Capture-Module-USB-Programmer-Downloader/32907587711.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>CC2531 zigbee +sniffer</a>.</li> +<li><a class="link" href="https://www.aliexpress.com/item/CFSUNBIRD-CC-DEBUGGER-Debugger-and-Programmer-for-RF-System-on-Chips-TI-ORIGINAL-Fast-hipping/32813122315.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>CC-debugger</a>.</li> +</ul> +You will need to flash your sniffer. For that, you only need to follow +the instructions from the <a class="link" href="https://koenkk.github.io/zigbee2mqtt/" target="_blank" rel="noopener" +>zigbee2mqtt +documentation</a>. +Once you’re done flashing, you’re ready to set up the zigbee2mqtt +server. For convenience, I wrote a simple docker-compose to deploy a +zigbee2mqtt server and a test mosquitto server: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">version: '2.1' +services: + zigbee2mqtt: + image: koenkk/zigbee2mqtt + container_name: zigbee2mqtt + restart: always + volumes: + - ./z2m-data/:/app/data/ + devices: + - "/dev/ttyACM0" + networks: + - hass + mqtt: + image: eclipse-mosquitto + ports: + - 1883:1883 + - 9001:9001 + networks: + - hass + volumes: + - ./mosquitto.conf:/mosquitto/config/mosquitto.conf +networks: + hass: + driver: overlay +</code></pre></td></tr></table> +</div> +</div>You can test your installation with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">❯ mosquitto_sub -h localhost -p 1883 -t 'zigbee2mqtt/#' +online +{"battery":17,"voltage":2925,"linkquality":149,"action":"rotate_right","angle":12.8} +{"battery":17,"voltage":2925,"linkquality":141,"action":"slide","side":2} +{"battery":17,"voltage":2925,"linkquality":120} +{"battery":17,"voltage":2925,"linkquality":141,"action":"wakeup"}</code></pre></td></tr></table> +</div> +</div> +zigbee2mqtt supports the following events for the aqara cube: shake, +wakeup, fall, tap, slide, flip180, flip90, rotate_left and +rotate_right. Every event has additional information, such as the sides +involved, or the degrees turned. +Now you are ready to set up home assistant support in zigbee2mqtt +following <a class="link" href="https://koenkk.github.io/zigbee2mqtt/integration/home_assistant.html" target="_blank" rel="noopener" +>this +guide</a>. \ No newline at end of file diff --git a/tags/mqtt/page/1/index.html b/tags/mqtt/page/1/index.html new file mode 100644 index 0000000..890dfcf --- /dev/null +++ b/tags/mqtt/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/mqtt/ + \ No newline at end of file diff --git a/tags/nginx/index.html b/tags/nginx/index.html new file mode 100644 index 0000000..5db151e --- /dev/null +++ b/tags/nginx/index.html @@ -0,0 +1,31 @@ +Tag: Nginx - J. Fernando Sánchez +

1 page

Nginx

Zotero

\ No newline at end of file diff --git a/tags/nginx/index.xml b/tags/nginx/index.xml new file mode 100644 index 0000000..0383521 --- /dev/null +++ b/tags/nginx/index.xml @@ -0,0 +1,142 @@ +Nginx on J. Fernando Sánchezhttps://balkian.com/tags/nginx/Recent content in Nginx on J. Fernando SánchezHugo -- gohugo.ioen-usTue, 09 Dec 2014 12:12:12 +0000Zoterohttps://balkian.com/p/zotero/Tue, 09 Dec 2014 12:12:12 +0000https://balkian.com/p/zotero/<a class="link" href="https://www.zotero.org/" target="_blank" rel="noopener" +>Zotero</a> is an Open Source tool that lets you +organise your bibliography, syncing it with the cloud. Unlike other +alternatives such as <a class="link" href="http://www.mendeley.com" target="_blank" rel="noopener" +>Mendeley</a>, Zotero can +upload the attachments and data to a private cloud via WebDav. +If you use nginx as your web server, know that even though it provides +partial support for webdav, Zotero needs more than that. Hence, you will +need another webdav server, and optionally let nginx proxy to it. This +short post provides the basics to get that set-up working under +Debian/Ubuntu. +<h2 id="setting-up-apache">Setting up Apache +</h2>First we need to install Apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo apt-get install apache2 +</code></pre></td></tr></table> +</div> +</div>Change the head of “/etc/apache2/sites-enabled/000-default” to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><VirtualHost *:880> +</code></pre></td></tr></table> +</div> +</div>Then, create a file /etc/apache2/sites-available/webdav: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache">Alias /dav /home/webdav/dav +<Location /dav> + Dav on + Order Allow,Deny + Allow from all + Dav On + Options +Indexes + AuthType Basic + AuthName DAV + AuthBasicProvider file + AuthUserFile /home/webdav/.htpasswd + Require valid-user +</Location> +</code></pre></td></tr></table> +</div> +</div>Ideally, you want your webdav folders to be private, adding +authentication to them. So you need to create the webdav and zotero +users and add the passwords to an htpasswd file. Even though you could +use a single user, since you will be configuring several clients with +your credentials I encourage you to create the zotero user as well. This +way you can always change the password for zotero without affecting any +other application using webdav. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo adduser webdav +sudo htpasswd -c /home/webdav/.htpasswd webdav +sudo htpasswd /home/webdav/.htpasswd zotero +sudo mkdir -p /home/webdav/dav/zotero +</code></pre></td></tr></table> +</div> +</div>Enable the site and restart apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo a2enmod webdav +sudo a2enmod dav_fs +sudo a2ensite webdav +sudo service apache2 restart +</code></pre></td></tr></table> +</div> +</div>At this point everything should be working at +<a class="link" href="http://" target="_blank" rel="noopener" +>http://</a><your_host>:880/dav/zotero +<h2 id="setting-up-nginx">Setting up NGINX +</h2>After the Apache side is working, we can use nginx as a proxy to get +cleaner URIs. In your desired site/location, add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-nginx" data-lang="nginx">location /dav { + client_max_body_size 20M; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $remote_addr; + proxy_set_header Host $host; + proxy_pass http://127.0.0.1:880; +} +</code></pre></td></tr></table> +</div> +</div>Now just reload nginx: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo service nginx force-reload +</code></pre></td></tr></table> +</div> +</div><h2 id="extras">Extras +</h2><ul> +<li><a class="link" href="http://zoteroreader.com/" target="_blank" rel="noopener" +>Zotero Reader</a> - HTML5 client</li> +<li><a class="link" href="https://github.com/ajlyon/zandy" target="_blank" rel="noopener" +>Zandy</a> - Android Open Source +client</li> +</ul> \ No newline at end of file diff --git a/tags/nginx/page/1/index.html b/tags/nginx/page/1/index.html new file mode 100644 index 0000000..bdbc632 --- /dev/null +++ b/tags/nginx/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/nginx/ + \ No newline at end of file diff --git a/tags/nix/index.html b/tags/nix/index.html new file mode 100644 index 0000000..738262e --- /dev/null +++ b/tags/nix/index.html @@ -0,0 +1,31 @@ +Tag: Nix - J. Fernando Sánchez +

1 page

Nix

Nix Recipe for Python Projects

\ No newline at end of file diff --git a/tags/nix/index.xml b/tags/nix/index.xml new file mode 100644 index 0000000..4ad16af --- /dev/null +++ b/tags/nix/index.xml @@ -0,0 +1,97 @@ +Nix on J. Fernando Sánchezhttps://balkian.com/tags/nix/Recent content in Nix on J. Fernando SánchezHugo -- gohugo.ioen-usMon, 13 Nov 2023 18:21:46 +0100Nix Recipe for Python Projectshttps://balkian.com/p/nix-recipe-for-python-projects/Mon, 13 Nov 2023 18:21:46 +0100https://balkian.com/p/nix-recipe-for-python-projects/This is a quick and easy recipe to add a <code>default.nix</code> to any Python project with a <code>requirements.txt</code> file: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-nix" data-lang="nix">with import <nixpkgs> { }; + +let + pythonPackages = python311Packages; +in pkgs.mkShell rec { + name = "impurePythonEnv"; + venvDir = "./.venv"; + buildInputs = [ + # A python interpreter including the 'venv' module is required to bootstrap + # the environment. + pythonPackages.python + + # This execute some shell code to initialize a venv in $venvDir before + # dropping into the shell + pythonPackages.venvShellHook + + # Those are dependencies that we would like to use from nixpkgs, which will + # add them to PYTHONPATH and thus make them accessible from within the venv. + pythonPackages.numpy + pythonPackages.requests + + # In this particular example, in order to compile any binary extensions they may + # require, the python modules listed in the hypothetical requirements.txt need + # the following packages to be installed locally: + taglib + openssl + git + libxml2 + libxslt + libzip + zlib + ]; + + # Now we can execute any commands within the virtual environment. + # This is optional and can be left out to run pip manually. + postShellHook = '' + pip install -r requirements.txt + ''; + +} +</code></pre></td></tr></table> +</div> +</div>Now, you will get a clean environment by running: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">nix-shell +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/nix/page/1/index.html b/tags/nix/page/1/index.html new file mode 100644 index 0000000..f26c1b7 --- /dev/null +++ b/tags/nix/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/nix/ + \ No newline at end of file diff --git a/tags/org/index.html b/tags/org/index.html new file mode 100644 index 0000000..34bdebb --- /dev/null +++ b/tags/org/index.html @@ -0,0 +1,31 @@ +Tag: Org - J. Fernando Sánchez +

1 page

Org

Emacs

\ No newline at end of file diff --git a/tags/org/index.xml b/tags/org/index.xml new file mode 100644 index 0000000..08dc838 --- /dev/null +++ b/tags/org/index.xml @@ -0,0 +1,10 @@ +Org on J. Fernando Sánchezhttps://balkian.com/tags/org/Recent content in Org on J. Fernando SánchezHugo -- gohugo.ioen-usEmacshttps://balkian.com/emacs/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/emacs/<img src="https://balkian.com/img/emacs.png" alt="Featured image of post Emacs" /><h2 id="show-plain-text-version">Show plain text version +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(font-lock-mode) +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/org/page/1/index.html b/tags/org/page/1/index.html new file mode 100644 index 0000000..fa7f605 --- /dev/null +++ b/tags/org/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/org/ + \ No newline at end of file diff --git a/tags/page/1/index.html b/tags/page/1/index.html new file mode 100644 index 0000000..da632d9 --- /dev/null +++ b/tags/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/ + \ No newline at end of file diff --git a/tags/page/2/index.html b/tags/page/2/index.html new file mode 100644 index 0000000..014aab1 --- /dev/null +++ b/tags/page/2/index.html @@ -0,0 +1,35 @@ +Tags +

Section

35 pages

Tags

Lisp

Org

Productivity

Programming

Rpi

\ No newline at end of file diff --git a/tags/productivity/index.html b/tags/productivity/index.html new file mode 100644 index 0000000..633752a --- /dev/null +++ b/tags/productivity/index.html @@ -0,0 +1,31 @@ +Tag: Productivity - J. Fernando Sánchez +

Tags

1 page

Productivity

Emacs

\ No newline at end of file diff --git a/tags/productivity/index.xml b/tags/productivity/index.xml new file mode 100644 index 0000000..138d56b --- /dev/null +++ b/tags/productivity/index.xml @@ -0,0 +1,10 @@ +Productivity on J. Fernando Sánchezhttps://balkian.com/tags/productivity/Recent content in Productivity on J. Fernando SánchezHugo -- gohugo.ioen-usEmacshttps://balkian.com/emacs/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/emacs/<img src="https://balkian.com/img/emacs.png" alt="Featured image of post Emacs" /><h2 id="show-plain-text-version">Show plain text version +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(font-lock-mode) +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/productivity/page/1/index.html b/tags/productivity/page/1/index.html new file mode 100644 index 0000000..4921f2a --- /dev/null +++ b/tags/productivity/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/productivity/ + \ No newline at end of file diff --git a/tags/programming/index.html b/tags/programming/index.html new file mode 100644 index 0000000..52ab459 --- /dev/null +++ b/tags/programming/index.html @@ -0,0 +1,31 @@ +Tag: Programming - J. Fernando Sánchez +

1 page

Programming

Python

\ No newline at end of file diff --git a/tags/programming/index.xml b/tags/programming/index.xml new file mode 100644 index 0000000..3d62c7d --- /dev/null +++ b/tags/programming/index.xml @@ -0,0 +1,26 @@ +Programming on J. Fernando Sánchezhttps://balkian.com/tags/programming/Recent content in Programming on J. Fernando SánchezHugo -- gohugo.ioen-usPythonhttps://balkian.com/python/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/python/<img src="https://balkian.com/img/python.png" alt="Featured image of post Python" /><h2 id="interesting-libraries">Interesting libraries +</h2><h3 id="tqdm"><a class="link" href="https://github.com/tqdm/tqdm" target="_blank" rel="noopener" +>TQDM</a> +</h3>From tqdm’s github repository: +<blockquote> +tqdm means “progress” in Arabic (taqadum, تقدّم) and an abbreviation for “I love you so much” in Spanish (te quiero demasiado).</blockquote> +<img src="https://raw.githubusercontent.com/tqdm/tqdm/master/images/tqdm.gif" +loading="lazy" +alt="TQDM in action" +> +<h2 id="tools">Tools +</h2><h3 id="uv"><a class="link" href="https://github.com/astral-sh/uv" target="_blank" rel="noopener" +>uv</a> +</h3>🚀 A single tool to replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +⚡️ 10-100x faster than pip. +<ul> +<li>Provides comprehensive project management, with a universal lockfile.</li> +<li>Runs scripts, with support for inline dependency metadata.</li> +<li>Installs and manages Python versions.</li> +<li>Runs and installs tools published as Python packages.</li> +<li>Includes a pip-compatible interface for a performance boost with a familiar CLI.</li> +<li>Supports Cargo-style workspaces for scalable projects.</li> +<li>Disk-space efficient, with a global cache for dependency deduplication.</li> +<li>Installable without Rust or Python via curl or pip.</li> +<li>Supports macOS, Linux, and Windows.</li> +</ul> \ No newline at end of file diff --git a/tags/programming/page/1/index.html b/tags/programming/page/1/index.html new file mode 100644 index 0000000..c949be7 --- /dev/null +++ b/tags/programming/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/programming/ + \ No newline at end of file diff --git a/tags/proxy/index.html b/tags/proxy/index.html new file mode 100644 index 0000000..6ee7f77 --- /dev/null +++ b/tags/proxy/index.html @@ -0,0 +1,31 @@ +Tag: Proxy - J. Fernando Sánchez +

1 page

Proxy

Proxies with Apache and python

\ No newline at end of file diff --git a/tags/proxy/index.xml b/tags/proxy/index.xml new file mode 100644 index 0000000..b5cd5c0 --- /dev/null +++ b/tags/proxy/index.xml @@ -0,0 +1,105 @@ +Proxy on J. Fernando Sánchezhttps://balkian.com/tags/proxy/Recent content in Proxy on J. Fernando SánchezHugo -- gohugo.ioen-usThu, 09 Oct 2014 10:00:00 +0000Proxies with Apache and pythonhttps://balkian.com/p/proxies-with-apache-and-python/Thu, 09 Oct 2014 10:00:00 +0000https://balkian.com/p/proxies-with-apache-and-python/This is a quick note on proxying a local python application (e.g. flask) +to a subdirectory in Apache. This assumes that the file wsgi.py contains +a WSGI application with the name application. Hence, wsgi:application. +<h2 id="gunicorn">Gunicorn +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + ProxyPass http://127.0.0.1:8888/myapp/ + ProxyPassReverse http://127.0.0.1:8888/myapp/ + RequestHeader set SCRIPT_NAME "/myapp/" +</Location> +</code></pre></td></tr></table> +</div> +</div>Important: SCRIPT_NAME and the end of ProxyPass URL MUST BE +THE SAME. Otherwise, Gunicorn will fail miserably. +Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">venv/bin/gunicorn -w 4 -b 127.0.0.1:8888 --log-file - --access-logfile - wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="uwsgi">UWSGI +</h2>This is a very simple configuration. I will try to upload one with more +options for uwsgi (in a .ini file). +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + SetHandler uwsgi_handler + uWSGISocker 127.0.0.1:8888 +</Location> +</code></pre></td></tr></table> +</div> +</div>Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">uwsgi --socket 127.0.0.1:8888 -w wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="extra-supervisor">Extra: Supervisor +</h2>If everything went as expected, you can wrap your command in a +supervisor config file and let it handle the server for you. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini">[unix_http_server] +file=/tmp/myapp.sock ; path to your socket file + +[supervisord] +logfile = %(here)s/logs/supervisor.log +childlogdir = %(here)s/logs/ + +[rpcinterface:supervisor] +supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface + +[supervisorctl] +logfile = %(here)s/logs/supervisorctl.log +serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket + +[program:myapp] +command = venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 --log-file %(here)s/logs/gunicorn.log --access-logfile - wsgi:application +directory = %(here)s +environment = PATH=%(here)s/venv/bin/ +logfile = %(here)s/logs/myapp.log +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/proxy/page/1/index.html b/tags/proxy/page/1/index.html new file mode 100644 index 0000000..03d18a5 --- /dev/null +++ b/tags/proxy/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/proxy/ + \ No newline at end of file diff --git a/tags/pypi/index.html b/tags/pypi/index.html new file mode 100644 index 0000000..0966e37 --- /dev/null +++ b/tags/pypi/index.html @@ -0,0 +1,31 @@ +Tag: Pypi - J. Fernando Sánchez +

1 page

Pypi

Publishing on PyPi

\ No newline at end of file diff --git a/tags/pypi/index.xml b/tags/pypi/index.xml new file mode 100644 index 0000000..21e99a7 --- /dev/null +++ b/tags/pypi/index.xml @@ -0,0 +1,162 @@ +Pypi on J. Fernando Sánchezhttps://balkian.com/tags/pypi/Recent content in Pypi on J. Fernando SánchezHugo -- gohugo.ioen-usSat, 27 Sep 2014 10:00:00 +0000Publishing on PyPihttps://balkian.com/p/publishing-on-pypi/Sat, 27 Sep 2014 10:00:00 +0000https://balkian.com/p/publishing-on-pypi/Developing a python module and publishing it on Github is cool, but most +of the times you want others to download and use it easily. That is the +role of PyPi, the python package repository. In this post I show you how +to publish your package in less than 10 minutes. +<h2 id="choose-a-fancy-name">Choose a fancy name +</h2>If you haven’t done so yet, take a minute or two to think about this. +To publish on PyPi you need a name for your package that isn’t taken. +What’s more, a catchy and unique name will help people remember your +module and feel more inclined to at least try it. +The package name should hint what your module does, but that’s not +always the case. That’s your call. I personally put uniqueness and +memorability over describing the functionality. +<h2 id="create-a-pypirc-configuration-file">Create a .pypirc configuration file +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[distutils] # this tells distutils what package indexes you can push to +index-servers = + pypi # the live PyPI + pypitest # test PyPI + +[pypi] # authentication details for live PyPI +repository = https://pypi.python.org/pypi +username = { your_username } +password = { your_password } # not necessary + +[pypitest] # authentication details for test PyPI +repository = https://testpypi.python.org/pypi +username = { your_username } +</code></pre></td></tr></table> +</div> +</div>As you can see, you need to register both in the <a class="link" href="https://pypi.python.org/pypi?%3Aaction=register_form" target="_blank" rel="noopener" +>main pypi +repository</a> and +the <a class="link" href="https://testpypi.python.org/pypi?%3Aaction=register_form" target="_blank" rel="noopener" +>testing +server</a>. The +usernames and passwords might be different, that is up to you! +<h2 id="prepare-your-package">Prepare your package +</h2>This should be the structure: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">root-dir/ # Any name you want + setup.py + setup.cfg + LICENSE.txt + README.md + mypackage/ + __init__.py + foo.py + bar.py + baz.py +</code></pre></td></tr></table> +</div> +</div><h3 id="setupcfg">setup.cfg +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[metadata] +description-file = README.md +</code></pre></td></tr></table> +</div> +</div>The markdown README is the de facto standard in Github, but you can +also use rST (reStructuredText), the standard in the python community. +<h3 id="setuppy">setup.py +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from distutils.core import setup + +setup(name = 'mypackage', + packages = ['mypackage'], # this must be the same as the name above + version = '{ version }', + description = '{ description }', + author = '{ name }', + email = '{ email }', + url = 'https://github.com/{user}/{package}', # URL to the github repo + download_url = 'https://github.com/{user}/{repo}/tarball/{version}', + keywords = ['websockets', 'display', 'd3'], # list of keywords that represent your package + classifiers = [], ) +</code></pre></td></tr></table> +</div> +</div>You might notice that the download_url points to a Github URL. We could +host our package anywhere, but Github is a convenient option. To create +the tarball and the zip packages, you only need to tag a tag in your +repository and push it to github: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git tag {version} -m "{ Description of this tag/version}" +git push --tags origin master +</code></pre></td></tr></table> +</div> +</div><h2 id="push-to-the-testingmain-pypi-server">Push to the testing/main pypi server +</h2>It is advisable that you try your package on the test repository and fix +any problems first. The process is simple: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">python setup.py register -r {pypitest/pypi} python setup.py sdist upload -r {pypitest/pypi} +</code></pre></td></tr></table> +</div> +</div>If everything went as expected, you can now install your package through +pip and browse your package’s page. For instance, check my senpy +package: <a class="link" href="https://pypi.python.org/pypi/senpy" target="_blank" rel="noopener" +>https://pypi.python.org/pypi/senpy</a> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">pip install senpy +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/pypi/page/1/index.html b/tags/pypi/page/1/index.html new file mode 100644 index 0000000..7cd8109 --- /dev/null +++ b/tags/pypi/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/pypi/ + \ No newline at end of file diff --git a/tags/python/index.html b/tags/python/index.html new file mode 100644 index 0000000..235e626 --- /dev/null +++ b/tags/python/index.html @@ -0,0 +1,32 @@ +Tag: Python - J. Fernando Sánchez +

7 pages

Python

uv - One rust tool to rule all pythons

Nix Recipe for Python Projects

Progress bars in python

Proxies with Apache and python

Publishing on PyPi

\ No newline at end of file diff --git a/tags/python/index.xml b/tags/python/index.xml new file mode 100644 index 0000000..aa9a36e --- /dev/null +++ b/tags/python/index.xml @@ -0,0 +1,665 @@ +Python on J. Fernando Sánchezhttps://balkian.com/tags/python/Recent content in Python on J. Fernando SánchezHugo -- gohugo.ioen-usMon, 17 Feb 2025 23:02:47 +0100uv - One rust tool to rule all pythonshttps://balkian.com/p/uv-one-rust-tool-to-rule-all-pythons/Mon, 17 Feb 2025 23:02:47 +0100https://balkian.com/p/uv-one-rust-tool-to-rule-all-pythons/<img src="https://balkian.com/img/uv.png" alt="Featured image of post uv - One rust tool to rule all pythons" />Long story short: I’m now using <a class="link" href="https://github.com/astral-sh/uv" target="_blank" rel="noopener" +>uv</a>, and so should you. +It is a great replacement for pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +<h2 id="context">Context +</h2>For years, my strategy to manage python projects has been a mix of a custom <code>setup.py</code>, several hand-crafted <code>requirements.txt</code> files (through <code>pip freeze</code>), a custom virtualenv per project, and multiple tools to upload to PyPI. +Although this works, this setup has many drawbacks: +<ul> +<li>It requires user intervention (creating a venv, sourcing it, handling new deps). This isn’t ideal if you want new (probably inexperienced) users to use your projects.</li> +<li>On a similar note, the whole process needs to be well documented if you want other users to contribute or maintain the code.</li> +<li>Pinning dependency versions is finicky, and I’ve run into problems beause of that.</li> +<li>Creating a new project involves a template, or copying files from an older project.</li> +</ul> +Of course, this is nothing new. +There is a whole site dedicated to <a class="link" href="https://packaging.python.org/en/latest/" target="_blank" rel="noopener" +>packaging your Python project</a>. +A plethora of different projects have come and go, with varying degrees of success. +<h2 id="alternatives-poetry">Alternatives (poetry) +</h2>About a year before trying <code>uv</code>, I tried to catch up with the ecosystem and get to know the <code>blessed new way</code>. +However, the task proved to be a little more difficult, as the landscape is filled with a myriad of alternatives, each with their own set of drawbacks and detractors. +Packaging has historically been a weak spot, in ironical contradiction to the Zen of Python’s “There should be one– and preferably only one –obvious way to do it”, +I eventually settled on <a class="link" href="https://python-poetry.org/" target="_blank" rel="noopener" +>poetry</a>. +Mostly because it seemed like the most popular alternative. +There are many things I liked about it. +First of all, having a convention for dependencies (<code>pyproject.toml</code>) and a tool that properly handles them was nice. +It also removed the need to remember specific incantations to build and publish my Python projects. +Lastly, I mixed it <code>poetry2nix</code> to create reproducible python environments using nix. +This makes for a very powerful experience. +However, there were multiple hiccups. +First of all, it took me some time to figure out which specific fields to use (each tool can define ad-hoc properties in a the <code>pyproject.toml</code> file), and some of them seemed redundant with the more generic ones. +Full disclosure, this specific point might be a mistake on my side, and I do not remember the details. +The second one is speed. +(Re-)creating an environment took a non-negligible amount of time. +<h2 id="enter-light-uv">Enter <del>light</del> <code>uv</code> +</h2>According to its repository, <code>uv </code>can replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +Not only that, but it also claims to do that 10-100 times faster than pip. +I must admit that it being written in rust was a another selling point for me, as I’m looking for excuses to collaborate in a decently-sized rust projejct. +Installing it is dead simple: simply download the binary (e.g., with curl) or run <code>pip install uv</code>. +You won’t need much more: <code>uv</code> seems to just do the right thing out of the box. +And it does it really, really fast. +The rest of the time it gets out of the way. +My only gripe so far is that I don’t seem to find a built-in command to drop into a shell, but that is nothing that <code>uv run $SHELL</code> cannot fix. +<h2 id="common-operations">Common operations +</h2><h3 id="initialize-a-repository">Initialize a repository +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv init +</code></pre></td></tr></table> +</div> +</div><h3 id="adding-dependencies">Adding dependencies +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv add senpy +</code></pre></td></tr></table> +</div> +</div><h3 id="running-commands-inside-the-environment">Running commands inside the environment +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv run <COMMAND> + +# e.g., run a shell using your python version and dependencies +uv run $SHELL +</code></pre></td></tr></table> +</div> +</div><h3 id="dependency-tree">Dependency tree +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">uv shell +Resolved 44 packages in 1ms +my-project v0.1.0 +├── fastapi[standard] v0.115.8 +│ ├── pydantic v2.10.6 +│ │ ├── annotated-types v0.7.0 +│ │ ├── pydantic-core v2.27.2 +│ │ │ └── typing-extensions v4.12.2 +│ │ └── typing-extensions v4.12.2 +│ ├── starlette v0.45.3 +│ │ └── anyio v4.8.0 +│ │ ├── exceptiongroup v1.2.2 +│ │ ├── idna v3.10 +│ │ ├── sniffio v1.3.1 +│ │ └── typing-extensions v4.12.2 +│ ├── typing-extensions v4.12.2 +│ ├── email-validator v2.2.0 (extra: standard) +│ │ ├── dnspython v2.7.0 +... +</code></pre></td></tr></table> +</div> +</div>Nix Recipe for Python Projectshttps://balkian.com/p/nix-recipe-for-python-projects/Mon, 13 Nov 2023 18:21:46 +0100https://balkian.com/p/nix-recipe-for-python-projects/This is a quick and easy recipe to add a <code>default.nix</code> to any Python project with a <code>requirements.txt</code> file: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-nix" data-lang="nix">with import <nixpkgs> { }; + +let + pythonPackages = python311Packages; +in pkgs.mkShell rec { + name = "impurePythonEnv"; + venvDir = "./.venv"; + buildInputs = [ + # A python interpreter including the 'venv' module is required to bootstrap + # the environment. + pythonPackages.python + + # This execute some shell code to initialize a venv in $venvDir before + # dropping into the shell + pythonPackages.venvShellHook + + # Those are dependencies that we would like to use from nixpkgs, which will + # add them to PYTHONPATH and thus make them accessible from within the venv. + pythonPackages.numpy + pythonPackages.requests + + # In this particular example, in order to compile any binary extensions they may + # require, the python modules listed in the hypothetical requirements.txt need + # the following packages to be installed locally: + taglib + openssl + git + libxml2 + libxslt + libzip + zlib + ]; + + # Now we can execute any commands within the virtual environment. + # This is optional and can be left out to run pip manually. + postShellHook = '' + pip install -r requirements.txt + ''; + +} +</code></pre></td></tr></table> +</div> +</div>Now, you will get a clean environment by running: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">nix-shell +</code></pre></td></tr></table> +</div> +</div>Progress bars in pythonhttps://balkian.com/p/progress-bars-in-python/Wed, 28 Sep 2016 18:47:00 +0000https://balkian.com/p/progress-bars-in-python/<a class="link" href="https://github.com/noamraph/tqdm" target="_blank" rel="noopener" +>tqdm</a> is a nice way to add progress +bars in the command line or in a jupyter notebook. +<img src="https://camo.githubusercontent.com/48838faaa8d00ea297f18e5bf55d3c6bb4e0ba6b/68747470733a2f2f692e696d6775722e636f6d2f686539417735432e676966" +loading="lazy" +alt="image" +> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from tqdm import tqdm +import time + +for i in tqdm(range(100)): + time.sleep(1) +</code></pre></td></tr></table> +</div> +</div>Proxies with Apache and pythonhttps://balkian.com/p/proxies-with-apache-and-python/Thu, 09 Oct 2014 10:00:00 +0000https://balkian.com/p/proxies-with-apache-and-python/This is a quick note on proxying a local python application (e.g. flask) +to a subdirectory in Apache. This assumes that the file wsgi.py contains +a WSGI application with the name application. Hence, wsgi:application. +<h2 id="gunicorn">Gunicorn +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + ProxyPass http://127.0.0.1:8888/myapp/ + ProxyPassReverse http://127.0.0.1:8888/myapp/ + RequestHeader set SCRIPT_NAME "/myapp/" +</Location> +</code></pre></td></tr></table> +</div> +</div>Important: SCRIPT_NAME and the end of ProxyPass URL MUST BE +THE SAME. Otherwise, Gunicorn will fail miserably. +Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">venv/bin/gunicorn -w 4 -b 127.0.0.1:8888 --log-file - --access-logfile - wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="uwsgi">UWSGI +</h2>This is a very simple configuration. I will try to upload one with more +options for uwsgi (in a .ini file). +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + SetHandler uwsgi_handler + uWSGISocker 127.0.0.1:8888 +</Location> +</code></pre></td></tr></table> +</div> +</div>Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">uwsgi --socket 127.0.0.1:8888 -w wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="extra-supervisor">Extra: Supervisor +</h2>If everything went as expected, you can wrap your command in a +supervisor config file and let it handle the server for you. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini">[unix_http_server] +file=/tmp/myapp.sock ; path to your socket file + +[supervisord] +logfile = %(here)s/logs/supervisor.log +childlogdir = %(here)s/logs/ + +[rpcinterface:supervisor] +supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface + +[supervisorctl] +logfile = %(here)s/logs/supervisorctl.log +serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket + +[program:myapp] +command = venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 --log-file %(here)s/logs/gunicorn.log --access-logfile - wsgi:application +directory = %(here)s +environment = PATH=%(here)s/venv/bin/ +logfile = %(here)s/logs/myapp.log +</code></pre></td></tr></table> +</div> +</div>Publishing on PyPihttps://balkian.com/p/publishing-on-pypi/Sat, 27 Sep 2014 10:00:00 +0000https://balkian.com/p/publishing-on-pypi/Developing a python module and publishing it on Github is cool, but most +of the times you want others to download and use it easily. That is the +role of PyPi, the python package repository. In this post I show you how +to publish your package in less than 10 minutes. +<h2 id="choose-a-fancy-name">Choose a fancy name +</h2>If you haven’t done so yet, take a minute or two to think about this. +To publish on PyPi you need a name for your package that isn’t taken. +What’s more, a catchy and unique name will help people remember your +module and feel more inclined to at least try it. +The package name should hint what your module does, but that’s not +always the case. That’s your call. I personally put uniqueness and +memorability over describing the functionality. +<h2 id="create-a-pypirc-configuration-file">Create a .pypirc configuration file +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[distutils] # this tells distutils what package indexes you can push to +index-servers = + pypi # the live PyPI + pypitest # test PyPI + +[pypi] # authentication details for live PyPI +repository = https://pypi.python.org/pypi +username = { your_username } +password = { your_password } # not necessary + +[pypitest] # authentication details for test PyPI +repository = https://testpypi.python.org/pypi +username = { your_username } +</code></pre></td></tr></table> +</div> +</div>As you can see, you need to register both in the <a class="link" href="https://pypi.python.org/pypi?%3Aaction=register_form" target="_blank" rel="noopener" +>main pypi +repository</a> and +the <a class="link" href="https://testpypi.python.org/pypi?%3Aaction=register_form" target="_blank" rel="noopener" +>testing +server</a>. The +usernames and passwords might be different, that is up to you! +<h2 id="prepare-your-package">Prepare your package +</h2>This should be the structure: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">root-dir/ # Any name you want + setup.py + setup.cfg + LICENSE.txt + README.md + mypackage/ + __init__.py + foo.py + bar.py + baz.py +</code></pre></td></tr></table> +</div> +</div><h3 id="setupcfg">setup.cfg +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-cfg" data-lang="cfg">[metadata] +description-file = README.md +</code></pre></td></tr></table> +</div> +</div>The markdown README is the de facto standard in Github, but you can +also use rST (reStructuredText), the standard in the python community. +<h3 id="setuppy">setup.py +</h3><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">from distutils.core import setup + +setup(name = 'mypackage', + packages = ['mypackage'], # this must be the same as the name above + version = '{ version }', + description = '{ description }', + author = '{ name }', + email = '{ email }', + url = 'https://github.com/{user}/{package}', # URL to the github repo + download_url = 'https://github.com/{user}/{repo}/tarball/{version}', + keywords = ['websockets', 'display', 'd3'], # list of keywords that represent your package + classifiers = [], ) +</code></pre></td></tr></table> +</div> +</div>You might notice that the download_url points to a Github URL. We could +host our package anywhere, but Github is a convenient option. To create +the tarball and the zip packages, you only need to tag a tag in your +repository and push it to github: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git tag {version} -m "{ Description of this tag/version}" +git push --tags origin master +</code></pre></td></tr></table> +</div> +</div><h2 id="push-to-the-testingmain-pypi-server">Push to the testing/main pypi server +</h2>It is advisable that you try your package on the test repository and fix +any problems first. The process is simple: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">python setup.py register -r {pypitest/pypi} python setup.py sdist upload -r {pypitest/pypi} +</code></pre></td></tr></table> +</div> +</div>If everything went as expected, you can now install your package through +pip and browse your package’s page. For instance, check my senpy +package: <a class="link" href="https://pypi.python.org/pypi/senpy" target="_blank" rel="noopener" +>https://pypi.python.org/pypi/senpy</a> +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">pip install senpy +</code></pre></td></tr></table> +</div> +</div>Updating EuroLoveMaphttps://balkian.com/p/updating-eurolovemap/Thu, 27 Mar 2014 14:00:00 +0000https://balkian.com/p/updating-eurolovemap/As part of the <a class="link" href="http://www.opener-project.org/2013/07/18/opener-hackathon-in-amsterdam/" target="_blank" rel="noopener" +>OpeNER +hackathon</a> +we decided to build a prototype that would allow us to compare how +different countries feel about several topics. We used the OpeNER +pipeline to get the sentiment from a set of newspaper articles we +gathered from media in several languages. Then we aggregated those +articles by category and country (using the source of the article or the +language it was written in), obtaining the “overall feeling” of each +country about each topic. Then, we used some fancy JavaScript to make +sense out of the raw information. +It didn’t go too bad, it turns out <a class="link" href="http://eurosentiment.eu/wp-content/uploads/2013/07/BOLv9qnCIAAJEek.jpg" target="_blank" rel="noopener" +>we +won</a>. +Now, it was time for a face-lift. I used this opportunity to play with +new technologies and improve it: +<ul> +<li>Using Flask, this time using python 3.3 and Bootstrap 3.0</li> +<li>Cool HTML5+JS cards (thanks to +<a class="link" href="http://pastetophone.com" target="_blank" rel="noopener" +>pastetophone</a>)</li> +<li>Automatic generation of fake personal data to test the interface</li> +<li>Obfuscation of personal emails</li> +</ul> +The result can be <a class="link" href="http://eurolovemap.herokuapp.com/" target="_blank" rel="noopener" +>seen here</a>. +<h2 id="publishing-a-python-3-app-on-heroku">Publishing a Python 3 app on Heroku +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">mkvirtualenv -p /usr/bin/python3.3 eurolovemap +</code></pre></td></tr></table> +</div> +</div>Since Heroku uses python 2.7 by default, we have to tell it which +version we want, although it supports python 3.4 as well. I couldn’t +get python 3.4 working using the +<a class="link" href="https://launchpad.net/~fkrull/+archive/deadsnakes" target="_blank" rel="noopener" +>deadsnakes</a> ppa, so +I used python 3.3 instead, which works fine but is not officially +supported. Just create a file named runtime.txt in your project root, +with the python version you want to use: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">python-3.3.1 +</code></pre></td></tr></table> +</div> +</div>Don’t forget to freeze your dependencies so Heroku can install them: +<code>bash pip freze > requirements.txt</code> +<h2 id="publishing-personal-emails">Publishing personal emails +</h2>There are really sophisticated and effective ways to obfuscate personal +emails so that spammers cannot easily grab yours. However, this time I +needed something really simple to hide our emails from the simplest form +of crawlers. Most of the team are in academia somehow, so in the end all +our emails are available in sites like Google Scholar. Anyway, nobody +likes getting spammed so I settled for a custom <a class="link" href="http://en.wikipedia.org/wiki/Caesar_cipher" target="_blank" rel="noopener" +>Caesar +cipher</a>. Please, don’t use +it for any serious application if you are concerned about being spammed. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">def blur_email(email): + return "".join([chr(ord(i)+5) for i in email]) +</code></pre></td></tr></table> +</div> +</div>And this is the client side: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-javascript" data-lang="javascript">window.onload = function(){ + elems = document.getElementsByClassName('profile-email'); + for(var e in elems){ + var blur = elems[e].innerHTML; + var email = ""; + for(var s in blur){ + var a = blur.charCodeAt(s) + email = email+String.fromCharCode(a-5); + } + elems[e].innerHTML = email; + } +} +</code></pre></td></tr></table> +</div> +</div>Unfortunately, this approach does not hide your email from anyone using +<a class="link" href="http://phantomjs.org/" target="_blank" rel="noopener" +>PhantomJS</a>, +<a class="link" href="http://zombie.labnotes.org/" target="_blank" rel="noopener" +>ZombieJS</a> or similar. For that, other +approaches like generating a picture with the address would be +necessary. Nevertheless, it is overkill for a really simple ad-hoc +application with custom formatting and just a bunch of emails that would +easily be grabbed manually. +<h2 id="generation-of-fake-data">Generation of fake data +</h2>To test the contact section of the site, I wanted to populate it with +fake data. <a class="link" href="https://github.com/joke2k/faker" target="_blank" rel="noopener" +>Fake-Factory</a> is an amazing +library that can generate fake data of almost any kind: emails, +association names, acronyms… It even lets you localise the results +(get Spanish names, for instance) and generate factories for certain +classes (à la Django). +But I also wanted pictures, enter <a class="link" href="http://lorempixel.com/" target="_blank" rel="noopener" +>Lorem Pixel</a>. +With its API you can generate pictures of almost any size, for different +topics (e.g. nightlife, people) and with a custom text. You can even use +an index, so it will always show the same picture. +For instance, the picture below is served through Lorem Pixel. +<img src="http://lorempixel.com/400/200/nightlife/" +loading="lazy" +> +By the way, if you only want cat pictures, take a look at +<a class="link" href="http://placekitten.com/" target="_blank" rel="noopener" +>Placekitten</a>. And for NSFW text, there’s the +<a class="link" href="http://slipsum.com/" target="_blank" rel="noopener" +>Samuel L. Jackson Ipsum</a>Pythonhttps://balkian.com/python/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/python/<img src="https://balkian.com/img/python.png" alt="Featured image of post Python" /><h2 id="interesting-libraries">Interesting libraries +</h2><h3 id="tqdm"><a class="link" href="https://github.com/tqdm/tqdm" target="_blank" rel="noopener" +>TQDM</a> +</h3>From tqdm’s github repository: +<blockquote> +tqdm means “progress” in Arabic (taqadum, تقدّم) and an abbreviation for “I love you so much” in Spanish (te quiero demasiado).</blockquote> +<img src="https://raw.githubusercontent.com/tqdm/tqdm/master/images/tqdm.gif" +loading="lazy" +alt="TQDM in action" +> +<h2 id="tools">Tools +</h2><h3 id="uv"><a class="link" href="https://github.com/astral-sh/uv" target="_blank" rel="noopener" +>uv</a> +</h3>🚀 A single tool to replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more. +⚡️ 10-100x faster than pip. +<ul> +<li>Provides comprehensive project management, with a universal lockfile.</li> +<li>Runs scripts, with support for inline dependency metadata.</li> +<li>Installs and manages Python versions.</li> +<li>Runs and installs tools published as Python packages.</li> +<li>Includes a pip-compatible interface for a performance boost with a familiar CLI.</li> +<li>Supports Cargo-style workspaces for scalable projects.</li> +<li>Disk-space efficient, with a global cache for dependency deduplication.</li> +<li>Installable without Rust or Python via curl or pip.</li> +<li>Supports macOS, Linux, and Windows.</li> +</ul> \ No newline at end of file diff --git a/tags/python/page/1/index.html b/tags/python/page/1/index.html new file mode 100644 index 0000000..2d8dee1 --- /dev/null +++ b/tags/python/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/python/ + \ No newline at end of file diff --git a/tags/python/page/2/index.html b/tags/python/page/2/index.html new file mode 100644 index 0000000..17456f9 --- /dev/null +++ b/tags/python/page/2/index.html @@ -0,0 +1,32 @@ +Tag: Python - Pager 2 - J. Fernando Sánchez +

7 pages

Python

Updating EuroLoveMap

Python

\ No newline at end of file diff --git a/tags/rpi/index.html b/tags/rpi/index.html new file mode 100644 index 0000000..0245436 --- /dev/null +++ b/tags/rpi/index.html @@ -0,0 +1,31 @@ +Tag: Rpi - J. Fernando Sánchez +

1 page

Rpi

Raspberry Pi

\ No newline at end of file diff --git a/tags/rpi/index.xml b/tags/rpi/index.xml new file mode 100644 index 0000000..447b2af --- /dev/null +++ b/tags/rpi/index.xml @@ -0,0 +1,21 @@ +Rpi on J. Fernando Sánchezhttps://balkian.com/tags/rpi/Recent content in Rpi on J. Fernando SánchezHugo -- gohugo.ioen-usRaspberry Pihttps://balkian.com/raspberry-pi/Mon, 01 Jan 0001 00:00:00 +0000https://balkian.com/raspberry-pi/<img src="https://balkian.com/img/rpi.png" alt="Featured image of post Raspberry Pi" /><h2 id="hdmi-flickering">HDMI flickering +</h2>Avoid HDMI flickering/intermittent blanking on RPI with a 1400x1050 VGA monitor. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"> + hdmi_drive=2 + hdmi_group=2 + hdmi_mode=42 + disable_overscan=1 + config_hdmi_boost=7 +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/rpi/page/1/index.html b/tags/rpi/page/1/index.html new file mode 100644 index 0000000..d3ebfc6 --- /dev/null +++ b/tags/rpi/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/rpi/ + \ No newline at end of file diff --git a/tags/ruby/index.html b/tags/ruby/index.html new file mode 100644 index 0000000..e3d4e02 --- /dev/null +++ b/tags/ruby/index.html @@ -0,0 +1,31 @@ +Tag: Ruby - J. Fernando Sánchez +

1 page

Ruby

Creating my web

\ No newline at end of file diff --git a/tags/ruby/index.xml b/tags/ruby/index.xml new file mode 100644 index 0000000..4d0726f --- /dev/null +++ b/tags/ruby/index.xml @@ -0,0 +1,48 @@ +Ruby on J. Fernando Sánchezhttps://balkian.com/tags/ruby/Recent content in Ruby on J. Fernando SánchezHugo -- gohugo.ioen-usThu, 22 Aug 2013 14:14:22 +0000Creating my webhttps://balkian.com/p/creating-my-web/Thu, 22 Aug 2013 14:14:22 +0000https://balkian.com/p/creating-my-web/I’ve finally decided to set up a decent personal page. I have settled +for github-pages because I like the idea of keeping my site in a +repository and having someone else host and deploy it for me. The site +will be really simple, mostly static files. Thanks to Github, +<a class="link" href="http://jekyllrb.com" target="_blank" rel="noopener" +>Jekyll</a> will automatically generate static pages +for my posts every time I commit anything new to this repository. +But Jekyll can be used independently, so if I ever choose to host the +site myself, I can do it quite easily. Another thing that I liked about +this approach is that the generated html files can be used in the +future, and I will not need Jekyll to serve it. Jekyll is really simple +and most of the things are written in plain html. That means that +everything could be easily reused if I ever choose to change to another +blogging framework (e.g. pelical). But, for the time being, I like the +fact that Github takes care of the compilation as well, so I can simply +modify or add files through the web interface should I need to. +I hadn’t played with HTML and CSS for a while now, so I also wanted to +use this site as a playground. At some point, I realised I was doing +mostly everything in plain HTML and CSS, and decided to keep it like +that for as long as possible. As of this writing, I haven’t included +any Javascript code in the page. Probably I will use some to add my +<a class="link" href="http://gist.github.com/balkian" target="_blank" rel="noopener" +>gists</a> and +<a class="link" href="http://github.com/balkian" target="_blank" rel="noopener" +>repositories</a>, but we will see about that. +I think the code speaks for itself, so you can check out <a class="link" href="http://github.com/balkian/balkian.github.com" target="_blank" rel="noopener" +>my repository +on Github</a>. You can clone +and deploy it easily like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git clone +https://github.com/balkian/balkian.github.com cd balkian.github.com +jekyll serve -w +</code></pre></td></tr></table> +</div> +</div>I will keep updating this post with information about: +<ul> +<li>Some Jekyll plugins that might be useful</li> +<li>What CSS tricks I learnt</li> +<li>The webfonts I used</li> +<li>The badge on the left side of the page</li> +</ul> \ No newline at end of file diff --git a/tags/ruby/page/1/index.html b/tags/ruby/page/1/index.html new file mode 100644 index 0000000..bc0618d --- /dev/null +++ b/tags/ruby/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/ruby/ + \ No newline at end of file diff --git a/tags/rust/index.html b/tags/rust/index.html new file mode 100644 index 0000000..1be5f5f --- /dev/null +++ b/tags/rust/index.html @@ -0,0 +1,31 @@ +Tag: Rust - J. Fernando Sánchez +

1 page

Rust

Kanata: advanced keyboard configuration

\ No newline at end of file diff --git a/tags/rust/index.xml b/tags/rust/index.xml new file mode 100644 index 0000000..4eccebc --- /dev/null +++ b/tags/rust/index.xml @@ -0,0 +1,189 @@ +Rust on J. Fernando Sánchezhttps://balkian.com/tags/rust/Recent content in Rust on J. Fernando SánchezHugo -- gohugo.ioen-usFri, 20 Jan 2023 18:11:00 +0000Kanata: advanced keyboard configurationhttps://balkian.com/p/kanata-advanced-keyboard-configuration/Fri, 20 Jan 2023 18:11:00 +0000https://balkian.com/p/kanata-advanced-keyboard-configuration/<a class="link" href="https://github.com/jtroo/kanata/" target="_blank" rel="noopener" +>Kanata</a> is a software keyboard remapper that aims to improve keyboard comfort and usability with advanced customization. +Keyboard remappers are a good alternative to running a custom keyboard with QMK/ZMK, and have two main advantages: they work on any keyboard, and you can configure them to launch any command or program you want, not just key presses. +On the other hand, you need to configure them on every PC/OS you’re using your keyboard with, and all the processing is done on software on top of the OS, so there may be glitches and performance issues. +The project was inspired by the more popular <a class="link" href="https://github.com/kmonad/kmonad" target="_blank" rel="noopener" +>KMonad</a>, and the author cites some of the <a class="link" href="https://github.com/jtroo/kanata/blob/main/docs/kmonad_comparison.md" target="_blank" rel="noopener" +>differences</a>. +Both projects use a very similar configuration format based on lisp. +The configuration consists of a set of general options, a base key configuration, a series of layers, and macros that can be used within those layers. +<a class="link" href="https://github.com/jtroo/kanata/blob/main/cfg_samples/kanata.kbd" target="_blank" rel="noopener" +>Here’s a very complete config that serves as documentation</a>. +One big disadvantage of the lispy configuration is that you need to specify your hardware layout/all your keys, and repeat that every time you define a new layer. +The result visually maps to your keyboard, but can be very verbose/big if you need really few changes. +<a class="link" href="https://github.com/rvaiya/keyd/" target="_blank" rel="noopener" +>Keyd</a> is another alternative with a more declarative configuration format, which might lend itself to smaller. +For now I’m just trying it out, and getting a feel for using fewer keys before I build my own ZMK keyboard. +I particularly like the option of using mod-keys on the home row (e.g., having A work as a CTRL when held). +Mod-tap, tap-dancing and the like are very common techniques in sub-40% layouts, where there simply aren’t enough keys for all the letters and symbols. +In a regular-sized keyboard, these techniques can also help you stay on the home row and type more comfortably. +At least, that’s the idea. +We’ll see if I like it enough to stick with it. +For now, here’s my very simple config: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-lisp" data-lang="lisp">(defcfg + ;; Your keyboard device will likely differ from this. + linux-dev /dev/input/by-id/usb-Logitech_USB_Receiver-if02-event-mouse + + ;; Windows doesn't need any input/output configuration entries; however, there + ;; must still be a defcfg entry. You can keep the linux-dev entry or delete + ;; it and leave it empty. +) + +(defsrc + grv 1 2 3 4 5 6 7 8 9 0 - = bspc + tab q w e r t y u i o p [ ] + caps a s d f g h j k l ; ' ret + lsft \ z x c v b n m , . / rsft + lctl lmet lalt spc ralt rmet rctl +) + + +(deflayer qwerty + grv _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ @warrows _ _ _ _ _ _ _ _ _ _ + lctrl @alctrl @slsft @dlalt @flmet _ _ @jrmet @kralt @lrsft @;rctrl _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer arrows + _ _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ @flmet _ left down up rght _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ @smartspace _ _ _ +) + +(deflayer colemak + grv XX XX XX XX XX XX XX XX XX XX XX XX _ + tab q w f p b j l u y ; [ ] + lctrl @alctrl @rlsft @slalt @tlmet g m @nrmet @eralt @irsft @orctrl ' ret + lsft XX z x c d v k h , . / rsft + XX XX XX @smartspace XX XX XX +) + +(deflayer magic + _ @clmk @qwerty _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ tab A-tab _ _ _ _ bspc esc _ ret _ _ + _ _ _ _ _ _ _ _ _ _ _ _ _ + _ _ _ _ _ _ _ +) + +(defalias + warrows (tap-hold 200 200 w (layer-toggle arrows)) + + alctrl (tap-hold 200 200 a lctrl) + slsft (tap-hold 200 200 s lsft) + dlalt (tap-hold 200 200 d lalt) + flmet (tap-hold 200 200 f lmet) + + jrmet (tap-hold 200 200 j rmet) + kralt (tap-hold 200 200 k ralt) + lrsft (tap-hold 200 200 l rsft) + ;rctrl (tap-hold 200 200 ; rctrl) + + rlsft (tap-hold 200 200 r lsft) + slalt (tap-hold 200 200 s lalt) + tlmet (tap-hold 200 200 t lmet) + nrmet (tap-hold 200 200 n rmet) + eralt (tap-hold 200 200 e ralt) + irsft (tap-hold 200 200 i rsft) + orctrl (tap-hold 200 200 o rctrl) + clmk (layer-switch colemak) + qwerty (layer-switch qwerty) + + smartspace (tap-dance 200 ( + (tap-hold 300 300 spc (layer-toggle magic)) + (tap-hold 300 300 (one-shot 300 lalt) spc) + a + )) + + ) +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/rust/page/1/index.html b/tags/rust/page/1/index.html new file mode 100644 index 0000000..ed94d37 --- /dev/null +++ b/tags/rust/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/rust/ + \ No newline at end of file diff --git a/tags/starters/index.html b/tags/starters/index.html new file mode 100644 index 0000000..c3fbcd3 --- /dev/null +++ b/tags/starters/index.html @@ -0,0 +1,31 @@ +Tag: Starters - J. Fernando Sánchez +

1 page

Starters

Creating my web

\ No newline at end of file diff --git a/tags/starters/index.xml b/tags/starters/index.xml new file mode 100644 index 0000000..e795c4d --- /dev/null +++ b/tags/starters/index.xml @@ -0,0 +1,48 @@ +Starters on J. Fernando Sánchezhttps://balkian.com/tags/starters/Recent content in Starters on J. Fernando SánchezHugo -- gohugo.ioen-usThu, 22 Aug 2013 14:14:22 +0000Creating my webhttps://balkian.com/p/creating-my-web/Thu, 22 Aug 2013 14:14:22 +0000https://balkian.com/p/creating-my-web/I’ve finally decided to set up a decent personal page. I have settled +for github-pages because I like the idea of keeping my site in a +repository and having someone else host and deploy it for me. The site +will be really simple, mostly static files. Thanks to Github, +<a class="link" href="http://jekyllrb.com" target="_blank" rel="noopener" +>Jekyll</a> will automatically generate static pages +for my posts every time I commit anything new to this repository. +But Jekyll can be used independently, so if I ever choose to host the +site myself, I can do it quite easily. Another thing that I liked about +this approach is that the generated html files can be used in the +future, and I will not need Jekyll to serve it. Jekyll is really simple +and most of the things are written in plain html. That means that +everything could be easily reused if I ever choose to change to another +blogging framework (e.g. pelical). But, for the time being, I like the +fact that Github takes care of the compilation as well, so I can simply +modify or add files through the web interface should I need to. +I hadn’t played with HTML and CSS for a while now, so I also wanted to +use this site as a playground. At some point, I realised I was doing +mostly everything in plain HTML and CSS, and decided to keep it like +that for as long as possible. As of this writing, I haven’t included +any Javascript code in the page. Probably I will use some to add my +<a class="link" href="http://gist.github.com/balkian" target="_blank" rel="noopener" +>gists</a> and +<a class="link" href="http://github.com/balkian" target="_blank" rel="noopener" +>repositories</a>, but we will see about that. +I think the code speaks for itself, so you can check out <a class="link" href="http://github.com/balkian/balkian.github.com" target="_blank" rel="noopener" +>my repository +on Github</a>. You can clone +and deploy it easily like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">git clone +https://github.com/balkian/balkian.github.com cd balkian.github.com +jekyll serve -w +</code></pre></td></tr></table> +</div> +</div>I will keep updating this post with information about: +<ul> +<li>Some Jekyll plugins that might be useful</li> +<li>What CSS tricks I learnt</li> +<li>The webfonts I used</li> +<li>The badge on the left side of the page</li> +</ul> \ No newline at end of file diff --git a/tags/starters/page/1/index.html b/tags/starters/page/1/index.html new file mode 100644 index 0000000..2e9c177 --- /dev/null +++ b/tags/starters/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/starters/ + \ No newline at end of file diff --git a/tags/surface-go/index.html b/tags/surface-go/index.html new file mode 100644 index 0000000..435af45 --- /dev/null +++ b/tags/surface-go/index.html @@ -0,0 +1,31 @@ +Tag: Surface Go - J. Fernando Sánchez +

1 page

Surface Go

Linux on the Microsoft Surface Go

\ No newline at end of file diff --git a/tags/surface-go/index.xml b/tags/surface-go/index.xml new file mode 100644 index 0000000..8103da2 --- /dev/null +++ b/tags/surface-go/index.xml @@ -0,0 +1,80 @@ +Surface Go on J. Fernando Sánchezhttps://balkian.com/tags/surface-go/Recent content in Surface Go on J. Fernando SánchezHugo -- gohugo.ioen-usSat, 01 Jun 2019 00:00:01 +0000Linux on the Microsoft Surface Gohttps://balkian.com/p/linux-on-the-microsoft-surface-go/Sat, 01 Jun 2019 00:00:01 +0000https://balkian.com/p/linux-on-the-microsoft-surface-go/Believe it or not, Surface tablets have pretty good linux support, except for the webcams in newer models. +These are some useful notes to get Ubuntu installed in your surface go, as of Summer 2019. +<h2 id="installing-the-kernel">Installing the kernel +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">git clone --depth 1 https://github.com/jakeday/linux-surface.git ~/linux-surface +cp -a ~/linux-surface /media/<your usb> +</code></pre></td></tr></table> +</div> +</div><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">cp -a /media/<your usb>/linux-surface ~/ +cd ~/linux-surface/ +sudo sh setup.sh +</code></pre></td></tr></table> +</div> +</div><h2 id="booting-ubuntu-first">Booting ubuntu first +</h2>Switch out of Windows S mode. +Boot into the “Command Prompt”. +From Windows go to “change advanced startup options” and select “restart now”. +When it reboots, choose the “Troubleshoot” option, then choose the “Advanced options” option, and finally choose the “Command Prompt” option. +After the device reboots, login to the command prompt and then you should see a terminal with X:\windows\system32> +At the prompt, check your UEFI entries: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /enum firmware +</code></pre></td></tr></table> +</div> +</div>Copy UEFI entry of “Windows Boot Manager” to create a new entry for Ubuntu: bcdedit /copy {bootmgr} /d “Ubuntu” +Copy the printed GUID number including the braces {} using Ctrl+C +Set file path for the new Ubuntu entry. Replace {guid} with the returned GUID of the previous command (Ctrl+V). bcdedit /set {guid} path \EFI\ubuntu\grubx64.efi +Set Ubuntu as the first/ entry in the boot sequence. Again replace {guid} with the returned GUID of the copy command. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">bcdedit /set {fwbootmgr} displayorder {guid} /addfirst +</code></pre></td></tr></table> +</div> +</div>Check your UEFI entries again: bcdedit /enum firmware You should see something like this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"> +Firmware Boot Manager +--------------------- +identifier {fwbootmgr} +displayorder {3510232e-f8eb-e811-95ce-9ecab3f9d1c4} + {bootmgr} + {2148799b-f8eb-e811-95ce-9ecab3f9d1c4} + {312e8a67-c2f6-e811-95ce-3c1ab3f9d1de} + {312e8a68-c2f6-e811-95ce-3c1ab3f9d1de} +timeout 0 +</code></pre></td></tr></table> +</div> +</div>Make sure the GUID you copied is the first one listed in displayorder. Then type exit, turn off the PC and turn it back on. After this my surface go is automatically booting to the grub bootloader which lets me choose between Windows and Ubuntu but defaults to Ubuntu after ten seconds. \ No newline at end of file diff --git a/tags/surface-go/page/1/index.html b/tags/surface-go/page/1/index.html new file mode 100644 index 0000000..cf077cf --- /dev/null +++ b/tags/surface-go/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/surface-go/ + \ No newline at end of file diff --git a/tags/uwsgi/index.html b/tags/uwsgi/index.html new file mode 100644 index 0000000..5233ff8 --- /dev/null +++ b/tags/uwsgi/index.html @@ -0,0 +1,31 @@ +Tag: Uwsgi - J. Fernando Sánchez +

1 page

Uwsgi

Proxies with Apache and python

\ No newline at end of file diff --git a/tags/uwsgi/index.xml b/tags/uwsgi/index.xml new file mode 100644 index 0000000..7effff4 --- /dev/null +++ b/tags/uwsgi/index.xml @@ -0,0 +1,105 @@ +Uwsgi on J. Fernando Sánchezhttps://balkian.com/tags/uwsgi/Recent content in Uwsgi on J. Fernando SánchezHugo -- gohugo.ioen-usThu, 09 Oct 2014 10:00:00 +0000Proxies with Apache and pythonhttps://balkian.com/p/proxies-with-apache-and-python/Thu, 09 Oct 2014 10:00:00 +0000https://balkian.com/p/proxies-with-apache-and-python/This is a quick note on proxying a local python application (e.g. flask) +to a subdirectory in Apache. This assumes that the file wsgi.py contains +a WSGI application with the name application. Hence, wsgi:application. +<h2 id="gunicorn">Gunicorn +</h2><div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + ProxyPass http://127.0.0.1:8888/myapp/ + ProxyPassReverse http://127.0.0.1:8888/myapp/ + RequestHeader set SCRIPT_NAME "/myapp/" +</Location> +</code></pre></td></tr></table> +</div> +</div>Important: SCRIPT_NAME and the end of ProxyPass URL MUST BE +THE SAME. Otherwise, Gunicorn will fail miserably. +Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">venv/bin/gunicorn -w 4 -b 127.0.0.1:8888 --log-file - --access-logfile - wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="uwsgi">UWSGI +</h2>This is a very simple configuration. I will try to upload one with more +options for uwsgi (in a .ini file). +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><Location /myapp/> + SetHandler uwsgi_handler + uWSGISocker 127.0.0.1:8888 +</Location> +</code></pre></td></tr></table> +</div> +</div>Try it with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">uwsgi --socket 127.0.0.1:8888 -w wsgi:application +</code></pre></td></tr></table> +</div> +</div><h2 id="extra-supervisor">Extra: Supervisor +</h2>If everything went as expected, you can wrap your command in a +supervisor config file and let it handle the server for you. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-ini" data-lang="ini">[unix_http_server] +file=/tmp/myapp.sock ; path to your socket file + +[supervisord] +logfile = %(here)s/logs/supervisor.log +childlogdir = %(here)s/logs/ + +[rpcinterface:supervisor] +supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface + +[supervisorctl] +logfile = %(here)s/logs/supervisorctl.log +serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL for a unix socket + +[program:myapp] +command = venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 --log-file %(here)s/logs/gunicorn.log --access-logfile - wsgi:application +directory = %(here)s +environment = PATH=%(here)s/venv/bin/ +logfile = %(here)s/logs/myapp.log +</code></pre></td></tr></table> +</div> +</div> \ No newline at end of file diff --git a/tags/uwsgi/page/1/index.html b/tags/uwsgi/page/1/index.html new file mode 100644 index 0000000..6740cae --- /dev/null +++ b/tags/uwsgi/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/uwsgi/ + \ No newline at end of file diff --git a/tags/webdav/index.html b/tags/webdav/index.html new file mode 100644 index 0000000..e4c455c --- /dev/null +++ b/tags/webdav/index.html @@ -0,0 +1,31 @@ +Tag: Webdav - J. Fernando Sánchez +

1 page

Webdav

Zotero

\ No newline at end of file diff --git a/tags/webdav/index.xml b/tags/webdav/index.xml new file mode 100644 index 0000000..57f6cac --- /dev/null +++ b/tags/webdav/index.xml @@ -0,0 +1,142 @@ +Webdav on J. Fernando Sánchezhttps://balkian.com/tags/webdav/Recent content in Webdav on J. Fernando SánchezHugo -- gohugo.ioen-usTue, 09 Dec 2014 12:12:12 +0000Zoterohttps://balkian.com/p/zotero/Tue, 09 Dec 2014 12:12:12 +0000https://balkian.com/p/zotero/<a class="link" href="https://www.zotero.org/" target="_blank" rel="noopener" +>Zotero</a> is an Open Source tool that lets you +organise your bibliography, syncing it with the cloud. Unlike other +alternatives such as <a class="link" href="http://www.mendeley.com" target="_blank" rel="noopener" +>Mendeley</a>, Zotero can +upload the attachments and data to a private cloud via WebDav. +If you use nginx as your web server, know that even though it provides +partial support for webdav, Zotero needs more than that. Hence, you will +need another webdav server, and optionally let nginx proxy to it. This +short post provides the basics to get that set-up working under +Debian/Ubuntu. +<h2 id="setting-up-apache">Setting up Apache +</h2>First we need to install Apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo apt-get install apache2 +</code></pre></td></tr></table> +</div> +</div>Change the head of “/etc/apache2/sites-enabled/000-default” to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><VirtualHost *:880> +</code></pre></td></tr></table> +</div> +</div>Then, create a file /etc/apache2/sites-available/webdav: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache">Alias /dav /home/webdav/dav +<Location /dav> + Dav on + Order Allow,Deny + Allow from all + Dav On + Options +Indexes + AuthType Basic + AuthName DAV + AuthBasicProvider file + AuthUserFile /home/webdav/.htpasswd + Require valid-user +</Location> +</code></pre></td></tr></table> +</div> +</div>Ideally, you want your webdav folders to be private, adding +authentication to them. So you need to create the webdav and zotero +users and add the passwords to an htpasswd file. Even though you could +use a single user, since you will be configuring several clients with +your credentials I encourage you to create the zotero user as well. This +way you can always change the password for zotero without affecting any +other application using webdav. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo adduser webdav +sudo htpasswd -c /home/webdav/.htpasswd webdav +sudo htpasswd /home/webdav/.htpasswd zotero +sudo mkdir -p /home/webdav/dav/zotero +</code></pre></td></tr></table> +</div> +</div>Enable the site and restart apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo a2enmod webdav +sudo a2enmod dav_fs +sudo a2ensite webdav +sudo service apache2 restart +</code></pre></td></tr></table> +</div> +</div>At this point everything should be working at +<a class="link" href="http://" target="_blank" rel="noopener" +>http://</a><your_host>:880/dav/zotero +<h2 id="setting-up-nginx">Setting up NGINX +</h2>After the Apache side is working, we can use nginx as a proxy to get +cleaner URIs. In your desired site/location, add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-nginx" data-lang="nginx">location /dav { + client_max_body_size 20M; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $remote_addr; + proxy_set_header Host $host; + proxy_pass http://127.0.0.1:880; +} +</code></pre></td></tr></table> +</div> +</div>Now just reload nginx: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo service nginx force-reload +</code></pre></td></tr></table> +</div> +</div><h2 id="extras">Extras +</h2><ul> +<li><a class="link" href="http://zoteroreader.com/" target="_blank" rel="noopener" +>Zotero Reader</a> - HTML5 client</li> +<li><a class="link" href="https://github.com/ajlyon/zandy" target="_blank" rel="noopener" +>Zandy</a> - Android Open Source +client</li> +</ul> \ No newline at end of file diff --git a/tags/webdav/page/1/index.html b/tags/webdav/page/1/index.html new file mode 100644 index 0000000..ff73e76 --- /dev/null +++ b/tags/webdav/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/webdav/ + \ No newline at end of file diff --git a/tags/zigbee/index.html b/tags/zigbee/index.html new file mode 100644 index 0000000..a2d3f5b --- /dev/null +++ b/tags/zigbee/index.html @@ -0,0 +1,31 @@ +Tag: Zigbee - J. Fernando Sánchez +

1 page

Zigbee

Controlling Zigbee devices with MQTT

\ No newline at end of file diff --git a/tags/zigbee/index.xml b/tags/zigbee/index.xml new file mode 100644 index 0000000..ea575e9 --- /dev/null +++ b/tags/zigbee/index.xml @@ -0,0 +1,132 @@ +Zigbee on J. Fernando Sánchezhttps://balkian.com/tags/zigbee/Recent content in Zigbee on J. Fernando SánchezHugo -- gohugo.ioen-usSun, 06 Jan 2019 10:00:00 +0000Controlling Zigbee devices with MQTThttps://balkian.com/p/controlling-zigbee-devices-with-mqtt/Sun, 06 Jan 2019 10:00:00 +0000https://balkian.com/p/controlling-zigbee-devices-with-mqtt/This is a short tutorial on connecting a zigbee device (an Aqara cube) +to an MQTT server, so you can control your zigbee devices from the +network. +If you’re anything like me, you’re probably a sucker for IoT devices. +For a long time, I’ve been using WiFi-enabled lights, and Amazon dash +buttons to control them. To keep these (cheap Chinese) internet enabled +devices away from your network and their respective cloud services, +you’ll probably want to set up a dedicated network in your router (more +on this on a future post, maybe). Another disadvantage of WiFi devices +is that they’re relatively power hungry. +A popular alternative is using ZigBee for communication. It is a +dedicated protocol similar to bluetooth (BLE), with lower power +requirements and bitrate. +Take the (super cute) aqara cube as an example. It is a small cube that +detects rotation on all of its axes, and tapping events. Here’s a +video: +<div class="video-wrapper"> +<iframe loading="lazy" +src="https://www.youtube.com/embed/5YtqG1wEnng" +allowfullscreen +title="YouTube Video" +> +</iframe> +</div> +To connect to zigbee devices you will need a zigbee enabled gateway +(a.k.a. hub), which connects to your WiFi network and your zigbee +devices. Once again, this means adding an internet-enabled device to +your home, and probably a couple of cloud services. +As an alternative, you can set up your own zigbee gateway, and control +it to your home automation platform of choice (e.g. home assistant). We +will cover how to set up a zigbee2mqtt gateway that is also connected to +an MQTT server, so you can use MQTT to control your devices and get +notifications. +What you need: +<ul> +<li><a class="link" href="https://www.aliexpress.com/item/Original-Xiaomi-Mi-Aqara-Cube-Smart-Home-Controller-6-Action-Operation-Fr-Home-Device-Zigbee-Version/32892947622.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>Aqara +cube</a>.</li> +<li><a class="link" href="https://www.aliexpress.com/item/Wireless-Zigbee-CC2531-CC2540-Zigbee-Sniffer-Bluetooth-BLE-4-0-Dongle-Capture-Module-USB-Programmer-Downloader/32907587711.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>CC2531 zigbee +sniffer</a>.</li> +<li><a class="link" href="https://www.aliexpress.com/item/CFSUNBIRD-CC-DEBUGGER-Debugger-and-Programmer-for-RF-System-on-Chips-TI-ORIGINAL-Fast-hipping/32813122315.html?spm=a2g0s.9042311.0.0.3da24c4dXV8sBI" target="_blank" rel="noopener" +>CC-debugger</a>.</li> +</ul> +You will need to flash your sniffer. For that, you only need to follow +the instructions from the <a class="link" href="https://koenkk.github.io/zigbee2mqtt/" target="_blank" rel="noopener" +>zigbee2mqtt +documentation</a>. +Once you’re done flashing, you’re ready to set up the zigbee2mqtt +server. For convenience, I wrote a simple docker-compose to deploy a +zigbee2mqtt server and a test mosquitto server: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">version: '2.1' +services: + zigbee2mqtt: + image: koenkk/zigbee2mqtt + container_name: zigbee2mqtt + restart: always + volumes: + - ./z2m-data/:/app/data/ + devices: + - "/dev/ttyACM0" + networks: + - hass + mqtt: + image: eclipse-mosquitto + ports: + - 1883:1883 + - 9001:9001 + networks: + - hass + volumes: + - ./mosquitto.conf:/mosquitto/config/mosquitto.conf +networks: + hass: + driver: overlay +</code></pre></td></tr></table> +</div> +</div>You can test your installation with: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell">❯ mosquitto_sub -h localhost -p 1883 -t 'zigbee2mqtt/#' +online +{"battery":17,"voltage":2925,"linkquality":149,"action":"rotate_right","angle":12.8} +{"battery":17,"voltage":2925,"linkquality":141,"action":"slide","side":2} +{"battery":17,"voltage":2925,"linkquality":120} +{"battery":17,"voltage":2925,"linkquality":141,"action":"wakeup"}</code></pre></td></tr></table> +</div> +</div> +zigbee2mqtt supports the following events for the aqara cube: shake, +wakeup, fall, tap, slide, flip180, flip90, rotate_left and +rotate_right. Every event has additional information, such as the sides +involved, or the degrees turned. +Now you are ready to set up home assistant support in zigbee2mqtt +following <a class="link" href="https://koenkk.github.io/zigbee2mqtt/integration/home_assistant.html" target="_blank" rel="noopener" +>this +guide</a>. \ No newline at end of file diff --git a/tags/zigbee/page/1/index.html b/tags/zigbee/page/1/index.html new file mode 100644 index 0000000..d869619 --- /dev/null +++ b/tags/zigbee/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/zigbee/ + \ No newline at end of file diff --git a/tags/zotero/index.html b/tags/zotero/index.html new file mode 100644 index 0000000..88e3544 --- /dev/null +++ b/tags/zotero/index.html @@ -0,0 +1,31 @@ +Tag: Zotero - J. Fernando Sánchez +

1 page

Zotero

\ No newline at end of file diff --git a/tags/zotero/index.xml b/tags/zotero/index.xml new file mode 100644 index 0000000..6478815 --- /dev/null +++ b/tags/zotero/index.xml @@ -0,0 +1,142 @@ +Zotero on J. Fernando Sánchezhttps://balkian.com/tags/zotero/Recent content in Zotero on J. Fernando SánchezHugo -- gohugo.ioen-usTue, 09 Dec 2014 12:12:12 +0000Zoterohttps://balkian.com/p/zotero/Tue, 09 Dec 2014 12:12:12 +0000https://balkian.com/p/zotero/<a class="link" href="https://www.zotero.org/" target="_blank" rel="noopener" +>Zotero</a> is an Open Source tool that lets you +organise your bibliography, syncing it with the cloud. Unlike other +alternatives such as <a class="link" href="http://www.mendeley.com" target="_blank" rel="noopener" +>Mendeley</a>, Zotero can +upload the attachments and data to a private cloud via WebDav. +If you use nginx as your web server, know that even though it provides +partial support for webdav, Zotero needs more than that. Hence, you will +need another webdav server, and optionally let nginx proxy to it. This +short post provides the basics to get that set-up working under +Debian/Ubuntu. +<h2 id="setting-up-apache">Setting up Apache +</h2>First we need to install Apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo apt-get install apache2 +</code></pre></td></tr></table> +</div> +</div>Change the head of “/etc/apache2/sites-enabled/000-default” to: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache"><VirtualHost *:880> +</code></pre></td></tr></table> +</div> +</div>Then, create a file /etc/apache2/sites-available/webdav: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code> 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-apache" data-lang="apache">Alias /dav /home/webdav/dav +<Location /dav> + Dav on + Order Allow,Deny + Allow from all + Dav On + Options +Indexes + AuthType Basic + AuthName DAV + AuthBasicProvider file + AuthUserFile /home/webdav/.htpasswd + Require valid-user +</Location> +</code></pre></td></tr></table> +</div> +</div>Ideally, you want your webdav folders to be private, adding +authentication to them. So you need to create the webdav and zotero +users and add the passwords to an htpasswd file. Even though you could +use a single user, since you will be configuring several clients with +your credentials I encourage you to create the zotero user as well. This +way you can always change the password for zotero without affecting any +other application using webdav. +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo adduser webdav +sudo htpasswd -c /home/webdav/.htpasswd webdav +sudo htpasswd /home/webdav/.htpasswd zotero +sudo mkdir -p /home/webdav/dav/zotero +</code></pre></td></tr></table> +</div> +</div>Enable the site and restart apache: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo a2enmod webdav +sudo a2enmod dav_fs +sudo a2ensite webdav +sudo service apache2 restart +</code></pre></td></tr></table> +</div> +</div>At this point everything should be working at +<a class="link" href="http://" target="_blank" rel="noopener" +>http://</a><your_host>:880/dav/zotero +<h2 id="setting-up-nginx">Setting up NGINX +</h2>After the Apache side is working, we can use nginx as a proxy to get +cleaner URIs. In your desired site/location, add this: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +2 +3 +4 +5 +6 +7 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-nginx" data-lang="nginx">location /dav { + client_max_body_size 20M; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $remote_addr; + proxy_set_header Host $host; + proxy_pass http://127.0.0.1:880; +} +</code></pre></td></tr></table> +</div> +</div>Now just reload nginx: +<div class="highlight"><div class="chroma"> +<table class="lntable"><tr><td class="lntd"> +<pre tabindex="0" class="chroma"><code>1 +</code></pre></td> +<td class="lntd"> +<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">sudo service nginx force-reload +</code></pre></td></tr></table> +</div> +</div><h2 id="extras">Extras +</h2><ul> +<li><a class="link" href="http://zoteroreader.com/" target="_blank" rel="noopener" +>Zotero Reader</a> - HTML5 client</li> +<li><a class="link" href="https://github.com/ajlyon/zandy" target="_blank" rel="noopener" +>Zandy</a> - Android Open Source +client</li> +</ul> \ No newline at end of file diff --git a/tags/zotero/page/1/index.html b/tags/zotero/page/1/index.html new file mode 100644 index 0000000..3aebbdc --- /dev/null +++ b/tags/zotero/page/1/index.html @@ -0,0 +1,2 @@ +https://balkian.com/tags/zotero/ + \ No newline at end of file diff --git a/ts/main.1e9a3bafd846ced4c345d084b355fb8c7bae75701c338f8a1f8a82c780137826.js b/ts/main.1e9a3bafd846ced4c345d084b355fb8c7bae75701c338f8a1f8a82c780137826.js new file mode 100644 index 0000000..69ec30f --- /dev/null +++ b/ts/main.1e9a3bafd846ced4c345d084b355fb8c7bae75701c338f8a1f8a82c780137826.js @@ -0,0 +1,11 @@ +(()=>{var g=class e{galleryUID;items=[];constructor(t,r=1){if(window.PhotoSwipe==null||window.PhotoSwipeUI_Default==null){console.error("PhotoSwipe lib not loaded.");return}this.galleryUID=r,e.createGallery(t),this.loadItems(t),this.bindClick()}loadItems(t){this.items=[];let r=t.querySelectorAll("figure.gallery-image");for(let i of r){let n=i.querySelector("figcaption"),o=i.querySelector("img"),s={w:parseInt(o.getAttribute("width")),h:parseInt(o.getAttribute("height")),src:o.src,msrc:o.getAttribute("data-thumb")||o.src,el:i};n&&(s.title=n.innerHTML),this.items.push(s)}}static createGallery(t){let r=t.querySelectorAll("img.gallery-image");for(let o of Array.from(r)){let s=o.closest("p");if(!s||!t.contains(s)||(s.textContent.trim()==""&&s.classList.add("no-text"),!s.classList.contains("no-text")))continue;let d=o.parentElement.tagName=="A",m=o,c=document.createElement("figure");if(c.style.setProperty("flex-grow",o.getAttribute("data-flex-grow")||"1"),c.style.setProperty("flex-basis",o.getAttribute("data-flex-basis")||"0"),d&&(m=o.parentElement),m.parentElement.insertBefore(c,m),c.appendChild(m),o.hasAttribute("alt")){let l=document.createElement("figcaption");l.innerText=o.getAttribute("alt"),c.appendChild(l)}if(!d){c.className="gallery-image";let l=document.createElement("a");l.href=o.src,l.setAttribute("target","_blank"),o.parentNode.insertBefore(l,o),l.appendChild(o)}}let i=t.querySelectorAll("figure.gallery-image"),n=[];for(let o of i)n.length?o.previousElementSibling===n[n.length-1]?n.push(o):n.length&&(e.wrap(n),n=[o]):n=[o];n.length>0&&e.wrap(n)}static wrap(t){let r=document.createElement("div");r.className="gallery";let i=t[0].parentNode,n=t[0];i.insertBefore(r,n);for(let o of t)r.appendChild(o)}open(t){let r=document.querySelector(".pswp");new window.PhotoSwipe(r,window.PhotoSwipeUI_Default,this.items,{index:t,galleryUID:this.galleryUID,getThumbBoundsFn:n=>{let o=this.items[n].el.getElementsByTagName("img")[0],s=window.pageYOffset||document.documentElement.scrollTop,a=o.getBoundingClientRect();return{x:a.left,y:a.top+s,w:a.width}}}).init()}bindClick(){for(let[t,r]of this.items.entries())r.el.querySelector("a").addEventListener("click",n=>{n.preventDefault(),this.open(t)})}},b=g;var h={};if(localStorage.hasOwnProperty("StackColorsCache"))try{h=JSON.parse(localStorage.getItem("StackColorsCache"))}catch{h={}}async function S(e,t,r){if(!e)return await Vibrant.from(r).getPalette();if(!h.hasOwnProperty(e)||h[e].hash!==t){let i=await Vibrant.from(r).getPalette();h[e]={hash:t,Vibrant:{hex:i.Vibrant.hex,rgb:i.Vibrant.rgb,bodyTextColor:i.Vibrant.bodyTextColor},DarkMuted:{hex:i.DarkMuted.hex,rgb:i.DarkMuted.rgb,bodyTextColor:i.DarkMuted.bodyTextColor}},localStorage.setItem("StackColorsCache",JSON.stringify(h))}return h[e]}var D=(e,t=500)=>{e.classList.add("transiting"),e.style.transitionProperty="height, margin, padding",e.style.transitionDuration=t+"ms",e.style.height=e.offsetHeight+"px",e.offsetHeight,e.style.overflow="hidden",e.style.height="0",e.style.paddingTop="0",e.style.paddingBottom="0",e.style.marginTop="0",e.style.marginBottom="0",window.setTimeout(()=>{e.classList.remove("show"),e.style.removeProperty("height"),e.style.removeProperty("padding-top"),e.style.removeProperty("padding-bottom"),e.style.removeProperty("margin-top"),e.style.removeProperty("margin-bottom"),e.style.removeProperty("overflow"),e.style.removeProperty("transition-duration"),e.style.removeProperty("transition-property"),e.classList.remove("transiting")},t)},q=(e,t=500)=>{e.classList.add("transiting"),e.style.removeProperty("display"),e.classList.add("show");let r=e.offsetHeight;e.style.overflow="hidden",e.style.height="0",e.style.paddingTop="0",e.style.paddingBottom="0",e.style.marginTop="0",e.style.marginBottom="0",e.offsetHeight,e.style.transitionProperty="height, margin, padding",e.style.transitionDuration=t+"ms",e.style.height=r+"px",e.style.removeProperty("padding-top"),e.style.removeProperty("padding-bottom"),e.style.removeProperty("margin-top"),e.style.removeProperty("margin-bottom"),window.setTimeout(()=>{e.style.removeProperty("height"),e.style.removeProperty("overflow"),e.style.removeProperty("transition-duration"),e.style.removeProperty("transition-property"),e.classList.remove("transiting")},t)},B=(e,t=500)=>window.getComputedStyle(e).display==="none"?q(e,t):D(e,t);function w(){let e=document.getElementById("toggle-menu");e&&e.addEventListener("click",()=>{document.getElementById("main-menu").classList.contains("transiting")||(document.body.classList.toggle("show-menu"),B(document.getElementById("main-menu"),300),e.classList.toggle("is-active"))})}function N(e,t,r){var i=document.createElement(e);for(let n in t)if(n&&t.hasOwnProperty(n)){let o=t[n];n=="dangerouslySetInnerHTML"?i.innerHTML=o.__html:o===!0?i.setAttribute(n,n):o!==!1&&o!=null&&i.setAttribute(n,o.toString())}for(let n=2;n{this.isDark()?this.currentScheme="light":this.currentScheme="dark",this.setBodyClass(),this.currentScheme==this.systemPreferScheme&&(this.currentScheme="auto"),this.saveScheme()})}isDark(){return this.currentScheme=="dark"||this.currentScheme=="auto"&&this.systemPreferScheme=="dark"}dispatchEvent(t){let r=new CustomEvent("onColorSchemeChange",{detail:t});window.dispatchEvent(r)}setBodyClass(){this.isDark()?document.documentElement.dataset.scheme="dark":document.documentElement.dataset.scheme="light",this.dispatchEvent(document.documentElement.dataset.scheme)}getSavedScheme(){let t=localStorage.getItem(this.localStorageKey);return t=="light"||t=="dark"||t=="auto"?t:"auto"}bindMatchMedia(){window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change",t=>{t.matches?this.systemPreferScheme="dark":this.systemPreferScheme="light",this.setBodyClass()})}},E=y;function p(e){let t;return()=>{t&&window.cancelAnimationFrame(t),t=window.requestAnimationFrame(()=>e())}}var O=".article-content h1[id], .article-content h2[id], .article-content h3[id], .article-content h4[id], .article-content h5[id], .article-content h6[id]",T="#TableOfContents",L="#TableOfContents li",k="active-class";function V(e,t){let r=e.querySelector("a").offsetHeight,i=e.offsetTop-t.offsetHeight/2+r/2-t.offsetTop;i<0&&(i=0),t.scrollTo({top:i,behavior:"smooth"})}function U(e){let t={};return e.forEach(r=>{let n=r.querySelector("a").getAttribute("href");n.startsWith("#")&&(t[n.slice(1)]=r)}),t}function C(e){let t=[];return e.forEach(r=>{t.push({id:r.id,offset:r.offsetTop})}),t.sort((r,i)=>r.offset-i.offset),t}function M(){let e=document.querySelectorAll(O);if(!e){console.warn("No header matched query",e);return}let t=document.querySelector(T);if(!t){console.warn("No toc matched query",T);return}let r=document.querySelectorAll(L);if(!r){console.warn("No navigation matched query",L);return}let i=C(e),n=!1;t.addEventListener("mouseenter",p(()=>n=!0)),t.addEventListener("mouseleave",p(()=>n=!1));let o,s=U(r);function a(){let m=document.documentElement.scrollTop||document.body.scrollTop,c;i.forEach(f=>{m>=f.offset-20&&(c=document.getElementById(f.id))});let l;c&&(l=s[c.id]),c&&!l?console.debug("No link found for section",c):l!==o&&(o&&o.classList.remove(k),l&&(l.classList.add(k),n||V(l,t)),o=l)}window.addEventListener("scroll",p(a));function d(){i=C(e),a()}window.addEventListener("resize",p(d))}var $="a[href]";function P(){document.querySelectorAll($).forEach(e=>{e.getAttribute("href").startsWith("#")&&e.addEventListener("click",r=>{r.preventDefault();let i=decodeURI(e.getAttribute("href").substring(1)),n=document.getElementById(i),o=n.getBoundingClientRect().top-document.documentElement.getBoundingClientRect().top;window.history.pushState({},"",e.getAttribute("href")),scrollTo({top:o,behavior:"smooth"})})})}var x={init:()=>{w();let e=document.querySelector(".article-content");e&&(new b(e),P(),M());let t=document.querySelector(".article-list--tile");t&&new IntersectionObserver(async(s,a)=>{s.forEach(d=>{if(!d.isIntersecting)return;a.unobserve(d.target),d.target.querySelectorAll("article.has-image").forEach(async c=>{let l=c.querySelector("img"),f=l.src,H=l.getAttribute("data-key"),I=l.getAttribute("data-hash"),A=c.querySelector(".article-details"),u=await S(H,I,f);A.style.background=` + linear-gradient(0deg, + rgba(${u.DarkMuted.rgb[0]}, ${u.DarkMuted.rgb[1]}, ${u.DarkMuted.rgb[2]}, 0.5) 0%, + rgba(${u.Vibrant.rgb[0]}, ${u.Vibrant.rgb[1]}, ${u.Vibrant.rgb[2]}, 0.75) 100%)`})})}).observe(t);let r=document.querySelectorAll(".article-content div.highlight"),i="Copy",n="Copied!";r.forEach(o=>{let s=document.createElement("button");s.innerHTML=i,s.classList.add("copyCodeButton"),o.appendChild(s);let a=o.querySelector("code[data-lang]");a&&s.addEventListener("click",()=>{navigator.clipboard.writeText(a.textContent).then(()=>{s.textContent=n,setTimeout(()=>{s.textContent=i},1e3)}).catch(d=>{alert(d),console.log("Something went wrong",d)})})}),new E(document.getElementById("dark-mode-toggle"))}};window.addEventListener("load",()=>{setTimeout(function(){x.init()},0)});window.Stack=x;window.createElement=v;})(); +/*! +* Hugo Theme Stack +* +* @author: Jimmy Cai +* @website: https://jimmycai.com +* @link: https://github.com/CaiJimmy/hugo-theme-stack +*/ diff --git a/ts/search.js b/ts/search.js new file mode 100644 index 0000000..51e5636 --- /dev/null +++ b/ts/search.js @@ -0,0 +1 @@ +(()=>{var m={"&":"&","<":"<",">":">",'"':""","\u2026":"…"};function T(l){return m[l]||l}function d(l){return l.replace(/[&<>"]/g,T)}function f(l){return l.replace(/[.*+\-?^${}()|[\]\\]/g,"\\$&")}var g=class l{data;form;input;list;resultTitle;resultTitleTemplate;constructor({form:t,input:e,list:r,resultTitle:o,resultTitleTemplate:n}){this.form=t,this.input=e,this.list=r,this.resultTitle=o,this.resultTitleTemplate=n,this.input.value.trim()!==""?this.doSearch(this.input.value.split(" ")):this.handleQueryString(),this.bindQueryStringChange(),this.bindSearchForm()}static processMatches(t,e,r=!0,o=140,n=20){e.sort((i,s)=>i.start-s.start);let h=0,a=0,c=0,u=[];for(;ha?(u.push(`${d(t.substring(a,a+n))} [...] `),u.push(`${d(t.substring(i.start-n,i.start))}`),c+=n*2):(u.push(d(t.substring(a,i.start))),c+=i.start-a);let s=h+1,p=i.end;for(;s${d(t.substring(i.start,p))}`),c+=p-i.start,h=s,a=p,r&&c>o)break}if(a(a[h]=f(n),n.trim()!=="")).join("|"),"gi");for(let n of e){let h=[],a=[],c={...n,preview:"",matchCount:0},u=n.content.matchAll(o);for(let s of Array.from(u))a.push({start:s.index,end:s.index+s[0].length});let i=n.title.matchAll(o);for(let s of Array.from(i))h.push({start:s.index,end:s.index+s[0].length});h.length>0&&(c.title=l.processMatches(c.title,h,!1)),a.length>0?c.preview=l.processMatches(c.content,a):c.preview=d(c.content.substring(0,140)),c.matchCount=h.length+a.length,c.matchCount>0&&r.push(c)}return r.sort((n,h)=>h.matchCount-n.matchCount)}async doSearch(t){let e=performance.now(),r=await this.searchKeywords(t);this.clear();for(let n of r)this.list.append(l.render(n));let o=performance.now();this.resultTitle.innerText=this.generateResultTitle(r.length,((o-e)/1e3).toPrecision(1))}generateResultTitle(t,e){return this.resultTitleTemplate.replace("#PAGES_COUNT",t).replace("#TIME_SECONDS",e)}async getData(){if(!this.data){let t=this.form.dataset.json;this.data=await fetch(t).then(r=>r.json());let e=new DOMParser;for(let r of this.data)r.content=e.parseFromString(r.content,"text/html").body.innerText}return this.data}bindSearchForm(){let t="",e=r=>{r.preventDefault();let o=this.input.value.trim();if(l.updateQueryString(o,!0),o==="")return t="",this.clear();t!==o&&(t=o,this.doSearch(o.split(" ")))};this.input.addEventListener("input",e),this.input.addEventListener("compositionend",e)}clear(){this.list.innerHTML="",this.resultTitle.innerText=""}bindQueryStringChange(){window.addEventListener("popstate",t=>{this.handleQueryString()})}handleQueryString(){let e=new URL(window.location.toString()).searchParams.get("keyword");this.input.value=e,e?this.doSearch(e.split(" ")):this.clear()}static updateQueryString(t,e=!1){let r=new URL(window.location.toString());t===""?r.searchParams.delete("keyword"):r.searchParams.set("keyword",t),e?window.history.replaceState("","",r.toString()):window.history.pushState("","",r.toString())}static render(t){return createElement("article",null,createElement("a",{href:t.permalink},createElement("div",{class:"article-details"},createElement("h2",{class:"article-title",dangerouslySetInnerHTML:{__html:t.title}}),createElement("section",{class:"article-preview",dangerouslySetInnerHTML:{__html:t.preview}})),t.image&&createElement("div",{class:"article-image"},createElement("img",{src:t.image,loading:"lazy"}))))}};window.addEventListener("load",()=>{setTimeout(function(){let l=document.querySelector(".search-form"),t=l.querySelector("input"),e=document.querySelector(".search-result--list"),r=document.querySelector(".search-result--title");new g({form:l,input:t,list:e,resultTitle:r,resultTitleTemplate:window.searchResultTitleTemplate})},0)});var w=g;})();