Django Times

Django Times es un modulo el cual busca mejorar y optimizar el trabajo al momento de pasar fechas y dias a los templates en django y asi mejorar el mantenimiento del codigo.

Informacion General

Este proyecto proporciona una biblioteca que facilita el trabajo con fechas y horas en aplicaciones Django. Ofrece una serie de etiquetas y funciones personalizadas que permiten obtener y formatear la fecha y hora actual, asi como configurar la zona horaria y el idioma en algunos casos.

Proyecto

Este proyecto tiene como objetivo simplificar el manejo de fechas y horas en aplicaciones Django. Algunos de los aspectos clave del proyecto incluyen:

• Obtener la fecha y hora actual de acuerdo con la zona horaria configurada en las opciones de Django.
• Formatear la fecha y hora de diferentes maneras segun las necesidades del usuario.
• Personalizar la zona horaria y el idioma para adaptarse a requisitos especificos.

Instrucciones de Uso

Instalacion

Para utilizar esta biblioteca en tu proyecto Django, sigue estos pasos:

1. Crea un entorno virtual para tu proyecto (se recomienda, pero opcional).

   py -m venv env # Windows
   python3 -m virtualenv env # Linux
   

2. Activa el entorno virtual

   .\env\Scripts\activate # Windows
   source env/bin/activate # Linux
   

3. Instala los django_times

   pip install django-times

4. INSTALLED_APPS

   INSTALLED_APPS = [
       ...
       'django_times',
       ...
   ]
   

5. Recoger archivos estaticos

   py manage.py collectstatic # Windows
   python3 manage.py collectstatic # Linux
   

Uso

Para usar django times dentro de tus plantillas de django debes de cargar el tag, para ello usa:

{% load django_times %}

Y ya puedes usar los distintos tags que te ofrece django-times: ver mas...

Contribucion

¡Gracias por considerar contribuir a este proyecto! Si deseas contribuir, sigue estos pasos:

1. Crea un fork del repositorio en GitHub.

2. Clona tu repositorio fork en tu entorno de desarrollo local. git clone https://github.com/TU_NOMBRE_DE_USUARIO/django-times.git

3. Crea tu entorno virtual, activalo e instala requirements-dev.txt

4. Crea una rama para tu contribucion. git checkout -b mi-contribucion

5. Realiza tus cambios y realiza confirmaciones significativas.

6. Ejecuta pre-commit run --all-files, si falla vuelve a ejecutarlo hasta que todo sea "Passed" de lo contrario soluciona los errores.

7. Envia una solicitud de extraccion (pull request) a la rama principal del proyecto.

8. Tu solicitud de extraccion sera revisada y, si es aceptada, se fusionara con el proyecto principal.

Recuerda siempre editar el archivo CHANGELOG.md indicando que cambios realizastes, tambien se descriptivo en el mensaje de tu commit y agrega tu nombre a CONTRIBUTORS siguiendo el orden alfabetico.