A-Qute blog (code)

pandy

Wed, 11 Dec 2013 00:00:00 GMT

pandy is a command line wrapper for pandoc + cool stuff (if you use markdown -> html)

Basically takes a file/folder, input the markup to convert from, the output markup and runs it through pandoc.

Usage

To use the script, just call it with something like:

pandy source format_from format/s_to [other options]

Features

A bit easier syntax around pandoc commands (I can't never remember them)
Output folder keeping or not the folder structure
Source can be a file, a folder or a .list containing file paths
Formats: some of them have abbreviations (see below)
Output format: you can have more than one! just separate them with spaces
You can create a nice book (html, just adds navigation links between files). If you don't like/want "Next-Prev" navigation links, you can use the file's title. It creates a nice simple index file or you can include your own.
Use a config file: so you don't have to remember all the arguments or write a "wrapper" script for a "wrapper" script :)
[TOCME] support. That means that a file that has it, will have a TOC. No more separating files: these ones with TOC, these ones without, and finally place them in the same folder.
If you use markdown and convert to HTML there are some goodies for you! abbreviations (real abbreviations, like that they are parsed and not ignored as pandoc does) and admonitions.
"WikiLinks" for your custom index file!

For more information and explanation, go to pandy project page.

svnlog: make changelog from SVN

Mon, 02 Dec 2013 00:00:00 GMT

svnlog is a python script to create a changelog from a repository log.

Examples of output (default):

2013-11-25:
    changed arguments (better handling)
    fix: output path with one file
    fix: finding <h1>

2013-11-19:
    fixed: now files are saved according to source dir tree
    + option to save files in one depth dir

2013-11-19:
    + relative links for book

You can group that too:

2013-11-25:
    changed arguments (better handling)
    fix: output path with one file
    fix: finding <h1>

2013-11-19:
    fixed: now files are saved according to source dir tree
    + option to save files in one depth dir
    + relative links for book

It has some basic options:

Show author with --show-author or -a
Show revision number with --show-rev or -r
Show time with --show-time or -t
Prefix with a char using --prefix
Reverse the order (default: new to old) with --reverse
Specify date or a range (ISO 8601) with --date. You can leave the second date empy (date1:) to include today
If you are better with revision numbers, you can specify one or a range with --revision. You can leave the second revision empty (rev1:) to include HEAD revision
Group the dates with --group
Also group revisions with --subgroup
Or group dates but show it inline: --inline

Just make sure you have a SVN CLI in your path and then run svnlog with the options you desire

pymd: wrapper for Python Markdown

Sun, 17 Nov 2013 00:00:00 GMT

Hey!

pymd is now available in PyPI. That means that you can install it like pip install pymd :)

pymd is a command line wrapper for Python Markdown library but having a full HTML file instead of only what it's originally parsed.

Features

Batch process files (in folder or in a .list) with .md, .txt or .markdown extensions
Specify an output folder (with automatic creation)
Includes all the extensions installed by Python Markdown and you can even specify your own!
Merge files into one big HTML or create a little book with navigation links. You can even create your own index!
CSSed: leave the no-so-ugly embeded CSS (you can even switch between sans and serif fonts) or link to one of your own if you prefer.
Headers for files! So you can share the same metadata (like your beautiful name and the creative title of your work) in all the files or when you merge the files and forgot to include the main title of your project.
Wiki links: [](file|path) -> [title linked file](output_path)
Made with love <3

Find more information and examples in pymd's project page

proDO: super simple bug/issue tracker

Fri, 26 Jul 2013 00:00:00 GMT

Atención

Si no te interesa la historia del por qué se escribió el script y/o no queres saber sobre programitas, adelantate hasta acá

Background

Cuando desarrollas o escribis código (o palabras, por qué no) necesitas algún tipo de bug/issue tracker. Eso es normal para proyectos grandes o con varias personas, pero al ser un solo individuo o el proyecto es chico, todas las opciones son como mucho.

A algunos no les importa e instalan grandes bug trackers, otros usan algo mas simple. Otros vamos por la old school y escribimos en papel. Otras escribimos en un .txt, que puede ser un simple archivo o con esos ToDo.txt/taskwarrior¹.

Si el proyecto es medianamente grande (más grande que un mero script), escribo en papel. Si es algo simple/un script, anoto las cosas dentro del archivo, como varias personas.

El problema que tengo es que me gusta listar todas las cositas esas con el numero de linea y/o click que me lleve a tal. No todos los editores lo hacen por default (creo que las grandes IDEs), seguro hay un plugin que ni ganas de configurar. Se puede hacer una búsqueda, que es lo mas cercano a lo que quiero.

