Merge pull request #96 from macagua/2025_upgrades

2025 upgrades

Author: macagua

recursos/leccion2/sqlacodegen/sistema/main.py

@@ -93,6 +93,9 @@ def consulta_pedidos():
     try:
         # Crea la base de datos y tablas
         Base.metadata.create_all(engine)
+        logging.info(
+            f"✅ ¡Creación exitosa de las tablas en la base de datos '{DB_FILE}'!\n"
+        )
         # Consulta de productos
         consulta_estados()
         # Consulta de ciudades

recursos/leccion2/sqlacodegen/sistema/requirements.txt

@@ -1,7 +1,7 @@
-# Install the sqlacodegen v3.0.0rc1 from github repo.
-# -e git+https://github.com/agronholm/[email protected]#egg=sqlacodegen
-
 # Install the packages from PyPi repository.
-SQLAlchemy>=2.0.23
-sqlacodegen==3.0.0
+SQLAlchemy>=2.0.23 # For the last test date, version SQLAlchemy==2.0.38 was used.
 python-dotenv==1.0.1
+
+sqlacodegen==3.0.0
+# Install the sqlacodegen v3.0.0rc1 from github repo.
+# -e git+https://github.com/agronholm/[email protected]#egg=sqlacodegen

…ccion2/sqlalchemy/productos/.env.example …leccion2/sqlalchemy/sistema/.env.examplerecursos/leccion2/sqlalchemy/productos/.env.example renamed to recursos/leccion2/sqlalchemy/sistema/.env.example recursos/leccion2/sqlalchemy/productos/.env.example renamed to recursos/leccion2/sqlalchemy/sistema/.env.example

@@ -1,2 +1,2 @@
 ### SQLite #############################
-DB=productos.sqlite3
+DB=sistema.db

…eccion2/sqlalchemy/productos/__init__.py …/leccion2/sqlalchemy/sistema/__init__.pyrecursos/leccion2/sqlalchemy/productos/__init__.py renamed to recursos/leccion2/sqlalchemy/sistema/__init__.py recursos/leccion2/sqlalchemy/productos/__init__.py renamed to recursos/leccion2/sqlalchemy/sistema/__init__.py

@@ -88,7 +88,7 @@ def consultar_nombre_unico():
     print("\n✅ ¡Consulta del único producto!")
     # SELECT * FROM productos WHERE categoria == "Lácteos"
     producto = session.query(Productos).filter_by(categoria="Líquidos").one()
-    if len(producto) == 0:
+    if not producto:
         logging.error(
             "❌ ERROR: ¡No hay ningún Producto de la categoria 'Líquidos' en la base de datos!"
         )
@@ -157,7 +157,9 @@ def eliminar_data(producto_id):
         Base.metadata.drop_all(engine)
         # Crea la base de datos y tablas
         Base.metadata.create_all(engine)
-        logging.info(f"✅ ¡Creación exitosa de la tabla 'productos'!\n")
+        logging.info(
+            f"✅ ¡Creación exitosa de la tabla 'productos' en la base de datos '{DB_FILE}'!\n"
+        )
         ingresar_data()
         consultar_data()
         consultar_id_data(1)

…os/leccion2/sqlalchemy/productos/main.py …rsos/leccion2/sqlalchemy/sistema/main.pyrecursos/leccion2/sqlalchemy/productos/main.py renamed to recursos/leccion2/sqlalchemy/sistema/main.py recursos/leccion2/sqlalchemy/productos/main.py renamed to recursos/leccion2/sqlalchemy/sistema/main.py

@@ -9,7 +9,7 @@
 load_dotenv()
 
 DB_PATH = os.path.dirname(os.path.abspath(__file__)) + os.sep
-DB_FILE = os.getenv("DB", "productos.sqlite3")
+DB_FILE = os.getenv("DB", "sistema.db")
 
 engine = None
 

…/leccion2/sqlalchemy/productos/models.py …os/leccion2/sqlalchemy/sistema/models.pyrecursos/leccion2/sqlalchemy/productos/models.py renamed to recursos/leccion2/sqlalchemy/sistema/models.py recursos/leccion2/sqlalchemy/productos/models.py renamed to recursos/leccion2/sqlalchemy/sistema/models.py

@@ -18,7 +18,7 @@ versión de :ref:`SQLAlchemy <python_sqlalchemy_modelos>`).
 Características
 ---------------
 
-- Soporta ``SQLAlchemy`` 0.8.x - 1.4.x.
+- Soporta :ref:`SQLAlchemy <python_sqlalchemy>` 0.8.x - 1.4.x.
 
 - Produce código declarativo que casi parece escrito a mano.
 
@@ -43,15 +43,15 @@ a continuación se presentan el correspondiente comando de tu sistema operativo:
 
       .. code-block:: console
 
-          pip3 install sqlacodegen==3.0.0
+          pip3 install sqlacodegen
 ..
   pip3 install git+https://github.com/agronholm/[email protected]#egg=sqlacodegen
 
    .. group-tab:: Windows
 
       .. code-block:: console
 
-          pip3 install sqlacodegen==3.0.0
+          pip3 install sqlacodegen
 
 
 Puede probar si la instalación se realizo correctamente, ejecutando el siguiente
@@ -75,6 +75,36 @@ comando correspondiente a tu sistema operativo:
 Si muestra el nombre del paquete como ``sqlacodegen``, tiene correctamente instalada
 la librería. Con esto, ya tiene todo listo para continuar.
 
