63 lines
2.4 KiB
ReStructuredText
63 lines
2.4 KiB
ReStructuredText
Introducción
|
|
============
|
|
|
|
¿Qué es Tiempo?
|
|
---------------
|
|
|
|
Tiempo es una herramienta de línea de comandos para rastrear el tiempo. Te ayuda a grabar
|
|
el tiempo empleado en diferentes actividades y de manera opcional te permite organizarlas
|
|
en proyectos o `sheets` (hojas). Tiempo es compatible con `Timetrap`_, su predecesor.
|
|
|
|
¿Por qué otro rastreador de tiempo en lugar de mejorar Timetrap?
|
|
|
|
* Timetrap es `difícil de instalar`_, difícil de mantenerlo `actualizado`_ (debido a Ruby).
|
|
Con Tiempo puedes obtener o compilar un binario, ponerlo donde sea y simplemente funcionará
|
|
en la máquina. Estoy embebiendo SQLite.
|
|
* Timetrap es lento (no hay modo de sacarle la vuelta, es por Ruby), algunos comandos
|
|
tardan hasta un segundo. Tiempo siempre se siente rápido.
|
|
* Timetrap necesitaba una refactorización mayor para arreglar un problema con el huso
|
|
horario (en un lenguaje en el que no soy experto). Estaba al tanto de este problema
|
|
y diseñé Tiempo para guardar marcas de tiempo en UTC así como es posible
|
|
trabajar con la base de datos hecha por Timetrap sin estropearla. Y muchas pruebas
|
|
se han realizado que respaldan esta afirmación.
|
|
|
|
Tiempo tiene otras ventajas:
|
|
|
|
* Arreglé algunas inconsistencias en el input.
|
|
* Resolví algunas incidencias antiguas de Timetrap.
|
|
* Las columnas del output están siempre alineadas.
|
|
* La interfaz de línea de comandos es más fácil de descubrir (pregunta ``-h`` para cualquier subcomando).
|
|
* Los tiempos de conclusión se imprimen con un +1d para indicar que la actividad acabó al siguiente
|
|
día.
|
|
|
|
Instalación
|
|
-----------
|
|
|
|
Si tienes instaladas las herramientas de `Rust`_, solo ejecuta:
|
|
|
|
.. code:: bash
|
|
|
|
cargo install tiempo
|
|
|
|
Si usas Arch Linux, instala el paquete `tiempo-git` desde `AUR`_, por ejemplo:
|
|
|
|
.. code:: bash
|
|
|
|
git clone https://aur.archlinux.org/tiempo-git.git && cd tiempo-git && makepkg -si
|
|
|
|
.. NOTE::
|
|
Requieres tener instalado `Rust`_ y `Cargo`_. Para más información haz `clic aquí`_.
|
|
|
|
Inicio rápido
|
|
-------------
|
|
|
|
TODO
|
|
|
|
.. _Timetrap: https://github.com/samg/timetrap/
|
|
.. _difícil de instalar: https://github.com/samg/timetrap/issues/176
|
|
.. _actualizado: https://github.com/samg/timetrap/issues/174
|
|
.. _clic aquí: https://doc.rust-lang.org/cargo/getting-started/installation.html
|
|
.. _Rust: https://rust-lang.org
|
|
.. _Cargo: https://doc.rust-lang.org/book/ch01-03-hello-cargo.html
|
|
.. _AUR: https://aur.archlinux.org/packages/tiempo-git/
|