Uso dos editores de texto dependiendo del trabajo que tengo que hacer: Sublime Text para trabajos "grandes" (por alguna razón) y Notepad++. En ambos se puede hacer búsquedas por proyecto/archivos abiertos, la diferencia es que en Sublime Text te abre una pestañita de miercoles con los resultados (not fun), y Notepad++ te los muestra en una ventanita dockeable (good):

Qué no me gusta de esto? La forma en que te lo muestra² y el hecho que Notepad++ tiene otro tipo de regex que, según expertos, es mas pobre.

Lo más lógico es usar grep. Si usas Linux, ya viene por defecto, sino con algo como Cygwin en Windows (u otras variantes). Hasta le podes poner colorcitos pero solo a una cosa (el string encontrado). No está mal tampoco pero no es muy limpio³:

Si no te gustan las terminales/lineas de comandos pero queres usar grep, hay varios programitas que te dejan (hacer una especie de) grep⁴.

Tenes Agent Ransack, donde quedaría asi:

Para este tipo de trabajos no me gusta por que tengo que clickear archivo por archivo (not fun).

Y grepWin, donde hay que tener cuidado de clickear solo en "Search" y seleccionar la opción de "Content"

Este no estaba tan mal, pero eso de abrir programa > rellenar datos no me convencia mucho. Por lineas de comando solo podes poner el path y qué buscar (que no esta mal) pero quiero que, por lo menos, esté seleccionado el "Content".

Say hi to proDO

Como estoy aprendiendo Python y mas que nada lo estoy usando para hacer varios scripts⁵ y reemplazar/dejar de dar vueltas con los batch, me decidí a hacer el mío.

Con los ejemplos anteriores, queda asi:

Pero si tenes colorama instalado queda asi (con mas onda):

Datos:

Solo busca las palabras TODO y FIXME (es case insensitive: también podes poner ToDo, todo, tODO, etc)
Por default, al correr el programa te lista los archivos desde donde corre el script ⁶, ignorando los .bak
Se puede especificar la ruta a buscar, corriendo proDO.py -s/-source [rutita linda]
Se puede eliminar las lineas con: proDO.py del/d [archivo] [linea] (automaticamente hace un backup (.bak) del archivo por si se pone loca)
Si necesitas ejemplos de lo de arriba o queres mirar qué linda hice la ayuda: proDO.py -h
Si no queres escribir proDO.py (la extensión es importante en Windows), podes crear un "wrapper batch": en (ejemplo) proDO.bat poner: proDO.py %*. Guardás y listo, ya lo podes llamar como proDO

Decarga y más información en la página de proDO

Que esta lindo, es para linux o con Windows + Cygwin, pero es mucho trabajo para configurarlo para esto. ↩
Mentira, me acordé después de hacer el script. Lo testeé y no anda mal. Sólo que no se puede buscar por proyectos, asi que hay que escribir el path en la búsqueda o abrir todos los archivos. ↩
Se puede limpiar/formatear con awk, pero tuve problemas con Cygwin que no traía el ejecutable para la herramienta (!) ↩
No sé exactamente la diferencia entre grep y buscar dentro de los archivos (con regex), yo lo uso intercambiablemente. ↩
por que se me complicó con eso de buscar una IDE para la parte gráfica. ↩
en Linux es más fácil (por lo menos en xfce): botón derecho > terminal. En Windows tenes que apretar shift + botón derecho. ↩

Pasar de sintaxis DokuWiki a html

Sat, 11 Jun 2011 00:00:00 GMT

Para pasar de sintaxis DokuWiki a HTML necesitas poner el siguiente php:

<?php
if ('cli' != php_sapi_name()) die();
ini_set('memory_limit','128M');
if(!defined('DOKU_INC')) define('DOKU_INC',realpath(dirname(__FILE__).'/../').'/');
define('NOSESSION',1);
require_once(DOKU_INC.'inc/init.php');
require_once(DOKU_INC.'inc/common.php');
require_once(DOKU_INC.'inc/parserutils.php');
$source = stream_get_contents(STDIN);
$info = array();echo p_render('xhtml',p_get_instructions($source),$info);
?>

en dokuwiki\bin y tener php en el PATH.

Para ejecutarlo, solo tenes que llamarlo, con el input.txt y output.html que quieras. Ejemplo:

php path/a/dokuwiki/bin/dokucli.php < input.txt > output.html

Fuente: Dokuwiki Tips