+
+----
+
+
+Estructura de archivos
+^^^^^^^^^^^^^^^^^^^^^^
+
+Para crear la estructura de archivos del proyecto ``sqlacodegen`` debe ejecutar los siguientes comandos:
+
+Crear el directorio ``~/proyectos/sqlacodegen/sistema`` con el siguiente comando:
+
+.. code-block:: console
+
+    mkdir -p ~/proyectos/sqlacodegen/sistema && cd $_
+
+
+El comando anterior crea la siguiente estructura de directorios:
+
+.. code-block:: console
+    :class: no-copy
+
+    proyectos/
+    └── sqlacodegen/
+        └── sistema/
+
+Si tiene la estructura de archivo previa, entonces puede continuar con la siguiente sección.
+
+
+----
+
 .. _python_sqlacodegen_uso:
 
 Conexión al Engine
@@ -310,20 +340,21 @@ una mejor representación de los objetos.
 Práctica - Caso real
 --------------------
 
-A continuación se presenta una práctica más real de implementar el uso de ``sqlacodegen``
-en proyectos con ``SQLAlchemy``, a continuación la estructura de proyecto llamado ``sistema``:
+A continuación se presenta una práctica más real de implementar el uso de proyectos
+con ``sqlacodegen``, a continuación la estructura de proyecto llamado ``sistema``:
 
 .. code-block:: console
     :class: no-copy
 
-    sistema/
-    ├── .env.example
-    ├── __init__.py
-    ├── main.py
-    ├── models.py
-    ├── requirements.txt
-    ├── settings.py
-    └── sistema.db
+    proyectos/
+    └── sqlacodegen/
+        └── sistema/
+            ├── .env.example
+            ├── __init__.py
+            ├── main.py
+            ├── models.py
+            ├── requirements.txt
+            └── settings.py
 
 A continuación se presenta y explica el uso de cada archivo para este proyecto:
 
@@ -361,7 +392,7 @@ Módulo principal del programa.
 .. literalinclude:: ../../recursos/leccion2/sqlacodegen/sistema/main.py
     :language: python
     :linenos:
-    :lines: 1-117
+    :lines: 1-120
 
 *Archivo* :file:`requirements.txt`
 
@@ -370,13 +401,7 @@ Archivo de `requirements.txt`_ de la herramienta de gestión de paquetes `pip`_.
 .. literalinclude:: ../../recursos/leccion2/sqlacodegen/sistema/requirements.txt
     :language: python
     :linenos:
-    :lines: 1-7
-
-*Archivo* :file:`sistema.db`
-
-Archivo de base de datos de :ref:`SQLite <python_modulo_sqlite3>` llamado :file:`sistema.db`
-la cual se incluye ya que cada tiene la estructura de tablas y registros iniciales para hacer
-esta práctica.
+    :lines: 1-3,5
 
 
 Teniendo creada la anterior estructura de proyecto, vuelva a ejecutar ahora el módulo con
@@ -422,6 +447,8 @@ sistema operativo:
       .. code-block:: console
           :class: no-copy
 
+          INFO:root:✅ ¡Creación exitosa de las tablas en la base de datos 'sistema.db'!
+
           ✅ Lista de 10 Estados
           📜 Estado: Amazonas
           📜 Estado: Anzoátegui
@@ -463,6 +490,29 @@ sistema operativo:
 
           INFO:root:✅ ¡La conexión SQLite a la base de datos 'sistema.db' fue cerrada!
 
+      La ejecucion anterior generar la siguiente estructura:
+
+      .. code-block:: console
+          :class: no-copy
+
+          proyectos/
+          └── sqlacodegen/
+              └── sistema/
+                  ├── __init__.py
+                  ├── .env
+                  ├── .env.example
+                  ├── main.py
+                  ├── models.py
+                  ├── requirements.txt
+                  ├── settings.py
+                  └── sistema.db
+
+      *Archivo* :file:`sistema.db`
+
+      Archivo de base de datos de :ref:`SQLite <python_modulo_sqlite3>` llamado :file:`sistema.db`
+      la cual no se incluye ya que cada vez que se inicia el programa :file:`main.py` se elimina y crea
+      nuevamente, para cuidar la creación de los datos iniciales.
+
    .. group-tab:: Windows
 
       Antes de ejecutar debes instalar sus dependencias, con el siguiente comando:
@@ -506,6 +556,8 @@ sistema operativo:
       .. code-block:: console
           :class: no-copy
 
+          INFO:root:✅ ¡Creación exitosa de las tablas en la base de datos 'sistema.db'!
+
           ✅ Lista de 10 Estados
           📜 Estado: Amazonas
           📜 Estado: Anzoátegui
@@ -547,10 +599,33 @@ sistema operativo:
 
           INFO:root:✅ ¡La conexión SQLite a la base de datos 'sistema.db' fue cerrada!
 
+      La ejecucion anterior generar la siguiente estructura:
+
+      .. code-block:: console
+          :class: no-copy
+
+          proyectos/
+          └── sqlacodegen/
+              └── sistema/
+                  ├── __init__.py
+                  ├── .env
+                  ├── .env.example
+                  ├── main.py
+                  ├── models.py
+                  ├── requirements.txt
+                  ├── settings.py
+                  └── sistema.db
+
+      *Archivo* :file:`sistema.db`
+
+      Archivo de base de datos de :ref:`SQLite <python_modulo_sqlite3>` llamado :file:`sistema.db`
+      la cual no se incluye ya que cada vez que se inicia el programa :file:`main.py` se elimina y crea
+      nuevamente, para cuidar la creación de los datos iniciales.
+
 
 Asi de esta forma puede usar ``sqlacodegen`` para generar modelos ``SQLAlchemy`` desde
-una base de datos existente e implementar las operaciones ingresar, consultar,
-actualizar y eliminar registro en las tablas.
+una base de datos existente e implementar las operaciones ingresar, consultar, actualizar
+y eliminar registro en las tablas.
 
 
 ----