noroute2host.com

Arranque automático de contenedores con docker-compose y systemd

2025-04-06T19:00:00+02:00

Regresamos a vueltas con contenedores y docker. En este nuevo post vamos a ver como generar un servicio de systemd para nuestros ficheros docker compose o docker-compose.yml. Así que sí, después de la larga espera para hablar un poco de contenedores, vamos a encadenar un par de artículos consecutivos sobre este tema.

Iniciando tus contenedores automáticamente al inicio con docker compose y systemd

Nuestro objetivo es hacer que nuestros servicios y contenedores definidos en un fichero docker-compose.yml se inicien automáticamente con el arranque del sistema. Para ello necesitaremos:

Un fichero docker-compose.yml con la definición de los servicios y contenedores.
Un fichero de unidad o unit file de systemd donde se define el servicio asociado a nuestro fichero compose.
Probar el inicio y parada de nuestros servicios contenerizados con systemd.
Habilitar nuestro servicio para que se inicie al arranque del sistema.

Fichero docker-compose.yml base para integrar con systemd

Como parece lógico, lo primero que necesitamos para poder gestionar nuestro fichero docker compose mediante systemd es un fichero docker-compose.yml.

Como ejemplo para este artículo vamos a usar un fichero docker compose bastante simple. Solo contendrá un servicio web que será un servidor web nginx. Si sientes curiosidad por manejar ficheros docker-compose.yml más complejos puedes echarle un ojo a nuestro artículo sobre Gluetun y los ejemplos en nuestro repositorio que en él se muestran, o visitar la documentación oficial de Docker Compose.

Nuestro fichero docker-compose.yml será este:

---
services:
  web:
    image: nginx
    container_name: nginx_noroute2host
    ports:
      - "8080:80"

Y lo vamos a colocar, por ejemplo, en el siguiente directorio: /store/docker-compose-nginx. Pero tú puedes colocarlo donde prefieras. Eso sí, recuerda donde lo haces porque lo vamos a necesitar más adelante.

Unit File o fichero de unidad de systemd

Una vez que tenemos el fichero docker compose, el siguiente paso es generar un servicio de systemd asociado a nuestro fichero docker-compose.yml.

Llegados a este punto habrá alguno que se pregunte ¿qué es systemd? Aunque muchos de los que estéis leyendo esto ya lo sabréis, systemd es un gestor de sistemas y de servicios para Linux. Y esto se traduce en que es el sistema de inicialización por defecto en muchas distribuciones Linux, incluidas Debian, Redhat y sus derivadas. Así que se puede decir que hoy en día es el sistema de arranque de muchas distribuciones Linux.

Systemd funciona en base a unidades, y estas unidades se definen en ficheros de unidad. En concreto, en la ruta /etc/systemd/system/ se incluyen los ficheros de unidad personalizados del usuario entre otros.

Además, estas unidades pueden ser de diferente tipo, pero la unidad que nos interesa para llevar a cabo nuestra tareas es la de servicio o service.

Así que vamos a crear un fichero de unidad o unit file en la siguiente ruta y, por ejemplo, con el siguiente nombre: /etc/systemd/system/docker-compose-nginx.service.

[Unit]
Description=Docker compose de NGINX como servicio
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=true
User=adrimcgrady
WorkingDirectory=[TU/DIRECTORIO/QUE/CONTIENE/EL/FICHERO/DOCKER/COMPOSE]
ExecStart=[/RUTA/ABSOLUTA/A/TU/COMANDO]/docker-compose up -d --remove-orphans
ExecStop=[/RUTA/ABSOLUTA/A/TU/COMANDO]/docker-compose down

[Install]
WantedBy=multi-user.target

En el fichero de unidad de arriba hay varios parámetros que aparecen parametrizados. Para mayor claridad te dejo aquí abajo el fichero de unidad completo para nuestro ejemplo.

[Unit]
Description=Docker compose de NGINX como servicio
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=true
User=adrimcgrady
WorkingDirectory=/store/docker-compose-nginx
ExecStart=/usr/local/bin/docker-compose up -d --remove-orphans
ExecStop=/usr/local/bin/docker-compose down

[Install]
WantedBy=multi-user.target

Usando systemd para iniciar los contenedores definidos en el fichero docker-compose.yml

Antes de correr hay que aprender a andar. Pues siguiendo el símil, antes de arrancar los contenedores con el inicio del sistema hay que probar que se pueden arrancar y parar sin problemas con systemd, o más concretamente con systemctl.

Como ya tenemos definido tanto nuestro fichero docker-compose.yml como nuestro unit file de systemd, lo único que queda es probarlo.

El inicio de un servicio con systemctl es tan sencillo como:

sytemctl start NOMBRE_DE_SEVICIO

Por lo que si queremos arrancar el servicio que hemos definido como ejemplo, habrá que ejecutar simplemente:

root@raspibox:~# systemctl start docker-compose-nginx.service

Y para comprobar el estado del servicio lo podemos hacer vía systemctl status:

