DEV Community: shadowy-pycoder

Simple Markdown HTML Viever for Terminal and Neovim

shadowy-pycoder — Thu, 05 Jun 2025 03:18:47 +0000

First we need to install pandoc from their official GitHub:

cd ~/Downloads && wget -N https://github.com/jgm/pandoc/releases/download/3.7.0.2/pandoc-3.7.0.2-1-amd64.deb && \
sudo dpkg -i pandoc-3.7.0.2-1-amd64.deb

Create assets directory for pandoc and put some css files in here:

mkdir -p ~/.local/share/pandoc/ && wget http://a-dma.github.io/gruvbox-css/gruvbox-dark-medium.min.css -O ~/.local/share/pandoc/gruvbox-dark-medium.min.css

Create an executable:

tee ~/.local/bin/md << EOF 
pandoc $1 --highlight-style zenburn -s -c ~/.local/share/pandoc/gruvbox-dark-medium.min.css.css -o /tmp/pandocRenderedMarkdown.html
xdg-open /tmp/pandocRenderedMarkdown.html
EOF

Make sure ~/.local/bin in your PATH

chmod +x ~/.local/bin/md

Create desktop application:

tee ~/.local/share/applications/md.desktop << EOF 
[Desktop Entry]
Encoding=UTF-8
Version=1.0
Type=Application
NoDisplay=true
Exec='/home/$USER/.local/bin/md' %f
Name=Markdown Viever
Comment=Markdown Viever
Categories=Development;Code;
EOF

Finally, edit mimelist:

vi ~/.config/mimeapps.list

Like that:

Confirm that it works:

which md
# ~/.local/bin/md

md README.md
# Should appear in your browser

xdg-open README.md
# Should appear in your browser

Result should be similar to this:

How to use it in NeoVim?
Install NvimTree
Open your project and you will see file tree on the left.
Press s on any md file and it will be opened in a browser.

pyya - The way to manage YAML config in your Python project

shadowy-pycoder — Fri, 13 Dec 2024 13:34:19 +0000

Imagine you have a file like this in your project:

# config.yaml
database:   
    host: localhost
    port: 5432
    username: postgres
    password: postgres

To parse this dot yaml configuration file in Python you usually do this:

import yaml # pip install PyYAML

with open("config.yaml", encoding='utf-8') as fstream:
    config_yaml = yaml.safe_load(fstream)

To create Javascript-like objects from resulting dictionary you probably add the following:

from munch import munchify # pip install munch

config = munchify(config_yaml)

pyya does that automatically with one function:

from pyya import init_config

config = init_config(
    'config.yaml', 'default.config.yaml', 
    merge_configs = False,
    convert_keys_to_snake_case = False,
    add_underscore_prefix_to_keywords = False
    raise_error_non_identifiers = False)
print(config.database)

# Output:
# Munch({"host": "localhost", "port": 5432, "username": "postgres", "password": "postgres"})

What about all these flags?

merge_configs if set to True, compares config.yaml with default.config.yaml (or whatever names or paths you specify) and adds to the former all the fields that are not present in the latter. If set to False disables all merging and all formatting done by the rest of the flags.

convert_keys_to_snake_case is kinda self-explanatory because it simply makes configuration keys look pythonic. However, this flag may break some settings like logging configuration.

add_underscore_prefix_to_keywords if configuration key is also Python keyword, it will add underscore in front of it (class becomes _class). It allows attribute access work better.

raise_error_non_identifiers if configuration key is also non-valid Python identificator, it will raise error.

You can install pyya like this:

pip install pyya

Contributions and suggestions are welcome: https://github.com/shadowy-pycoder/pyya

goso: Stack Overflow CLI search tool written in Go

shadowy-pycoder — Thu, 28 Nov 2024 18:16:15 +0000

If you want to get answers to your programming questions without ever leaving convinient Terminal, then you should try goso which stands for “Golang Stack Overflow”. It is available on Github: goso repo where you can find all necessary installation instructions to make it running on your machine.

Here is little demonstration how it looks like.

Run a command:

goso  -l go -s onedark -q 1 -a 1 Sort maps in Go

Get your answer in a less than a second:

If you like this project, please give it a star or contribute to make it better.