Merge pull request #32 from django-ve/2025_upgrades

Upgraded to Django 5.1.6 version

Author: macagua

.github/workflows/django.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       max-parallel: 4
       matrix:
-        python-version: [3.7, 3.8, 3.9]
+        python-version: [ "3.10", "3.11", "3.12" ]
 
     steps:
     - uses: actions/checkout@v3

.gitignore

@@ -7,5 +7,6 @@
 *.pyo
 build/
 dist/
-helloworld.db
+*.db
+*.sqlite3
 local_settings.py

Dockerfile

@@ -1,20 +1,18 @@
 # Use an official Python runtime as a parent image
-FROM python:3.6
+FROM python:3.11
 
 # Set the working directory to /app
 WORKDIR /app
 
 # Copy the current directory contents into the container at /app
 COPY . /app
 
-CMD ["apt","install","python3-dev","python3-pip","python3-virtualenv","sqlitebrowser"]
-# Install any needed packages specified in requirements.txt
-RUN pip install -r requirements.txt
+# Install necessary packages and any needed packages specified in requirements.txt
+RUN apt-get update && apt-get install -y python3-dev python3-pip && pip install -r requirements.txt
 
 # Make port 8000 available to the world outside this container
 EXPOSE 8000
 
-CMD ["python3","manage.py","migrate"]
-# Run app.py when the container launches
-CMD ["python3", "manage.py","runserver","0.0.0.0:8000"]
+# Run migrations and then start the server
+CMD ["sh", "-c", "python3 manage.py migrate && python3 manage.py runserver 0.0.0.0:8000"]
 

README.rst

@@ -14,22 +14,28 @@ the following command:
 
 ::
 
-  $ sudo apt update
+  $ sudo apt update && sudo apt upgrade
 
 Install necessary minimum dependencies, with the following command:
 
 ::
 
-  $ sudo apt install python3-dev python3-pip python3-virtualenv sqlitebrowser
+  $ sudo apt install python3-dev python3-pip python3-virtualenv
 
 For run this example need to install Django framework
 executing the follow command:
 
 ::
 
-    $ sudo pip install -r requirements.txt
+    $ sudo pip3 install -r requirements.txt
+
+And later to test the Django Installation is done with the following command:
+
+::
+
+    $ python -m django --version
+    5.1.6
 
-And later followed by:
 
 ::
 
@@ -40,9 +46,8 @@ At which point you should see:
 ::
 
     Operations to perform:
-      Apply all migrations: admin, auth, contenttypes, sessions, sites
+      Apply all migrations: admin, auth, contenttypes, sessions
     Running migrations:
-
       Applying contenttypes.0001_initial... OK
       Applying auth.0001_initial... OK
       Applying admin.0001_initial... OK
@@ -57,9 +62,10 @@ At which point you should see:
       Applying auth.0007_alter_validators_add_error_messages... OK
       Applying auth.0008_alter_user_username_max_length... OK
       Applying auth.0009_alter_user_last_name_max_length... OK
+      Applying auth.0010_alter_group_name_max_length... OK
+      Applying auth.0011_update_proxy_permissions... OK
+      Applying auth.0012_alter_user_first_name_max_length... OK
       Applying sessions.0001_initial... OK
-      Applying sites.0001_initial... OK
-      Applying sites.0002_alter_domain_unique... OK
 
 
 For use the Django Admin Interface, it's needed to create a superuser 
@@ -108,14 +114,26 @@ the *Django Admin Interface* like this:
 Building with docker
 ====================
 
+Building image with the following command:
+
 ::
 
     $ docker build --tag=helloworld .
 
+
+Running the container with the following command:
+
 ::
 
     $ docker run -p 4000:8000 helloworld 
 
+
+Requesting the URL http://localhost:4000 with the following command:
+
 ::
 
-    $ curl localhost:4000
+    $ curl localhost:4000
+
+
+Also you can request the URL http://localhost:4000 in your web browser
+you can see the hello world example.

docs/django_admin_interface_running.png

@@ -0,0 +1,16 @@
+"""
+ASGI config for helloworld project.
+
+It exposes the ASGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.1/howto/deployment/asgi/
+"""
+
+import os
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'helloworld.settings')
+
+application = get_asgi_application()