root@raspibox:~# systemctl status docker-compose-nginx.service
● docker-compose-nginx.service - Docker compose de NGINX como servicio
     Loaded: loaded (/etc/systemd/system/docker-compose-nginx.service; disabled; vendor preset: enabled)
     Active: active (exited) since Sun 2025-04-06 13:25:37 CEST; 1min 21s ago
    Process: 25345 ExecStart=/usr/local/bin/docker-compose up -d --remove-orphans (code=exited, status=0/SUCCES>
   Main PID: 25345 (code=exited, status=0/SUCCESS)
        CPU: 578ms

Apr 06 13:25:24 raspibox systemd[1]: Starting Docker compose de NGINX como servicio...
Apr 06 13:25:27 raspibox docker-compose[25345]:  Container nginx_noroute2host  Created
Apr 06 13:25:27 raspibox docker-compose[25345]:  Container nginx_noroute2host  Starting
Apr 06 13:25:37 raspibox docker-compose[25345]:  Container nginx_noroute2host  Started
Apr 06 13:25:37 raspibox systemd[1]: Finished Docker compose de NGINX como servicio

También podemos ver el si el contenedor está funcionando vía docker ps:

root@raspibox:~# docker ps --last 1
CONTAINER ID   IMAGE     COMMAND                  CREATED       STATUS         PORTS                                   NAMES
c6d145c6e64a   nginx     "/docker-entrypoint.…"   3 weeks ago   Up 3 minutes   0.0.0.0:8080->80/tcp, :::8080->80/tcp   nginx_noroute2host

O lo que es mejor, simplemente se puede hacer la prueba de conectar a nuestro servidor web nginx contenerizado:

Llegados a este punto, toca probar la parada del servicio. De manera genérica esto puede hacerse de la siguiente manera:

sytemctl stop NOMBRE_DE_SEVICIO

Por tanto, para parar el servicio de ejemplo:

root@raspibox:~# systemctl stop docker-compose-nginx.service

Y se puede comprobar que nuestro contenedor nginx_noroute2host ya no está corriendo:

root@raspibox:~# docker ps --filter name=nginx_noroute2host
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

Así que si volvemos a repetir la prueba de conexión al servidor Nginx, ahora obtendremos un error:

Último paso: Habilitar el servicio al arranque

Ya está todo probado y definido así que nos queda simplemente el último paso, habilitar nuestro servicio de systemd. Esto es algo bastante sencillo y parecido a los comandos anteriores con systemctl. La sintaxis es esta:

systemctl enable NOMBRE_DE_SEVICIO

Lo que aplicado al servicio que estamos usando de ejemplo es simplemente:

systemctl enable docker-compose-nginx.service

Y ya está, ya sabes todo lo necesario para:

Definir tus contenedores y servicios en un fichero docker-compose.yml
Integrar el fichero docker-compose.yml con systemd mediante un fichero de unidad o unit file.
Iniciar tus contenedores del fichero compose mediante el servicio de systemd definido.
Habilitar este servicio al arranque del sistema.

Antes de acabar: Ficheros de ejemplo

Además de la explicación disponible en este post, se han dejado los ficheros compose y de unidad en el repositorio del blog a modo de referencia. Este es el acceso directo a cada fichero:

Enlaces de interés:

Guía de Gluetun: VPN y Proxy para tus contenedores o para cualquier dispositivo o aplicación en tu red

2025-02-07T21:00:00+01:00

Ha sido necesario que llegue 2025 para que hablemos de algo relacionado con contenedores en este blog. En concreto, vamos a hablar de Gluetun. Tal y como sus mantendores lo definen es un “Cliente VPN en un contenedor Docker ligero para múltiples proveedores de VPN, escrito en Go y que utiliza OpenVPN o Wireguard, DNS sobre TLS, con algunos servidores proxy integrados”

Gluetun: Una navaja suiza de clientes VPN que incluye servidores de proxy

En realidad, con la pequeña introducción y el título de esta sección se puede entender que es Gluetun. Aún así, vamos a intentar explicarlo un poco mejor. Gluetun es una imagen de contenedor que consiste básicamente en una ingente cantidad de clientes VPN para que utilices el que más te convenga. A lo anterior hay que sumarle que en la imagen tienes a tu disposición servidores de proxy.

Y al juntar estas dos características tenemos un contenedor que puede hacer de proxy con VPN integrada para tus contenedores o para tus dispositivos dentro de la red LAN. Incluso, en el caso de los contenedores, sin ni siquiera hacer uso del servicio de proxy puedes hacer que el acceso a la red de tus contenedores sea a través de Gluetun. Así que tendrás tus servicios en contenedores a través de una VPN.

Por último, como tiene soporte tanto para ARM como para x86 en sus versiones de 32 y 64 bits, te permite montar este juguetito en cualquier Raspberry u otra SBC, así como cualquier MiniPC a tu disposición de una manera rápida y simple.

Las características más importantes de Gluetun son:

Imagen muy ligera basada en Alpine Linux.
Soporte para múltiples proveedores de VPN: AirVPN, Cyberghost, ExpressVPN, FastestVPN, Giganews, HideMyAss, IPVanish, IVPN, Mullvad, NordVPN, Perfect Privacy, Privado, Private Internet Access, PrivateVPN, ProtonVPN, PureVPN, SlickVPN, Surfshark, TorGuard, VPNSecure.me, VPNUnlimited, Vyprvpn, WeVPN, Windscribe.
Soporte para OpenVPN para todos los servidores.
Soporte para Wireguard. En función del proveedor VPN hay soporte para Kernel y espacio de usuario, soporte usando custom provider o puede que el soporte en este caso no esté disponible. Este soporte esta en progreso y su avance puede consultarse aquí.
DNS over TLS. Además permite elegir el proveedor de DOT e incluso indicar múltiples proveedores.
Bloqueo DNS de hostnames e IPs maliciosas.
Firewall integrado.
Servidores proxy integrados. Shadowsocks y HTTP.
Conexión de otros contenedores y otros dispositivos LAN a Gluetun.
Posibilidad de uso como contenedor sidecar en Kubernetes.

Gluetun como VPN para tus contenedores

La primera manera de usar Gluetun que vamos a ver es como VPN para tus contenedores. De este modo se puede hacer que tus contenedores usen el stack de red de tu contenedor Gluetun. Esto se traduce que los contenedores que quieras estarán usando una VPN.

Arrancando tu contenedor Gluetun

Todas las características definidas anteriormente se materializan en una imagen de contenedor disponible en DockerHub. Por lo que en este apartado vamos a ver como arrancar nuestro contenedor de Gluetun.

Lo primero a tener en cuenta es que Gluetun soporta tanto OpenVPN como WireGuard. En este artículo nos centraremos en la opción de OpenVPN, pero puedes encontrar más información sobre como trabajar con WireGuard en esta página del Wiki de Gluetun. Así que, continuando con OpenVPN, puedes encontrar todas las opciones disponibles aquí.

Una vez elegido el protocolo OpenVPN como nuestra opción, el requisito fundamental es tener una cuenta en un servicio de VPN de los compatibles con Gluetun. En mi caso he estado probado las cuentas gratuitas de ProtonVPN y de PrivadoVPN y he detectado un requisito bastante importante en el caso de las cuentas gratuitas. No todos los proveedores permiten conexiones VPN con clientes no oficiales en la versión gratuita. En mi caso, perdí bastante tiempo con PrivadoVPN porque no conseguí hacer funcionar la cuenta gratuita con Gluetun hasta que descubrí que solo puedes usar la cuenta gratuita desde su cliente oficial. Pero el error que mostraba mi contenedor en el arranque es que las credenciales no eran correctas. Por lo que ante esta situación estaba claro que la configuración la iba a realizar con ProtonVPN.

Así que ya están decididos los dos requisitos fundamentales: El protocolo (OpenVPN) y el proveedor de VPN (ProtonVPN). Por lo que estamos listos para iniciar nuestro contenedor. Pero antes de continuar, y solo si el sistema donde vas a iniciar tu contenedor es de 32 bits, como en el caso de las primeras Raspberry Pi, debes tener en cuenta los requisitos que indican en el wiki de Gluetun.

Por tanto para arrancar nuestro contenedor Gluetun, este sería un buen ejemplo:

docker run -it --rm --name=gluetun_noroute2host \
 --cap-add=NET_ADMIN \
 --device /dev/net/tun \
 -v /store/gluetun:/gluetun \
 -e VPN_TYPE=openvpn \
 -e VPN_SERVICE_PROVIDER=protonvpn \
 -e OPENVPN_USER=[TU_USUARIO_DEL_PROVEEDOR] \
 -e OPENVPN_PASSWORD=[TU_PASSWORD_DEL_PROVEEDOR] \
 -e FREE_ONLY=on \
 -e DOT=on \
 -e TZ="Europe/Madrid" \
 -e UPDATER_PERIOD=24h \
 qmcgaw/gluetun

En este comando hay dos tipos de opciones que paso a explicar:

Opciones propias de Docker:
- -it: Opcional. Es la forma corta de las opciones --interative y --tty. Inicia el contenedor en modo interactivo y con un pseudo-terminal.
- --rm: Opcional. Para el ejemplo queremos que cuando se detenga el contenedor se elimine automáticamente.
- --name=gluetun_noroute2host: Simplemente sirve para indicar un nombre para nuestro contenedor. Lo establecemos porque después será necesario referenciarlo en los contenedores que hagan uso de este.
- --cap-add=NET_ADMIN: Requerido por Gluetun. Por defecto un contenedor corre en un modo “sin privilegios”. Con esta opción se dan privilegios adicionales sobre el stack de red.
- --device /dev/net/tun: Requerido por Gluetun. Añade el dispositivo /dev/net/tun del sistema al contenedor. Este dispositivo es la interfaz virtual de network TUNnel.
- -v /store/gluetun:/gluetun: Requerido por Gluetun. Mapea una ubicación del host a la ruta /gluetun del contenedor.
- qmcgaw/gluetun: Requerido por Gluetun. Es el nombre de la imagen de contenedor oficial de Gluetun.
Opciones de Gluetun. Estas opciones funcionan a través de variables de entorno con la opción de docker -e:
- VPN_TYPE: En nuestro ejemplo la establecemos openvpn. Pero también es la opción por defecto si no se indica este parámetro.
- VPN_SERVICE_PROVIDER: Indica un proveedor de servicio válido. En este caso protonvpn. Pero puede ser cualquier otro del que se disponga una cuenta. Aquí está la lista de proveedores válidos.
- OPENVPN_USER: Aquí se debe indicar el nombre de tu usuario en el proveedor elegido.
- OPENVPN_PASSWORD: Igualmente que el parámetro anterior, pero en este caso para el password.
- FREE_ONLY: Parámetro específico de protonvpn para indicar que solo use los servidores disponibles en el plan gratuito. Aquí puedes ver todas las opciones específicas de protonvpn.
- DOT: Habilita DNS over TLS. Por defecto ya está habilitado.
- TZ: Especifica un Timezone para ver correctamente los tiempos en los logs.
- UPDATER_PERIOD: Opcional. Actualiza los servidores disponibles alojados en memoria en el intervalo especificado. En este caso 24 horas.

La lista anterior es una propuesta para este artículo pero puedes comprobar por ti mismo todas las opciones disponibles.

Una vez ejecutado el comando, ya tendrás tu contenedor de Gluetun funcionando con las opciones indicadas. Como hemos arrancado el contenedor en modo interactivo puedes ver en tu terminal si todo hay ido bien en el arranque.

Hacer que un contenedor esté en el mismo namespace de red que otro

Ahora que ya tenemos nuestro conenedor de Gluetun funcionando la pregunta es: ¿Y como hago para que otro de mis contenedores lo aproveche? Y la respuesta es: haciendo que tus otros contenedores usen el mismo namespace de red que ya tiene el contenedor de Gluetun. De esta manera tus contenedores asociados al mismo namespace de red estarán en el mismo stack de red que el de gluetun. Tanto es así, que podrás acceder a los servicios de cualquiera de los contenedores en el mismo espacio de red a través de localhost.

Pero ¡atención! Que como los mapeos de puertos son únicos en el namespace de red, no puedes usar los mismos puertos para diferentes contenedores dentro del mismo namespace de red. Esto último es algo con lo que hay que tener mucho cuidado.

La implementación de esta estrategia se hace con la opción --network de docker. Esta opción indica a que red se conecta un contenedor. Por defecto, si no se indica esta opción, se conecta al bridge por defecto de docker. Pero la opción te permite cambiar este comportamiento. En concreto la vamos a especificar así: --network:container:NOMBRE_DE_TU_CONTENEDOR. Por ejemplo:

docker run --rm --network:container:gluetun_noroute2host hello-world

La orden anterior ejecuta el contenedor hello-world de docker en la misma pila de red que nuestro contenedor gluetun.

Esta misma opción se puede configurar dentro de un docker-compose donde estén los dos contenedores, aunque siendo así la sintaxis es algo diferente. Además también es algo distinto según el caso:

Si el contenedor que vaya a usar gluetun esta en el mismo fichero compose, la configuración análoga sería incluir en el servicio que vaya a usar gluetun la siguiente linea en el docker-compose.yml:

network_mode: "service:NOMBRE_DEL_SERVICIO_GLUETUN_EN_FICHERO_COMPOSE"

Si por el contrario, el contenedor que va a usar gluetun está en otro fichero compose la configuración incluir sería distinta:

network_mode: "container:gluetun"

Tienes más información sobre estas configuraciones en la siguiente página del wiki de Gluetun

Probando el acceso VPN para otro contenedor

Con la explicación anterior, ya solo nos queda demostrar que podemos hacer que otro de nuestros contenedores o servicios contenerizados pueden usar este contenedor Gluetun para acceder a Internet a través del servicio VPN configurado en Gluetun. Para esta prueba vamos a usar una imagen básica de Alpine Linux y a seguir estas instrucciones.

En primer lugar, vamos a probar a arrancar este contenedor básico de Alpine sin pasar por nuestro contenedor de Gluetun. Además le pasaremos un comando con la opción -c para que sea ejecutado en el arranque del contenedor. Este comando es wget -qO- https://ipinfo.io y básicamente lo que hace es mostrar con que ip está saliendo el contenedor a Internet.

docker run --rm alpine:latest \
 sh -c "apk add wget && wget -qO- https://ipinfo.io"

Y el resultado es que actualmente el contenedor de manera pública sale a Internet con una ip de España. He ofuscado el resto de datos:

{
  "ip": "X.X.X.X",
  "city": "Xxxxx",
  "region": "Xxxxxxxx",
  "country": "ES",
  "loc": "X,Y",
  "org": "Xxxxx Xxxxxx XX",
  "postal": "NNNNN",
  "timezone": "Europe/Madrid",
  "readme": "https://ipinfo.io/missingauth"
}

Y justo a continuación, vamos a ejecutar la misma orden, pero configurando nuestro contenedor para que use la red del contenedor de gluetun.

docker run --rm --network=container:gluetun_noroute2host alpine:latest \
 sh -c "apk add wget && wget -qO- https://ipinfo.io"

Es por ello que ahora el resultado es una dirección ip de Japón. Vuelvo a ofuscar algunas partes de la salida.

{
  "ip": "X.X.X.X",
  "hostname": "Xxxxx",
  "city": "Osaka",
  "region": "Osaka",
  "country": "JP",
  "loc": "X,Y",
  "org": "Xxxxx Xxxxxx XX",
  "postal": "NNNNN",
  "timezone": "Asia/Tokyo",
  "readme": "https://ipinfo.io/missingauth"
}

Como publicar puertos de tus contenedores mientras hacen uso de Gluetun

Personalmente esta es una de las cosas que más me ha costado entender al principio. Ya se ha comentado anteriormente en este artículo, pero hay que tener en cuenta que nuestros contenedores están conectados a la red o al namespace de red del contenedor de gluetun. ¿Y que implica esto? Pues algunos detalles como los que enumero a continuación:

Dentro del mismo namespace de red, no puedes usar un mismo puerto para publicar servicios de varios contenedores. Esta publicación es única dentro del namespace y no se puede repetir.
Además, con respecto a esto, la publicación de puertos hay que hacerla en el contenedor base de la pila de red que estamos usando, es decir, nuestro contenedor de gluetun. Por tanto, si tienes un servidor web usando la red del contenedor de gluetun, la publicación de este servicio web hay que hacerla al iniciar el contenedor de gluetun.
Todos los contenedores haciendo uso del mismo stack de red pueden comunicarse entre ellos usando localhost.

Voy a intentar explicar esto con un ejemplo. En concreto voy a usar la imagen de contenedor public-ip-monitor para intentar aclarar esta casuística. La funcionalidad de esta imagen es similar a lo que hacíamos con la imagen de Alpine Linux y el comando para obtener nuestra ip en Internet. Pero en este caso, tenemos un servidor web (el que trae embebido el cli de php) que correrá en el puerto 80. Este servidor web simplemente muestra un registro de la dirección ip de Internet de nuestro contendedor.

Antes de nada, si no tienes arrancado el contenedor de gluetun, hay que volver a arrancarlo. Además, hay que tener en cuenta todo lo que te he contado antes y hacer la publicación del puerto para el servidor web del otro contenedor (el de public-ip-monitor) que arrancaremos después. Así que para vamos a iniciar nuestro contenedor de Gluetun y a la vez vamos a publicar el puerto 80 del futuro contenedor en el puerto 8080 con la opción -p 8080:80:

docker run -it --rm --name=gluetun_noroute2host \
 --cap-add=NET_ADMIN \
 --device /dev/net/tun \
 -v /store/gluetun:/gluetun \
 -p 8080:80 \
 -e VPN_TYPE=openvpn \
 -e VPN_SERVICE_PROVIDER=protonvpn \
 -e OPENVPN_USER=[TU_USUARIO_DEL_PROVEEDOR] \
 -e OPENVPN_PASSWORD=[TU_PASSWORD_DEL_PROVEEDOR] \
 -e FREE_ONLY=on \
 -e DOT=on \
 -e TZ="Europe/Madrid" \
 -e UPDATER_PERIOD=24h \
 qmcgaw/gluetun

Ahora ya se puede arrancar el contenedor public-ip-monitor con el servidor web que muestra el histórico de nuestra ip “pública”.

docker run --network="container:gluetun_noroute2host" \
 --name public-ip-monitor \
 outlyernet/public-ip-monitor

Y antes de probar a acceder a este contenedor, es necesario hacer un paso adicional. La imagen public-ip-monitor-tiene una particularidad. Es necesario forzar que se “auto-descubra” nuestra ip en Internet con un comando ejecutado desde el propio contenedor. No se hace de manera automática. Para ello tendremos que hacer uso del subcomando docker exec tal que así:

docker exec public-ip-monitor /update

Este comando ejecuta el script update.sh en la raíz del sistema de ficheros del contenedor. Y este script obtiene nuestra ip y la guarda en un log, que después se visualiza en el servidor web.

Ahora ya podemos ir a un navegador, acceder a la ip de nuestro host de docker y al puerto 8080, es decir, http://[TU_HOST_DOCKER]:8080. De este modo, estaremos accediendo al servidor web de nuestro contenedor public-ip-monitor. Y aquí esta el resultado:

Gluetun como servidor proxy

El otro modo de funcionamiento de Gluetun es como proxy para cualquier servicio que pueda configurarse para funcionar a través de proxy. Puede ser un servicio contenerizado o simplemente el navegador web de cualquiera de los dispositivos de tu red.

Gluetun tiene disponibles dos tipos de servidor proxy: HTTP y Shadowsocks. Para nuestros ejemplos vamos a usar la opción de HTTP, pero puedes consultar toda la información para las ambas opciones aquí.

Iniciando tu contenedor gluetun con servidor proxy incluido

Para arrancar gluetun con servicio de proxy incluido vamos a usar un comando similar a cuando lo lanzamos sin proxy pero añadiendo las respectivas opciones para activar el servicio de proxy HTTP.

docker run -it --rm --name=gluetun_noroute2host \
 --cap-add=NET_ADMIN \
 --device /dev/net/tun \
 -p 8888:8888 \
 -v /store/gluetun:/gluetun \
 -e VPN_TYPE=openvpn \
 -e VPN_SERVICE_PROVIDER=protonvpn \
 -e OPENVPN_USER=[TU_USUARIO_DEL_PROVEEDOR] \
 -e OPENVPN_PASSWORD=[TU_PASSWORD_DEL_PROVEEDOR] \
 -e FREE_ONLY=on \
 -e DOT=on \
 -e TZ="Europe/Madrid" \
 -e UPDATER_PERIOD=24h \
 -e HTTPPROXY=on \
 qmcgaw/gluetun

Solo se han añadido un par de opciones. De estas opciones, la primera es propia de docker:

-p 8888:8888: Expone el puerto 8888 del contenedor de Gluetun en el puerto 8888 del host de Docker. El puerto 8888 es en el corre el servicio de proxy HTTP de Gluetun.

Y la segunda es específica de gluetun, por lo que está definida como variable de entorno con la opción -e:

HTTPPROXY: Como su propio nombre indica. Al establecer esta variable a on habilita el servicio de proxy HTTP de Gluetun.

Configurar otros dispositivos para que funcionen a través del proxy de Gluetun

Tras arrancar el contenedor de gluetun con el servicio de proxy, ya solo nos queda conectar alguno de nuestros servicios, dispositivos o programas a este proxy. ¿Que te parece si lo hacemos con Firefox?

En primer lugar, vamos a comprobar de que país es nuestra ip actual sin configurar ningún tipo de proxy. El servicio que usaremos para ello es IPinfo.io.

Como puedes ver, la ubicación normal de mi ip es España. Pero ahora vamos a activar el proxy en Firefox y a ver que pasa. Para ello configuraremos dentro de Firefox la dirección de red de nuestro contenedor de Gluetun así como su puerto. En mi caso, tengo corriendo el contenedor en mi Raspberry Pi llamada raspibox, y en cuanto al puerto a usar, solo hay que tener en cuenta que el puerto del proxy HTTP de Gluetun es el 8888. Además, si miras el comando de ejecución de docker ejecutado anteriormente verás que dicho puerto está expuesto en el 8888. Por tanto la configuración de proxy quedaría así:

Si tienes dudas sobre como configurar un proxy HTTP en Firefox puedes ver como hacerlo en esta página de la documntación oficial de Firefox. En cualquier caso, tras la configuración del proxy en Firefox el resultado es el siguiente:

Como puedes ver, mi ubicación ha cambiado y ahora ¡estamos navegando a través de un servicio proxy que además funciona sobre una VPN!

Bonus Track: Algunas cositas más…

Ficheros docker-compose de ejemplo

Aunque todos los ejemplos los hemos explicado mediante docker run, he dejado ficheros docker-compose.yml para cada uno de los ejemplos que hemos visto en esta guía en el repositorio del blog. La lista de ficheros de ejemplo es la siguiente:

Usar Gluetun para listar los servidores disponibles de tu proveedor VPN

Como ya hemos comentado al principio de este artículo, Gluetun está preparado para funcionar con un montón de proveedores de VPN. Y muchos de ellos tienen configuración específica adicional donde puedes definir donde se ubican los servidores de VPN a los que te quieres conectar. Dependiendo del proveedor puedes elegir la región, el país o incluso la ciudad. Es por ello que Gluetun provee un modo de ejecución donde te permite ejecutar el contenedor Gluetun solo para listar los servidores del proveedor elegido. Este modo lista los servidores disponibles, la información de sus características, y al acabar, simplemente finaliza su ejecución. Esto se explica aquí.

Este modo de ejecución funciona lanzando el contenedor de gluetun así:

docker run --rm \
 -v /yourpath:/gluetun \
 qmcgaw/gluetun \
 format-servers -yourprovider

Y si lo personalizamos con el volumen que ya usamos en los comandos anteriores, y para el proveedor ProtonVPN. El comando quedaría así:

docker run --rm \
 -v /store/gluetun:/gluetun \
 qmcgaw/gluetun \
 format-servers -protonvpn

Y la salida sería esta:

| Country | Region | City | Hostname | VPN | Free | Port forwarding | Secure | Tor |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Albania |  | Tirana | `al-01.protonvpn.net` | openvpn | ❌ | ✅ |  |  |
| Albania |  | Tirana | `al-01.protonvpn.net` | wireguard | ❌ | ✅ |  |  |
| Albania |  | Tirana | `al-02.protonvpn.net` | openvpn | ❌ | ✅ |  |  |
| Albania |  | Tirana | `al-02.protonvpn.net` | wireguard | ❌ | ✅ |  |  |
| Algeria |  | Algiers | `dz-02.protonvpn.net` | openvpn | ❌ | ✅ |  |  |
| Algeria |  | Algiers | `dz-02.protonvpn.net` | wireguard | ❌ | ✅ |  |  |
| Algeria |  | Algiers | `dz-01.protonvpn.net` | openvpn | ❌ | ✅ |  |  |
| Algeria |  | Algiers | `dz-01.protonvpn.net` | wireguard | ❌ | ✅ |  |  |
| Angola |  | Luanda | `ao-02.protonvpn.net` | openvpn | ❌ | ✅ |  |  |
| Angola |  | Luanda | `ao-02.protonvpn.net` | wireguard | ❌ | ✅ |  |  |
| Argentina |  |  | `node-ar-03.protonvpn.net` | openvpn | ❌ | ❌ |  |  |
| Argentina |  |  | `node-ar-03.protonvpn.net` | wireguard | ❌ | ❌ |  |  |
| Argentina |  |  | `node-ar-04.protonvpn.net` | openvpn | ❌ | ❌ |  |  |
| Argentina |  |  | `node-ar-04.protonvpn.net` | wireguard | ❌ | ❌ |  |  |
| Argentina |  | Buenos Aires | `node-ar-03.protonvpn.net` | openvpn | ❌ | ❌ |  |  |
| Argentina |  | Buenos Aires | `node-ar-03.protonvpn.net` | wireguard | ❌ | ❌ |  |  |
| Argentina |  | Buenos Aires | `node-ar-04.protonvpn.net` | openvpn | ❌ | ✅ |  |  |
| Argentina |  | Buenos Aires | `node-ar-04.protonvpn.net` | wireguard | ❌ | ✅ |  |  |
...
...
...

Elige bien tu proveedor VPN para Gluetun

Esto es simplemente un consejo que puede parecer muy básico pero que es muy importante. No todos los servicios de VPN ofrecen todos los servicios ni siquiera en su plan de pago. Pero en el caso de los planes gratuitos cada uno pone sus limitaciones y pueden ser muy diferentes de un proveedor a otro. Te pongo algunos ejemplos…

ProtonVPN funciona muy bien pero en el plan gratuito los países están limitados a solo unos pocos. Esto suele ser normal en los planes gratis. Pero también tiene limitaciones con el tráfico P2P que se pueden solventar en su plan de pago.

Otro ejemplo puede ser PrivadoVPN, he probado su aplicación Android y no tiene esas limitaciones en el tráfico P2P, pero si tiene límite de GB de tráfico al mes en su plan gratuito. Y no solo eso, tras estar alguna que otra hora intentando hacer funcionar Gluetun con PrivadoVPN en su plan gratuito, acabé dándome cuenta que PrivadoVPN no permite usar otras aplicaciones que no sean la oficial para el plan gratis. Pasaron horas hasta que me dí cuenta porque el error en Gluetun siempre era de credenciales incorrectas.

Así que para elegir tu proveedor VPN, además de tener en cuenta el coste, piensa en el uso que le vas a dar y evalúa cual es el mejor para este uso.

Enlaces de interés:

Bots en Telegram (II): Tu bot de Telegram con Bash

2024-12-10T19:00:00+01:00

Bots en Telegram (II): Tu bot de Telegram con Bash

Ya era hora de traer la continuación del artículo de Bots en Telegram (I) Creación de un bot de Telegram. En este nuevo capítulo vamos a centrarnos en como usar un bot de Telegram desde la shell bash de Linux. Como ya indiqué en la primera parte, estos bots son muy útiles para integrarlos con nuestros scripts.

Con bash y un bot de Telegram podemos recibir la información que queramos en cualquier momento y lugar. ¿Como lograrlo? Pues justo esto es lo que voy a explicar hoy.

Curl

En este blog muchas veces nos centramos en las utilidades más básicas de nuestros terminales. Y curl es sin duda una de ellas. En este caso, la relación con este post se basa en que la manera más simple de enviar mensajes desde tu terminal de linux a tu bot de Telegram es curl. ¿Que no conoces curl? ¡Pues deberías! Citando directamente la definición de Wikipedia, cURL es un proyecto de software informático que proporciona una biblioteca (libcurl) y una herramienta de línea de comandos (curl) para transferir datos utilizando varios protocolos de red.

Y como indican directamente en la página oficial de curl, curl se utiliza en líneas de comandos o scripts para transferir datos. curl también es libcurl, se utiliza en automóviles, televisores, enrutadores, impresoras, equipos de audio, teléfonos móviles, tabletas, dispositivos médicos, decodificadores, juegos de computadora, reproductores multimedia y es el motor de transferencia de Internet para innumerables aplicaciones de software en más de veinte mil millones de instalaciones. Curl es utilizado diariamente por prácticamente todos los usuarios de Internet en el mundo.

Así que como puedes ver, prácticamente en cada terminal existe curl y aunque no lo conocieras antes de leer este texto, seguro que has usado la herramienta sin saberlo.

Tu bot de Telegram en Bash

Así que como ya te he dicho anteriormente, la manera más directa de hacer uso de tu bot de Telegram desde la terminal es usar directamente curl. Pero antes de explicarte cómo, hay que ver que se necesita. La respuesta es simple:

Tu bot de Telegram.
El Token para hacer uso del mismo.
Tu Chat Id.

Si todavía no dispones de lo anterior, te recuerdo que tienes explicado como crear un bot de Telegram desde cero y obtener tu Token y tu Chat Id en la primera parte de esta serie: Bots en Telegram (I): Creación de un bot de Telegram.

Con todo lo anterior, hacer uso de tu bot de Telegram desde tu terminal es muy sencillo:

curl -s -X POST https://api.telegram.org/bot[TOKEN_SUPERSECRETO_DEL_BOT]/sendMessage -d chat_id=[TU_CHATID_SECRETO] -d text="Este es un mensaje especial para/de mi bot"

Estas son las opciones de curl usadas:

-s: Activa el Modo Silencioso de curl.
-X: Establece el modo de la petición HTTP que enviaremos. En este caso usaremos POST.
URL: Justo después del modo se indica la URL https://api.telegram.org/bot[TOKEN_SUPERSECRETO_DEL_BOT]/sendMessage que se construye con el Token del bot dentro.
[TOKEN_SUPERSECRETO_DEL_BOT]: Es el Token de tu bot. Se incluye dentro de la propia Url.
-d: Al usar el modo POST se pueden pasar datos. La opción -d sirve para indicar que vamos a pasar información en la petición POST. En este caso, dos campos chat_id y text.
[TU_CHATID_SECRETO]: Es tu Chat ID.

Script de bot de Telegram para tu terminal

Una vez que ya se ha visto la manera más rápida de usar tu bot de Telegram desde tu consola, es hora de hacer esto un poco más sofisticado y compartir un script de bash para usar tu bot de Telegram desde la terminal: 0030_enviar_mensaje_telegram.sh.

Este script tiene dos modos de uso:

Usando un fichero de configuración previamente definido donde esté la información del Token y el Chat Id
Pasando directamente el Token y el Chat Id por parámetros.

Los parámetros de entrada admitidos son:

-f: Fichero de configuración donde deben estar definidos el TOKEN_SUPERSECRETO_DEL_BOT y CHAT_ID especificados como se indica en el siguiente punto. Este parámetro se usa en el modo de funcionamiento 1.
-t: El TOKEN_SUPERSECRETO_DEL_BOT de tu bot. Este parámetro se usa en el modo de funcionamiento 2.
-c: Tu CHAT_ID super secreto. Este parámetro se usa en el modo de funcionamiento 2.
-m: Especifica el mensaje a enviar. Es un parámetro obligatorio en los dos modos de funcionamiento.
-d: Habilita el modo depuración.
-h: Muestra la ayuda.

Especificación del fichero de configuración para el primer modo de funcionamiento

La sintaxis esperada del fichero de configuración es tremendamente simple. Solo hay que definir dos líneas o variables: TOKEN y CHAT_ID. A continuación se muestra un ejemplo, pero tienes un fichero de configuración ejemplo aquí:

TOKEN="TOKEN_SUPERSECRETO_DEL_BOT"
CHAT_ID="CHAT_ID_SUPERSECRETO_DEL_BOT"

Ejemplos de funcionamiento del script

Como el script tiene dos modos de funcionamiento os voy a mostrar como se ejecuta y funciona en cada uno de ellos.

Modo 1: Usando un archivo de configuración con el parámetro -f

./0030_enviar_mensaje_telegram.sh -f /tu/ruta/al/fichero/configuracion/telegram_bot.conf -m "Prueba del bot de noroute2host usando el fichero de configuracion"

Modo 2: Pasando por parámetros el Token y el Chat Id

./0030_enviar_mensaje_telegram.sh -t "TOKEN_SUPERSECRETO_DEL_BOT" -c "CHAT_ID_SUPERSECRETO_DEL_BOT" -m "Prueba del bot de noroute2host pasando los datos por parámetro"

Código fuente del script de bot de Telegram para Bash

Antes de terminar te recuerdo que tanto este como todos los scripts, ficheros de código u otras chuletas de código fuente las puedes encontrar en el repositorio del blog en GitLab.

En el siguiente capitulo si lo hubiera…

Si en futuro hubiese un siguiente capítulo, estaría dedicado a como usar tu bot de Telegram desde Python. Hay múltiples formas de hacerlo y alguna de ellas es bastante interesante si lo que se quiere es estar notificado de eventos de tus aplicaciones Python.

Enlaces de interés:

Localización de aplicaciones Python con gettext

2024-08-01T18:20:00+02:00

Recientemente me planteé traducir o localizar el juego que desarrollé en Python con Pygame. Y la verdad es que no tenía claro como hacerlo. Acabé usando el módulo gettext. Pero, a decir verdad, pensaba que iba a ser bastante más sencillo de lo que finalmente fué. Así que me ha parecido buena idea compartir como realizar este proceso y hacer algunas recomendaciones en base a mi experiencia.

Lo primero que me llamó la atención es que pensaba encontrar más opciones de base o al menos más sencillas de utilizar. Pero la realidad es que la única opción en las librerías estándar de Python es gettext.

Acerca de gettext

gettext es una librería o un sistema de internacionalización y localización de aplicaciones (i18n y l10n) que se usa de manera muy común en el desarrollo de aplicaciones en entornos tipo Unix (como Linux por ejemplo). De hecho la implementación más famosa de gettext es GNU gettext. Tanto es así que Python soporta dos maneras diferentes de usar gettext:

GNU API gettext
API basada en clases

La segunda de las opciones, la API basada en clases es la opción recomendada para localizar aplicaciones y módulos Python debido a que ofrece una mayor flexibilidad. Para más información puedes consultar la documentación oficial de Python para gettext.

Antes de pasar a como usar gettext para localizar tus aplicaciones python (o cualquier aplicación que soporte gettext en realidad) me gustaría indicar que gettext permite tanto internacionalización como localización. En mi caso, he usado gettext fundamentalmente para temas de localización. Es decir, trasladar los textos de mi aplicación a varios idiomas. Se podría decir que la internacionalización es algo más amplio que puede incluir el formato de las fechas, números u otros elementos.

Ficheros de gettext

Como buena utilidad para sistemas Linux gettext basa su funcionamiento en una serie de ficheros. En concreto, además de los ficheros de código fuente de tu aplicación, hay que tener en cuenta tres tipos de ficheros a la hora de trabajar con gettext:

.pot: Portable Object Template. Este fichero es la plantilla para traducción o localización que se genera cuando se extraen las cadenas a traducir de tu aplicación.
.po: Portable Object. Estos ficheros son los que contienen la traducción de las cadenas a los diferentes lenguajes. Normalmente habrá un fichero .po por cada traducción.
.mo: Machine Object. Los ficheros .mo son el resultado de compilar los ficheros .po. Como en el caso anterior, también habrá un fichero .mo por traducción. Se puede decir que la información de los ficheros .po y .mo es la misma. Pero, en el primer caso es legible por los humanos, en el segundo están en lenguaje máquina.

Utilidades de gettext

gettext tiene multitud de utilidades para diferentes objetivos. Puedes consultarlas todas aquí. Pero, para el caso que nos ocupa usaremos fundamentalmente tres:

xgettext o pygettext3: Esta utilidad escanea nuestros ficheros de código fuente para obtener cadenas localizables y generar el fichero de plantilla .pot.
msgmerge: Genera o regenera los ficheros .po a partir del fichero .pot. Como los ficheros que se usan para traducir son los .po, ¿qué pasa cuando incluimos nuevas cadenas localizables en nuestra aplicación? ¿hay que volver a crear y traducir los ficheros .po? La respuesta es msgmerge, que mezcla o une nuestro fichero .po que ya contiene traducciones con el fichero de referencia .pot. De este modo se preservan las traducciones existentes y se añaden las nuevas que encuentre en el fichero .pot.
msgfmt: Este programa crea un archivo binario .mo a partir de la compilación del fichero de texto .po.

Estructura de ficheros

Debido a la dependencia de gettext de los ficheros que hemos visto antes, también es necesaria una estructura de ficheros concreta para que el sistema pueda encontrar los ficheros .mo con las traducciones. En esencia, debes colocar tus ficheros .mo en la siguiente ruta: localedir/language/LC_MESSAGES/.

localedir: Es simplemente el directorio base de las traducciones. Veremos que puedes definir esta ubicación en tu código.
languaje: Se trata de un código de lenguaje. Puede ser genérico como en o es, o más específico como es_ES o es_AR.
LC_MESSAGES: Se trata de la categoría del locale. Por defecto, para gettext es LC_MESSAGES.

Puede parecer un poco complicado pero tampoco lo es demasiado. Como ejemplo, te muestro la estructura creada para mi juego en Pygame:

locales
├── en
│   └── LC_MESSAGES
│       ├── pang-nightfall.mo
│       └── pang-nightfall.po
├── es
│   └── LC_MESSAGES
│       ├── pang-nightfall.mo
│       └── pang-nightfall.po
└── pang-nightfall.pot

Trabajando con getttext en Python

Una vez que hemos hablado un poco de gettext, su origen, su estructura y su funcionamiento básico, llega el momento de ponernos manos a la obra y mostrar como se puede usar para localizar tus aplicaciones Python.

Usando GNU API gettext en Python

Aunque he dicho antes que acabé usando la implementación API basada en clases porque es la recomendada, creo que para explicar el funcionamiento voy a comenzar mostrando el modo GNU API gettext.

Vamos a partir de un primer ejemplo, 0029_localizacion-python-gnu-gettext.py, donde se definen las cadenas con la función _() que a su vez se define como un alias para gettext.gettext().

import gettext
_ = gettext.gettext

def imprimir_cadenas():
    print(_("Somos cadenas localizables"))
    print(_("Hola noroute2host"))
    print(_("Adios noroute2host"))

if __name__ == '__main__':
    imprimir_cadenas()

Si ejecutamos este programa, el resultado será similar a si se hubiera hecho un print normal.

$ python 0029_localizacion-python-gnu-gettext.py
Somos cadenas localizables
Hola noroute2host
Adios noroute2host

Pero en realidad lo que esta pasando es no se están imprimiendo las cadenas directamente. Sino que se está devolviendo la traducción localizada de cada mensaje con la función gettext.gettext("mensaje"). Pero como no se han generado ficheros de traducción .mo ni definido donde se encontrarían, directamente devuelve y por tanto imprime por defecto el identificador de la cadena dentro de módulo de gettext o el msgid.

Usando la API basada en clases de gettext en Python

Ahora vamos a transformar el ejemplo anterior para usar el método recomendado, es decir, la API basada en clases del módulo gettext de Python. Esto dará lugar al fichero 0029_localizacion-python-API-basada-clases.py

import gettext

appname = "noroute2host"
localedir = "locales"

translations = gettext.translation(appname, localedir, fallback=True, languages=["en", "es"])
translations.install()

def imprimir_cadenas():
    print(_("Somos cadenas localizables"))
    print(_("Hola noroute2host"))
    print(_("Adios noroute2host"))

if __name__ == '__main__':
    imprimir_cadenas()

En este caso la gran diferencia es el uso de la función gettext.translation que según la documentación oficial se define por defecto del siguiente modo:

gettext.translation(domain, localedir=None, languages=None, class_=None, fallback=False)

Y en nuestro ejemplo la hemos usado así:

translations = gettext.translation(appname, localedir, fallback=True, languages=["en", "es"])

Paso a explicar cada uno de los parámetros que se han usado:

domain: Para el dominio se ha usado una variable llamada appname definida previamente con el valor noroute2host. La explicación podría ser más compleja, pero básicamente podemos quedarnos con que el dominio es el nombre de fichero que usará de base para buscar los ficheros de traducción .mo.
localedir: Se ha definido como una variable localedir que tiene el valor locales. Podría tener otro valor puesto que es básicamente la raíz donde va a buscar los ficheros de traducción.
fallback: Se ha puesto a True para que si no encuentra un fichero .mo la función no devuelva una excepción y devuelva un objeto de la clase NullTranslations. De hecho, en este ejemplo todavía no están definidos los ficheros de traducción y como veremos después no se genera ningún error.
languages: Es una lista de uno o más lenguajes. Son los que intentará cargar el fichero .mo si existe para localizar las cadenas.
class_: Este parámetro no se usa. Sirve para modificar el tipo de clase que devuelve la función translation. Si no se especifica nada, por defecto será un objeto de la clase GNUTranslations. Este es nuestro caso.

Por otro lado, hay otro cambio importante en el código:

translations.install()

Esto es simplemente una manera, aunque la más conveniente, de hacer disponible la función _() en la aplicación.

Después de todos los cambios el resultado es similar al del modo anterior. Como comentamos antes, se está intentando devolver la versión localizada de las cadenas pero como no se encuentran se devuelven tal cual.

$ python 0029_localizacion-python-API-basada-clases.py
Somos cadenas localizables
Hola noroute2host
Adios noroute2host

Esto se puede comprobar si se cambia el parámetro fallback a False. Al ejecutar nuestro ejemplo con este cambio, se produce un error al no encontrar los ficheros de traducción.

$ python 0029_localizacion-python-API-basada-clases.py
Traceback (most recent call last):
  File "0029_localizacion-python-API-basada-clases.py", line 6, in <module>
    translations = gettext.translation(appname, localedir, fallback=False, languages=["en", "es"])
  File "/usr/lib/python3.8/gettext.py", line 603, in translation
    raise FileNotFoundError(ENOENT,
FileNotFoundError: [Errno 2] No translation file found for domain: 'noroute2host

Trabajando con los ficheros de localización

Lo primero que hay que hacer es crear la estructura de directorios que ya hemos esbozado antes. En principio, vamos a generar localizaciones para dos idiomas: Español (es) e Inglés (es).

$ mkdir locales
$ mkdir locales/es
$ mkdir locales/es/LC_MESSAGES
$ mkdir locales/es
$ mkdir locales/es/LC_MESSAGES

Generando el fichero de platilla (.pot)

El primer paso será generar el fichero de plantilla .pot. Este fichero se genera con la utilidad pygettext3 o xgettext. Esta utilidad lo que hace es extraer los cadenas localizables de nuestro fichero Python. ¿Y como sabe cuáles son? Pues la respuesta es bastante sencilla, simplemente extrae los textos que se pasan como parámetros a la función _(). Y esto es bastante importante porque significa, que lo que pongamos en esas llamadas es el texto base de nuestra aplicación. Es decir, lo que se mostrará si no hay traducción. Por lo que esta decisión “puede” marcar el lenguaje base de tu aplicación. Y digo puede porque al final te contaré como me gusta a mí usar este lenguaje base.

En cuanto a usar pygettext3 o xgettext puedes usar la que quieras. Antiguamente xgettext no funcionaba del todo con ficheros Python y por eso había una versión Python: pygettext. Pero en la actualidad xgettext soporta multitud de lenguajes, entre los que está Python.

Para instalar las utilidades de GNU gettext, es posible que tengas que instalarlas antes. En en el caso de Debian/Ubuntu bastaría con usar apt:

# apt install gettext

Sin embargo a mí me gusta más la salida que muestra pygettext3 y por eso es el que uso este último, pero es simplemente una cuestión de gustos. En cualquier caso, pygettext suele venir incluido en las instalaciones de Python.

La ejecución de esta herramienta podría ser:

pygettext3 -debug --verbose -d DOMINIO -o FICHERO_POT_SALIDA FICHERO_PYTHON_ENTRADA

Donde los parámetros son:

DOMINIO: Es un nombre único que identifica tu aplicación.
FICHERO_POT_SALIDA: Es el la ruta donde se dejará el fichero .pot de salida.
FICHERO_PYTHON_SALIDA: El fichero de entrada donde se buscarán las cadenas.

Por tanto, en el ejemplo que nos ocupa el comando quedaría tal que así:

pygettext3 -debug --verbose -d noroute2host -o locales/noroute2host.pot 0029_localizacion-python-API-basada-clases.py

Y el resultado es el fichero locales/noroute2host.pot

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR ORGANIZATION
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-07-25 20:53+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n"


#: 0029_localizacion-python-API-basada-clases.py:10
msgid "Somos cadenas localizables"
msgstr ""

#: 0029_localizacion-python-API-basada-clases.py:11
msgid "Hola noroute2host"
msgstr ""

#: 0029_localizacion-python-API-basada-clases.py:12
msgid "Adios noroute2host"
msgstr ""

Creando los ficheros de traducción (.po) y localizando los textos

Con el fichero de plantilla creado, y teniendo en cuenta que vamos a trabajar con dos idiomas (español e inglés), hay que generar los ficheros de traducciones y localizar las cadenas.

El modo más simple de generar los ficheros de traducción es simplemente copiar el fichero .pot para crear los ficheros .po.

$ cp -a locales/noroute2host.pot locales/es/LC_MESSAGES/noroute2host.po
$ cp -a locales/noroute2host.pot locales/en/LC_MESSAGES/noroute2host.po

Ahora que ya están creados los ficheros .po, lo que hay que hacer es traducirlos. En el ejemplo que nos ocupa los hemos dejado así:

Español: locales/es/LC_MESSAGES/noroute2host.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR ORGANIZATION
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-07-25 20:53+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n"

#: 0029_localizacion-python-API-basada-clases.py:10
msgid "Somos cadenas localizables"
msgstr "Somos cadenas localizables"

#: 0029_localizacion-python-API-basada-clases.py:11
msgid "Hola noroute2host"
msgstr "Hola noroute2host"

#: 0029_localizacion-python-API-basada-clases.py:12
msgid "Adios noroute2host"
msgstr "Adios noroute2host"

Inglés: locales/en/LC_MESSAGES/noroute2host.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR ORGANIZATION
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-07-25 20:53+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n"

#: 0029_localizacion-python-API-basada-clases.py:10
msgid "Somos cadenas localizables"
msgstr "We are localizable strings"

#: 0029_localizacion-python-API-basada-clases.py:11
msgid "Hola noroute2host"
msgstr "Hi noroute2host"

#: 0029_localizacion-python-API-basada-clases.py:12
msgid "Adios noroute2host"
msgstr "Goodbye noroute2host"

Compilando los ficheros .po para generar los ficheros binarios .mo

Con lo hecho anteriormente tenemos los catálogos de mensajes en formato texto. Pero nuestro programa Python necesita que estos mensajes estén compilados en un formato binario que pueda entender. Para este cometido usaremos la utilidad msgfmt. Usaremos esta utilidad de la siguiente forma:

msgfmt -f -o FICHERO_MO_SALIDA FICHERO_PO_ENTRADA

Donde las opciones y los parámetros son:

-f: Opción fuzzy. Con esta opción se tienen en cuenta los mensajes que las utilidades anteriores han marcado como fuzzy o difusos. En mi caso es una opción que uso porque ha veces (no entiendo el por qué hay mensajes que los detecta así. Y si no se indica esta opción no se compilan en la traducción.
-o: Sirve para especificar el fichero .mo de salida.
FICHERO_MO_SALIDA: Es el la ruta donde se dejará el fichero .mo de salida.
FICHERO_PO_ENTRADA: El fichero de entrada .po que se usará de base para la compilación.

Además, algo muy importante que hay que tener en cuenta es que la compilación tiene un fichero de entrada y uno de salida. Por tanto, hay que ejecutar el msgfmt una vez por cada fichero .po que tengamos. En nuestro ejemplo, tenemos 2 ficheros .po por lo que habría que lanzar los siguientes 2 comandos:

$ msgfmt -f -o locales/es/LC_MESSAGES/noroute2host.mo locales/es/LC_MESSAGES/noroute2host.po
$ msgfmt -f -o locales/en/LC_MESSAGES/noroute2host.mo locales/en/LC_MESSAGES/noroute2host.po

Estructura de ficheros de localización

Ya tenemos todos los ficheros de localización creados. Esta sería la estructura de directorios y ficheros de localización:

locales/
├── en
│   └── LC_MESSAGES
│       ├── noroute2host.mo
│       └── noroute2host.po
├── es
│   └── LC_MESSAGES
│       ├── noroute2host.mo
│       └── noroute2host.po
└── noroute2host.pot

Probando la aplicación localizada

Antes de pasar a probar la aplicación con localización, vamos a hacer un pequeño cambio en el código para que nos permita seleccionar el idioma antes de imprimir la salida. No es la mejor solución para pedir al usuario que elija el idioma de una lista pero para el ejemplo valdrá.

Esta versión del programa quedará reflejada en el fichero 0029_localizacion-python-API-basada-clases-multi.py

import gettext

appname = "noroute2host"
localedir = "locales"

# Funcion para seleccionar el idioma
def preguntar_idioma():
    print("Seleccion de Idioma")
    response = ''
    while response not in {"esp", "eng"}:
        response = input("Por favor introduce esp o eng: ").lower()
    if response == "eng":
        translations = gettext.translation(appname, localedir, fallback=True, languages=["en"])
    else:
        translations = gettext.translation(appname, localedir, fallback=True, languages=["es"])
    translations.install()

# Funcion para imprimir cadenas
def imprimir_cadenas():
    print(_("Somos cadenas localizables"))
    print(_("Hola noroute2host"))
    print(_("Adios noroute2host"))

if __name__ == '__main__':
    preguntar_idioma()
    imprimir_cadenas()

El pequeño cambio que hemos hecho es crear la función preguntar_idioma(), que pregunta al usuario por el idioma previamente. Para que, de este modo, establecer la localización antes de imprimir las cadenas. Es verdad que se imprime primero el texto que pregunta al usuario sin localizar pero para fines didácticos se ve claro. El resultado es el siguiente:

Seleccionando Español:

$ python 0029_localizacion-python-API-basada-clases-multi.py
Seleccion de Idioma
Por favor introduce esp o eng: esp
Somos cadenas localizables
Hola noroute2host
Adios noroute2host

Seleccionando Inglés:

$ python 0029_localizacion-python-API-basada-clases-multi.py
Seleccion de Idioma
Por favor introduce esp o eng: eng
We are localizable strings
Hi noroute2host
Goodbye noroute2host

Como puedes ver, las cadenas se imprimen en un idioma diferente en función de la selección del usuario. Así que ¡objetivo conseguido!

Actualizando la localización

Todo lo anterior es estupendo, pero ¿y si necesito añadir nuevos mensajes a mi aplicación? Pues la respuesta es que gettext también tiene herramientas para actualizar los ficheros de traducción. Así que voy a contarte como hacerlo.

Incluir nuevos mensajes en la aplicación

En primer lugar, vamos a añadir un nuevo mensaje a la función imprimir_cadenas(). En concreto será la línea print(_("Soy una nueva cadena localizable")).

import gettext

appname = "noroute2host"
localedir = "locales"

# Funcion para seleccionar el idioma
def preguntar_idioma():
    print("Seleccion de Idioma")
    response = ''
    while response not in {"esp", "eng"}:
        response = input("Por favor introduce esp o eng: ").lower()
    if response == "eng":
        translations = gettext.translation(appname, localedir, fallback=True, languages=["en"])
    else:
        translations = gettext.translation(appname, localedir, fallback=True, languages=["es"])
    translations.install()

# Funcion para imprimir cadenas
def imprimir_cadenas():
    print(_("Somos cadenas localizables"))
    print(_("Hola noroute2host"))
    print(_("Adios noroute2host"))
    print(_("Soy una nueva cadena localizable"))

if __name__ == '__main__':
    preguntar_idioma()
    imprimir_cadenas()

Actualizando el fichero de platilla (.pot)

La actualización del fichero de plantilla consiste simplemente en volver a generarlo. Para ello usaremos exactamente el mismo comando que antes, salvo por el detalle de que ahora el fichero de entrada es el de la versión que tenemos con la selección del usuario:

pygettext3 -debug --verbose -d noroute2host -o locales/noroute2host.pot 0029_localizacion-python-API-basada-clases-multi.py

Esto volverá a generar el fichero locales/noroute2host.pot donde ya se encontrará el nuevo mensaje para localizar.

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR ORGANIZATION
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-07-29 20:01+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n"

#: 0029_localizacion-python-API-basada-clases-multi.py:20
msgid "Somos cadenas localizables"
msgstr ""

#: 0029_localizacion-python-API-basada-clases-multi.py:21
msgid "Hola noroute2host"
msgstr ""

#: 0029_localizacion-python-API-basada-clases-multi.py:22
msgid "Adios noroute2host"
msgstr ""

#: 0029_localizacion-python-API-basada-clases-multi.py:23
msgid "Soy una nueva cadena localizable"
msgstr ""

Regenerando los ficheros de localización (.po) a partir del nuevo fichero de plantilla (.pot)

Ahora que ya se ha actualizado el fichero de plantilla con la lista actualizada de mensajes localizables llega el momento de mezclar la nueva plantilla con los ficheros de localización previos. Para este cometido existe la utilidad msgmerge que permite hacer esta mezcla para incorporar los nuevos mensajes localizables a los ficheros .po previos que ya contienen la traducción de los mensajes anteriores sin que esta se pierda.

El uso de msgmerge sería de la siguiente manera:

msgmerge -U FICHERO_PO_A_ACTUALIZAR FICHERO_POT_PLANTILLA

Otra vez hay que tener en cuenta que hay que ejecutar esto para los dos ficheros .po, uno por idioma, que estamos usando.

$ msgmerge -U locales/es/LC_MESSAGES/noroute2host.po locales/noroute2host.pot 
...... terminado.
$ msgmerge -U locales/en/LC_MESSAGES/noroute2host.po locales/noroute2host.pot
...... terminado.

El resultado serán los nuevos ficheros .po en los que ya se puede añadir la traducción de los nuevos mensajes. En este caso, los presento ya con la traducción del nuevo mensaje incluida.

Fichero de localización al español: locales/es/LC_MESSAGES/noroute2host.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR ORGANIZATION
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-07-29 20:01+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n"

#: 0029_localizacion-python-API-basada-clases-multi.py:20
msgid "Somos cadenas localizables"
msgstr "Somos cadenas localizables"

#: 0029_localizacion-python-API-basada-clases-multi.py:21
msgid "Hola noroute2host"
msgstr "Hola noroute2host"

#: 0029_localizacion-python-API-basada-clases-multi.py:22
msgid "Adios noroute2host"
msgstr "Adios noroute2host"

#: 0029_localizacion-python-API-basada-clases-multi.py:23
#, fuzzy
msgid "Soy una nueva cadena localizable"
msgstr "Soy una nueva cadena localizable"

Fichero de localización al inglés: locales/en/LC_MESSAGES/noroute2host.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR ORGANIZATION
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-07-29 20:01+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n"

#: 0029_localizacion-python-API-basada-clases-multi.py:20
msgid "Somos cadenas localizables"
msgstr "We are localizable strings"

#: 0029_localizacion-python-API-basada-clases-multi.py:21
msgid "Hola noroute2host"
msgstr "Hi noroute2host"

#: 0029_localizacion-python-API-basada-clases-multi.py:22
msgid "Adios noroute2host"
msgstr "Goodbye noroute2host"

#: 0029_localizacion-python-API-basada-clases-multi.py:23
#, fuzzy
msgid "Soy una nueva cadena localizable"
msgstr "I am a new localizable string"

ReCompilando los ficheros .po para ReGenerar los ficheros binarios .mo

Ya solo nos quedaría la última operación que consiste simplemente en volver a generar los ficheros compilados .mo a partir de ficheros .po. Además, como dato curioso se ha dado el caso de que ha añadido el nuevo mensaje como fuzzy. No tengo muy claro porque ocurre esto a veces, pero es por esto mismo que os recomendar la opción -f del comando msgfmt.

$ msgfmt -f -o locales/es/LC_MESSAGES/noroute2host.mo locales/es/LC_MESSAGES/noroute2host.po
$ msgfmt -f -o locales/en/LC_MESSAGES/noroute2host.mo locales/en/LC_MESSAGES/noroute2host.po

Probando de nuevo la aplicación localizada con el nuevo texto.

Con lo anterior realizado, nuestra aplicación ya contiene el nuevo mensaje y sus versiones traducidas. Así que solo queda ejecutarla y comprobar que todo funciona correctamente:

Seleccionando Español:

$ python 0029_localizacion-python-API-basada-clases-multi.py
Seleccion de Idioma
Por favor introduce esp o eng: esp
Somos cadenas localizables
Hola noroute2host
Adios noroute2host
Soy una nueva cadena localizable

Seleccionando Inglés:

$ python 0029_localizacion-python-API-basada-clases-multi.py
Seleccion de Idioma
Por favor introduce esp o eng: eng
We are localizable strings
Hi noroute2host
Goodbye noroute2host
I am a new localizable string

Bonus Track: Buenas prácticas y recomendaciones personales

Lo cierto es que ha quedado un artículo un poco largo, pero no quiero terminarlo sin dejar algunas recomendaciones personales o comentar alguna buena práctica.

Definir las cadenas con nombres representativos, no con la traducción del idioma por defecto.

Reconozco que esta primera recomendación es algo bastante personal, pero en conjunción con la siguiente clarifica y facilita mucho el trabajo con las cadenas a localizar y su gestión.

Si observamos la estructura de los ficheros .pot y .po podemos ver que cada mensaje localizable tiene un msgid y un msgstr. Por defecto el msgid se rellena con la cadena que se le pasa a la función _(). Y además el msgid es lo que se muestra por defecto en la aplicación si no hay una localización (un fichero .mo) específico para el lenguaje que se quiera usar. Esto puede ser un punto positivo a favor de usar directamente las cadenas del lenguaje “base” como msgid pues siempre mostrará un texto real en algún idioma.

Aún con esto, los ficheros quedan un poco raros en el lenguaje base teniendo msgid igual a msgstr, a mi gusto, y puede hacer que en los msgid haya caracteres especiales. Es por esto que yo uso una nomenclatura alternativa para los msgid: los defino como si fueran nombres de variables, usando solo números y letras pero usando el signo - para separar palabras. Por ejemplo, en vez de usar la línea:

print(_("Hola noroute2host"))

Usaría la siguiente:

print(_("hola-noroute2host")

Este cambio haría que al generar el fichero noroute2host.pot, las entradas para esta cadena fueran las siguientes:

#: 0029_localizacion-python-API-basada-clases-multi.py:21
msgid "hola-noroute2host"
msgstr ""

Y ya, tal y como hemos explicado antes, en los msgstr ficheros .po de cada idioma se incluyen las traducciones.

La única pega es que, en caso de no encontrar una localización válida, se mostraría “hola-noroute2host”. Para evitar esto, mi recomendación es controlar si hay o no una traducción disponible, y en caso de no haberla fijar un idioma por defecto. En mi opinión, esta manera de definir las cadenas localizables en combinación con la siguiente recomendación ayuda a trabajar de una manera más fácil y ágil con gettext en Python.

Unifica tus cadenas en un fichero

Una cosa que me no me ha gustado al trabajar con gettext es que las cadenas quedan un poco desperdigadas por los diferentes ficheros .py. Aunque esto no es raro cuando estás programando en Python, e incluso puedes pasarle varios ficheros o un directorio de ficheros a pygettext3 o xgettext, si me parece un problema cuando quieres cambiar algún texto. O incluso cuando simplemente quieres ver si se han extraído todas las cadenas localizables.

Así que para mejorar esto te propongo algo: ¿por qué no crear un fichero .py donde se definan todas las cadenas como variables o constantes?. De este modo una vez generado el fichero de cadenas de texto, lo único que necesitas es importarlo en el resto de tus ficheros y referenciar las variables o constantes que hayas definido. De esto modo, solo tendrás un fichero donde definir tus cadenas de texto y el trabajo con ellas se facilitará mucho. Incluso puedes definir con comentarios secciones paras las diferentes cadenas. En mi opinión, esto facilita muchísimo el trabajo con las cadenas. Trabajas solo con un fichero .py para los comandos de gettext, si te ayudan traductores solo manejaras un fichero .pot y .po, y por supuesto la lista de cadenas localizables no está repartida por toda tu aplicación.

Esto es puramente una opinión personal, no se si es porque he trabajado con algún framework en otros lenguajes y hacían algo similar o porque es que así lo veo mucho más claro. En cualquier caso, en combinación con la anterior recomendación facilita mucho el trabajo con gettext. De hecho la “trampita” que hemos hecho para preguntar el idioma y toda la definición de cadenas irá al fichero propio de definición de cadenas, dejando nuestro código mucho más claro y limpio. Así que os dejo los cambios y el resultado a continuación.

Lo primero a mostrar serán nuestros dos ficheros .py.

definicion_cadenas.py

import gettext

appname = "noroute2host-defstr"
localedir = "locales"

# Funcion para seleccionar el idioma
def preguntar_idioma():
    print("Seleccion de Idioma")
    response = ''
    while response not in {"esp", "eng"}:
        response = input("Por favor introduce esp o eng: ").lower()
    if response == "eng":
        translations = gettext.translation(appname, localedir, fallback=True, languages=["en"])
    else:
        translations = gettext.translation(appname, localedir, fallback=True, languages=["es"])
    translations.install()

# Se instalan las traducciones
preguntar_idioma()

# Definicion de cadenas localizables

STR_CADENAS_LOCALIZABLES = _("somos-cadenas-localizables")
STR_HOLA = _("hola-noroute2host")
STR_ADIOS = _("adios-noroute2host")
STR_NUEVA_CADENA_LOCALIZABLE = _("nueva-cadena-localizable")

0029_localizacion-python-API-basada-clases-multi-con-fichero-cadenas.py

import definicion_cadenas as defstr

# Funcion para imprimir cadenas
def imprimir_cadenas():
    print(defstr.STR_CADENAS_LOCALIZABLES)
    print(defstr.STR_HOLA)
    print(defstr.STR_ADIOS)
    print(defstr.STR_NUEVA_CADENA_LOCALIZABLE)

if __name__ == '__main__':
    imprimir_cadenas()

A continuación vamos a generar un nuevo conjunto de ficheros .pot y .po a los que les hemos añadido -defstr en el nombre para diferenciarlos de los anteriores ejemplos.

# Creación de fichero de plantilla .pot
$ pygettext3 -debug --verbose -d noroute2host-defstr -o locales/noroute2host-defstr.pot definicion_cadenas.py 
Working on definicion_cadenas.py

# Creación inicial de nuevos ficheros .po
$ cp -a locales/noroute2host-defstr.pot locales/es/LC_MESSAGES/noroute2host-defstr.po
$ cp -a locales/noroute2host-defstr.pot locales/en/LC_MESSAGES/noroute2host-defstr.po

Y posteriormente se crean las traducciones de cada idioma (español e inglés) en los ficheros .po. Este es el resultado final de los ficheros .pot y .po.

locales/noroute2host-defstr.pot

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR ORGANIZATION
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-07-31 17:36+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n"


#: definicion_cadenas.py:23
msgid "somos-cadenas-localizables"
msgstr ""

#: definicion_cadenas.py:24
msgid "hola-noroute2host"
msgstr ""

#: definicion_cadenas.py:25
msgid "adios-noroute2host"
msgstr ""

#: definicion_cadenas.py:26
msgid "nueva-cadena-localizable"
msgstr ""

locales/es/LC_MESSAGES/noroute2host-defstr.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR ORGANIZATION
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-07-31 17:36+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n"


#: definicion_cadenas.py:23
msgid "somos-cadenas-localizables"
msgstr "Somos cadenas localizables"

#: definicion_cadenas.py:24
msgid "hola-noroute2host"
msgstr "Hola noroute2host"

#: definicion_cadenas.py:25
msgid "adios-noroute2host"
msgstr "Adiós noroute2host"

#: definicion_cadenas.py:26
msgid "nueva-cadena-localizable"
msgstr "Soy una nueva cadena localizable"

locales/en/LC_MESSAGES/noroute2host-defstr.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR ORGANIZATION
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-07-31 17:36+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: pygettext.py 1.5\n"


#: definicion_cadenas.py:23
msgid "somos-cadenas-localizables"
msgstr "We are localizable string"

#: definicion_cadenas.py:24
msgid "hola-noroute2host"
msgstr "Hi noroute2host"

#: definicion_cadenas.py:25
msgid "adios-noroute2host"
msgstr "Goodbye noroute2host"

#: definicion_cadenas.py:26
msgid "nueva-cadena-localizable"
msgstr "I am a new localizable string"

Finalmente solo nos queda compilar nuestros ficheros .po para generar los ficheros .mo

$ msgfmt -f -o locales/es/LC_MESSAGES/noroute2host-defstr.mo locales/es/LC_MESSAGES/noroute2host-defstr.po
$ msgfmt -f -o locales/en/LC_MESSAGES/noroute2host-defstr.mo locales/en/LC_MESSAGES/noroute2host-defstr.po

Por último, lo único que queda es comprobar que el resultado de la ejecución sigue siendo el mismo.

Seleccionando español:

$ python 0029_localizacion-python-API-basada-clases-multi-con-fichero-cadenas.py
Seleccion de Idioma
Por favor introduce esp o eng: esp
Somos cadenas localizables
Hola noroute2host
Adiós noroute2host
Soy una nueva cadena localizable

Seleccionando inglés:

$ python 0029_localizacion-python-API-basada-clases-multi-con-fichero-cadenas.py
Seleccion de Idioma
Por favor introduce esp o eng: eng
We are localizable string
Hi noroute2host
Goodbye noroute2host
I am a new localizable string

Como se puede observar el funcionamiento del programa es el mismo, pero hemos mejorado la estructura y la claridad de nuestro código.

Añade los ficheros binarios (.mo) y el fichero de plantilla (.pot) a tu .gitignore

Esta best-practice es simple, añade las extensiones .mo y .pot a tu fichero .gitignore. Recuerda que los ficheros .mo son compilados y no son código fuente, y que el fichero de plantilla .pot tiene en los ficheros .po específicos de cada idioma las versiones útiles del mismo. Aunque en el caso de los ficheros .mo hay que tener en cuenta que si debes incluirlos en tus releases puesto que si no están los textos no aparecerán correctamente.

Yo por mi parte estoy usando gitignore.io para la generación de los ficheros .gitignore. Este servicio te permite generar ficheros .gitignore seleccionando tu sistema operativo, lenguajes de programación y otros elementos para generar un fichero de exclusiones para git fácilmente. Además de ser un servicio web, es software libre bajo licencia MIT y tiene disponible repositorio en github, por lo que te lo recomiendo sin dudas.

A localizar tus aplicaciones

Como has podido observar, la localización de aplicaciones con gettext no es una tarea sencilla, requiere de trabajo extra. Además te he propuesto algunas recomendaciones para facilitar y organizar mejor las cadenas localizables y los ficheros de traducción. Todos los ficheros que te he mostrado en este post están en el repositorio del blog noroute2host-files. En el código de los ejemplos no he utilizado orientación a objetos por simplicidad, pero es fácilmente adaptable.

Por último, no puedo dejar de recordar que la localización e internacionalización de aplicaciones es más amplia que solo la traducción de cadenas. Permite jugar con los plurales, fechas o valores monetarios. Así que ya está en tu mano comenzar a localizar tus aplicaciones y aprovechar todas las posibilidades que gettext nos brinda.

Enlaces de interés:

Feliz en la Noche, mi primer juego en Python con PyGame para mi primera Game Jam

2024-05-28T19:00:00+02:00

Con la idea de seguir practicando y mejorando con Python y aprender a realizar juegos con PyGame, decidí participar en mi primera Game Jam: la Indie Spain Jam 2023. El resultado fue Feliz en la Noche, un juego desarrollado con PyGame-ce en una semana. Ahora publico el código fuente y os hablo sobre él.

Feliz en la Noche

Feliz en la Noche es un juego estilo Pang desarrollado para la Indie Spain Jam 2023. Los objetivos eran:

Participar en mi primera Game Jam.
Aprender a trabajar con PyGame-ce y profundizar en Python mientras aprendía las bases de la programación de juegos.

El tema de la Game Jam era “Cae la noche”. Después del “brainstorming” típico al inicio de una Game Jam, y después de empezar otro juego y tirarlo a la basura apareció esta idea, la de crear un juego al estilo Pang pero cambiando las bolas por soles. De modo que cuando el jugador acaba con un sol, la pantalla se va oscureciendo un poco.

El objetivo de cada nivel del juego es acabar con todos los soles para que la noche caiga.

Puedes obtener más información, ver el resultado e incluso descargar versiones empaquetadas de juego desde su página de itch.io.

Historia de Feliz en la Noche (a.k.a Pang Nightfall)

Lucas es un antiguo astronauta de la Agencia Espacial Europea. El espacio era su casa, pero desde su jubilación siente una gran soledad en su interior. Solamente es feliz cuando CAE LA NOCHE y puede contemplar el cielo nocturno. Observar las estrellas lo hace sonreír recordando los tiempos en los que fue un viajero entre ellas.

Pero ahora, unos traviesos soles han invadido sus tierras alumbrando todo a su paso e impidiendo contemplar la noche en todo su esplendor.

Usa el láser y ayuda a Lucas a acabar con sus enemigos. ¡Acabad con ellos para conseguir que la noche vuelva a caer de nuevo! Pero ten cuidado, cada vez que elimines a un enemigo, la noche ira cayendo…

Código fuente del juego

Uno de objetivos del blog es divulgar el software libre. Al estar desarrollando el juego para una Game Jam, y más siendo la primera, no pude crear el repositorio y publicar el código fuente del juego en aquel momento. Pero ahora, unos meses más tarde, he preparado el repositorio en Gitlab, los ficheros README.md y por fin, publicado el código.

Además, he aprovechado para preparar el juego para soportar traducciones y generado las dos primeras: Inglés y Español.

Tengo que reconocer que la idea era también hacer algunos artículos o algún tutorial de PyGame, pero creo que esto tendrá que esperar… Así que si estás interesado puedes usar el repositorio de público de Feliz en la Noche para aprender Python y PyGame o más bien PyGame-ce.

Desarrollando videojuegos con PyGame-ce

Ahora que ya te he hablado del juego en sí, voy a contarte un poco más sobre PyGame y PyGame-ce.

PyGame es básicamente un conjunto de módulos Python para el desarrollo de videojuegos. Se podría decir que nos permite usar desde Python la conocidísima libreria SDL a la vez que añade funcionalidades. Además, al estar usando Python, y dado que este es un lenguaje interpretado, permite que los juegos sean ejecutados en multitud de plataformas y sistemas operativos.

No se puede decir que PyGame sea realmente un motor gráfico para el desarrollo de juegos como pueden ser Godot, Unity o Unreal Engine. Esto hace que haya muchas cosas que un motor gráfico ya te resuelve de manera más o menos automática y que en PyGame tienes que hacerlo tú. Por ejemplo, una cosa tan simple como animar un personaje cambiando el sprite tienes que codificarla tú. Esto podría ser su punto débil, pero depende de lo que estés buscando. De hecho, esta misma situación puede verse como su punto fuerte, porque te permite aprender las bases del desarrollo de videojuegos. Así que lo que si puede ser PyGame es un buen punto de partida para aprender las bases y después saltar a algún motor gráfico.

PyGame vs PyGame-ce

¿Pero por qué a veces estoy hablando de PyGame y otras de PyGame-ce? Esto se debe a que no hace mucho que la comunidad de PyGame y el responsable del repositorio del código tuvieron un conflicto. No conozco los detalles, pero parece que el origen viene de cierta dejadez del responsable a la hora de aceptar cambios, trabajar con la comunidad en mejoras y en general con ciertos problemas con el mantenimiento del PyGame original. Así que, llegado el momento, la mayor parte de los colaboradores de la comunidad decidieron seguir su propio camino y generar PyGame-ce. Esta versión cuenta con mejoras, mayor frecuencia de actualizaciones y de momento un desarrollo más activo. Así que se está imponiendo en la comunidad como la versión más recomendada para usar. De hecho, Feliz en la Noche está desarrollado con PyGame-ce.

Enlaces de interés

Ordenación por número de versión en la terminal con sort y ls

2024-02-24T21:00:00+01:00

Este post va a estar centrado en unas pequeñas opciones de los comandos sort y ls. Estas opciones de estos comandos nos van a permitir ordenar números de versiones. Es simplemente un pequeño truco que descubrí no hace mucho y me apetece compartirlo.

Los comandos sort y ls

Pero antes de nada hay que dar una breve pincelada sobre que son los comandos sort y ls.

Por si no los conoces (algo raro si has llegado a este lugar), son utilidades bastante básicas a la hora de trabajar con la terminal.

En el caso de sort, su función es ordenar las líneas de un archivo de texto o de la entrada estándar según el caso. Y eso es prácticamente todo lo que tengo que decir al respecto. Evidentemente tiene un montón de opciones que puedes consultar en su página de man.
En cuanto a ls, su función es básicamente listar el contenido de un directorio. Por supuesto, también dispone de una ingente cantidad de opciones que también puedes revisar en su página de man.

Ordenación de versiones con el comando sort usando la opción `-V` o `--version-sort`

De todas las opciones del comando sort voy a centrarme únicamente en una: -V o --version-sort. Y es que, hace poco, tuve que hacer un pequeño script que en algún punto necesitaba ordenar una lista de paquetes disponibles y realizar una operación con ella. Esta tesitura fue la que me hizo descubrir este pequeño truco que hoy comparto contigo.

La opción -V o --version-sort, como prefieras, te permite ordenar un conjunto de líneas tratándolas como versiones. Estas versiones pueden ser de código, de software o de algún tema similar. Parece una cuestión baladí, pero es muy útil.

Vamos a imaginar que tenemos la siguiente lista de ficheros que se corresponden con diferentes versiones de un software empaquetado en rpm.

migransoftware-2.22.rpm
migransoftware-22.2.rpm
migransoftware-2.2.2.rpm
migransoftware-2.2.2.3.rpm

Por tanto, este sería el fichero versiones.txt con el que vamos a trabajar como demostración:

migransoftware-2.22.rpm
migransoftware-22.2.rpm
migransoftware-2.2.2.rpm
migransoftware-2.2.2.3.rpm

Ahora veamos que pasa si usamos sort para ordenar las lineas de este fichero de versiones.

En primer lugar, os muestro el resultado con la ordenación por defecto sin indicar ninguna opción. Como se puede observar, el resultado no es correcto. Por ejemplo, la versión 2.2.2 debería ser la primera, pero la salida no muestra eso.

$ sort versiones.txt 
migransoftware-2.2.2.3.rpm
migransoftware-2.2.2.rpm
migransoftware-2.22.rpm
migransoftware-22.2.rpm

¿Y si probamos con la opción -n o --numeric-sort que trata las líneas como valores numéricos? Pues vamos a ver que el resultado es igualmente incorrecto:

$ sort -n versiones.txt
migransoftware-2.2.2.3.rpm
migransoftware-2.2.2.rpm
migransoftware-2.22.rpm
migransoftware-22.2.rpm

Ahora sí que sí, vamos a probar con la opción -V o --version-sort:

$ sort -V versiones.txt
migransoftware-2.2.2.rpm
migransoftware-2.2.2.3.rpm
migransoftware-2.22.rpm
migransoftware-22.2.rpm

Como se puede observar el resultado es perfecto y la lista de opciones queda ordenada como debe.

Ordenación de versiones con el comando ls usando la opción `-v`

Al igual que en el caso anterior, de la gran cantidad de versiones del comando ls, voy a hablarte exclusivamente de la opción v.

De manera similar a lo descrito con sort, y tal y como dice la documentación del comando ls, la opción -v “ordena de modo natural los números de versión según el texto”.

Para mostrar su funcionamiento usaremos la misma lista de versiones que en los ejemplos anteriores. Pero en este caso, en vez de tener un fichero de versiones trabajaremos directamente con archivos en un directorio. Por supuesto, cada versión tendrá su propio archivo. De modo que si listamos el directorio donde están guardados los ficheros obtendremos lo siguiente (Se añade la opción -1 que modifica el comportamiento de ls para mostrar un fichero por línea y que se vea con más claridad):

$ ls -1
migransoftware-2.2.2.3.rpm
migransoftware-2.2.2.rpm
migransoftware-2.22.rpm
migransoftware-22.2.rpm

Como se puede observar en la salida anterior, la ordenación no es correcta. ¿Pero que pasa si se usa la opción -v? Pues que tendremos una lista correctamente ordenada según la versión como se puede apreciar a continuación (seguimos añadiendo la opción -1 para mayor claridad):

$ ls -1 -v
migransoftware-2.2.2.rpm
migransoftware-2.2.2.3.rpm
migransoftware-2.22.rpm
migransoftware-22.2.rpm

Enlaces de interés:

Aplicaciones libres para Android. Índice.

2023-06-22T19:00:00+02:00

Aplicaciones Libres para Android

Lo cierto es que la serie de artículos de Aplicaciones Libres para Android ha estado creciendo dentro del del blog. Así que llegados a este punto era necesario un artículo principal a modo de índice o recopilatorio para acceder fácilmente a todos los capítulos de la serie publicados en noroute2host.com.

Por tanto, este post es un recopilatorio de todos los artículos publicados de la serie Aplicaciones Libres para Android. En el encontraras un índice y una pequeña descripción de todas las aplicaciones open source que sobre las que te he ido hablando. Además se convertirá en un buen recopilatorio si quieres empezar aplicaciones de código abierto en tu dispositivo o smartphone Android. Y por supuesto, se enlazará al post de cada aplicación para que puedas obtener un mayor detalle de manera rápida y fácil.

I. Etar - Calendario Open Source

Etar es un calendario con licencia GPLv3 que cumple perfectamente y podemos instalar en nuestros dispositivos Android de manera muy sencilla. De hecho, Etar es simple y directamente una versión mejorada del calendario por defecto del proyecto AOSP (Android Open Source Project).

Ficha de la App

Nombre App: Etar - OpenSource Calendar.
Artículo en el blog: https://noroute2host.com/etar-calendario.html
Página del proyecto: https://github.com/Etar-Group/Etar-Calendar
Repositorio del proyecto: https://github.com/Etar-Group/Etar-Calendar
Licencia: GPLv3
Alternativa Libre a…: Google Calendar, Otros calendarios cloud o locales de los fabricantes.
Obtener desde F-Droid o Google Play:

II. AntennaPod

AntennaPod es un gestor y reproductor de podcasts brutal con licencia open source que podemos instalar en nuestros dispositivos Android de manera muy sencilla.

Ficha de la App

Nombre App: AntennaPod
Artículo en el blog: https://noroute2host.com/antennapod.html
Página del proyecto: https://antennapod.org
Repositorio del proyecto: https://github.com/AntennaPod/AntennaPod
Licencia: GPLv3
Alternativa Libre a…: Google Podcasts, Spotify, iVoox
Obtener desde F-Droid o Google Play:

III. Aegis Authenticator

Aegis Authenticator es un gestor de tus tokens para los servicios con segundo factor de autenticación o 2FA.

Ficha de la App

Nombre App: Aegis Authenticator
Artículo en el blog: https://noroute2host.com/aegis-authenticator.html
Página del proyecto: https://getaegis.app/
Repositorio del proyecto: https://github.com/beemdevelopment/Aegis
Licencia: GPLv3
Alternativa Libre a…: Google Authenticator, Microsoft Authenticator, Authy, andOTP.
Obtener desde F-Droid o Google Play:

IV. Markor

Markor se define a él mismo como un editor de textos, notas y ToDo para Android que soporta Markdown, todo.txt, Zim. No está disponible en Google Play, pero sí lo tienes en F-Droid.

Ficha de la App

Nombre App: Markor
Artículo en el blog: https://noroute2host.com/markor.html
Página del proyecto: https://github.com/gsantner/markor#readme
Repositorio del proyecto: https://github.com/gsantner/markor
Licencia: Apache 2.0
Alternativa Libre a…: Google Keep, Evernote, o cualquier otro editor de texto, notas o Markdown
Obtener desde F-Droid o Google Play:

V. Ning

Ning es un ligero escáner de red local al estilo Fing que te permite descubrir equipos y servicios en tu red local.

Ficha de la App

Nombre App: Ning
Artículo en el blog: https://noroute2host.com/ning-escaner-de-red.html
Página del proyecto: https://github.com/csicar/Ning
Repositorio del proyecto: https://github.com/csicar/Ning
Licencia: GPLv3
Alternativa Libre a…: Fing
Obtener desde F-Droid o Google Play:

Bots en Telegram (I): Creación de un bot de Telegram

2023-06-16T19:15:00+02:00

Empezamos una nueva serie de artículos relacionados con los bots de Telegram. En mi opinión, son una herramienta muy útil para integrar con nuestros scripts o programas para que nos informen de incidencias, el estado de funcionamiento de un servicio o cualquier cosa que se nos ocurra. En este primer capítulo, vamos a empezar por lo más básico: Crear un bot de Telegram. Y dejaré para los siguientes artículos otras cosas, como realizar diferentes acciones con ellos. La idea no es entrar en el detalle de todo lo que se puede hacer con un bot de Telegram porque sería casi infinito, pero sí mostrar como enviar mensajes desde bash o python por ejemplo. Es decir, os contaré como hacer que el bot os envíe mensajes pero ignoraré otras partes como conversar con el bot.

Bots en Telegram

Los bots de telegram son, en esencia, pequeñas aplicaciones que corren completamente dentro de la propia aplicación de Telegram. Tienen muchas funcionalidades y campos de aplicación. Desde reemplazar completamente a webs enteras, a integrar diferentes servicios, pasando por juegos en HTML. Vamos, que las aplicaciones del os bots de Telegram llegan prácticamente a cualquier cosa que se nos ocurra. Y es precisamente por esto, por lo que que a lo largo de esta serie voy centrarme en la utilidad que personalmente a mí más me ayuda. Se trata de usarlo como sistema de notificación para mis scripts y programas. Es decir, usar un bot como un sistema de notificación asociado a mis scripts y programas.

Crear un bot de Telegram

Pero este capítulo 1 trata de como crear un bot de Telegram, así que vamos a ello. No pienses que es nada muy complicado ni nada por el estilo porque vas a tener ayuda. En concreto, nos va ayudar un bot oficial de Telegram creado para este cometido: @BotFather.

Lo primero que tienes que hacer es abrir una conversación con @BotFather. Da igual que lo hagas, desde la web, un cliente de escritorio o la aplicación para móviles. Si nunca has hablado con él tendrás que pulsar en Iniciar para comenzar. En cuanto hagas esto último, BotFather te responderá con a las acciones que puedes realizar.

Como ya habrás imaginado, la creación del nuevo bot se realiza enviando la orden /newbot. Y mediante un proceso interactivo, BotFather te irá pidiendo lo siguiente:

Nombre del Bot: Es lo que aparecerá en la lista de contactos y por todos lados en realidad. Puede ser cualquier cadena de texto conteniendo incluso espacios. Para este ejemplo, le daremos el siguiente nombre: El Bot de noroute2host.com.
Nombre de usuario: Será el nombre de usuario del bot y se usará también en las menciones los enlaces t.me y la búsqueda. Para el que estamos creando será noroute2host_bot. Aquí si hay que tener en cuenta lo siguiente:
- Que debe tener una longitud de 5 a 32 caracteres.
- Debe estar formado únicamente por letras, números y/o “_”.
- Ha de terminar en “bot”. Aunque no distingue entre mayúsculas y minúsculas, por lo que podría terminar en bot o Bot.

Una vez que se le pasan los datos a BotFather este te devuelve tanto, un enlace al bot que en este caso es https://t.me/noroute2host_bot como el Token del mismo. Este token debes guardarlo en lugar seguro y no compartirlo, pues es lo que va a servir como autorización para usar el bot. Cualquiera con el token puede hacer llamadas a la API de Telegram y usar el bot.

Como puedes ver en las acciones que permite BotFather, estas son muy diversas. Van desde modificar el perfil del bot hasta eliminarlo. Aquí te dejo una lista de algunos de ellas:

/setname para cambiar el nombre al bot.
/setdescription para cambiar la descripción de nuestro bot.
/setabouttext para cambiar la información que aparece en el acerca de.
/setuserpic para cambiar la imagen de perfil de nuestro bot.

Así que, por ejemplo, puedes cambiar la imagen de perfil del bot con /setuserpic y enviar la imagen que quieras a la conversación de BotFather.

Y este sería el resultado:

Obtener tu chatID

Como ya te he contado como crear el bot, lo siguiente que necesitas para que tu bot te alerte con las notificaciones o mensajes que quieras, es obtener tu Chat ID. Esto se puede hacer de varias maneras, pero te voy a contar la que para mí es más sencilla y además se ajusta más a lo que ya hemos visto en este post.

Para obtener tu chat id, vamos a usar otro bot @myidbot. En este caso diría que no es bot oficial, pero es tremendamente útil. La operativa es bastante similar a la que seguimos con BotFather:

Abrimos un chat con el bot.
Le enviamos la orden de inicio /start si no se envía automáticamente.
Le pedimos el id con /getid.

Aquí está el proceso, esta vez desde un dispositivo móvil:

En el siguiente capítulo…

Con lo descrito en este post ya puedes crear tu bot de Telegram y obtener tu Chat ID para realizar el envío de mensajes. En el siguiente o los siguientes capítulos detallaré el envío de mensajes usando el bot desde varias fuentes como pueden ser bash o python.

Enlaces de interés:

Aplicaciones libres para Android (V): Ning

2023-06-10T12:30:00+02:00

De vuelta con la serie de Aplicaciones libres para Android, hoy os traigo quizás la app más simple de las que han llegado a esta sección. Se trata de Ning, un escáner de red local similar a Fing y que destaca por su simplicidad y ligereza.

Pero antes de comenzar a hablar de Ning y como siempre hago al comienzo de estos artículos, os recuerdo que la intención de la sección es mostrar aplicaciones que sean software libre. El objetivo puede ser tan simple como compartirlas y darlas a conocer, o más complejo como ayudar a reemplazar de manera sencilla o con garantías otras apps que incorporan nuestros dispositivos Android por defecto, o simplemente que instalamos por que son las más conocidas pese a que sean privativas.

Ning

Como ya he adelantado, la quinta aplicación de la serie es Ning. Y se trata de un ligero escáner de red local al estilo Fing. Pero como siempre, lo primero es la ficha de la app y sus enlaces a F-Droid o Google Play.

Ficha de la App

Nombre App: Ning
Página del proyecto: https://github.com/csicar/Ning
Repositorio del proyecto: https://github.com/csicar/Ning
Licencia: GPLv3
Alternativa Libre a…: Fing
Obtener desde F-Droid o Google Play:

Características

Las características de Ning son bastante simples. Es un escáner de tu red local y te permite descubrir equipos y servicios en tu red local. Por ejemplo, cuando quieres saber la ip de un equipo conectado a tu red, descubrir todos los equipos de la red wifi a la que estás conectado o encontrar servicios de red dentro de tu red local. Ning descubre los sistemas y servicios dentro de la red mediante las siguientes fuentes de datos:

Ping a los dispositivos.
Descubrimiento de servicios de red mediante Avahi y Bonjour.
Tablas ARP
Escaneo de puertos TCP y UDP.

Además, también incorpora información de los dispositivos y sus fabricantes mediante identificación del proveedor. Normalmente esta característica suele estar basada en la dirección MAC de los sistemas descubiertos. Si sientes curiosidad por esto, puedes consultar como está formada una dirección MAC aquí, o incluso el detalle de cómo es la parte que identifica al proveedor en este otro enlace.

Escanea tu red de manera sencilla

El uso de Ning es tremendamente simple. En cuanto abres la aplicación puedes elegir la interfaz de red sobre la que iniciar el escaneo, y solo con hacer el gestor de deslizar hacia abajo para refrescar, comenzará el escaneo de la red seleccionada.

Y una vez pasados unos segundos tendrás en tu pantalla todos los equipos y servicios de red de la red escaneada como puedes ver a continuación. Las XX:XX:XX que aparecen es porque he activado la única opción de la que dispone la aplicación: Ocultar las direcciones MAC de los equipos encontrados.

Por último, también puedes seleccionar cualquiera de los equipos descubiertos para una información más detallada que incluye una lista de los puertos abiertos y los servicios corriendo sobre ellos. Por ejemplo, aquí se puede comprobar lo que ha encontrado de mi Raspberry Pi.

Y ya está, así de fácil es escanear tu red con Ning. Así que, si lo necesitas aquí tienes una sencilla y gran alternativa a tu disposición.

Aplicaciones Libres para Android

Si quieres conocer otras Aplicaciones Libres para Android y te has quedado con ganas de más en este enlace está el índice con todos los artículos de la serie

Cambiamos la apariencia: Adiós “bullseye”, Hola “bookworm”.

2023-06-10T12:00:00+02:00

Este post va a ser una rara avis dentro del blog. No se hablará de nada técnico, ni de software libre (bueno de esto un poquito), ni de nada de lo habitual. Esto es simplemente una entrada de celebración: Cambiamos el diseño. ¡Adiós y Gracias bullseye! ¡Bienvenido bookworm!

Cambiando el diseño. De Homeworld a Emerald.

noroute2host.com comenzó su andadura pública muy poquito después de que la versión 11 de Debian, bullseye, viese la luz de manera definitiva. Pero en realidad, su puesta en marcha coincidió practicamente con la salida de bullseye. Así que la apariencia del blog estaba inspirada en el tema principal de la distro recién salida del horno: Homeworld. Por tanto, ¿qué mejor momento para darle otro aire al blog que justo cuando Debian 12 bookworm ve la luz?.

Seguimos con esta pequeña tradición homenajeando a una de las distros con más solera del panorama Linux y mudamos la piel para inspirar la apariencia del blog con el tema por defecto de Debian 12 bookworm: Emerald. Este cambio implica pasar de los tonos azul oscuro, rojo y grís a otros verdes y azulados. Aunque se han dejado detalles en rojo y gris que son los colores históricos de Debian.

Pero en cuanto al contenido y al funcionamiento nada cambia. La idea sigue siendo la misma, devolver a la comunidad (sobre todo a la comunidad libre) una parte de lo que me da cada día y compartir lo que me apetezca con todo aquel que pase por estos lares. Sin fechas fijas, sin ritmo prefijado y sin guías.

Sin más, un saludo y no olvides seguir las cuentas del blog en las redes sociales:

Previsualización de ficheros Markdown en Vim en la terminal

2023-05-29T17:30:00+02:00

En esta entrada vamos a ver como previsualizar tus ficheros markdown con vim. Y sí, en la misma terminal que estás usando para editar tus ficheros con vim, sin necesidad de abrir ningún navegador, ni tan siquiera de tener un entorno de escritorio funcionando. Únicamente usaremos, el plugin de Vim preview-markdown.vim y el renderizador de markdown MarkDown Renderer, también conocido como mdr.

Si buscas plugins de Vim previsualización de archivos Markdown o incluso de otro tipo de archivos en Vim Awesome observarás que hay bastantes plugins para llevar acabo esta tarea. Pero también te darás cuenta que la mayoría de ellos usan un navegador para mostrarte la previsualización de los ficheros. Y esto es algo que no me gusta nada por varios motivos. Para empezar, en mi caso no tengo entorno de escritorio corriendo en mis SBC como la Raspberry Pi o el NanoPi Fire 3, y suelo conectarme por SSH para trabajar y editar ficheros. Pero es que incluso si estuviera trabajando en un entorno gráfico o exportando las X, la previsualización en un navegador me haría quitar el foco de la terminal para previsualizar el fichero.

preview-markdown.vim

Así que por todo lo que os he contado antes, os voy a hablar de preview-markdown.vim. En realidad, es un plugin bastante sencillo de usar y utilizar como podéis comprobar en su Repositorio oficial de GitHub o en su ficha en Vim Awesome. Lo unico importante ha tener en cuenta es que existe un pre-requisito indispensable que es la instalación de un renderizador de Markdown para la terminal de los que nos indican en la documentación como soportados:

mdr
glow
mdcat

En mi caso he optado por el primero de ellos, mdr.

Pre-Requisito: Instalación de mdr

La instalación de mdr es bastante sencilla. Puedes realizar la compilación del código fuente desde El repositorio de mdr en GitHub o descargar un binario precompilado desde la sección de Releases del repositorio. Esta última opción es la que yo he escogido por simplicidad. En mi caso he escogido el binario precompilado de la versión 0.25 de mdr para ARM en Linux. Si tu arquitectura coincide, puedes descargarlo directamente desde aquí. En otro caso, tendrás que descargar el que se corresponda con tu sistema operativo y arquitectura.

Vamos a proceder a realizar la descarga directamente en /usr/local/bin para lo que necesitarás permisos de escritura en esa carpeta. Lo que probablemente te lleve a realizar la descarga con root (como es mi caso) o con sudo. Una vez descargado habrá que darle permisos de ejecución al binario y ya lo tendremos listo para usarlo.

root@nanopifire3:~# cd /usr/local/bin/
root@nanopifire3:/usr/local/bin# wget https://github.com/MichaelMure/mdr/releases/download/v0.2.5/mdr_linux_arm
root@nanopifire3:/usr/local/bin# chmod +x mdr_linux_arm
root@nanopifire3:~# ln -s mdr_linux_arm /usr/local/bin/mdr

Instalación de preview-markdown.vim

Lo único que nos falta tener en cuenta antes de realizar la instalación de preview-markdown.vim es simplemente que tu versión de Vim debe ser mayor o igual que 8.1.1401. Puedes comprobar esto de esta manera tan simple:

vim --version

Así que, ya cumpliendo con los dos pre-requisitos, lo único que falta es proceder a la instalación del plugin. En este artículo, y puesto que es el gestor de plugins para Vim que yo uso, voy a dejarte como lo instalo con el gestor de plugins Plug. Pero si tienes cualquier otro, basta que lo hagas como normalmente. O si no sabes, en la ficha del plugin en Vim Awesome vienen diferentes ejemplos para diferentes gestores de plugins. Sea como fuere, para el caso de Plug se instala así:

Añadimos la siguiente línea al fichero ~/.vimrc en la sección de Plug:

" CONFIGURACIÓN GESTOR DE COMPLEMENTOS PLUG
call plug#begin('~/.vim/plugged')
" -------------------------------
" ... Otros plugins de vim por aquí...
Plug 'skanehira/preview-markdown.vim', {'for': 'markdown'}
" -------------------------------
call plug#end()

Si no estás muy familiarizado con el gestor de complementos Plug, te puede resultar extraña la parte {'for': 'markdown'}. Su función es que el plugin solo se cargue cuando estemos editando ficheros markdown.

Una vez editado el fichero de configuración de vim, lo que nos falta es realizar la instalación del complemento. Esto último se hace ejecutando la siguiente orden desde dentro del propio Vim:

:PlugInstall

Previsualizando tus ficheros Markdown directamente en Vim

Ahora que está instalado preview-markdown.vim, solo queda empezar a usarlo para previsualizar tus ficheros markdown dentro de Vim directamente desde la terminal. A este respecto, solo puedo decirte que es tremendamente simple de usar. Basta con ejecutar el siguiente comando dentro de Vim:

:PreviewMarkdown [left|top|right|bottom|tab]

Lo que implica cada opción de la previsualización es bastante fáciles de adivinar:

left: Abrirá una nueva ventana de Vim a la izquierda para la previsualización.
top: Abrirá una nueva ventana de Vim arriba para la previsualización.
right: Abrirá una nueva ventana de Vim a la derecha para la previsualización.
bottom: Abrirá una nueva ventana de Vim debajo para la previsualización.
tab: En vez de usar una ventana nueva para la previsualización, usará una pestaña.

Opciones adicionales de preview-markdown.vim

preview-markdown.vim dispone de un par de opciones adicionales para usar añadiendo a tu fichero ~/.vimrc.

La primera es bastante autodescriptiva: g:preview_markdown_parser. Su función es la de elegir el previsualizador o renderizador que se quiera. Por defecto es mdr.
La segunda es muy interesante: g:preview_markdown_auto_update. Sirve para que la previsualización se vaya actualizando tal y como se vaya escribiendo en el buffer (cuando ejecutes :w por ejemplo) sin tener que volver a ejecutar el comando PreviewMarkdown.

Para configurar esta última opción, que es la más interesante, deberás a añadir a tu fichero ~/.vimrc la siguiente configuración:

" CONFIGURACIÓN MARKDOWN PREVIEW
let g:preview_markdown_auto_update = 1

Algunas consideraciones sobre este plugin de Vim

Para finalizar me gustaría aclarar algunas cositas sobre el plugin preview-markdown.vim. La primera de ellas es que desgraciadamente no está en desarrollo activo ya. Pero aún así lo he querido traer el blog porque no he encontrado otro similar con desarrollo activo. Y… ¿quién sabe? Lo mismo alguién que esté leyendo esto se anima a hacer un fork y continuarlo. Porque la segunda cosa que tengo que aclarar es que tiene algunos detalles que pulir como, por ejemplo, que cada vez que recarga la previsualización te lleva al principio del documento. Esto último puede resultar bastante molesto, sobre todo cuando el documento sobre el que estás trabajando es grande.

En cualquier caso, creo que es un plugin de bastante utilidad y que te ayudará a la hora de trabajar con Vim y ficheros Markdown. Y además, a la vez que hemos hablado del plugin te he mostrado un render de Markdown para la terminal que también puede ser muy util para leer archivos Markdown directamente en la terminal.

Enlaces de interés:

Como hacer que bash no distinga entre mayúsculas y minúsculas

2023-03-31T17:30:00+02:00

El objetivo de este post es tan simple como lo que dice su título. ¿Cómo hacer que bash no distinga entre mayúsculas o minúsculas? O lo que es lo mismo… ¿Cómo hacer que bash trabaje en modo case insensitive?

Que bash trabaje en modo case sensitive no es un capricho ni es algo exclusivo de la propia shell bash. ¿Y por qué? Pues la verdad es que no lo he hablado con Dennis Ritchie, Ken Thompson ni Linus Torvlads, pero si tengo una frase grabada de una de mis primeras prácticas de la asignatura de Sistemas Operativos en la universidad:

En Linux todo es un fichero.

Y teniendo en cuenta que la inmensa mayoría de los sistemas de ficheros para Linux y Unix son case sensitive, o lo que es lo mismo, distinguen entre mayúsculas y minúsculas… Que bash, la shell de la que estamos hablando distinga entre mayúsculas y minúsculas cae por su propio peso.

Pero, a veces, nos interesa que el comportamiento sea distinto para que trabaje de modo que no haya distinción entre mayúsculas y minúsculas. Por ejemplo, en el artículo Tratamiento y conversión de imágenes con ImageMagick (II) Aplicación a densidades de pantalla de Android se buscan las imágenes originales en base a su extensión definida por el tipo de formato origen que se pasaba como parámetros. Por ejemplo, si bash trabajara en su modo “normal” los ficheros .png y .PNG no serían tratados igual. Lo que nos lleva al meollo de este post.

¿Como hacer que bash no distinga entre mayúsculas y minúsculas?

Antes de explicar como hacer que bash no haga distinción entre mayúsculas y minúsculas, voy a poner un ejemplo de su funcionamiento original (case sensitive).

# Tenemos 2 ficheros de texto en nuestro directorio de pruebas, pero uno tiene la extensión en maýusculas
adrimcgrady@nanopifire3:~/noroute2host-pruebas$ ls -1 fichero*
fichero1.txt
fichero2.TXT

# Si listamos los ficheros *.txt solo nos aparece uno de ellos
adrimcgrady@nanopifire3:~/noroute2host-pruebas$ ls -1 *.txt
fichero1.txt

# Y lo mismo para el caso de *.TXT
adrimcgrady@nanopifire3:~/noroute2host-pruebas$ ls -1 *.TXT
fichero2.TXT

Pero ¿y si queremos listar todos los ficheros de texto con extensión txt sin importar si está en mayúsculas o minúsculas? Pues que en el caso de bash, existe la posibilidad de hacer que no distinga entre mayúsculas y minúsculas para el caso de ficheros y directorios. La responsable es la función incorporada de bash shopt. Esta función permite activar o desactivar bastantes aspectos de bash que modifican como se comporta por defecto en diferentes aspectos. Su uso básico es bastante simple:

# Activar una opción
shopt -s OPCIÓN

# Desactivar una opción
shopt -u OPCIÓN

Y para la opción de la distinción entre mayúsculas y minúsculas, el nombre no es demasiado original: nocaseglob. Así que para activar o desactivar la opción sería tan simple como:

# Activar modo case-insensitive
shopt -s nocaseglob

# Volver al modo case-sensitive
shopt -u nocaseglob

Por tanto, si activamos la opción, y volvemos a listar los ficheros .txt del directorio de pruebas veremos como ahora si se listan todos independientemente de si su extensión está en minúsculas o mayúsculas.

adrimcgrady@nanopifire3:~/noroute2host-pruebas$ shopt -s nocaseglob

adrimcgrady@nanopifire3:~/noroute2host-pruebas$ ls -1 *.txt
fichero1.txt
fichero2.TXT

Mostrar el estado de las opciones de shopt

Como he comentado antes shopt provee una gran cantidad de modificadores de comportamiento de la shell bash. Y podemos listar el estado de todas ellas en cualquier momento simplemente ejecutando la función incorporada shopt.

adrimcgrady@nanopifire3:~$ shopt
autocd          off
assoc_expand_once   off
cdable_vars     off
cdspell         off
checkhash       off
checkjobs       off
checkwinsize    on
cmdhist         on
compat31        off
compat32        off
compat40        off
compat41        off
compat42        off
compat43        off
compat44        off
complete_fullquote  on
direxpand       off
dirspell        off
dotglob         off
execfail        off
expand_aliases  on
extdebug        off
extglob         off
extquote        on
failglob        off
force_fignore   on
globasciiranges on
globstar        off
gnu_errfmt      off
histappend      on
histreedit      off
histverify      off
hostcomplete    on
huponexit       off
inherit_errexit off
interactive_comments    on
lastpipe        off
lithist         off
localvar_inherit    off
localvar_unset  off
login_shell     on
mailwarn        off
no_empty_cmd_completion off
nocaseglob      off
nocasematch     off
nullglob        off
progcomp        on
progcomp_alias  off
promptvars      on
restricted_shell    off
shift_verbose   off
sourcepath      on
xpg_echo        off

Si, por el contrario, solo queremos listar es estado de una de las opciones la sintaxis sería la siguiente:

shopt [NOMBRE_OPCIÓN]

Por ejemplo, para ver el estado de la opción nocaseglob, cambiar su comportamiento y volver a listar el estado sería así de simple:

# Comprobar el estado antes de cambiar la opción
adrimcgrady@nanopifire3:~$ shopt nocaseglob
nocaseglob      off

# Activar nocaseglob
adrimcgrady@nanopifire3:~$ shopt -s nocaseglob

# Volver a comprobar el estado de la opción nocaseglob
adrimcgrady@nanopifire3:~$ shopt nocaseglob
nocaseglob      on

Por último, solo añadir que las opciones y modificadores que se pueden activar y desactivar con shopt son válidas mientras la sesión de la shell esté activa. Por lo que al salir de la sesión volverán a su estado por defecto

Puedes hacer permanente estos cambios añadiendo el comando shopt al fichero .bashrc, pero en el caso de nocaseglob no te lo recomiendo porque puede afectar a scripts o comandos el sistema que se lancen dentro de una shell bash.

Es más, como ya he comentado la opción tiene validez para toda la sesión por lo que tienes que tener cuidado si no la desactivas cuando no la necesites. Por ejemplo, si la activas dentro de un script y no la desactivas, afectará a todo el script. Puedes ver un ejemplo de como activarla cuando sea necesario y desactivarla después en el script 0018_generar_drawables_dpi.sh del que te hablo en el artículo Tratamiento y conversión de imágenes con ImageMagick (II) Aplicación a densidades de pantalla de Android

A partir de aquí, ya te toca a ti seguir investigando las opciones disponibles en shopt y ver como cambian el comportamiento por defecto de la shell bash. Aunque no descarto que aparezca por el blog en un futuro un post hablando de las opciones más comunes de shopt…

Enlaces de interés:

Manual de Referencia de Shopt

El comando tee

2023-03-24T12:30:00+01:00

El comando tee

Toca hablar de comandos útiles para la terminal en Linux o UNIX, y en concreto de uno en particular: tee. Se trata de un comando cuyo funcionamiento es bastante simple, pero es directamente proporcional a su utilidad. Básicamente lo que hace es leer de la entrada estándar y escribir a la salida estándar y a uno o más ficheros. ¿Y para que sirve esto? Pues para algo tan sencillo y útil, como por ejemplo, ver la salida de un comando o script a la vez que la estamos volcando a un fichero.

Instalando tee

Antes de explicar como se usa, lo primero que os tengo que decir que el comando suele venir en el paquete coreutils de tu distro. Es un paquete de los básicos de todas las distribuciones. Así que lo normal es que lo tengas instalado, pero si no es tu caso, la forma de instalarlo sería esta:

# Debian/Ubuntu 
apt install coreutils

# RedHat/Centos/OracleLinux
dnf install coreutils

Usando tee

Como curiosidad os diré que, si no estoy mal informado, su nombre viene de lo que se ha llamado una T de tuberías de toda la vida. Y la verdad es que tiene todo el sentido del mundo porque nuestro tee hace fundamentalmente lo que una T en cualquier especialidad. De hecho, lo común es usar tee junto con pipe o tubería a la salida de otro comando.

El uso básico de tee es bastantes simple:

tee [OPCIONES] [FICHERO DE SALIDA]

El fichero de salida puede ser sólo uno o varios, y en el comportamiento por defecto es sobreescribir el fichero de salida.

En cuanto a las opciones, las más útiles del comando son las siguientes:

-a: Como ya he indicado, por defecto tee sobrescribe el fichero de salida que le hemos indicado. Pero con esta opción, el comportamiento cambia para añadir al final del fichero.
-i: Esta opción sirve para ignorar las interrupciones. Ahora veremos usos típicos de tee, pero el más común es tras un comando con un pipe. Esta opción permite que el comando tee acabe de manera ordenada cuando queremos cortar la ejecución del comando fuente de los datos con CTRL+C.

Ejemplos de uso

Una vez explicada la sintaxis y las opciones, podemos pasar a los usos más comunes del comando tee en nuestra terminal. Podemos empezar por el ejemplo de uso más habitual, es decir, mandar la salida de un comando o un script a un fichero mientras mantenemos la posibilidad de seguir mostrándola por la salida estándar.

# Ejecutar un comando, ver su salida estándar y guardarla a la vez un un fichero.
echo "1 - Hola soy un texto que se verá por la salida estándar y se guardará en un fichero" | tee prueba-tee.log

# Ejecutar un comando, ver su salida estándar y a la vez añadirla al final de un un fichero.
echo "2 - Hola soy un texto que se verá por la salida estándar y se guardará en un fichero" | tee -a prueba-tee.log

En la siguiente animación se puede ver el funcionamiento de los comandos anteriores y su resultado.

Pero… ¿y si el comando que estamos ejecutando lanza algún error por la salida de errores? Pues con el ejemplo anterior, el error se mostraría por pantalla pero no se guardaría en el fichero indicado a tee. Sin embargo, en muchas veces puede ser útil, que tee guarde las salidas estándar y de error en el mismo fichero. Por ejemplo, cuando interesa dejar lanzado algo y guardar toda la salida para revisarla después. Para este caso, os muestro el siguiente ejemplo:

# Comando sin errores
echo "El comando tee en noroute2host" 2>&1 | tee -a prueba-tee-errores.log

# Comando con errores
bash SoyUnComandoQueNoExiste 2>&1 | tee -a prueba-tee-errores.log

La clave está en 2>&1 que tiene como resultado redirigir la salida de errores a la estándar. Por lo que al final, tee sigue haciendo lo que hace normalmente, pero ahora la salida estándar que se vuelca al fichero como siempre, ya incluye la salida de errores.

Para terminar con los ejemplos, os dejo uno con la opción -i. Al leer la documentación de que es lo que hace esta opción nos puede parecer confuso, pero con un ejemplo se ve mucho más claro.

# Ejecución de una espera de 100 segundos que se para con CTRL+C
adrimcgrady@nanopifire3:~/noroute2host-pruebas$ sleep 100 | tee prueba-tee-opcion-i.log
^C

# Código de salida del comando anterior
adrimcgrady@nanopifire3:~/noroute2host-pruebas$ echo $?
130

# Misma operación usando la opción -i del comando tee
adrimcgrady@nanopifire3:~/noroute2host-pruebas$ sleep 100 | tee -i prueba-tee-opcion-i.log
^C

# Código de salida del comando anterior
adrimcgrady@nanopifire3:~/noroute2host-pruebas$ echo $?
0

Como se puede ver, si paramos la ejecución del comando o script fuente de los datos de tee mediante una interrupción, en este caso CTRL+C, el resultado del comando completo no es 0, lo cuál implicaría que no terminó correctamente. Sin embargo, al usar la opción -i tee termina con código de error 0.

Enlaces de interés:

Aplicaciones libres para Android (IV): Markor

2023-03-10T19:30:00+01:00

Como siempre y antes de nada me gustaría recordar que la intención de la sección es mostrar aplicaciones que sean software libre y con las que podamos reemplazar de manera sencilla o con garantías otras que traen nuestros dispositivos Android por defecto, o simplemente que instalamos por que son las más conocidas pese a que sean privativas. Dicho esto ya podemos pasar a hablar de Markor.

Markor

En este cuarto episodio de la serie Aplicaciones Libres para Android se hablará sobre Markor o como el mismo se define, un editor de textos, notas y ToDo para Android que soporta Markdown, todo.txt, Zim.

Como siempre al inicio, aquí está la ficha de la aplicación. Eso sí, os aviso desde ya que no busquéis la descarga desde Google Play porque, al menos a fecha de redacción de este artículo, la aplicación solo está disponible en F-Droid o en el propio repositorio en Github.

Ficha de la App

Nombre App: Markor
Página del proyecto: https://github.com/gsantner/markor#readme
Repositorio del proyecto: https://github.com/gsantner/markor
Licencia: Apache 2.0
Alternativa Libre a…: Google Keep, Evernote, o cualquier otro editor de texto, notas o Markdown
Obtener desde F-Droid o Google Play:

Características

Markor es básicamente un editor de textos para Android con soporte para varios lenguajes de marcado, posibilidad de crear listas To-Do y compatible con cualquier otro editor de texto. Y todo esto de manera completamente offline y sin anuncios ni permisos innecesarios.

El listado de características oficiales sacadas de su descripción en su repositorio de github son las siguientes:

📝 Crear notas y administrar tus listas To-Do usando lenguajes de marcado simple.
🌲 Funciona completamente offline.
👌 Compatible con cualquier otro software o plataforma.
🖍 Resaltado de sintaxis y autoformato.
👀 Conversión, previsualización y posibilidad de compartir documentos como HTML y PDF.
📚 Cuaderno: Guarda todos los documentos en una simple carpeta del sistema de ficheros.
📓 QuickNote: Toma notas de manera rápida.
☑️ To-Do: Crea tus propias listas to-do.
🖍 Formatos: Markdown, todo.txt, Zim/WikiText, Texto Plano, csv, ics, ini, json, toml, vcf, yaml.
📋 Copia al portapapeles: Copia cualquier hecho, incluyendo los textos compartidos markor.
💡 El cuaderno es el directorio raíz de los documentos y puede ser cambiado en cualquier momento. Las QuickNotes y las listas To-Do son simples ficheros de texto.
🎨 Altamente personalizable, tema oscuro incluido.
💾 Autoguardado y opciones para deshacer/rehacer.
👌 Sin publicidad ni permisos innecesarios.
🌎 Elección de idioma, puedes usar uno distinto al del sistema.
🔃 Aplicación offline. Aunque funciona con otras apps para sincronizar.
🔒 Puedes cifrar tus ficheros de texto con AES256 siempre que tu versión de Android lo permita. Y puedes usar jpencconverter para cifrar y descifrar en tu PC. Pero ten encuenta que solo se cifran archivos de texto, nada de imágenes o adjuntos.

Un completo editor de textos en tu bolsillo

Visto el listado de características anterior te podrás imaginar porqué traigo Markor a la sección. Me parece un editor indispensable, en mi caso para la edición de ficheros Markdown. De hecho este articulo esta siendo escrito directamente desde mi móvil Android.

Y me ha permitido escribir muchos post en noroute2host.com en un periodo donde no podía estar sentado delante de un PC.

Dispone de infinidad de opciones para personalizar el editor, así como otras propias para el lenguaje de marcado que estés usando. Por ejemplo te permite insertar cualquier elemento del lenguaje de marcado directamente desde su barra de herramientas.

En concreto, hay un par de funciones que me encantan. Estas son, poder tener varios archivos abiertos a la vez con su propia ventana de edición y la posibilidad de previsualización del texto resultado en cualquier momento.

Una alternativa libre para editar cualquier archivo de texto

Markor te permitirá editar cualquier archivo de texto, y facilitará y mejorará tu experiencia editando tus textos en lenguajes de marcado el cualquier dispositivo Android. Y todo desde un a aplicación con un enfoque de software libre total.

Aplicaciones Libres para Android

Si quieres conocer otras Aplicaciones Libres para Android y te has quedado con ganas de más en este enlace está el índice con todos los artículos de la serie

Tratamiento y conversión de imágenes con ImageMagick (II) Aplicación a densidades de pantalla de Android.

2023-01-27T18:00:00+01:00

Siguiendo con el tratamiento de imágenes desde la terminal con ImageMagick, vamos a aplicar lo visto en el post anterior al desarrollo de aplicaciones para Android. En concreto, a la necesidad de trabajar con imágenes en diferentes tamaños para las diferentes densidades de pantalla que puede tener un dispositivo Android.

La necesidad: Los diferentes tamaños y densidades de pantalla de un dispositivo Android.

Si no eres desarrollador de aplicaciones Android seguro que nos te has parado a pensar en este aspecto. Pero si lo eres… te habrás dado cuenta de que Android corre en miles de dispositivos diferentes, y que la diversidad de tamaños y densidades de pantalla es absolutamente abrumadora. Si desarrollas una aplicación para Android, está puede acabar corriendo en smartphones, tablets, Android TV, etcétera. Y en cada una de estas categorías te puedes encontrar con pantallas completamente diferentes.

Esto que en realidad es un punto positivo porque tu aplicación puede funcionar en multitud de dispositivos diferentes, también puede ser un dolor de cabeza en el desarrollo de la parte gráfica de tu app. Porque si lo piensas, el resultado puede ser muy diferente en función de donde se esté ejecutando. A nivel de disposición de elementos sobre la pantalla, la solución más recomendable y usada es la de definir los elementos usando medidas y dimensiones relativas, pero ese no es el ámbito de este post. Aquí nos vamos a centrar en las imágenes, que aunque puedes definir sus contenedores de manera relativa, el resultado puede ser deficiente. Por ejemplo, aunque conserves la relación de aspecto, si tienes una imagen de 25x25 píxeles, se mostrará de manera muy diferente en dispositivos con pantallas muy diferentes, y no solo en resolución, sino sobre todo en densidad.

Densidad de pantalla o DPI

Vamos a ver que es esto de la Densidad de pantalla o los DPI. Anteriormente, la medida base para ver como se veía algo un una pantalla era la resolución, es decir, 640x480, 1980x1080… Pero en la época de los smartphones es fácil ver como afecta la densidad de pantalla al escalado de las imágenes. Solo tenemos que pensar en dos dispositivos con el mismo tamaño de pantalla pero con diferentes resoluciones máximas. Es bastante común ver pantallas iguales, por ejemplo 6 pulgadas, pero que una tenga una resolución HD (1280x720) y otro FHD (1920x1080), o similares. Si se define la densidad de pantalla como el número de pixeles por pantalla está bastante claro que las dos pantallas que hemos puesto como ejemplo tendrán diferentes densidades de pantalla. Y a que nos lleva esto, pues a que la misma imagen mostrada en pantallas del mismo tamaño se verá mucho más grande (y puede que pixelada) en la pantalla HD que en la FHD. Si no te queda claro con mi explicación te recomiendo que le eches un ojo a este enlace de la documentación oficial.

La solución oficial de Android: Definir diferentes versiones de la misma imagen para según que DPI.

¿Y que proponen desde Android para lidiar con este problema? En el caso de las imágenes, una de las soluciones es crear 6 conjuntos de gráficos diferentes que serían los siguientes:

ldpi: Para densidades de pantalla de aproximadamente 120 dpi. Tamaño de imagen 0.75x.
mdpi: Para densidades de pantalla de aproximadamente 160 dpi. Tamaño de imagen de referencia 1x.
hdpi: Para densidades de pantalla de aproximadamente 240 dpi. Tamaño de imagen 1.5x.
xhdpi: Para densidades de pantalla de aproximadamente 320 dpi. Tamaño de imagen 2x.
xxhdpi: Para densidades de pantalla de aproximadamente 480 dpi. Tamaño de imagen 3x.
xxxhdpi: Para densidades de pantalla de aproximadamente 640 dpi. Tamaño de imagen 4x.

Por tanto, la proporción de escalamiento de estas 6 densidades principales sería 3:4:6:8:12:16. Pero puedes ver más claramente estas proporciones en la siguiente imagen extraida de la documentación de Android:

Por ejemplo, si tenemos una imagen de tamaño de referencia (mdpi) de 48x48 píxeles, los diferentes tamaños según dpi deberían ser:

36x36 (0.75x) para ldpi
48x48 (1.0x) para mdpi
72x72 (1.5x) para hdpi
96x96 (2.0x) para xhdpi
144x144 (3.0x) para xxhdpi
192x192 (4.0x) para xxxhdpi

Todas estas imágenes se colocarán en diferentes subdirectorios dentro del directorio res/ de la aplicación. De modo que creando un directorio con drawable- más el nombre de cada densidad de pantalla y dejando dentro la imagen con la resolución correcta, la aplicación cogerá automáticamente la que corresponda en función de la pantalla en que esté funcionando. De este modo el árbol de recursos quedaría tal que así:

|--res
|  |--drawable-ldpi
|  |  |--imagenGuay.png
|  |--drawable-mdpi
|  |  |--imagenGuay.png
|  |--drawable-hdpi
|  |  |--imagenGuay.png
|  |--drawable-xhdpi
|  |  |--imagenGuay.png
|  |--drawable-xxhdpi
|  |  |--imagenGuay.png
|  |--drawable-xxxhdpi
|  |  |--imagenGuay.png

Además, merece la pena destacar que hay un par de densidades especiales que son las siguientes:

nodpi: Para gráficos que queremos que se muestren igual en todas las densidades de pantalla.
tvdpi: Para pantallas entre mdpi y hdpi de aproximadamente 213 dpi. Tamaño de imagen 1.33x.

Automatizando la creación de las diferentes imágenes para cada DPI con ImageMagick y un script en bash.

Una vez explicada la teoría, ya podemos pasar al objetivo de esta entrada del blog, que no es otro que el de poner a tu disposición un script bash que a partir de un directorio de imágenes base, las transforme y genere 6 imágenes diferentes, que ubicará en la ruta correcta dentro del directorio res/. Incluyendo además una conversión de formato si fuese necesaria. Es decir, vamos aplicar todo lo que os conté de ImageMagick en el capítulo I para automatizar el proceso de creación de imágenes para diferentes densidades de pantalla en el desarrollo de una aplicación de Android.

El script: generar_drawables_dpi.sh

El script que os comparto para automatizar la creación de las diferentes imágenes asociadas a las distintas densidades de pantalla lo he llamado 0018_generar_drawables_dpi.sh y lo tenéis compartido directamente en el repositorio del blog en Gitlab.

Este pequeño script hace exactamente lo que hemos hablado anteriormente:

Genera 6 imágenes por cada imagen encontrada en el directorio que llamaremos de origen. Es decir, una imagen para cada una de las densidades de pantalla.
Además, convertirá la imagen “original” del formato “original” al que le indiquemos. Por ejemplo, de XCF a PNG.
Por último, si así lo deseamos, copiará todas las imágenes generadas al proyecto de nuestra App Android en desarrollo

En cuanto al directorio y las imágenes originales hay que tener en cuenta los siguientes aspectos:

Todas las imágenes del directorio deberán ser del mismo formato de “origen”.
El tamaño de las imágenes deberá ser el deseado para la densidad xxxhdpi. Es decir, en vez de tomar como referencia mdpi tomaremos la imagen más grande para ir reduciendo al ir generando las sucesivas imágenes.

Usando generar_drawables_dpi.sh

El uso y la llamada del script sería como cualquier script en bash. Es decir ./generar_drawables_dpi.sh o 0018_generar_drawables_dpi.sh si has usado el mismo nombre del fichero en el repositorio. Pero la utilidad tiene varios parámetros obligatorios y otros opcionales que detallo a continuación:

-i: Se usa para definir el directorio donde se encuentran las imágenes “originales”. Parámetro obligatorio.
-o: Se usará para definir el directorio de salida para las nuevas imágenes. Dentro de este directorio se creará una carpeta para cada dpi. Parámetro obligatorio.
-f: Se utilizará para indicar al script el formato de partida de las imágenes dentro del directorio definido con -i. Parámetro obligatorio.
-s: Se utiliza para indicar al script el formato de salida de las nuevas imágenes. Parámetro obligatorio.
-c: Si se define, lo último que hará la herramienta es copiar todas las imágenes generadas al directorio definido con este parámetro. Debe ser una ruta al directorio res del proyecto de tu aplicación Android en desarrollo. Parámetro opcional.
-d: Modo Debug. Añade una salida más detallada. Parámetro opcional.
-h: Ayuda. Muestra información de como ejecutar la utilidad.

Ejemplos de uso

A continuación os muestro varios ejemplos de uso de la herramienta junto con la salida de la ejecución. Para estos ejemplos vamos a usar, como imagen dentro del directorio de entrada, una imagen con el logo del blog, con tamaño inicial 192x192, con formato inicial XCF y con formato de salida PNG. Está sería la imágen original:

Y estas las diferentes ejecuciones del script:

Generar imágenes para diferentes densidades en formato PNG desde formato XCF.

./0018_generar_drawables_dpi.sh -i /home/usuario/noroute2host.com/files/0018_imagemagick-android/originales -o /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs -f xcf -s png

Comienzo de la ejecución.
  Comprobando la instalación de ImageMagick...
  Generando recursos...
Fin de la ejecución.

Generar imágenes para diferentes densidades en formato PNG desde formato XCF y copiar a directorio de proyecto.

./0018_generar_drawables_dpi.sh -i /home/usuario/noroute2host.com/files/0018_imagemagick-android/originales -o /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs -f xcf -s png -c /home/usuario/StudioProjects/miApp/app/src/main/res/

Comienzo de la ejecución.
  Comprobando la instalación de ImageMagick...
  Generando recursos...
  Copiando al proyecto...
Fin de la ejecución.

Generar imágenes para diferentes densidades en formato PNG desde formato XCF y copiar a directorio de proyecto incluyendo la opción para debug o depuración.

./0018_generar_drawables_dpi.sh -i /home/usuario/noroute2host.com/files/0018_imagemagick-android/originales -o /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs -f xcf -s png -c /home/usuario/StudioProjects/miApp/app/src/main/res/

Comienzo de la ejecución.
  Comprobando la instalación de ImageMagick...
DEBUG: Binario ImageMagick: /usr/local/bin/magick
  Generando recursos...
DEBUG: /usr/local/bin/magick mogrify -format png -flatten -path /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/xxxhdpi /home/usuario/noroute2host.com/files/0018_imagemagick-android/originales/*.xcf
DEBUG: /usr/local/bin/magick mogrify -resize 75% -format png -flatten -path /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/xxhdpi /home/usuario/noroute2host.com/files/0018_imagemagick-android/originales/*.xcf
DEBUG: /usr/local/bin/magick mogrify -resize 50% -format png -flatten -path /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/xhdpi /home/usuario/noroute2host.com/files/0018_imagemagick-android/originales/*.xcf
DEBUG: /usr/local/bin/magick mogrify -resize 37.5% -format png -flatten -path /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/hdpi /home/usuario/noroute2host.com/files/0018_imagemagick-android/originales/*.xcf
DEBUG: /usr/local/bin/magick mogrify -resize 25% -format png -flatten -path /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/mdpi /home/usuario/noroute2host.com/files/0018_imagemagick-android/originales/*.xcf
DEBUG: /usr/local/bin/magick mogrify -resize 18.75% -format png -flatten -path /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/ldpi /home/usuario/noroute2host.com/files/0018_imagemagick-android/originales/*.xcf
  Copiando al proyecto...
DEBUG: cp -a /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/xxxhdpi/*.png /home/usuario/StudioProjects/miApp/app/src/main/res/drawable-xxxhdpi
DEBUG: cp -a /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/xxhdpi/*.png /home/usuario/StudioProjects/miApp/app/src/main/res/drawable-xxhdpi
DEBUG: cp -a /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/xhdpi/*.png /home/usuario/StudioProjects/miApp/app/src/main/res/drawable-xhdpi
DEBUG: cp -a /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/hdpi/*.png /home/usuario/StudioProjects/miApp/app/src/main/res/drawable-hdpi
DEBUG: cp -a /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/mdpi/*.png /home/usuario/StudioProjects/miApp/app/src/main/res/drawable-mdpi
DEBUG: cp -a /home/usuario/noroute2host.com/files/0018_imagemagick-android/imgs/ldpi/*.png /home/usuario/StudioProjects/miApp/app/src/main/res/drawable-ldpi
Fin de la ejecución.

Por último, solo me queda mostrar las imágenes resultantes que se han obtenido a partir de la que hemos usado de base:

ldpi (36x36)	mdpi (48x48)	hdpi (72x72)	xhdpi (96x96)	xxhdpi (144x144)	xxxhdpi (192x192)

Código fuente del script

Como ya os he comentado anteriormente este script, así como todos los del blog, lo tenéis en el repositorio Noroute2host Files. Así que mejor que poner por aquí el código, consultarlo y descargarlo directamenre aquí. ¡Y por supuesto es mejorable, modificable, ampliable y todo lo que se os ocurra!

Enlaces de interés:

Tratamiento y conversión de imágenes con ImageMagick (I)

2022-12-23T16:00:00+01:00

Seguro que has tenido hacer cambios en las propiedades de una imagen (tamaño, formato, etc) muchas veces. Y seguro que has usado cualquier programa de edición en tu PC o una app para el móvil. Pero… ¿y si tuvieras que hacer el mismo cambio a decenas o cientos de imágenes? ¿sería efectivo hacerlo de esa forma? Para solucionar esto, damos gracias a ImageMagick por existir. En este primer capítulo os contaré como realizar algunas operaciones básicas con imágenes desde la terminal con ImageMagick. Y habrá un segundo capítulo donde aplicaré estas transformaciones para generar un script que nos ayude a lidiar con las diferentes densidades de pantalla en el desarrollo de aplicaciones para Android.

ImageMagick

Creo que es lógico empezar hablando de ImageMagick. Se trata de una suite open source para la visualización, edición y conversión de imágenes. De modo que permite la modificación de múltiples propiedades de nuestras imágenes. Desde animaciones a reducción de ruido o cambios de tamaño o directamente la conversión entre formatos. Y todo esto para usar desde la terminal, por lo que las posibilidades de automatización y de encadenamiento de operaciones son casi infinitas.

En este ejemplo, voy a centrarme en las más básicas que, al menos para mí son:

Cambio de tamaño.
Conversión de formato.

Instalación de ImageMagick

ImageMagick se puede instalar de varias maneras:

Mediante la mejor opción que suele ser la paquetería de tu distribución. El paquete suele llamarse imagemagick:

# Debian/Ubuntu 
apt install imagemagick

# RedHat/Centos/OracleLinux
dnf install ImageMagick

Si por el contrario tienes algún problema con los paquetes oficiales como por ejemplo un bug que impide convertir tus imágenes desde el formato XCF a otros formatos y usas Debian/Ubuntu puedes ayudarte de “IMEI - ImageMagick Easy Install” que automáticamente descarga los fuentes, los compila y los instala: https://softcreatr.github.io/imei/

Usando ImageMagick

Independientemente del método de instalación que hayas usado el funcionamiento será el mismo. Sí tienes que tener en cuenta que en las versiones antiguas de imagemagick, el comando básico para el tratamiento de las imágenes era convert y ahora se llama magick. De hecho, se sigue manteniendo convert como un link simbólico a magick para facilitar la compatibilidad de scripts o aplicaciones ya creadas previamente.

Como ejemplo para las transformaciones vamos a usar el logo del blog. Una imagen cuadrada de tamaño 378x378 y formato XCF. Y para que no tengas que fiarte de mi palabra con respecto a la imagen inicial, el primer subcomando del que te hablaré es identify. Este comando provee información básica sobre una imagen sobre una imagen.

El uso de ImageMagick para la opción identify es bastante simple:

adrimcgrady@bixito:~$ magick identify noroute2host_logo.xcf 
noroute2host_logo.xcf XCF 378x378 378x378+0+0 8-bit sRGB 0.020u 0:00.007

Para una información más extensa se puede usar el modificador -verbose, pero sin él ya nos quedan claras las características de nuestra imagen inicial. Así que vamos a empezar por mostrar como convertir nuestro archivo XCF a PNG manteniendo el resto de propiedades. Y esto se hace todavía más fácil. La sintaxis básica para esto es:

magick "imagen_entrada.formato_original" "imagen_salida.formato_salida"

Lo que en el caso de la conversión de nuestro logo a PNG desde XCF quedaría de la siguiente manera:

# Conversión de imagen XCF a PNG
adrimcgrady@bixito:~$ magick noroute2host_logo.xcf noroute2host_logo.png

# Uso de identify para ver las propiedades de la nueva imagen
adrimcgrady@bixito:~$ magick identify noroute2host_logo.png
noroute2host_logo.png PNG 378x378 378x378+0+0 8-bit sRGB 12617B 0.000u 0:00.000

Y aquí esta la imagen resultante:

Si además de convertir el formato, quieres redimensionar la imagen, no es ningún problema. Solo tendrás que añadir la operación -resize junto con el tamaño deseado al comando de conversión. Por lo que quedaría así:

# Conversión de imagen XCF a PNG + Cambio de tamaño a 128x128
adrimcgrady@bixito:~$ magick noroute2host_logo.xcf -resize 128x128  noroute2host_logo_128.png

# Uso de identify para ver las propiedades de la nueva imagen
adrimcgrady@bixito:~$ magick identify noroute2host_logo_128.png 
noroute2host_logo_128.png PNG 128x128 128x128+0+0 8-bit sRGB 5937B 0.000u 0:00.000

Este sería el resultado:

Al respecto de las imágenes XCF, tengo que admitir que la imagen usada de ejemplo es monocapa, pero un archivo XCF puede tener varias capas. Y si haces las conversiones tal y como te he descrito arriba, se generarían imágenes diferentes para capas diferentes añadiendo un apéndice numérico al final del nombre del fichero. Si quieres evitar esto, debes usar la operación -flatten que es un alias de -layers flatten. Y que básicamente lo que hace es “aplanar” todas las capas. Hay otras opciones para las capas tal y como puedes consultar aquí. En cualquier caso, dejo aquí un ejemplo de como realizar esta operación.

# Conversión de imagen XCF multicapa a PNG aplanando las capas.
adrimcgrady@bixito:~$ magick noroute2host_logo_mcapa.xcf -flatten noroute2host_logo_mcapa.png

Mogrify. Mejorando el tratamiento por lotes.

Lo último que voy a contarte de ImageMagick algo relativo a sus posibilidades de ser usado por lotes o en scripts. Y es que para este cometido existe un subcomando diferente llamado mogrify. Esta herramienta nos permite una mejor automatización. Pero hay que tener en cuenta que si no usamos la opción -format para realizar conversión del fichero original o -path para cambiar el destino se sobrescribirá el fichero original.

De modo, que si queremos hacer la misma operación que anteriormente, es decir, convertir una imagen de formato XCF a PNG y cambiar su tamaño, pero ampliándolo a todas las imágenes de un directorio sería algo así:

adrimcgrady@bixito:~$ magick mogrify -resize 128x128 -format png -path $HOME/imgs_convertidas/ $HOME/imgs_originales/*.xcf

En el anterior comando estamos usando la herramienta mogrify para tratar todas todas las imágenes XCF del directorio $HOME/imgs_originales/*.xcf con 3 opciones:

-resize: Para redimensionar las imágenes a un tamaño de 128x128.
-format: Para establecer el formato de salida a PNG.
-path: Para fijar el directorio de salida de las nuevas imágenes a $HOME/imgs_convertidas/

Puedes consultar más opciones para la herramienta mogrify en el enlace que te dejo al final del post.

¿Algo más?

Como puedes ver, las posibilidades de ImageMagick son casi infinitas. Así que si quieres ampliar tu conocimiento de que más puedes hacer te recomiendo que eches uno ojo a la documentación oficial. En concreto, te recomiendo este apartado donde hay infinidad de ejemplos de todo lo que puedes hacer. Por mi parte, te emplazo al siguiente capítulo de este tema que estará disponible próximamente, y en el que te contaré como usar estas operaciones para trabajar con las diferentes densidades de pantalla en el desarrollo de aplicaciones para Android.

Enlaces de interés:

Aplicaciones libres para Android (III): Aegis Authenticator

2022-11-25T20:00:00+01:00

La intención de la sección es mostrar aplicaciones que sean software libre y con las que podamos reemplazar de manera sencilla o con garantías otras que traen nuestros dispositivos Android por defecto, o simplemente que instalamos por que son las más conocidas pese a que sean privativas.

Aegis Authenticator

Ya vamos por el tercer artículo de la serie Aplicaciones Libres para Android. En este caso vengo con Aegis Authenticator, un gestor de tus tokens para los servicios con segundo factor de autenticación o 2FA. Aunque tengo que decir que la idea original era venir con andOTP, pero desgraciadamente esta descontinuado.

Ficha de la App

Nombre App: Aegis Authenticator
Página del proyecto: https://getaegis.app/
Repositorio del proyecto: https://github.com/beemdevelopment/Aegis
Licencia: GPLv3
Alternativa Libre a…: Google Authenticator, Microsoft Authenticator, Authy, andOTP.
Obtener desde F-Droid o Google Play:

Características

Aegis Authenticator dispone de las funcionalidades que necesitas para gestionar tu acceso seguro a diferentes servicios. Y como no puede ser de otra manera estando en esta sección, es completamente opensource.

Algoritmos soportados

Soporta completamente los algoritmos HOTP y TOTP. Además se soportar otros procolos como mOTP de manera experimental.

Añadir nuevas entradas

Pra añadir nuevas entradas, dispone de varios métodos:

Usar los típicos códigos QR.
Introducir los datos manualmente.
Importar desde otras apps.

Métodos de importación

Con respecto a este último punto, hay que destacar la cantidad de metodos de importación soportados. Según la información oficial:

2FAS Authenticator
Authenticator Plus
Authy
andOTP
FreeOTP
FreeOTP+
Google Authenticator
Microsoft Authenticator
Texto Plano
Steam
TOTP Authenticator
WinAuth

Aunque para algunos de estos modos de importación requiere acceso root.

Seguridad

La aplicación cuenta con varias funciones de seguridad como puede ser la encriptación de la bóveda que se puede desbloquear mediante contraseña o características biométricas.

También hay otras opciones de seguridad bastante útiles como bloquear la captura de pantalla o el típico “pulsar para mostrar”.

Backups

Aegis te facilita la copia de seguridad permitiendote exportar la claves manualmente a un archivo JSON, realizar copias de seguridad automáticas, o integrarla en la copia de Android.

Hay que indicar que las opciones automáticas solo estan disponibles para bóvedas cifradas.

Otras características

Esta App dispone de otras características:

Es realmente curiosa la posibilidad de instalar paquetes de iconos personalizados para customizar automáticamente la nuevas entradas. Incluyendo uno “no oficial” propio que puedes descargar desde aquí
La organización de los tokens y su ordenación según diferentes criterios. Permite la creación de grupos o notas para este cometido.
Está disponible para funcionar con diferentes temas incluyendo el oscuro.

Una alternativa libre para que te quedes sin excusas para usar siempre 2FA

Aegis Authenticator lo tiene todo para que no tengas excusas para activar y usar siempre que sea posible el segundo factor de autenticación. ¡Venga! ¡La seguridad no es negociable!

Aplicaciones Libres para Android

Si quieres conocer otras Aplicaciones Libres para Android y te has quedado con ganas de más en este enlace está el índice con todos los artículos de la serie

Ampliar swap a máquina virtual Linux sin reiniciar

2022-11-04T19:15:00+01:00

La definición de requisitos de una máquina virtual puede ser una tarea tan sencilla de hacer como susceptible de modificaciones posteriores. En este caso, vamos a ver como ampliar la swap a una máquina virtual sin reiniciar el sistema operativo.

SWAP: Un poco de literatura

Si has llegado a este artículo es porque sabes que es la swap o memoria de intercambio. Pero por si acaso hago un pequeño resumen.

Al final, la memoria RAM física de un ordenador es finita. Para salvar este límite los sistemas operativos crean en disco un segundo nivel de memoria llamado de intercambio o swap.

Evidentemente este nivel es mas lento, pero te permite pasar programas desde la RAM a la swap cuando no estás haciendo uso de ellos, si necesitas memoria para otros programas que si está usando. Cuando vuelvas a necesitar algo que está en swap tu sistema operativo volverá a subirlo a RAM y listo.

La swap no es más que un pequeño truco que usan los sistemas operativos para disponer de más memoria. Normalmente está memoria swap debería usarse solo cuando tú sistema está falto de RAM. Aunque esto no es siempre así…

Ampliando la swap en caliente

Vamos a partir de una máquina virtual con 4 GB de swap. Estos 4 GB están ubicados en una partición LVM actualmente. En mi caso, no quiero ampliar por problemas de rendimiento sino por requisitos en la instalación de un software. Además, esta es solo una forma de las múltiples que hay para conseguir este objetivo.

Comprobación de configuración actual swap

En primer lugar, lo mejor es comprobar la configuración actual de swap con el comando swapon -s

[root@linux-mv ~]# swapon -s
Filename                                Type            Size    Used    Priority
/dev/dm-1                               partition       4194300 0       -2

Preparar el nuevo espacio

Lo siguiente es preparar el nuevo espacio para alojar la nueva memoria de intercambio. En mi caso, he añadido un nuevo disco virtual a mi máquina virtual de VirtualBox que ha sido reconocido como /dev/sdc. (El procedimiento de añadir un nuevo disco virtual y descubrirlo en la mv lo puedes encontrar en múltiples sitios de Internet.)

Una vez asignado el nuevo disco, hay que prepararlo para usarlo como memoria swap.

Lo primero será hacer una partición LVM con fdisk usando todo el disco, aunque el tamaño es a gusto del consumidor.

[root@linux-vm ~]# fdisk /dev/sdc
Welcome to fdisk (util-linux 2.23.2).

Changes will remain in memory only, until you decide to write them.
Be careful before using the write command.

Device does not contain a recognized partition table
Building a new DOS disklabel with disk identifier 0x190a4313.

The device presents a logical sector size that is smaller than
the physical sector size. Aligning to a physical sector (or optimal
I/O) size boundary is recommended, or performance may be impacted.

Command (m for help): p

Disk /dev/sdc: 10.7 GB, 10737418240 bytes, 20971520 sectors
Units = sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 4096 bytes
I/O size (minimum/optimal): 4096 bytes / 4096 bytes
Disk label type: dos
Disk identifier: 0x190a4313

   Device Boot      Start         End      Blocks   Id  System

Command (m for help): n
Partition type:
   p   primary (0 primary, 0 extended, 4 free)
   e   extended
Select (default p): p
Partition number (1-4, default 1):
First sector (2048-20971519, default 2048):
Using default value 2048
Last sector, +sectors or +size{K,M,G} (2048-20971519, default 20971519):
Using default value 20971519
Partition 1 of type Linux and of size 10 GiB is set

Command (m for help): t
Selected partition 1
Hex code (type L to list all codes): 8e
Changed type of partition 'Linux' to 'Linux LVM'

Command (m for help): w
The partition table has been altered!

Calling ioctl() to re-read partition table.
Syncing disks.

Con el comando partprobe hacemos que el kernel actualice la información de particiones y tenga en cuenta la nueva. Los mensajes del dispositivo /dev/sr0 pueden obviarse.

[root@linux-vm ~]# partprobe
Warning: Unable to open /dev/sr0 read-write (Read-only file system).  /dev/sr0 has been opened read-only.

Ahora con lvdiskscan comprobaremos que efectivamente nuestro sistema reconoce la nueva partición y está lista para ser usada con LVM.

[root@linux-vm ~]# lvmdiskscan
  /dev/vg_so/lv_raiz        [     <10.00 GiB]
  /dev/sda1                      [     512.00 MiB]
  /dev/vg_so/lv_swap        [       4.00 GiB]
  /dev/sda2                      [     <40.49 GiB] LVM physical volume
  /dev/vg_almacen/lv_almacen [    <20.00 GiB]
  /dev/vg_so/lv_home        [       6.00 GiB]
  /dev/vg_so/lv_opt         [       6.00 GiB]
  /dev/vg_so/lv_tmp         [       5.00 GiB]
  /dev/vg_so/lv_var         [       8.00 GiB]
  /dev/sdb                       [     20.00 GiB] LVM physical volume
  /dev/sdc1                      [     <10.00 GiB]
  7 disks
  2 partitions
  1 LVM physical volume whole disk
  1 LVM physical volume

En este punto ya podemos pasar a crear todos los elementos de LVM donde alojaremos nuestra nueva swap. Lo primero es crear el Physical Volume sobre nuestra partición con pvcreate y comprobarlo con pvs.

[root@linux-vm ~]# pvcreate /dev/sdc1
  Physical volume "/dev/sdc1" successfully created.

[root@linux-vm ~]# pvs
  PV         VG           Fmt  Attr PSize    PFree
  /dev/sda2  vg_so   lvm2 a--    40.49g   4.00m
  /dev/sdb   vg_almacen lvm2 a--  <20.00g      0
  /dev/sdc1               lvm2 ---   <10.00g <10.00g

Posteriormente, añadiremos el PV creado al Volume Group existente para el sistema operativo donde tenemos actualmente el volumen de swap. Si lo prefieres puedes crear un VG nuevo solo para la nueva swap. Pero en este caso usaremos el existente para el sistema operativo. Así que primero se ampliará el VG con vgextend y después se comprobará la ampliación con vgs.

[root@linux-vm ~]# vgextend vg_so /dev/sdc1
  Volume group "vg_so" successfully extended

[root@linux-vm ~]# vgs
  VG           #PV #LV #SN Attr   VSize    VFree
  vg_almacen   1   1   0 wz--n- <20.00g     0
  vg_so     2   6   0 wz--n-  <40.49g 10.00g

Deshabilitar swap para redimensionar

En este ejemplo veremos cómo ampliar el volumen de swap actual. Se podría generar una nueva swap2 y tener ambas activadas a la vez, o descartar la antigua y solo usar la nueva. Pero, en este caso lo que haremos será ampliar el espacio de intercambio anterior con el espacio del nuevo disco para acabar con una única memoria swap con el total del espacio.

Para esto, lo primero ha hacer es deshabilitar las swap actual para poder redimensionarla. Al hacer esta operación todo lo que está en swap pasará a memoria RAM. Así que es recomendable realizar este paso cuando el consumo de memoria RAM no esté en su punto más elevado. En cualquier caso, deberías asegurarte antes de que tienes suficiente memoria con free -m por ejemplo.

[root@linux-vm ~]# swapoff -v /dev/vg_so/lv_swap
swapoff /dev/vg_so/lv_swap

Para comprobar que efectivamente se ha deshabilitado se puede hacer así:

[root@linux-vm ~]# swapon -s

Redimensionar swap

Una vez que nuestra memoria de intercambio está inactiva, podemos proceder a ampliar el volumen lógico con el espacio del nuevo disco y su nueva partición /dev/sdc1 con lvresize. Aunque antes y después comprobaremos el tamaño del volumen de swap con lvs para ir revisando como se ejecuta la ampliación.

La ampliación la vamos a hacer añadiendo 8 GB. Pero puedes hacerla por el tamaño total si obvias el +8G o simplemente por la cantidad que desees, siempre que tengas espacio disponible en el VG.

[root@linux-vm ~]# lvs /dev/vg_so/lv_swap
  LV      VG         Attr       LSize Pool Origin Data%  Meta%  Move Log Cpy%Sync Convert
  lv_swap vg_so -wi-a----- 4.00g

[root@linux-vm ~]# lvresize /dev/vg_so/lv_swap -L +8G /dev/sdc1
  Size of logical volume vg_so/lv_swap changed from 4.00 GiB (1024 extents) to 12.00 GiB (3072 extents).
  Logical volume vg_so/lv_swap successfully resized.

[root@linux-vm ~]# lvs /dev/vg_so/lv_swap
  LV      VG         Attr       LSize  Pool Origin Data%  Meta%  Move Log Cpy%Sync Convert
  lv_swap vg_so -wi-a----- 12.00g
[root@linux-vm ~]# mkswap /dev/vg_so/lv_swap
mkswap: /dev/vg_so/lv_swap: warning: wiping old swap signature.
Setting up swapspace version 1, size = 12582908 KiB
no label, UUID=6d710bbb-6efb-586e-955c-235e83ef7d29

Activación de swap ampliada

Como ya tenemos nuestra memoria swap ampliada a 12 GB, solo queda reactivarla con swapon. En el ejemplo usamos parametrización para activar todas las disponibles, pero se podría modificar el comando para activar una swap en específico si tuvieras mas de una.

[root@linux-vm ~]# swapon -va
swapon /dev/mapper/vg_so-lv_swap
swapon: /dev/mapper/vg_so-lv_swap: found swap signature: version 1, page-size 4, same byte order
swapon: /dev/mapper/vg_so-lv_swap: pagesize=4096, swapsize=12884901888, devsize=12884901888

Para finalizar, ya solo queda comprobar que la swap ampliada esta activa y tiene el nuevo tamaño con swapon -s. Así como revisar el estado de la memoria con free.

[root@linux-vm ~]# swapon -s
Filename                                Type            Size    Used    Priority
/dev/dm-1                               partition       12582908        0       -2

[root@linux-vm ~]# free -m
              total        used        free      shared  buff/cache   available
Mem:          10005        4819        4993           8         192        3496
Swap:         12287           0       12287

Enlaces de interés

NFLscores Mastodon Bot. Crear Bot de Mastodon y tootear con Python (II)

2022-10-14T19:00:00+02:00

Segunda parte sobre la creación de bots con Mastodon desde Python. Este segundo capítulo esta centrado en contar el proyecto real de bot de marcadores de la NFL en vivo para Mastodon.

Si todavía no has leído la parte I, la tienes aquí: Crear Bot de Mastodon y tootear con Python (II)

Bot Scoreboard NFL para Mastodon

Pues sí, tal como suena, me he puesto manos a la obra y con el fin de aprender y enseñar he creado un bot que he puesto a funcionar.

¿Y de qué es? Pues tras un intenso estudio de mercado y de los gustos del personal el Mastodon de 30 segundos o así, he decidido hacer lo contrario. Es decir, un bot de deportes. Es más, no es que lo haya hecho de fútbol o de baloncesto donde todavía podría tener alguna esperanza de repercusión. No, es un bot de un Scoreboard de la jornada en NFL: NFLscores Mastodon Bot

¿Y por qué? Pues porque me apetecía. Ya que le iba a echar un tiempecito, por lo menos, que fuera algo que me guste y que al menos sea útil para mí. Así que el enfoque es básicamente educativo tanto para mí como para el que quiera usarlo.

El proyecto

Mi situación actual, solo me deja trastear con el móvil, y en mi móvil tengo todo lo necesario para desarrollar el proyecto:

Un editor de código para Python: Pydroid 3
Un cliente de Mastodon: Tusky
Un editor de Markdown: Markor
Un cliente ssh.

Además, es el primer proyecto real que de libera en noroute2host. Así que me hace especial ilusión. Por lo que aquí tienes ya el Enlace al proyecto.

Por otro lado, me gustaría dejar claro que ni soy experto dn Python, ni esto es más que una version inicial aunque funcional. Faltan bastantes cosas, comprobaciones de errores, etcétera. Y quizás hay algún objeto que podría ser un diccionario.

Pero a mí me ha servido para explicar el funcionamiento de un bot en Mastodon, aprender algo de Python orientado a objetos y tener mis marcadores de NFL en directo en Tusky.

Funcionamiento

La base para la publicación de toots es la que vimos en el primer capítulo. Aunque con algunos añadidos bastante interesantes:

El bot se alimenta de los datos que proporciona una API de ESPN
Se puede limitar el tamaño maximo de toot para dividir en varios toots si es necesario.
Tanto la API de marcadores, como la de Mastodon, el Token y el número máximo de caracteres por toot se puede configurar mediante fichero de configuración.
La programación de toots se hace mediante cron cambiando la frecuencia de publicación en función de los horarios de partido.

Básicamente, el funcionamiento de cada ejecución del bot es el siguiente:

Se obtiene la configuración del fichero config.conf. Donde se encuentra la API de marcadores y la info para publicar en mastodon.
Se hace una petición a la API y se descarga la información en formato json.
Se traduce la información a objetos de Python.
Con los objetos, se construye el scoreboard.
Se publica el toot o los toots con la información del scoreboard. Si el tamaño del toot supera lo establecido en la configuración se dividirá el toot.

En el README.md del proyecto podéis encontrar más información de como instalarlo o usarlo. Asi de cómo esta construido.

Contribuir

El proyecto ha sido publicado en Gitlab bajo licencia GPLv3, por lo que todo el mundo puede contribuir. Además pienso que esta preparado para poder usar otra API y desarrollando otro “recolector” sería posible adaptar a cualquier deporte de partidos de equipos.

Enlaces de interés

Crear Bot de Mastodon y tootear con Python (I)

2022-10-06T19:00:00+02:00

En esta ocasión os traigo la manera de crear un bot en Mastodon para después usarlo y tootear desde Python. Esta es la primera parte de una pareja de posts a este respecto.

En este primer capítulo, os explicaré detalladamente cómo crear una cuenta de Mastodon para usarla como un bot, y como postear en ella desde Python. Mientras que en el segundo capítulo os mostraré un bot que actualmente ya está funcionando y cuyo código estará publicado en Gitlab.

Mastodon

Podríamos definir Mastodon como una red social de tipo mocroblogging que es libre y descentralizada. Descentralizada implica que los usuarios se reparten en instancias y estas instancias pueden interactuar entre ellas. Además Mastodon forma parte del Fediverso y puede interoperar con otras redes sociales que implementen ActivityPub.

Pero tampoco quiero entrar de lleno en estos términos. Si tienes interés y ganas de ampliar información sobre Mastodon y el Fediverso, he dejado algunos links al final del artículo.

Para lo que si aprovecharé, es para recordar que tenemos cuenta de Mastodon de noroute2host: https://mastodon.social/@noroute2host

Creando un bot en una instancia de Mastodon

Cualquier cuenta de Mastodon puede servir para un bot. Así que el primer paso será simple, elegir una instancia, y crear una cuenta en ella.

Puedes elegir una instancia pública desde aquí. En mi caso, por ejemplo, voy a elegir una de las mayoritarias: mastodon.online, pero tú puedes elegir cualquiera que te guste.

Una vez creada tu cuenta puedes completar tu perfil, avatar, etcétera. Pero lo importante en esta sección para seguir la buena práctica, es que marques tu cuenta como bot.

Con esto ya tendrás tu cuenta bot creada.

Creando el token para tootear mediante la API

Ahora es el momento de crear una aplicación autorizada dentro de nuestra cuenta de Mastodon que nos permita publicar desde la API.

Esto es muy sencillo de hacer. Se ejecuta desde las opciones de nuestra propia cuenta en el apartado Desarrollo.

Pulsando en Nueva Aplicación nos permitirá fundamentalmente dar un nombre a nuestra aplicación y restablecer los permisos que tendrá. Estos van desde publicar o leer estados, hasta borrarlos o hacer follow a cuentas. Por simplificar, para este ejemplo puedes seleccionar Read y Write. Aunque si quieres puedes refinar estos permisos bastante.

Una vez has creado tu aplicación autorizada y dado permisos, es el momento de obtener tu token de acceso para tootear vía API. Y es tan facil como pulsar en tu aplicación y copiar el Token de Acceso.

Hacer funcionar el bot desde Python

Ya a nivel de Mastodon esta todo creado. Tenemos una cuenta y un aplicación autorizada con su token de acceso a buen recaudo. Ahora toca usar todo desde Python. Para ello usaremos la librería Mastodon.py.

Mastodon.py

Mastodon.py es un wrapper para la API de Mastodon implementado en Python. Para instalarlo en tu virtualenv o distribución directamente puedes hacerlo con pip.

pip install Mastodon.py

Tootear desde Python

Ya solo nos falta tootear desde Python. Para ello habrá que crear una nueva instancia de la API usando el wrapper Mastodon.py, para mas adelante publicar un toot usando esa instancia que acabamos de crear. Además, en el ejemplo siguiente incluyo también como responder a uno de nuestros toots.

Hay que tener en cuenta que los datos de access_token y api_base_url son los de mi aplicación de prueba. Y que deberán ser sustituidos en función del token de cada uno y de la instancia que se esté usando.

# Importar la clase necesaria desde Mastodon.py
from mastodon import Mastodon

# Crear la instancia de la API
mastodon = Mastodon(
    access_token = 'gJVj3oO1fJgg3AbLSfq7Yj43J_c0PJ65AP9ypcO4ZCA',
    api_base_url = 'https://mastodon.online'
)

# Tootear. Guardo la salida en la variable toot
# para poder responder despues.
toot=mastodon.toot('Mi primer toot usando la API')

# Tootear en modo respuesta. Para identificar a
# que toot responder podria usar directamente la
# variable toot o solo el id que se guarda en toot['id']
mastodon.status_post("Y ahora me estoy respondiendo a mi mismo", in_reply_to_id = toot)

Con ésto ya podriamos tootear desde la API cada vez que lo necesitemos, incluir tareas programadas para tootear automáticamente o lo que se nos ocurra.

Por último, indicar que este ejemplo se ha dejado publicado en el repositorio noroute2host-files. Y no olvidéis que esta es la primera parte de este tema y que habrá una segunda mostrando un bot real que esta funcionando actualmente.

Enlaces de interés

Página oficial de Mastodon
Repositorio del código oficial de Mastodon
App oficial de Mastodon
Tusky. Otro cliente para mastodon
Documentación de Mastodon.py
Repositorio de código de Mastodon.py
El artículo de Adrián Perales que me llevó a las redes sociales libres.
Y el podcast de Podcast Linux que me lo contó.
Cuenta de Mastodon de noroute2host

Aplicaciones libres para Android (II): AntennaPod

2022-09-30T20:00:00+02:00

AntennaPod

Este es el segundo artículo de la serie Aplicaciones Libres para Android. Nueve meses han pasado desde el primer articulo de la serie. Ahora traemos AntennaPod, un gestor y reproductor de podcasts brutal con licencia que podemos instalar en nuestros dispositivos Android de manera muy sencilla.

Ficha de la App

Nombre App: AntennaPod
Página del proyecto: https://antennapod.org
Repositorio del proyecto: https://github.com/AntennaPod/AntennaPod
Licencia: GPLv3
Alternativa Libre a…: Google Podcasts, Spotify, iVoox
Obtener desde F-Droid o Google Play:

Características

AntennaPod tiene todas las características que puedas esperar de un reproductor y de un gestor de tu colección de podcasts.

Quizás la función que mas valoro de AntennaPod es la facilidad para buscar, añadir o importar padcasts a tu colección. Desde el apartado Añadir Podcast muestra sugerencias y proporciona un buscador. Pero si aún así no es suficiente, te permite importar podcasts directamente desde su RSS, desde una lista OPML, desde una carpeta local o buscando en otras fuentes.

Desde el apartado Suscripciones puedes gestionar la lista de podcasts a la que estas suscrito, así como comprobar la lista de episodios, consutar si hay nuevos, descargarlos, u otras opciones sobre tus suscripciones.

Otros apartados del menu principal te permiten gestionar la cola de escucha, listar los episodios de los podcasts a los que estas suscrito o gestionar la descargas.

Sincronización

Una característica muy interesante de esta aplicación es la posibilidad de usar gpodder.net o gpoddersycn como servicios de sincronización.

Ajustes

La cantidad y variedad de ajustes y personalizaciones que tiene Antennapod es impresionante. Desde los típicos temas oscuro o claro, pasando por el uso de red o la eliminación automática o programada de episodios. Tal es la variedad que te animo a personalizar la aplicación de la forma que más se adapte a ti.

Reproducción

El reproductor de la app tiene poco de lo que hablar, es simple, cumple su cometido y funciona perfectamente.

Android Auto

Además de todo lo anterior, AntennaPod es compatible con Android Auto. Y eso está genial si eres de los que escuchas podcasts cuando vas conduciendo.

Sinceramente no lo he podido probar porque nunca vi la app en Android Auto debido a que no me aparecía en el menú en el coche. Pero acabo de descubrir mientras redacto el artículo que es porque tengo instalada la versión de F-Droid, y Android Auto por defecto no muestra apps que no se hayan instalado desde Google Play. Para solucionar esto tienes dos opciones:

Activar la opcion de “Fuentes Desconocidas” de Android Auto que es independiente de que la tengas activa tu smartphone. Se accede a esta opción desde el modo desarrollador. Aquí puedes ver cómo acceder a estas opciones.
Instalar la versión de Google Play.

Una alternativa libre para tus podcasts

AntennaPod no es que sea una alternativa válida para las gestión y reproducción de podcasts, es que probablemente no vayas a en contar ninguna opción mejor. ¿Cómo? ¿Has llegado hasta aquí y todavía no la has instalado?

Aplicaciones Libres para Android

Si quieres conocer otras Aplicaciones Libres para Android y te has quedado con ganas de más en este enlace está el índice con todos los artículos de la serie

Instalación y uso de virtualenv de Python

2022-07-13T19:00:00+02:00

Cuando estás desarrollando algo, hay varias tareas relacionadas con el entorno de desarrollo y sus características que suelen ser un quebradero de cabeza bastante importante. Muchas de estas tareas tienen que ver con la posibilidad de tener diferentes entornos donde desarrollar sin afectar a la versión productiva de tu aplicación o con la gestión de dependencias de librerías y versiones de estas. En el caso de Python, virtualenv te ayuda a lidiar con esta problemática.

Virtualenv

virtualenv es una herramienta que te permite crear entornos Python aislados. No tiene grandes requerimientos y es bastante simple. Como se decía en la introducción nos ayudará a resolver bastantes problemas derivados de la gestión de dependencias o como mecanismo para tener varios entornos de desarrollo.

Por ejemplo, podemos nombrar un par de casos de uso:

Imagina que tienes un proyecto en python funcionando de maravilla, pero necesitas actualizar la versión de una librería. Si haces la actualización en el entorno donde está funcionando tu aplicación corres el riesgo de romperla y que no funcione. Pero imagina ahora, que puedes crear un entorno virtual independiente, desplegar tu aplicación, actualizar la librería y probar sin ningún riesgo.

O por poner otro ejemplo, si quieres tener un entorno de desarrollo independiente dentro del mismo sistema donde tienes tu aplicación, puedes generar un virtualevn diferente, desplegar tu aplicación, y hacer todas las pruebas y cambios que necesites sin poner en riesgo la versión productiva. Así como independizar tu desarrollo de librerías de python que también usa tu Sistema Operativo.

Instalación de Virtualenv

virtualenv se puede instalar de varias maneras:

Mediante paquetería de tu distribución. El paquete suele llamarse virtualenv:

# Debian/Ubuntu Si el paquete se llama virtualenv
apt install virtualenv

# RedHat/Centos/OracleLinux
yum install virtualenv

Si dispones de pipx:

pipx install virtualenv

Directamente desde pip:

python -m pip install --user virtualenv

Usando Virtualenv

Sea cual sea el método de instalación elegido, vamos a lo importante: a como crear tu entorno virtual y trabajar con él.

Para crear un nuevo entorno virtual usando el interprete python por defecto del sistema.

adrimcgrady@nanopifire3:~/python/virtualenvs$ virtualenv venv-ejemplo
created virtual environment CPython3.8.10.final.0-64 in 661ms
  creator CPython3Posix(dest=/home/adrimcgrady/python/virtualenvs/venv-ejemplo, clear=False, global=False)
  seeder FromAppData(download=False, pip=latest, setuptools=latest, wheel=latest, pkg_resources=latest, via=copy, app_data_dir=/home/adrimcgrady/.local/share/virtualenv/seed-app-data/v1.0.1.debian.1)
  activators BashActivator,CShellActivator,FishActivator,PowerShellActivator,PythonActivator,XonshActivator

Para crear un nuevo entorno virtual usando un interprete python personalizado.

adrimcgrady@nanopifire3:~/python/virtualenvs$ virtualenv -p /path/a/tu/python venv-ejemplo

Activar tu virtualenv:

adrimcgrady@nanopifire3:~/python/virtualenvs$ source venv-ejemplo/bin/activate
(venv-ejemplo) adrimcgrady@nanopifire3:~/python/virtualenvs$

Ahora ya puedes instalar una librería en ese virtualenv.

venv-ejemplo) adrimcgrady@nanopifire3:~/python/virtualenvs$ pip install cowsay
Collecting cowsay
  Downloading cowsay-5.0.tar.gz (25 kB)
Building wheels for collected packages: cowsay
  Building wheel for cowsay (setup.py) ... done
  Created wheel for cowsay: filename=cowsay-5.0-py2.py3-none-any.whl size=25707 sha256=4a2f91d17b7de2dc18f8b010af907b056b99573e3af866b87d3eae0c9d067a81
  Stored in directory: /home/adrimcgrady/.cache/pip/wheels/64/ae/fe/f16b584bc50cebd8fc7eb1fa69e96abf8b9024114517874952
Successfully built cowsay
Installing collected packages: cowsay
Successfully installed cowsay-5.0

Y ahora ya podemos usar cowsay en nuestro virtualenv.

(venv-ejemplo) adrimcgrady@nanopifire3:~/python/virtualenvs$ python
Python 3.8.10 (default, Jun  2 2021, 10:49:15) 
[GCC 9.4.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import cowsay
>>> cowsay.cow('Muuuuuuuu')
  _________
| Muuuuuuuu |
  =========
         \
          \
            ^__^
            (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

Cuando quieras desactivar tu entorno virtual solo tienes que usar la orden deactivate:

(venv-ejemplo) adrimcgrady@nanopifire3:~/python/virtualenvs$ deactivate
adrimcgrady@nanopifire3:~/python/virtualenvs$

Hemos salido de nuestro entorno virtual, pero continúa ahí para cuando lo queramos usar. Pero, ahora vamos a comprobar que, efectivamente, cowsay no está instalado en el entorno python por defecto.

adrimcgrady@nanopifire3:~/python/virtualenvs$ python
Python 3.8.10 (default, Jun  2 2021, 10:49:15) 
[GCC 9.4.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import cowsay
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'cowsay'
>>>

Por último si queremos borrar un entorno virtual será tan simple como borrar el directorio donde lo creamos. Por ejemplo:

adrimcgrady@nanopifire3:~/python/virtualenvs$ rm -rf venv-ejemplo

Enlaces de interés:

Codificar y Decodificar Base64 desde la terminal

2022-02-28T21:45:00+01:00

Recientemente he tenido que hacer uso de base64 para codificar algunas cadenas de texto. Esto puede ser útil para codificar un fichero de forma básica, convertir una cadena con caracteres no alfabéticos a una cadena que sólo tiene estos caracteres, o incluso para codificar tokens o cadenas de autorización en determinadas APIs. Así que aprovechando eso, os dejo este mini-artículo de como usar el comando base64 desde la terminal.

Para ir al grano voy a poner directamente ejemplos de uso del comando base64 en la terminal.

Codificar una cadena en base64

Esta es la manera en la que personalmente más uso el comando. Sería así:

echo -n "cadena" | base64

Por ejemplo, vamos a codificar la cadena “noroute2host.com”

echo -n "noroute2host.com" | base64
bm9yb3V0ZTJob3N0LmNvbQ==

En función de lo que quieras hacer es muy importante la opción -n del echo puesto que esto evitará que se incluya el salto de línea en la cadena codificada. Esto suele ser un punto de error al codificar tokens o cadenas de autorización de APIs. Si no usamos esta opción la cadena codificada será distinta:

echo "noroute2host.com" | base64
bm9yb3V0ZTJob3N0LmNvbQo=

Decodificar una cadena base64

En este caso hay que usar la opción -d. El comando quedaría así:

echo -n "cadenaBase64" | base64 -d"

Probemos a decodificar las dos cadenas obtenidas en el anterior punto. En este caso dejo el prompt para que se vea la diferencia sin y con salto de línea:

adrimcgrady@nanopifire3:~$ echo -n "bm9yb3V0ZTJob3N0LmNvbQ==" | base64 -d
noroute2host.comadrimcgrady@nanopifire3:~$

adrimcgrady@nanopifire3:~$ echo "bm9yb3V0ZTJob3N0LmNvbQo=" | base64 -d
noroute2host.com
adrimcgrady@nanopifire3:~$

Codificar un fichero en base64

Si por el contrario, lo que necesitas es codificar en base64 un fichero completo lo único que debes hacer es pasar el fichero como parámetro al comando.

La sintaxis sería así:

base64 tufichero.txt

Por ejemplo, si tenemos un fichero llamado “textoplano.txt” con el siguiente contenido:

Esto es un fichero en texto plano.
Solo servirá para comprobar como funciona el comando base64.
noroute2host.com

Se puede codificar de la siguiente manera:

base64 textoplano.txt 
RXN0byBlcyB1biBmaWNoZXJvIGVuIHRleHRvIHBsYW5vLgpTb2xvIHNlcnZpcsOhIHBhcmEgY29t
cHJvYmFyIGNvbW8gZnVuY2lvbmEgZWwgY29tYW5kbyBiYXNlNjQuCm5vcm91dGUyaG9zdC5jb20K

Y para guardarlo codificado solo tendremos que usar la redirección adecuada para guardar la salida en un fichero:

base64 textoplano.txt > textoplano.txt.base64

Decodificar un fichero base64

Por último, si ya tienes un fichero codificado en base64 y lo que te hace falta es decodificarlo es muy simple. Es exactamente igual que para codificar pero usando la opción -d. Es decir, quedaría así:

base64 -d tufichero.txt.base64

Por ejemplo, para decodificar el fichero del apartado anterior:

base64 -d textoplano.txt.base64
Esto es un fichero en texto plano.
Solo servirá para comprobar como funciona el comando base64.
noroute2host.com

Y para guardarlo decodificado, como antes, solo habrá que usar la redirección a un fichero nuevo.

base64 -d textoplano.txt.base64 > textoplano.txt.decodificado

Enlaces de interés:

Página de wikipedia sobre Base64

Aplicaciones libres para Android (I): Etar Calendario.

2022-01-14T17:30:00+01:00

Después de un tiempo sin nuevos artículos regresamos para inaugurar una sección a la que le tenía bastantes ganas: Aplicaciones Libres para Android. La idea de la sección es traer herramientas que sean software libre y con las que podamos reemplazar de manera sencilla o con garantías otras que traen nuestros dispositivos Android por defecto, o simplemente que instalamos por que son las más conocidas pese a que sean privativas.

Etar - Calendario Open Source

Para comenzar esta nueva sección traemos Etar, un calendario con licencia GPLv3 que cumple perfectamente y podemos instalar en nuestros dispositivos Android de manera muy sencilla. De hecho, Etar es simple y directamente una versión mejorada del calendario por defecto del proyecto AOSP (Android Open Source Project).

Ficha de la App

Nombre App: Etar - OpenSource Calendar.
Página del proyecto: https://github.com/Etar-Group/Etar-Calendar
Repositorio del proyecto: https://github.com/Etar-Group/Etar-Calendar
Licencia: GPLv3
Alternativa Libre a…: Google Calendar, Otros calendarios cloud o locales de los fabricantes.
Obtener desde F-Droid o Google Play:

Características

Etar dispone de las opciones que puedes esperar de cualquier aplicación de calendario como pueden ser las vistas varias de Día, Mes, Semana o Agenda. Esta última es muy interesante porque en dicha vista solo aparecen los días que tienes registrados eventos. Además también dispondrás de un widget para la vista de agenda.

Además a nivel gráfico te permite personalizar la aplicación haciendo uso de modo oscuro, o cambiando el color principal de la aplicación, así como de los eventos de cada calendario para que puedas distinguir rápidamente de donde vienen.

Al crear un evento puedes elegir sobre cual de tus calendarios quieres crearlo, definir el color del evento, establecer varios recordatorios y su tipo, email o notificación. El aviso por email solo está disponible para calendarios tipo cloud como es lógico.

Pero las características más interesantes de Etar tiene que ver con la sincronización o no de calendarios. Porque tienes múltiples opciones:

Para empezar puede sincronizar con múltiples proveedores de calendarios como Google Calendar, Exchange, etc…
Pero no solo eso, es que puedes integrarlo tu propio servicio de calendarios CalDAV o EteSync. Esto hace la aplicación tremendamente útil para sincronizar con tu propio servicio y no depender o tener la información en otros.
Y la opción más simple pero muchas veces la mejor para mantener tu privacidad, puedes crear y usar calendarios completamente offline.

Una alternativa libre para tu aplicación de calendario

Etar dispone de las opciones necesarias para ser tu aplicación de calendario por defecto y es de código abierto. Ten por seguro que no echarás de menos la aplicación propietaria que seguro que trae tu smartphone por defecto y además no contiene anuncios ni permisos innecesarios. ¿A qué esperas para probarla?

Aplicaciones Libres para Android

Si quieres conocer otras Aplicaciones Libres para Android y te has quedado con ganas de más en este enlace está el índice con todos los artículos de la serie

Script Multiping para Bash

2021-11-06T14:15:00+01:00

Aprovechando temas tratados anteriormente os mostraré un script para hacer un multiping o ping múltiple a una lista de ips. Estas ips pueden venir de un fichero de texto y de parsear la salida del comando prips. Es cierto que hay herramientas alternativas y que se suelen usar para esto como nmap, fping u otras, pero con nuestro script no necesitarás instalar nada en tu servidor o equipo, solo copiar y ejecutarlo. Y además podrás adaptarlo a tus necesidades fácilmente. Además, podrás adaptarlo a tus necesidades y nos servirá para aplicar soluciones vistas aquí anteriormente:

multiping_bash.sh

multiping_bash.sh, más bien, 0008_multiping_bash.sh será nuestro script. Y como hemos dicho antes lo tenéis disponible en el repositorio. Básicamente lo que hace el script es, a partir de una lista de ips, comprobar cuales responden a ping y cuales no, mostrando un reporte final.

Usando multiping_bash.sh

La manera de ejecutar el script sería como la de cualquier otro, así que simplemente se copiaría al sistema donde se quiera ejecutar y se lanzaría con ./0008_multiping_bash.sh, bash 0008_multiping_bash o la manera que cada uno prefiera.

Pero hay que tener en cuenta que tiene dos modos de funcionamiento dependiendo de como se reciba la lista de ips:

Vía pipe y el comando prips. Por ejemplo: prips RED/MASCARA | ./0008_multiping_bash.sh [-r] [-d]
Mediante un fichero de ips. Por ejemplo: /0008_multiping_bash.sh -f FICHERO-IPS [-r] [-d]

A continuación se describen las opciones del script:

-f: Si no se pasan las ips vía pipe y prips esta opción es obligatoria. Así como también es obligatorio indicar una ruta a un fichero de ips que tenga una ip por linea. Puedes consultar un ejemplo aquí
-r: Parámetro opcional. Se usa para habilitar que el script muestre un reporte final.
-d: Parámetro opcional. Se usa para habilitar la salida de depuración.
-h: Muestra ejemplos de uso.

Ejemplos de uso

A continuación os dejo varios ejemplos de uso, así como su salida.

# Usar prips para pasar la salida al script de multiping y mostrar reporte final.
prips 192.168.0.32/29 | ./0008_multiping_bash.sh -r

# Usar un fichero de ips para el script de multiping y mostrar reporte final.
./0008_multiping_bash.sh -f 0008_ejemplo_ips.txt -r

Código fuente del script

Como ya os he comentado el script de multiping, así como todos los del blog, lo tenéis en el repositorio Noroute2host Files. Así que mejor que poner por aquí el código, podéis verlo directamenre aquí y echarle un ojo. ¡Y por supuesto es mejorable, modificable, ampliable y lo que se os ocurra!

Exportar y dejar de exportar un recurso NFS de manera manual con el comando exportfs

2021-10-20T18:30:00+02:00

Habitualmente para exportar o dejar de exportar un directorio por NFS lo normal es proceder a la modificación del fichero /etc/exports para después acabar haciendo un exportfs -a o incluso un reload del demonio NFS. Pero recientemente me he visto en la obligación de realizar esto sin tener que asumir el riesgo de afectar al resto de shares. Es decir, lo que os cuento a continuación sirve para exportar/dejar de exportar un directorio por NFS de manera manual y no persistente ante reinicios del servicio NFS o del sistema completo.

Exportar manualmente un directorio por NFS

Para exportar un directorio por NFS de manera manual usaremos también el comando exportfs pero de distinto modo a si quisiéramos que leyera el fichero /etc/exports.

La sintaxis sería así:

exportfs [-o OPCIONES] CLIENTE:/ruta/a/exportar

Por ejemplo, el siguiente comando exporta por NFS el directorio /home/testdir al sistema 192.168.0.88 con la opción de lectura/escritura:

exportfs -o rw 192.168.0.88:/home/testdir

Dejar de exportar manualmente un directorio por NFS

Si por el contrario, lo que se necesita es dejar de exportar un directorio por NFS de manera manual seguiremos usando exportfs, pero esta vez con la opción -u.

La sintaxis sería así:

exportfs -u CLIENTE:/ruta/a/exportar

Por ejemplo, el siguiente comando deja de exportar por NFS el directorio /home/testdir al sistema 192.168.0.88:

exportfs -u 192.168.0.88:/home/testdir

Comprobar que la exportación o le eliminación del export se ha realizado correctamente.

Para comprobar el estado de nuestras exportaciones NFS podemos usar cualquiera de los siguientes métodos para ver el listado de las exportaciones actuales:

Listar todos los recursos exportados por NFS:

exportfs

Consultar la tabla maestra de recursos exportados:

cat /var/lib/nfs/etab

Enlaces de interés:

El comando watch

2021-10-12T16:00:00+02:00

¿No os ha pasado nunca que al lanzar un comando que tarda un poquito en ejecutarse os habéis abierto otra sesión y lanzado un comando de comprobación tropecientas veces pulsando ↑ + [Enter]? Pues a mí me pasaba pero ya no. Bueno lo mismo es que soy un poco agonía pero el asunto es que hay una pequeña utilidad que te evitará esto y además te valdrá para otras circunstancias.

El comando watch

Efectivamente, esta utilidad se llama watch y te ahorrará lanzar cualquier comando de manera repetida. Este sencilla herramienta lo que hace es básicamente lanzar de manera periódica el comando que le digamos y en el intervalo que le digamos.

Es decir, podemos estar copiando un fichero de una ubicación a otra, y en vez estar continuamente comprobando el fichero destino para ver como va la copia, podemos decirle a watch que nos lance un ls -l del fichero destino cada 5 segundos.

Usando watch

Comenzando con su instalación (si es que tu distribución no lo tiene instalado por defecto), hay que decir que es bastante sencilla. En Debian, Ubuntu o derivados es tan simple como:

apt install watch

Una vez instalada, la herramienta es muy sencilla de usar. Su uso básico podría ser así:

watch COMANDO_A_EJECUTAR

Además, el comando watch tiene algunas opciones más que interesantes que lo hacen muy configurable dentro de su simplicidad:

-n: Establece el intervalo con que se ejecuta el comando. Si no se establece, por defecto es 2 segundos (por lo menos en mi distro).
-d: Resalta las diferencias de las sucesivas ejecuciones, muy útil la verdad.
-b: Emitirá un beep si el comando lanzado no tiene código de salida 0.

Hay algunas opciones más como hacer que el comando watch deje de ejecutarse cuando haya un cambio en la salida, o congelar la salida si el comando devuelve un error o alguna más. Te animo a que le des un vistazo al resto de opciones.

Ejemplos de uso

Como os podéis imaginar podemos usar este comando un multitud de ocasiones y con múltiples objetivos. A continuación muestro algunos ejemplos simples de su uso y su funcionamiento. Para ello combinaremos el comando watch con date.

# Ejecutar y mostrar la salida de un comando usando las opciones por defecto.
watch date

# Ejecutar y mostrar la salida de un comando cada 3 segundos.
watch -n 3 date

# Ejecutar y mostrar la salida de un comando cada 3 segundos y resaltando las diferencias.
watch -n 3 -d date

Enlaces de interés:

Actualizando la versión de InfiniTime de PineTime

2021-10-02T17:30:00+02:00

Como ya os conté en el artículo anterior, el firmware que estoy usando en mi PineTime es Infinitime. En este artículo os voy a explicar como actualizar la versión de InfiniTime de vuestro PineTime. En concreto, os contaré como actualizar a la versión 1.6 desde cualquier otra versión de InfiniTime 1.0 o superior haciendo uso de GadgetBridge. En cualquier caso, debería funcionar también para cualquier versión superior salvo que en un futuro cambie el mecanismo de actualización.

Cambios en las versiones 1.5 y 1.6 de Infinitime

De manera previa a contaros el proceso de actualización, os muestro cuales son las novedades de las versiones 1.5 y 1.6. Sí, habéis leído bien, de ambas. La comunidad de InfiniTime está haciendo un trabajo fantástico y menos de un mes después de la versión 1.4 que es sobre la que os conté mis impresiones, ya tenia lista la versión 1.5. Pero no se quedó ahí, sino que ¡dos días! después ya estaba publicada la versión 1.6. Estas son las mejoras implementadas en estas versiones:

InfiniTime 1.5 “Huckleberry”:
- Nueva aplicación de Alarma.
- Mejoras en las vibraciones de las notificaciones. Ahora cuando desactivas la vibración, se desactiva de las notificaciones pero si usas el metrónomo por ejemplo el reloj sigue haciendo uso de la función de vibración.
- Ahora si reinicias tu PineTime conserva la hora tras el reinicio. Antes tras reiniciar la hora se quedaba en 00:00 si no resincronizabas con la aplicación.
- Mejoras en el código BLE.
- Correcciones sobre fiabilidad del medidor de batería. Es algo de lo que hablamos en el artículo anterior. La medición de la batería no era muy fiable.
InfiniTime 1.6 “Ice Apple”:
- Se ha corregido el principal problema que tenia InfiniTime, las desconexiones del bluetooth y la imposibilidad de recuperar la conectividad sin reiniciar.

Como podéis ver son bastantes mejoras y bastante importantes. De hecho, ya os hablé sobre ellas en el artículo de impresiones de PineTime. El trabajo de la comunidad está siendo impresionante y no me canso de repetirlo.

Actualización de InfiniTime mediante GadgetBridge.

Consideraciones Previas

La actualización la vamos a realizar haciendo uso de GadgetBridge, así que lo primero que debéis hacer es instalar la aplicación en vuestro móvil Android desde F-Droid y emparejar vuestro PineTime.

Es importante también que tengamos el bootloader correcto instalado. Si tenéis la versión 1.x de InfiniTime actualmente no será necesario que hagáis nada. En otro caso, aquí tenéis la URL del proyecto del bootloader. Pero lo normal es que no haga falta este paso.

Suele ser recomendable no actualizar el firmware con la batería llena porque en caso de que se quede bloqueada la actualización o el reloj, habrá que esperar hasta que se acabe la batería para poder re-arrancarlo.

Ficheros necesarios para la actualización.

Puedes encontrar todas las versiones disponibles de InfiniTime en el apartado de “Releases” del proyecto en GitHub. Mas en concreto en el apartado de Assets de cada versión. El único fichero que necesitas para la actualización vía GadgetBridge es el fichero dfu. Por ejemplo, este es el fichero dfu de la versión 1.6: https://github.com/JF002/InfiniTime/releases/download/1.6.0/pinetime-mcuboot-app-dfu-1.6.0.zip

Actualizando

Para comenzar la actualización lo único que debes hacer es abrir el fichero dfu en tu móvil Android indicándole que se abra con el actualizador de firmware de GadgetBridge tal y como muestra la siguiente imagen:

Una vez abierto el fichero con GadgetBridge solo hay que pulsar en instalar.

Y la actualización de InfiniTime comenzará inmediatamente. Y podremos ver el progreso tanto en GadgetBridge…

Y cuando acabe GadgetBridge nos avisará…

Así como en el propio PineTime…

Y nuestro reloj se reiniciará con la nueva versión. Y si todo ha ido bien deberíamos validar la actualización desde el apartado firmware como podéis ver a continuación:

Si algo ha ido mal, bastará con pulsar en Reset, y en vez de validar la actualización lo que haremos será volver a la versión anterior.

Y eso es todo, así que el proceso de actualización es bastante sencillo. Así que no debéis tener miedo a las actualizaciones y a seguir el fantástico ritmo de actualizaciones que lleva la comunidad de InfiniTime.

Además si con esta explicación no tenéis suficiente u os gusta más el formato vídeo os recomiendo el siguiente canal de PineTime en FediverseTV. En el tenéis bastantes vídeos de PineTime así como vídeos de las actualizaciones a las diferentes versiones de InfiniTime.

Enlaces de interés:

Probando PineTime, el reloj libre.

2021-09-25T17:30:00+02:00

¿Que es PineTime?

Antes de hablar del PineTime, lo primero que debéis saber es que en este artículo no se hablará de cuanto pesa, de que tamaño es su pantalla o cualquier otra característica de ese tipo. Aquí vamos a hablar de que es PineTime, de que va y como funciona.

El reloj nos llega de la mano de PINE64. Y partiendo de lo anterior, lo primero que hay que decir de PineTime es que es un reloj inteligente basado en software y hardware libre. Y es este concepto el que lo hace interesante para mí. Además os indico que os voy a hablar de la versión “sellada” que es la que se puso a la venta este verano y la que estoy probando.

¿Qué sí y qué no esperar de PineTime?

Esto es quizás lo más importante a la otra de evaluar PineTime. De este reloj te puedes esperar que te de la hora, que tenga algunas funciones inteligentes, que vaya creciendo a la vez que su comunidad de desarrolladores o que su concepto libre sea el corazón del mismo.

Por otro lado hay cosas que no debes esperar cuando recibes tu flamante reloj, como que te espíe, tenga una integración perfecta con tu aplicación deportiva preferida o unas funciones avanzadas de la leche.

¿Y qué es InfiniTime?

PineTime, Infinitime… ¿Qué es esto? Pues muy fácil: Si PineTime es el reloj, InfiniTime es el Firmware más activo que le puedes instalar. De hecho es el que viene preinstalado en la versión “sellada”. En concreto, recibí mi PineTime con la versión 1.2 de InfiniTime y nada más llegarme lo actualicé a la versión 1.4 que ya estaba disponible (Y ahora ya lo tengo en la versión 1.6). En su repositorio de GitHub puedes estar al día de como va cambiando y de las nuevas releases. Y la verdad es que tienen bastante buen ritmo de actualizaciones.

Lo tengo, lo uso a diario y esto es lo que os puedo contar

Como ya os he contado, tengo un PineTime en mi muñeca funcionando con la versión 1.4 de InfiniTime. Y os voy a contar que me está pareciendo, como está funcionando, así como que me gusta y que echo de menos.

En primer lugar, la estética es bastante sencilla y no destaca por nada en concreto pero tengo que decir que no es feo. Es sobrio, sin alardes. No me esperaba más y la verdad es que tengo que reconocer que me gusta. Queda bien en la muñeca y los materiales no decepcionan y la pantalla cumple bastante bien.

El tema o “watch face” que estoy usando es simplemente el Digital. Me gustaría que se pudiera personalizar más pero es lo que hay. Aunque hay que decir que hay uno más personalizable llamado “PineTimeStyle”, pero no me acaba de convencer, prefiero el Digital simple.

Dejando a un lado lo estético me centraré en el funcionamiento y empezaré por la integración con mi móvil Android. La realiza mediante la aplicación GadgetBridge que puedes encontrar en F-Droid. La puesta en marcha es bastante sencilla y esta misma aplicación es la que se usa para actualizar el firmware. El problema es que pasadas unas horas, en torno a 20, el reloj se desconecta de la aplicación y para reconectarlo es necesario reiniciar el reloj, y eliminarlo y emparejarlo de nuevo en GadgetBridge. La buena noticia es que hay un problema reportado en GitHub al respecto y esperemos que quede arreglado en sucesivas revisiones. El problema de la sincronización y desconexión del Bluetooth se ha solventado en InfiniTime 1.6 gracias al impresionante trabajo de la comunidad. También puedes integrarlo con tu PC con linux mediante Siglo o Amazfish pero personalmente no las he probado.

Otra de las cosas que está en desarrollo es que no se puede establecer la hora de manera manual, debe ser mediante sincronización con tu teléfono o tu PC. Por lo que el uso de las aplicaciones anteriormente citadas se hace indispensable. Desde la versión 1.5 de InfiniTime la hora se guarda entre reinicios

Las notificaciones funcionan bastante bien la verdad. InfiniTime mantiene las últimas 5 para que puedas verlas directamente desde el reloj. Y con GadgetBridge puedes hacer una lista negra de que notificaciones no lleguen a tu teléfono. Es decir, puedes hacer que las notificaciones de recepción de un email te lleguen al reloj, pero que la previsión del tiempo se quede en tu móvil. Aquí la única pega es que no se si es cosa mía o no, pero las llamadas no se notifican en el reloj. Y eso pese a que con GadgetBridge puedo hacer una de prueba y si me aparece directamente. Seguiré investigando esto… Confirmado que era problema mío. Le faltaban permisos sobre las llamadas a GadgetBridge

En cuanto a la batería, es posiblemente una de las cosas más positivas. Me está durando una semana completa con el uso diario normal, lo que me parece que está bastante bien la verdad. Aunque también necesita algo de mejora aquí porque los porcentajes son algo confusos. Por ejemplo, nunca marca el 100%, o a partir del 33% baja demasiado rápido. Esto ha mejorado algo en la versión 1.5 pero aún necesita mejorar.

Por último, para mí no es un problema pero creo que merece la pena indicar que no tiene posibilidad de usar otro idioma que no sea el inglés.

Aplicaciones Adicionales

Nuestro PineTime viene adornado con un buen puñado de aplicaciones. Pero hay que tener en cuenta que no dispone de una “store” ni nada parecido, sino que están directamente incluidas en el firmware. Son las siguientes:

Música: Controla el reproductor de música de tu dispositivo vinculado.
Pulsómetro: La verdad es que diría que es de las cosas más decepcionantes del reloj. Es bastante impreciso la verdad.
Navegación: No la he probado, pero se supone que a través de GadgetBridge se envían las indicaciones de navegación al reloj.
Paddle: Un clon de pong para un jugador.
Twos: Un clon de 2048.
Cronómetro: Un cronómetro simple que hace su función perfectamente.
Cuenta atrás: Una aplicación de cuenta atrás.
Podómetro: Te muestra los pasos realizados en el día. Funciona bien, permite establecer metas diarias pero no se guarda ningún tipo de registro. Espero que evolucione en futuras versiones.
Metrónomo: Un metrónomo bastante curioso que marca el ritmo con las vibraciones.
Alarma: Desde la Versión 1.5 de InifiniTime tenemos una aplicación para programar alarmas.

Un detalle más

Este último detalle no es achacable a la gente de Pine64 ni a InfiniTime sino al servicio de correos. Si lo pides desde España te puede pasar lo que a mí y encontrarte con un par de sorpresas. La primera, es que para recoger el pedido tendrás que abonar en la oficina de correos el importe relativo al IVA del producto. Sinceramente esto no me extraña a raíz de las últimas leyes aprobadas, y sinceramente tampoco me molesta. Es lo que hay que hacer y se hace. Pero la segunda sorpresa si me molestó bastante, y es esa nueva “tasa” (por llamarla de algún modo) en concepto de gestión de aduanas que está cobrando correos de manera bastante arbitraria. Son 5€ por un trabajo bastante oscuro que no queda claro y que tampoco se a donde va a parar.

Conclusiones

PineTime es un reloj inteligente del que si sabes lo que esperas no te defraudará. Su espíritu libre y su constante evolución lo hacen perfecto si lo que buscas es eso. Evidentemente no se puede comparar en funciones a otros relojes inteligentes del mercado, pero tampoco creo que sea lo que pretenda. ¿En qué otro reloj puedes compilarte el firmware, cambiarle detalles tú mismo en el código, colaborar en el desarrollo para mejorar cualquiera de las cosas que hemos hablado en este artículo o añadir nuevas funciones?

Mi PineTime no es perfecto, no es precioso, pero no lo cambio por ningún otro.

Enlaces de interés:

El comando prips. Obtén y trabaja con la lista de ips de una red en tu terminal.

2021-09-04T16:00:00+02:00

El comando prips

A veces se necesita obtener de forma rápida información acerca de las ips de una red. En mi caso, al final lo que hacía siempre es poner en el buscador “Network Calculator” o algo del estilo y usaba cualquier web que pillara. Pero ya existe un comando para la terminal de linux que nos puede ayudar con esa tarea: prips. Bueno, al menos en parte, aunque también te permite tener la información directamente en el terminal y usarla dentro de tus scripts o como entrada para otros comandos.

Para tener la funcionalidad completa de una de estas webs se puede complementar prips con ipcalc. Pero en este artículo nos centraremos en prips.

Usando prips

Comenzando por el principio, su instalación es bastante sencilla, al menos en Debian, Ubuntu o derivados. Es tan simple como:

apt install prips

Una vez instalada, la utilidad es bastante simple de usar. Su uso más básico es de una de las dos siguientes formas:

prips IP-INICIO IP-FIN

prips RED/MÁSACARA

Es decir, que prips 192.168.0.0 192.168.0.255 y prips 192.168.0.0/24 producirán la misma salida:

192.168.0.0
192.168.0.1
192.168.0.2
192.168.0.3
192.168.0.4

# Salida Truncada...

192.168.0.251
192.168.0.252
192.168.0.253
192.168.0.254
192.168.0.255

A partir de aquí, prips añade varias opciones más independientemente de la forma de uso que hayas decidido utilizar. Aunque las opciones son un poco especiales, creo que las más útiles son:

-e: Excluye un rango de la salida.
-i: Establece un incremento para listar las ips solo en intervalos de ese incremento. Por ejemplo si se establece en 2, el comando listará una ip, omitirá la siguiente y así sucesivamente.
-c: Devuelve en notación CIDR el bloque de red más pequeño que incluye a las dos ips pasadas como parámetros.
-d: Por defecto, las ips aparecen separadas por un retorno de línea. Pero esta opción te permite cambiar el carácter que separa cada ip de la lista. El problema es que lo que espera la opción no es un carácter directamente sino el código decimal del símbolo ASCII que queremos utilizar. Por ejemplo para usar como separador “;” deberemos usar el código ASCII 59. Puedes consultar más ejemplos de caracteres ASCII aquí.

Ejemplos de uso

Se muestran aquí varios ejemplos de uso del comando prips.

# Listar todas las ips de la subred 192.168.0.32/29
prips 192.168.0.32/29

# Listar todas las ips de la subred 192.168.0.32/29 usando ";" como separador
prips -d 59 192.168.0.32/29

# Listar todas las ips de la subred 192.168.0.32/29 excluyendo la dirección de broadcast (192.168.0.39)
prips -e ...39 192.168.0.32/29

# Listar todas las ips de la subred 192.168.0.32/29 en incrementos de 2.
prips -i 2 192.168.0.32/29

# Indicar el bloque CIDR más pequeño que incluye a las ips 192.168.0.18 y 192.168.0.77
prips -c 192.168.0.18 192.168.0.77

En la siguiente imagen se puede observar la salida de todos los comandos anteriores:

Enlaces de interés:

Da color a tus scripts en Bash

2021-08-29T18:30:00+02:00

Da color a tus scripts en bash

Aunque pueda parecer algo sin importancia y solo un adorno, a veces, viene muy bien poder dar color la salida de tus scripts en bash. De hecho, pienso que si no se hace más es porque no todo el mundo sabe lo sencillo que es. Y ciertamente, para scripts donde la salida no es de muchas líneas no tiene demasiado sentido, pero hay montones de ocasiones donde esperamos un salida de bastantes lineas y marcar por colores las ocurrencias más interesantes es algo muy útil.

El uso de colores en bash es tan sencillo como añadir unos códigos de secuencias de escape antes de la salida que se quiera mostrar por la salida estándar. Eso sí, después no se puede olvidar dejar el formato como estaba antes. Así que lo mejor es empezar por el principio.

Secuencias de formato

Los secuencias de formato serán del tipo <Esc>[Codigo de Formatom

Secuencias de escape

La secuencia de escape puede expresarse de alguna de las siguientes formas:

\e
\033
\x1B

En realidad, no importa cual de estas secuencias usemos para \<Esc>. Personalmente suelo usar \033 o \e, pero puedes usar la que prefieras.

Código de Formato

Aquí esta la gracia del asunto: el código de formato. Puede ser un código de color y pueden definir colores tanto para la fuente como para el fondo. O un código de estilo de la fuente. Y como puedes imaginarte estos códigos pueden usarse conjuntamente separando cada uno de ellos por ;.

Códigos de estilo

Aquí algunos ejemplos de códigos de formato solo con estilos:

Negrita: \e[1m
Subrayado: \e[4m
Parpadeo: \e[5m

Códigos de color de fuente

Y aquí más ejemplos de códigos de estilo solo para el color de la fuente:

Color por defecto: \e[39m
Rojo: \e[31m
Verde: \e[32m
Amarillo: \e[33m
Azul: \e[34m

Códigos de color de fondo

Y códigos de color de fondo:

Rojo: \e[41m
Verde: \e[42m
Amarillo: \e[43m
Azul: \e[44m

Códigos combinados

Negrita + Texto amarillo + Fondo azul: \e[1;33;44m
Texto rojo + Fondo azul: \e;31;44m

Códigos de reset

Existen códigos específicos para hacer un reset del formato del texto. Hay que usarlos para dejar el formato como estaba. El formato no se restablece al terminar el comando, tenemos que hacerlo manualmente.

Reset de todo el formato: \e[0m
Reset de negrita: \e[21
Reset del color de fuente: \e[39m
Reset del color de fondo: \e[49m

Se pueden combinar los códigos de color y existen muchos más códigos de formato de cualquiera de los anteriores tipos. Como ejemplo os dejo este enlace donde podéis consultar muchos más.

Uso de los códigos de formato

Los códigos de formato puedes usarlos con “echo -e” o “printf”. Aquí te dejo unos ejemplos:

echo -e "\e[;31mError: Revisa esto\e[0m"
echo -e "\e[4;30;43mSoy la Abeja Maya\e[0m"
printf "\e[;31mError: Revisa esto\e[0m\n"

Y este es el resultado:

Por último, para usar estos códigos de manera más cómoda en tus scripts puedes definir variables al comienzo de los mismos con los formatos ya preestablecidos. A continuación tienes un pequeño script que en función de si el número de segundos de la hora actual es par o no muestra el texto en un formato u otro.

#!/bin/bash

ROJO="\e[;31m"
CELESTE="\e[;36m"
NOCOLOR="\e[0m"

SEGUNDOS=""

for i in {1..5}; do
    SEGUNDOS=$(date +%S)
    if (( $SEGUNDOS % 2 )); then
        echo -e "${CELESTE}$SEGUNDOS es número PAR"
    else
        echo -e "${ROJO}$SEGUNDOS es número IMPAR"
    fi
    sleep 3
done

En la siguiente imagen se puede ver la salida de la ejecución del script anterior:

¡Abierto por vacaciones! Arranca noroute2host.com

2021-08-27T22:30:00+02:00

Abierto por vacaciones

Coincidiendo con las vacaciones y pensando en que podía hacer para seguir aprendiendo, caí en la cuenta de un blog o página de artículos principalmente técnicos cumpliría las dos cosas fundamentales que tenía en la cabeza. Por un lado me permitiría descubrir nuevas tecnologías libres y por otro, compartirlas con todo aquel al que le parezcan interesantes.

Pero ¡oye! Estamos en 2021 y existe stackoverflow. Y muy bien que está, pero no todo es eso. Por un lado la puesta en marcha de este sitio me ha permitido aprender o afianzar tecnologías como python, pelican, jinja2, css, bootstrap, git, gitlab pages, Markdown y alguna que otra más. Además, y pese a que soy de los que casi siempre prefiere buscar la documentación en inglés puesto que después hace más fácil identificar lo que estás buscando, es cierto que el contenido en español en temas técnicos es menor y me apetecía hacer algo al respecto.

Evidentemente esto no tiene nada que ver con stackoverflow o UNIX Stack Exchange. Esto es simplemente un repositorio de información en la que aparecerá lo que me pique en cada momento, lo que me parezca interesante o simplemente lo que me apetezca. Para que nos vamos a engañar…

También reconozco que el proyecto tiene algo de nostalgia puesto que ya hubo un noroute2host.com de la mano de amigos que admiro y aprecio. Así que esto es como su reencarnación en pleno 2021. Si tienes curiosidad por ver como fue aquello siempre nos quedará la WayBack Machine de archive.org.

Así que esto arranca cargado de buenas intenciones, ganas de hablar de Linux, Software Libre, Cloud, DevOps y todo lo que surja. Arranca noroute2host.com

Por último, si quieres estar al tanto de lo que vaya apareciendo por aquí o incluso proponer algún tema puedes comenzar a seguirnos en nuestras redes sociales:

O simplemente suscribirte a nuestro RSS.

noroute2host.com

Arranque automático de contenedores con docker-compose y systemd

Iniciando tus contenedores automáticamente al inicio con docker compose y systemd

Fichero docker-compose.yml base para integrar con systemd

Unit File o fichero de unidad de systemd

Usando systemd para iniciar los contenedores definidos en el fichero docker-compose.yml

Último paso: Habilitar el servicio al arranque

Antes de acabar: Ficheros de ejemplo

Enlaces de interés:

Guía de Gluetun: VPN y Proxy para tus contenedores o para cualquier dispositivo o aplicación en tu red

Gluetun: Una navaja suiza de clientes VPN que incluye servidores de proxy

Gluetun como VPN para tus contenedores

Arrancando tu contenedor Gluetun

Hacer que un contenedor esté en el mismo namespace de red que otro

Probando el acceso VPN para otro contenedor

Como publicar puertos de tus contenedores mientras hacen uso de Gluetun

Gluetun como servidor proxy

Iniciando tu contenedor gluetun con servidor proxy incluido

Configurar otros dispositivos para que funcionen a través del proxy de Gluetun

Bonus Track: Algunas cositas más…

Ficheros docker-compose de ejemplo

Usar Gluetun para listar los servidores disponibles de tu proveedor VPN

Elige bien tu proveedor VPN para Gluetun

Enlaces de interés:

Bots en Telegram (II): Tu bot de Telegram con Bash

Bots en Telegram (II): Tu bot de Telegram con Bash

Curl

Tu bot de Telegram en Bash

Script de bot de Telegram para tu terminal

Especificación del fichero de configuración para el primer modo de funcionamiento

Ejemplos de funcionamiento del script

Código fuente del script de bot de Telegram para Bash

En el siguiente capitulo si lo hubiera…

Enlaces de interés:

Localización de aplicaciones Python con gettext

Acerca de gettext

Ficheros de gettext

Utilidades de gettext

Estructura de ficheros

Trabajando con getttext en Python

Usando GNU API gettext en Python

Usando la API basada en clases de gettext en Python

Trabajando con los ficheros de localización

Generando el fichero de platilla (.pot)

Creando los ficheros de traducción (.po) y localizando los textos

Compilando los ficheros .po para generar los ficheros binarios .mo

Estructura de ficheros de localización

Probando la aplicación localizada

Actualizando la localización

Incluir nuevos mensajes en la aplicación

Actualizando el fichero de platilla (.pot)

Regenerando los ficheros de localización (.po) a partir del nuevo fichero de plantilla (.pot)

ReCompilando los ficheros .po para ReGenerar los ficheros binarios .mo

Probando de nuevo la aplicación localizada con el nuevo texto.

Bonus Track: Buenas prácticas y recomendaciones personales

Definir las cadenas con nombres representativos, no con la traducción del idioma por defecto.

Unifica tus cadenas en un fichero

Añade los ficheros binarios (.mo) y el fichero de plantilla (.pot) a tu .gitignore

A localizar tus aplicaciones

Enlaces de interés:

Feliz en la Noche, mi primer juego en Python con PyGame para mi primera Game Jam

Feliz en la Noche

Historia de Feliz en la Noche (a.k.a Pang Nightfall)

Código fuente del juego

Desarrollando videojuegos con PyGame-ce

PyGame vs PyGame-ce

Enlaces de interés

Ordenación por número de versión en la terminal con sort y ls

Los comandos sort y ls

Ordenación de versiones con el comando sort usando la opción -V o --version-sort

Ordenación de versiones con el comando ls usando la opción -v

Enlaces de interés:

Aplicaciones libres para Android. Índice.

Aplicaciones Libres para Android

I. Etar - Calendario Open Source

Ficha de la App

II. AntennaPod

Ficha de la App

III. Aegis Authenticator

Ficha de la App

Ordenación de versiones con el comando sort usando la opción `-V` o `--version-sort`

Ordenación de versiones con el comando ls usando la opción `-v`