Cómo Instalar y Usar un Paquete en Django Framework

4 minuto(s)

En esta página:

Cuando estás empezando a crear tu primer proyecto con el framework Django, en ocasiones necesitas instalar un paquete.

Para instalar un paquete en Django debes realizar ciertos pasos necesarios para que todo funcione correctamente.

En este tutorial te enseñaré a cómo instalar y usar un paquete en Django Framework, vamos con ello.

Instalando un paquete en Django Framework — En Django Framework podemos instalar miles de paquetes

Podemos dar por hecho que si ya creaste un proyecto con Django, entonces ya tienes instalado el gestor de paquetes PIP y Python.

Ya que es necesario tenerlos instalados para poder trabajar con Django, esto lo explicamos en este video.

Instalación de un Paquete en Django Framework

Para este ejemplo instalaremos el paquete random-generator (este paquete nos permite generar números aleatorios).

Abrimos nuestra terminal o consola de comandos en el directorio principal de nuestro proyecto Django y ejecutamos el siguiente comando:


pip install random-generator

Collecting random-generator
  Obtaining dependency information for random-generator from https://files.pythonhosted.org/packages/fb/49/70b5fdc4f16997e9ad8a458bacbf78e2a9957bba9d080f51db657a5b78ad/random_generator-1.0.0-py3-none-any.whl.metadata
  Downloading random_generator-1.0.0-py3-none-any.whl.metadata (1.3 kB)
Downloading random_generator-1.0.0-py3-none-any.whl (5.4 kB)
Installing collected packages: random-generator
Successfully installed random-generator-1.0.0

[notice] A new release of pip is available: 23.2.1 -> 24.2
[notice] To update, run: python.exe -m pip install --upgrade pip
(mientornovirtual)

pip install random-generator

Collecting random-generator

Obtaining dependency information for random-generator from https://files.pythonhosted.org/packages/fb/49/70b5fdc4f16997e9ad8a458bacbf78e2a9957bba9d080f51db657a5b78ad/random_generator-1.0.0-py3-none-any.whl.metadata

Downloading random_generator-1.0.0-py3-none-any.whl.metadata (1.3 kB)

Downloading random_generator-1.0.0-py3-none-any.whl (5.4 kB)

Installing collected packages: random-generator

Successfully installed random-generator-1.0.0

[notice] A new release of pip is available: 23.2.1 -> 24.2

[notice] To update, run: python.exe -m pip install --upgrade pip

(mientornovirtual)

Luego de ejecutar el comando anterior ya tenemos instalado nuestro paquete en Django Framework.

Configuración del Paquete Instalado en Django Framework

Pero para poder usarlo debemos instanciarlo en el archivo settings.py de nuestro proyecto.

El archivo settings.py se encuentra en miproyectodjango > miproyectodjango > settings.py:


/miproyectodjango
    ├── /miproyectodjango        
            ├── __init__.py 
            ├── asgi.py 
            ├── settings.py // Abre este archivo 
            ├── urls.py 
            ├── wsgi.py   
    ├── /numeros      
    ├── db.sqlite3
    ├── manage.py

/miproyectodjango

├── /miproyectodjango

├── __init__.py

├── asgi.py

├── settings.py // Abre este archivo

├── urls.py

├── wsgi.py

├── /numeros

├── db.sqlite3

├── manage.py

En el archivo settings.py nos dirigimos a la sección INSTALLED_APPS y colocamos el nombre de nuestro paquete instalado:


INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',  
    'random_generator', # Colocamos el nombre del paquete que instalamos
]

INSTALLED_APPS = [

'django.contrib.admin',

'django.contrib.auth',

'django.contrib.contenttypes',

'django.contrib.sessions',

'django.contrib.messages',

'django.contrib.staticfiles',

'random_generator', # Colocamos el nombre del paquete que instalamos

]

Investiga bien el nombre de tu paquete, a veces colocar el nombre equivocado hará que no te funcione.

Con ello ya tenemos todo listo para usar nuestro paquete.

Usando el Paquete Instalado en Django Framework

Para verificar que nuestro paquete se ha instalado correctamente, vamos a usarlo.

Crearé un app llamada numeros para usar el paquete que instalé.

Ejecuto el siguiente comando para crearla:


# Comando para crear un app en Django Framework
python manage.py startapp numeros

# Comando para crear un app en Django Framework

