Diferencias

Muestra las diferencias entre dos versiones de la página.

--- python:instalable [2025/07/15 12:55] – [Local en otro equipo] alberto
+++ python:instalable [2025/07/16 12:05] (actual) – [main.py] alberto
@@ Línea 36: / Línea 36: @@
 ==== main.py ====
 Es el punto de entrada al paquete cuando lo ejecutas desde consola. \\
-Es donde se define la interfaz de línea de comandos (CLI): qué comandos, opciones y argumentos puede introducir el usuario, incluidos los //--help//. \\
+Es donde se define la interfaz de línea de comandos (CLI, //Command Line Interface//): qué comandos, opciones y argumentos puede introducir el usuario, incluidos los //--help//. En ocasiones el archivo donde se encuentra la función main() también suele llamarse cli.py\\
 Utiliza la biblioteca **argparse** para leer argumentos desde línea de comandos. \\
 En main.py se puede:
@@ Línea 46: / Línea 46: @@
 \\
 En definitiva, realiza el flujo del programa.\\
+Cuando añadimos parámetros con add_argument, tenemos las siguientes opciones:
+^ Parámetro             ^ Descripción                                                                                     ^ Ejemplo                                              ^
+| `name or flags`       | Nombre del argumento (posicional o con guiones).                                                | `'--verbose'`, `'-v'`, `'archivo'`                   |
+| `action`              | Qué hacer con el argumento al encontrarlo (ver tabla de abajo).                                | `'store'`, `'store_true'`, `'append'`, etc.          |
+| `nargs`               | Número de valores esperados (`?`, `*`, `+`, número entero, etc).                                | `nargs='?'`, `nargs=2`                               |
+| `const`               | Valor constante usado cuando se emplea con ciertas acciones como `store_const`.                 | `const=42`                                           |
+| `default`             | Valor por defecto si no se proporciona el argumento.                                            | `default='salida.txt'`                               |
+| `type`                | Tipo de dato al que convertir el argumento.                                                     | `type=int`, `type=float`, `type=Path`                |
+| `choices`             | Lista de valores permitidos.                                                                    | `choices=['bajo', 'medio', 'alto']`                  |
+| `required`            | Si el argumento es obligatorio (solo para argumentos opcionales).                              | `required=True`                                      |
+| `help`                | Texto de ayuda mostrado al ejecutar `--help`.                                                   | `help='Archivo de entrada.'`                         |
+| `metavar`             | Nombre que aparece en la ayuda en lugar del nombre real del argumento.                         | `metavar='FICHERO'`                                  |
+| `dest`                | Nombre del atributo en `args` donde se guarda el valor.                                         | `dest='nivel'`                                       |
+Para el parámetro "action" disponemos e estas posibilidades:
+^ Acción           ^ Descripción                                                                                   ^ Ejemplo de uso                                     ^
+| `'store'`        | Guarda el valor dado (por defecto).                                                           | `--salida salida.txt`                              |
+| `'store_const'`  | Guarda un valor constante (requiere `const=`).                                                | `--modo`, `action='store_const', const='debug'`    |
+| `'store_true'`   | Guarda `True` si se especifica, `False` si no.                                                | `--verbose`, `action='store_true'`                 |
+| `'store_false'`  | Guarda `False` si se especifica, `True` si no.                                                | `--no-cache`, `action='store_false'`               |
+| `'append'`       | Añade cada valor a una lista.                                                                | `--tag urgente --tag personal` → `['urgente',...]` |
+| `'append_const'` | Añade un valor constante a una lista (requiere `const=`).                                     | (menos común)                                       |
+| `'count'`        | Cuenta cuántas veces aparece el argumento.                                                   | `-v -v -v` → `3`                                    |
+| `'help'`         | Muestra el mensaje de ayuda y termina. (automática con `--help`)                             | `--help`                                            |
+| `'version'`      | Muestra el número de versión y termina. (requiere `version=`)                                | `--version`                                         |
 A continuación un ejemplo, en el que se define el comando "gendocs" y 3 subcomandos "simples", "compuestos" y "cruce", cada uno con sus parámetros de entrada:
@@ Línea 220: / Línea 247: @@
 </code>
+El bloque entry_points["console_scripts"] de setup.py sirve para registrar comandos de terminal que apuntan a funciones Python:
+<code toml>
+"console_scripts": [
+    "mi_comando = paquete.modulo:funcion_que_se_ejecuta"
+]
+</code>
+mi_comando → nombre que escribirás en la terminal. \\
+paquete.modulo → ruta al módulo dentro del paquete. \\
+funcion_que_se_ejecuta → debe ser una función sin argumentos (o que gestione sys.argv) que actuarán como el “main()” del comando. \\
+\\
+Si se desea cambiar el comando para ejecutar un programa, es suficiente con indicarlo en "console_scripts" y cambiar el campo "mi_comando". A continuación **es necesario reinstalar** con "pip install -e .", por ejemplo.
 ==== readme.md ====
 Es un archivo de texto (usualmente en formato Markdown, de ahí la extensión .md) que explica de qué trata el proyecto. \\
@@ Línea 295: / Línea 335: @@
 ==== Desde GitHub ====
+Puedes instalar tu paquete desde cualquier máquina con:
+<code bash>
+pip install git+https://github.com/usuario/repositorio.git
+</code>
+O para una versión específica:
+<code bash>
+# Esto instalará la versión exactamente como estaba en el tag v1.0.0.
+pip install git+https://github.com/usuario/repositorio.git@v1.0.0
+</code>
+Desde GitHub, el programa se instala en modo no editable. \\
+Cada vez que se realice una mejora, corrección o cambio relevante, se hace un //commit// con un mensaje descriptivo. \\
+Al completar un conjunto de cambios estables (por ejemplo, una versión funcional completa), se hace un release/tag con un número de versión:
+<code bash>
+git tag v1.0.0
+git push origin v1.0.0
+# Ahora en GitHub aparece ese tag como versión 1.0.0. Puedes descargar ese estado exacto o instalar desde ahí.
+</code>
+Y para actualizar a la nueva versión (por ejemplo la v1.1.0):
+<code bash>
+pip install --upgrade git+https://github.com/usuario/repositorio.git@v1.1.0
+</code>