Skip to content

Instantly share code, notes, and snippets.

@barseghyanartur
barseghyanartur / small_selection_of_photographs_i_took_before_2012.rst
Last active April 14, 2026 21:09
blog: A small selection of photographs I took before 2012
@barseghyanartur
barseghyanartur / my-recent-sketches.rst
Last active April 20, 2026 00:13
blog: My recent sketches
@barseghyanartur
barseghyanartur / pytest_codeblock.rst
Last active April 11, 2026 22:36
blog: pytest-codeblock - A pytest plugin for testing code examples in Markdown and reStructuredText files

pytest-codeblock - A pytest plugin for testing code examples in Markdown and reStructuredText files

Date: 2026-04-12 00:24
category:Tech
tags:python, pytest
summary:Tired of broken code snippets in your documentation? Try pytest-codeblock, a zero-config plugin that supports both Markdown and reStructuredText. It brings the full power of pytest—including fixtures, markers, and native async support—directly into your docs without any boilerplate or manual wiring. Just name your block test_name_of_your_block and stop relying on users to find your documentation bugs.
image:https://github.com/barseghyanartur/gist-blog-images/blob/main/images/pytest_codeblock.webp?raw=true

I wrote a small pytest plugin that tests code blocks in your docs.

@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 / 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.