python manage.py startapp numeros

Luego de ejecutar el comando anterior se nos ha creado un directorio llamado numeros.

Dentro del directorio numeros creamos un directorio con el nombre templates y dentro de él un archivo llamado index.html:


/miproyectodjango
    ├── /miproyectodjango   
    ├── /numeros
        ├── /migrations
        ├── /templates
            ├── index.html // Creo este archivo
        ├── __init__.py
        ├── admin.py
        ├── apps.py
        ├── models.py
        ├── test.py    
        ├── views.py    
    ├── db.sqlite3
    ├── manage.py

/miproyectodjango

├── /miproyectodjango

├── /numeros

├── /migrations

├── /templates

├── index.html // Creo este archivo

├── __init__.py

├── admin.py

├── apps.py

├── models.py

├── test.py

├── views.py

├── db.sqlite3

├── manage.py

En el archivo index.html llamo a la variable numero la cual crearé más adelante:


<div class="numeros">
    <h5>Número aleatorio:</h5> 
    {{ numero }}             
</div>

<h5>Número aleatorio:</h5>

</div>

Ahora abrimos el archivo views.py que se encuentra dentro del directorio numeros:


/miproyectodjango
    ├── /miproyectodjango   
    ├── /numeros
        ├── /migrations
        ├── /templates
            ├── index.html 
        ├── __init__.py
        ├── admin.py
        ├── apps.py
        ├── models.py
        ├── test.py    
        ├── views.py // Abro este archivo
    ├── db.sqlite3
    ├── manage.py

/miproyectodjango

├── /miproyectodjango

├── /numeros

├── /migrations

├── /templates

├── index.html

├── __init__.py

├── admin.py

├── apps.py

├── models.py

├── test.py

├── views.py // Abro este archivo

├── db.sqlite3

├── manage.py

En el archivo views.py importamos nuestro paquete que instalamos anteriormente y lo enviamos a la vista (index.html):


from django.shortcuts import render

import random_generator

# Create your views here.
def index(request):
    generar_numero_aleatorio = random_generator.number(15) # Usamos el paquete instalado
    numero_aleatorio = {'numero': generar_numero_aleatorio}
    return render(request, 'index.html', context=numero_aleatorio,)

from django.shortcuts import render

import random_generator

# Create your views here.

def index(request):

generar_numero_aleatorio = random_generator.number(15) # Usamos el paquete instalado

numero_aleatorio = {'numero': generar_numero_aleatorio}

return render(request, 'index.html', context=numero_aleatorio,)

Definimos una url nueva para nuestra vista en el archivo urls.py que se encuentra en miproyectodjango > urls.py:


/miproyectodjango
    ├── /miproyectodjango        
            ├── __init__.py 
            ├── asgi.py 
            ├── settings.py 
            ├── urls.py // Abre este archivo 
            ├── wsgi.py   
    ├── /numeros      
    ├── db.sqlite3
    ├── manage.py

/miproyectodjango

├── /miproyectodjango

├── __init__.py

├── asgi.py

├── settings.py

├── urls.py // Abre este archivo

├── wsgi.py

├── /numeros

├── db.sqlite3

├── manage.py

Abrimos el archivo urls.py y agregamos la nueva url:


from django.contrib import admin
from django.urls import path
from numeros import views

urlpatterns = [
    path('admin/', admin.site.urls),

    path('', views.index, name='home'),  
    path('numeros/', views.index, name = "numeros"), # Nueva URL 
]

from django.contrib import admin

from django.urls import path

from numeros import views

urlpatterns = [

path('admin/', admin.site.urls),

path('', views.index, name='home'),

path('numeros/', views.index, name = "numeros"), # Nueva URL

]

Estoy en mi servidor de desarrollo local de Django Framework (PC).

Arrancamos el servidor con el siguiente comando:


python manage.py runserver

Watching for file changes with StatReloader
[30/Jul/2024 13:05:22] "GET / HTTP/1.1" 200 5829
[30/Jul/2024 13:05:22] "GET /static/css/estilos.css HTTP/1.1" 404 1804
[30/Jul/2024 13:05:26] "GET /numeros HTTP/1.1" 301 0
[30/Jul/2024 13:05:26] "GET /numeros/ HTTP/1.1" 200 5829
[30/Jul/2024 13:05:26] "GET /static/css/estilos.css HTTP/1.1" 404 1804