docs/django_helloword.png

@@ -1,26 +1,26 @@
 """
 Django settings for helloworld project.
 
-Generated by 'django-admin startproject' using Django 2.2.3.
+Generated by 'django-admin startproject' using Django 5.1.6.
 
 For more information on this file, see
-https://docs.djangoproject.com/en/2.2/topics/settings/
+https://docs.djangoproject.com/en/5.1/topics/settings/
 
 For the full list of settings and their values, see
-https://docs.djangoproject.com/en/2.2/ref/settings/
+https://docs.djangoproject.com/en/5.1/ref/settings/
 """
 
-import os
+from pathlib import Path
 
-# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
-BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+# Build paths inside the project like this: BASE_DIR / 'subdir'.
+BASE_DIR = Path(__file__).resolve().parent.parent
 
 
 # Quick-start development settings - unsuitable for production
-# See https://docs.djangoproject.com/en/2.2/howto/deployment/checklist/
+# See https://docs.djangoproject.com/en/5.1/howto/deployment/checklist/
 
 # SECURITY WARNING: keep the secret key used in production secret!
-SECRET_KEY = 'matxp6k!wbkmdlk)97)ew2qr%&9nr=n#v_-+v#yel4^r&czf7q'
+SECRET_KEY = 'django-insecure-sokpy*q9_=6j-9mrh_l)*k+&im(xfbxz_8=&u536n@9s)9&*gv'
 
 # SECURITY WARNING: don't run with debug turned on in production!
 DEBUG = True
@@ -72,18 +72,18 @@
 
 
 # Database
-# https://docs.djangoproject.com/en/2.2/ref/settings/#databases
+# https://docs.djangoproject.com/en/5.1/ref/settings/#databases
 
 DATABASES = {
     'default': {
         'ENGINE': 'django.db.backends.sqlite3',
-        'NAME': os.path.join(BASE_DIR, 'helloworld.db'),
+        'NAME': BASE_DIR / 'helloworld.sqlite3',
     }
 }
 
 
 # Password validation
-# https://docs.djangoproject.com/en/2.2/ref/settings/#auth-password-validators
+# https://docs.djangoproject.com/en/5.1/ref/settings/#auth-password-validators
 
 AUTH_PASSWORD_VALIDATORS = [
     {
@@ -102,7 +102,7 @@
 
 
 # Internationalization
-# https://docs.djangoproject.com/en/2.2/topics/i18n/
+# https://docs.djangoproject.com/en/5.1/topics/i18n/
 
 LANGUAGE_CODE = 'en-us'
 
@@ -112,14 +112,19 @@
 # to load the internationalization machinery.
 USE_I18N = True
 
-# If you set this to False, Django will not format dates, numbers and
-# calendars according to the current locale
-USE_L10N = True
-
+# If you set this to False, Django will not use timezone-aware datetimes.
 USE_TZ = True
 
 
 # Static files (CSS, JavaScript, Images)
-# https://docs.djangoproject.com/en/2.2/howto/static-files/
+# https://docs.djangoproject.com/en/5.1/howto/static-files/
+
+STATIC_URL = 'static/'
+STATICFILES_DIRS = [
+    BASE_DIR / "static",
+]
+
+# Default primary key field type
+# https://docs.djangoproject.com/en/5.1/ref/settings/#default-auto-field
 
-STATIC_URL = '/static/'
+DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'

helloworld/asgi.py

@@ -1,7 +1,8 @@
-"""helloworld URL Configuration
+"""
+URL configuration for helloworld project.
 
 The `urlpatterns` list routes URLs to views. For more information please see:
-    https://docs.djangoproject.com/en/2.2/topics/http/urls/
+    https://docs.djangoproject.com/en/5.1/topics/http/urls/
 Examples:
 Function views
     1. Add an import:  from my_app import views

helloworld/settings.py

@@ -4,7 +4,7 @@
 It exposes the WSGI callable as a module-level variable named ``application``.
 
 For more information on this file, see
-https://docs.djangoproject.com/en/2.2/howto/deployment/wsgi/
+https://docs.djangoproject.com/en/5.1/howto/deployment/wsgi/
 """
 
 import os