Skip to content

Instantly share code, notes, and snippets.

@barseghyanartur
barseghyanartur / licence_normaliser.rst
Last active April 4, 2026 00:28
blog: licence-normaliser

licence-normaliser: Taming licence chaos in Python

Date: 2026-04-04 14:00
category:Tech
tags:python, licence
summary:Tired of wrestling with messy license strings like "MIT License" vs. "The MIT License" or cryptic URLs? licence-normaliser is a lightweight Python tool that tames the chaos. It maps inconsistent metadata into a clean, machine-readable hierarchy (Family → License → Version), turning strings like CC BY-NC-ND 4.0 into a tidy cc-by-nc-nd-4.0 automatically. Whether you're scraping repos or managing compliance, it handles SPDX codes, prose, and even complex Creative Commons variants with ease—giving you a single source of truth for your legal metadata.
image:https://raw.githubusercontent.com/barseghyanartur/licence-normaliser/main/docs/_static/licence_normaliser_logo.webp

Hey, ever tried cleaning up messy license strings — like CC BY-NC-ND 4.0 or MIT License — and getting them into

@barseghyanartur
barseghyanartur / safezip.rst
Last active April 3, 2026 20:11
blog: Safezip - zero-dependency wrapper for secure ZIP extraction

Safezip - zero-dependency wrapper for secure ZIP extraction

Date: 2026-02-25 13:00
category:Tech
tags:python, zip, security
summary:Safezip is a zero-dependency Python wrapper for zipfile that makes secure extraction the default. It provides essential protections against ZipSlip, ZIP bombs, and inconsistent ZIP64 headers—security features missing from the standard library. With support for atomic writes and environment-based configuration, it is an ideal drop-in solution for safely handling untrusted user uploads in production.
image:https://raw.githubusercontent.com/barseghyanartur/safezip/main/docs/_static/safezip_logo.webp

https://raw.githubusercontent.com/barseghyanartur/safezip/main/docs/_static/safezip_logo.webp

@barseghyanartur
barseghyanartur / how_to_debug_python_applications.rst
Last active April 3, 2026 20:58
blog: How to debug Python applications

How to debug Python applications

Date: 2022-06-21 11:00
category:Tech
tags:python, debugging
summary:In software development, testing is an essential part of ensuring that code works as intended. One critical aspect of testing is debugging, which involves finding and fixing errors or bugs in a program. In this article, we’ll explore how to debug Python applications and highlight some of the most commonly used methods for debugging Python code.
image:https://i.postimg.cc/rp4SskQv/rp-L4mz-N2-ZJ0-Pnopju2da-1-kguub.jpg

https://i.postimg.cc/rp4SskQv/rp-L4mz-N2-ZJ0-Pnopju2da-1-kguub.jpg

@barseghyanartur
barseghyanartur / log4brains_images_support.rst
Last active April 3, 2026 20:59
blog: Log4Brains images support

Log4Brains images support

Date: 2026-04-03 14:00
category:Tech
tags:ADRs, log4brains
summary:Tired of broken images in your Architecture Decision Records? This quick fix shows you how to add static image support to Log4brains. By setting up a docs/l4b-static folder and adding a simple copy command to your Build script or GitHub Action, you can finally use local icons and diagrams directly in your ADRs. Perfect for keeping your architecture docs visual and professional without the hosting headaches.

https://github.com/thomvaill/log4brains

Directory structure

@barseghyanartur
barseghyanartur / open_webui_setup_macos.rst
Last active April 3, 2026 21:03
blog: open-webui setup on macOS

open-webui setup on macOS

Date: 2026-04-03 00:21
category:Tech
tags:python, open-webui, macos
summary:Want to run Open WebUI as a seamless background service on your Mac? This guide walks you through setting it up with launchd, so it starts automatically every time you log in. Using uv for a clean install and a simple .plist configuration, you'll get persistent hosting, automatic crash recovery, and easy log management. No more manual terminal commands—just a reliable local AI interface ready whenever you need it.

Here’s how to set up Open WebUI as a launchd service on macOS.

@barseghyanartur
barseghyanartur / open_webui_setup_macos.md
Last active April 2, 2026 13:33
open-webui setup on macOS

open-webui setup on macOS

Here's how to set up Open WebUI as a launchd service on macOS.


Prerequisites

First, install Open WebUI via uv if you haven't already:

@barseghyanartur
barseghyanartur / useful_plugins_for_vscode.rst
Last active April 3, 2026 21:02
blog: VS Code - Useful plugins for

Useful plugins for VSCode

Date: 2026-04-03 01:02
category:Tech
tags:python, vs-code, vs-code-plugins
summary:Supercharge your VS Code setup with this curated list of essential plugins! Whether you're a Python pro needing Pylance and Makefile support, or a documentation stickler looking for Markdown and reStructuredText tools, these extensions bridge the gap between a basic editor and a powerhouse IDE. Plus, grab the PyCharm Theme to get that classic JetBrains look without sacrificing VS Code's lightweight speed.
@barseghyanartur
barseghyanartur / rst_to_md.sh
Created January 20, 2026 21:53 — forked from zaiste/rst_to_md.sh
Convert RST to Markdown using Pandoc
FILES=*.rst
for f in $FILES
do
filename="${f%.*}"
echo "Converting $f to $filename.md"
`pandoc $f -f rst -t markdown -o $filename.md`
done