Package: zibanu-django
Paquetes de Zibanu para DjangoZibanu para Django está conformado por los siguientes paquetes:Paquete de API de Zibanu para Django (zibanu.django.api package)Paquete de Base de Datos de Zibanu para Django (zibanu.django.db package)Paquete de Marco de Trabajo REST de Zibanu para Django (zibanu.django.rest_framework package)Paquete de Plantillas de Zibanu para Django (zibanu.django.template package)Paquete de Utilidades de Zibanu para Django (zibanu.django.utils package)Paquete de API de Zibanu para Django (zibanu.django.api package)Este paquete Django proporciona servicios REST para enumerar los idiomas y zonas horarias disponibles.zibanu.django.api.services.language moduleEste módulo Django proporciona una API REST para enumerar los idiomas disponibles en un proyecto Django.classzibanu.django.api.services.language.LanguageViewSet(ViewSet)Vista configurada para exponer los servicios REST para enumerar los idiomas disponibles de Django.Métodoslist(request, *args, **kwargs)→ Response:Servicio REST para enumerar los idiomas disponibles de Django desde la configuración.Parámetros:request:Objeto de solicitud HTTP.*args*:Tupla con parámetros.**kwargs**:Diccionario con parámetros clave/valor.Retorna:languages:Lista con idiomas Django desde la configuración.zibanu.django.api.services.timezone moduleEste Django ViewSet expone una lista de todas las zonas horarias disponibles.classzibanu.django.api.services.timezone.TimeZoneViewSet(ViewSet)Vista configurada para exponer la lista disponible de zonas horarias.Métodoslist(request)→ Response:Listar zonas horarias disponibles.Parámetros:request:Objeto de solicitud HTTP.Retorna:response:Objeto de respuesta con estado y lista de zonas horarias.Estado ->200si la longitud de la lista de zonas horarias > 0, en caso contrario204.Paquete de Base de Datos de Zibanu para Django (zibanu.django.db package)Este paquete demuestra el uso de un contenedor de base de datos personalizado y una clase de operaciones para permitir el uso de campos con nombres entre comillas dobles, como palabras reservadas, por ejemplo. También incluye una clase de modelo personalizado que agrega los campos created_at  y modified_at  de forma predeterminada, y una clase de administrador personalizado que incluye el uso del atributo "use_db" de la clase de modelo, si existe.zibanu.django.db.backends.oracle packageEsta es una versión modificada del contenedor de base de datos Django.zibanu.django.db.backends.oracle.base moduleclasszibanu.django.db.backends.oracle.base.DatabaseOperations(OracleOperations)Clase para anular la clase DatabaseOperation del cliente django Oracle.
Esta clase permite el uso de campos con nombres entre '""', como palabras reservadas por ejemplo.Métodosquote_name(name)→Anular método para obtener el nombre del campo respetando las comillas dobles.Parámetros:name:Nombre del campo de la tabla.Retorna:name:Nombre del campo con comillas dobles si corresponde.classzibanu.django.db.backends.oracle.base.DatabaseWrapper(OracleWrapper)Clase contenedora de base de datos para usar una nueva clase DatabaseOperation.zibanu.django.db.models packageEste paquete contiene un conjunto de modelos abstractos que pueden usarse como base para sus propios modelos de Django.zibanu.django.db.models.dated_model moduleclasszibanu.django.db.models.dated_model.DatedModel(*args, **kwargs)Clase abstracta heredada de la clase zibanu.django.db.Model para agregar los campos creado_at y modificado_at de forma predeterminada.______zibanu.django.db.models.manager moduleclasszibanu.django.db.models.manager.Manager(*args, **kwargs)Esta es una clase de administrador personalizada para modelos Django. Incluye algunos métodos de utilidad que se pueden utilizar para simplificar tareas comunes.Métodosget_queryset()→ QuerySetDevuelve un conjunto de consultas para el modelo. Este método se anula para incluir el uso del atributouse_dbde la clase de modelo, si existe.Retorna:qs:Objeto de conjunto de consultas.get_by_pk(pk: Any)→ QuerySetDevuelve un conjunto de consultas para el modelo basado en el campo de clave principal. Este método valida que la clave principal exista antes de devolver el conjunto de consultas.Parámetros:pk:Valor del campo PK.Retorna:qs:Objeto de conjunto de consultas.zibanu.django.db.models.model moduleclasszibanu.django.db.models.model.Model(*args, **kwargs)Esta es una clase base para modelos de Django que agrega el atributouse_db. Este atributo le permite especificar qué base de datos usar para un modelo en particular.Métodosset(self, fields: dict):Método para guardar un conjunto de campos de un diccionario.Parámetros:fields:Diccionario con claves y valores de campos.Retorna:Ninguno.Paquete de Marco de Trabajo REST de Zibanu para Django (zibanu.django.rest_framework package)Este paquete contiene extensiones personalizadas para el marco REST de Django.zibanu.django.rest_framework.decorators modulepermission_required(permissions: Any, raise_exception=True)→Decorador para validar permisos de la estructura de autenticación de Django. Compatible con JWT simple.Parámetros:permissions:Nombre de permiso o tupla con lista de permisos. Obligatorio.raise_exception:Verdadero si desea generar la excepción PermissionDenied; de lo contrario, Falso. Valor predeterminado: VerdaderoRetorna:b_return:Verdadero si la autorización se realizó correctamente; en caso contrario, Falso.check_perms(user)→Función interna para verificar el permiso de la función maestra.Parámetros:user:Objeto de usuario a validar.Retorna:b_return:Verdadero si los permisos verifican el éxito; en caso contrario, Falso.zibanu.django.rest_framework.exceptions packageEste paquete contiene clases de excepción personalizadas para Django REST Framework.zibanu.django.rest_framework.exceptions.api_exception moduleexceptionzibanu.django.rest_framework.exceptions.api_exception.APIException(msg: str | None = None, error: str | None = None, http_status: int = 400)Clase heredada de rest_framework.exceptions. ApiException.Contenido del móduloexceptionzibanu.django.rest_framework.exceptions.AuthenticationFailed(detail=None, code=None)default_code= 'authentication_failed'default_detailstatus_code= 401exceptionzibanu.django.rest_framework.exceptions.MethodNotAllowed(method, detail=None, code=None)default_code= 'method_not_allowed'default_detailstatus_code= 405exceptionzibanu.django.rest_framework.exceptions.NotAcceptable(detail=None, code=None, available_renderers=None)default_code= 'not_acceptable'default_detailstatus_code= 406exceptionzibanu.django.rest_framework.exceptions.NotFound(detail=None, code=None)default_code= 'not_found'default_detailstatus_code= 404exceptionzibanu.django.rest_framework.exceptions.ParseError(detail=None, code=None)default_code= 'parse_error'default_detailstatus_code= 400exceptionzibanu.django.rest_framework.exceptions.PermissionDenied(detail=None, code=None)default_code= 'permission_denied'default_detailstatus_code= 403exceptionzibanu.django.rest_framework.exceptions.UnsupportedMediaType(media_type, detail=None, code=None)default_code= 'unsupported_media_type'default_detailstatus_code= 415exceptionzibanu.django.rest_framework.exceptions.ValidationError(detail=None, code=None)default_code= 'invalid'default_detailstatus_code= 400zibanu.django.rest_framework.fields packageEste paquete contiene campos personalizados para Django REST Framework.zibanu.django.rest_framework.fields.current_user_default moduleEste modulo proporciona una clase personalizadaCurrentUserDefaultque es compatible con el objeto de usuario SimpleJWT.zibanu.django.rest_framework.fields.hybrid_image moduleclasszibanu.django.rest_framework.fields.hybrid_image.HybridImageField(*args, **kwargs)Clase heredada de drf_extra_fields.field.HybridImageField para permitir la validación del tamaño e implementar la imagen de uso validación de formato y tamaño.Métodosto_internal_value(data)→Método de anulación para procesar datos internos del serializador.Parámetros:data:Datos recibidos del serializador (datos de publicación sin procesar).Retorna:Compatible con datos de Python.zibanu.django.rest_framework.serializers packageEste paquete proporciona un conjunto de serializadores personalizados para usar con Django REST Framework.zibanu.django.rest_framework.serializers.model_serializer moduleclasszibanu.django.rest_framework.serializers.model_serializer.ModelSerializer(*args, **kwargs)Este módulo proporciona una clase ModelSerializer personalizada que anula el ModelSerializer predeterminado proporcionado por Django REST Framework.zibanu.django.rest_framework.serializers.fields moduleEste módulo contiene el siguiente campo de serializador:CurrentUserDefault: Un campo que establece el campousercomo el usuario actual.zibanu.django.rest_framework.viewsets packageEste paquete contiene un conjunto de conjuntos de vistas personalizados que se pueden usar con Django REST Framework.zibanu.django.rest_framework.viewsets.model_viewset moduleEste repositorio contiene una versión modificada de la clase ModelViewSet de Django REST Frameworkclasszibanu.django.rest_framework.viewsets.model_viewset.ModelViewSet(*args, **kwargs)Clase heredada de rest_framework.viewsets.ModelViewSet para anular.Métodosget_queryset(**kwargs)→ QuerySet:Obtenga un conjunto de consultas del modelo a partir de los parámetros **kwargs. Si desea queryset pk se base en, envíe la clave "pk" en kwargs.Parámetros:**kwargs:Diccionario con parámetros clave y de valor.Retorna:qs:Objeto de conjunto de consultas del modelo.list(request, *args, **kwargs)→ Response:Servicio REST para obtener una lista de registros del modelo definido por clase.Parámetros:request:Solicitar objeto desde HTTP.*args:Tupla de parámetros.**kwargs:Diccionario de parámetros clave y de valor.Retorna:response:Objeto de respuesta con estado y lista de conjuntos de datos.Estado -> 200 si existen datosEstado -> 204 si los datos están vacíos.retrieve(request, *args, **kwargs)→ Response:Servicio REST para obtener un registro filtrado por pk.Parámetros:request:Solicitar objeto desde HTTP.*args:Tupla de parámetros.**kwargs:Diccionario de parámetros clave y de valor.Retorna:response:Objeto de respuesta con estado.Estado -> 200 si existe registro y registro de datos.Si el registro no existe, se lanza una excepción.create(request, *args, **kwargs)→ Response:Servicio REST para crear un registro de modelo.Parámetros:request:Solicitar objeto desde HTTP.*args:Tupla de parámetros.**kwargs:Diccionario de parámetros clave y de valor.Retorna:response:Objeto de respuesta con estado.Estado -> 201 si se realizó correctamente y registro creado a partir del objeto modelo.update(request, *args, **kwargs)→ Response:Servicio REST para actualizar un registro existente del modelo.Parámetros:request:Solicitar objeto desde HTTP.*args:Tupla de parámetros.**kwargs:Diccionario de parámetros clave y de valor.Retorna:response:Objeto de respuesta con estado.Estado -> 200 si se realiza correctamente y registro actualizado desde el objeto modelo.destroy(request, *args, **kwargs)→ Response:Servicio REST para eliminar un registro del modelo.Parámetros:request:Solicitar objeto desde HTTP.*args:Tupla de parámetros.**kwargs:Diccionario de parámetros clave y de valor.Retorna:response:Objeto de respuesta con estado.Estado -> 200 si se realiza correctamente.zibanu.django.rest_framework.viewsets.viewset moduleclasszibanu.django.rest_framework.viewsets.viewset.ViewSet(RestViewSet)Esta es una clase ViewSet personalizada que hereda de la claserest_framework.viewsets.ViewSet.Define las permission_classes  y authentication_classes  predeterminadas para todos los conjuntos de vistas que heredan de él.Paquete de Plantillas de Zibanu para Django (zibanu.django.template package)Este repositorio contiene procesadores de contexto para Django.zibanu.django.template.apps moduleclasszibanu.django.template.apps.ZbDjangoTemplate(app_name, app_module)Clase heredada de django.apps.AppConfig para definir la configuración de zibanu.django.templatedefault_auto_field= 'django.db.models.BigAutoField'name= 'zibanu.django.template'zibanu.django.template.context_processors packageEste paquete contiene procesadores de contexto para Django.zibanu.django.template.context_processors.full_static_uri modulezibanu.django.template.context_processors.full_static_uri.full_static_uri(request)Preprocesador de contexto para obtener "full_static_uri", incluido el nombre de host y el uri estático para el uso de la plantilla.Parámetros:request:Solicitar objeto desde HTTP.Retorna:full_uri:Diccionario con clave/valor "full_static_uri".zibanu.django.template.context_processors.site modulezibanu.django.template.context_processors.site.site(request)Preprocesador de contexto para obtener la uri absoluta del sitio para usar en plantillas de Django.Parámetros:request:Solicitar objeto desde HTTP.Retorna:site_uri:Diccionario con clave/valor del sitio.zibanu.django.template.templatetags packageEste repositorio contiene etiquetas de plantilla personalizadas para Django.zibanu.django.template.templatetags.static_uri moduleclasszibanu.django.template.templatetags.static_uri.StaticNodeUri(uri_string: str)Clase heredada de django.template.Node para permitir el uso de la etiqueta de plantilla "static_uri" en las plantillas de Django.Métodoszibanu.django.template.templatetags.static_uri.render(context)Anular el método para representar la etiqueta en la plantilla.Parámetros:context:Objeto de diccionario de contexto de plantilla.Retorna:uri:Cadena para renderizar en plantilla.Funciónzibanu.django.template.templatetags.static_uri.static_uri(parse, token)Función para registrar etiqueta en plantilla.Parámetros:parse:Analizar objeto de plantilla.token:Objeto token de plantilla.Retorna:La clase StaticNodeUri se llamará desde la plantilla y se representará.zibanu.django.template.templatetags.string_concat modulezibanu.django.template.templatetags.string_concat.string_concat(first_string: str, *args)Etiqueta simple para concatenar una cadena con tupla de cadenas.Parámetros:first_string:Cadena base para concatenar.args:Tupla de cadenas.Retorna:Cadena concatenada.zibanu.django.template.templatetags.subtotal_dict modulezibanu.django.template.templatetags.subtotal_dict.subtotal_dict(source_list: list, key_control: str, *args)→ listEtiqueta de plantilla para obtener un subtotal de una lista de registros del diccionario.Parámetros:source_list:Lista con todos los datos del diccionario.key_control:Uso de claves para indexar y realizar los desgloses de subtotales.args:Tupla con lista de nombres clave para obtener los subtotales.Retorna:return_list:Lista con un diccionario de datos con las claves "control", "totales" y datos", que contiene los subtotales como este:Control -> Valor de source_list para la clave key_control.Totals -> Total para key_control.Data -> Lista con datos de source_list con una clave diferente del valor del parámetro key_control.zibanu.django.template.templatetags.sum_dict modulezibanu.django.template.templatetags.sum_dict.sum_dict(source_list: list, key: str, format_string: str | None = None)Etiqueta de plantilla para obtener una suma de una lista de registros del diccionario.Parámetros:source_list:Lista con registros de dictado.key:Nombre de la cadena clave para realizar la suma.format_string:Formato que se utilizará en la plantilla de renderizado.Retorna:f_sum:Cadena con resultado formateado de la operación de suma.Paquete de Utilidades de Zibanu para Django (zibanu.django.utils package)Este paquete contiene clases de utilidad y funciones para Zibanu Django.Estas son algunas de las clases de utilidades y funciones en este paquete:CodeGenerator:
Esta clase se utiliza para generar diferentes tipos de códigos de forma aleatoria.ErrorMessages: Esta clase contiene constantes de compilación de mensajes de error.Mail: Esta clase se hereda de la clase EmailMultiAlternatives para crear un correo electrónico a partir de una plantilla html y texto html.Datetime: Esta clase contiene funciones para cambiar la zona horaria y agregar la zona horaria a un valor de fecha y hora.Request_Utils: Obtiene la dirección IP de la solicitud.User: Función para obtener usuario del token SimpleJWT TokenUser o usuario de Django.APIsLista de zonas horarias (Timezone List)Servicio REST para listar las zonas horarias disponibles.Parámetros:Request: Solicitar objeto de HTTP.Retorna:Objeto Response con estado HTTP 200 y lista de zonas horarias.zibanu.django.utils.code_generator moduleclass zibanu.django.utils.code_generator.CodeGenerator(action: str, is_safe: bool = True, code_length: int = 6)Clase para generar diferentes tipos de código de forma aleatoria. Esta clase tiene la capacidad de generar códigos numéricos, códigos alfanuméricos y códigos seguros, según sea necesario, además, puede generar un identificador único universal (UUID).Parámetros:'action: str':Código de acción para referenciarlo en la caché si es necesario.'is_safe: bool':Bandera para indicar si se utiliza el modo seguro de UUID.'code_lenght: int':La longitud del código que se va a generar (por defecto es 6).Propiedades:'action():Obtiene el valor de __action.Retorna:
Valor de tipo cadena con la descripción de la acción.'is_safe():Obtiene el valor de _uuid_safe.Retorna:
Parámetro booleano, verdadero si el UUID usa el modo seguro; de lo contrario, falso.'code()':Obtiene el valor de __code.Retorna:
Valor de tipo de cadena con el código generado.Métodosget_numeric_code(length: int | None = None)→ strObtener un código numérico con la longitud definida en el constructor o recibida como parámetro "length" en este método.Parámetros:length:Longitud del código generado. Anular la longitud definida en la clase.Retorna:Una cadena con el código numérico.get_alpha_numeric_code(length: int | None = None)→ strObtener un código alfanumérico con la longitud definida en el constructor o recibida como parámetro "length" en este método.Parámetros:length:Longitud del código generado. Este parámetro anula la longitud definida en la clase.Retorna:Una cadena con el código numérico.get_secure_code(length: int | None = None)→ strObtener un código seguro con la longitud definida en el constructor o recibida como parámetro "length" en este método.Parámetros:length:Longitud del código generado. Este parámetro anula la longitud definida en la clase.Retorna:Una cadena con el código numérico.generate_uuid()→ boolMétodo para generar un UUID en modo seguro, dependiendo del parámetro establecido en el constructor.Retorna:True si se genera con éxito, de lo contrario, False.generate_dict(is_numeric: bool = True)→ dictMétodo para generar un diccionario con uuid, code y action.Parámetros:is_numeric:Bandera para indicar si el código generado es numérico o alfanumérico.Retorna:Diccionario con las claves uuid, code y action.zibanu.django.utils.error_messages moduleclass zibanu.django.utils.error_messages.ErrorMessagesClase que contiene constantes o mensajes de error utilizados a través de la API de Django. Estos mensajes de error se pueden utilizar para proporcionar información detallada sobre el tipo de error que se ha producido y así facilitar la depuración y el manejo adecuado de excepciones en el código.ConstantesFIELD_REQUIRED:El campo es obligatorioCREATE_ERROR:No se ha creado el registro.UPDATE_ERROR:El registro no ha sido actualizado.NOT_FOUND:No hay coincidencia de registros.DELETE_ERROR:El registro no se puede eliminar.DATA_REQUIRED:Los datos requeridos no se encuentran.DATABASE_ERROR:Error en la base de datos.DATA_REQUEST_NOT_FOUND:Datos requeridos en la solicitud no encontrados.NOT_CONTROLLED:Excepción no controlada.zibanu.django.utils.mail moduleclass zibanu.django.utils.mail.Email(subject: str = '', body: str = '', from_email: str | None = None, to: list | None = None, bcc: list | None = None, connection: Any | None = None, attachments: list | None = None, headers: dict | None = None, cc: list | None = None, reply_to: list | None = None, context: dict | None = None)Clase para realizar envíos de correos electrónicos a partir de un template html o texto o de lo contrario, por medio de un asunto.Parámetros:'subject: str':Asunto del correo electrónico.'body: str':Texto del cuerpo del correo electrónico.'from_email: str':De la dirección de correo electrónico'to: list':Lista o tupla de direcciones de destinatarios.'bcc: list':Una lista o tupla de direcciones utilizadas en el encabezado "Bcc" al enviar el correo electrónico.'connection: Any':Instancia de conexión de back-end de correo electrónico.'attachments: list':Lista de archivos adjuntos.'headers: dict':Un diccionario de encabezados adicionales para poner en el mensaje. Las claves son el nombre del encabezado, los valores son los valores del encabezado.'cc: list':Una lista o tupla de la dirección del destinatario utilizada en el encabezado "Cc" al enviar el correo electrónico.'reply_to: list':Una lista o tupla de direcciones de destinatarios utilizadas en el encabezado "Responder a" al enviar el correo electrónico.'context: dict':Diccionario de contexto para algunas variables adicionales.Métodossend(fail_silently=False)Anule el método para enviar un mensaje de correo electrónico.Parámetros:fail_silently:Indicador para determinar si se detecta un error o no.set_html_template(template: str, context: dict | None = None)Establezca una plantilla html para la construcción del correo electrónico del cuerpo.Parámetros:template:Ruta completa y nombre de archivo de la plantilla.context:Diccionario de contexto con vars adicionales.set_text_template(template: str, context: dict | None = None)Establezca una plantilla de texto para el cuerpo del correo electrónico.Parámetros:template:Ruta completa y nombre de archivo de la plantilla.context:Diccionario de contexto con vars adicionales.zibanu.django.utils.date_time modulezibanu.django.utils.date_time.change_timezone(date_to_change: datetime, tz: ZoneInfo | None = None)→ datetimeFunción para cambiar la zona horaria a un valor de fecha y hora.Parámetros:date_to_change:Valor de fecha y hora para cambiar la zona horariatz:Zona horaria a la que se le asignará un valor de fecha y horaRetorna:Fecha y hora con una nueva zona horaria.zibanu.django.utils.date_time.add_timezone(date_to_change: datetime, tz: ZoneInfo | None = None)→ datetimeFunción para agregar la zona horaria a un valor de fecha y hora ingenuo.Parámetros:date_to_change:Valor de fecha y hora ingenuo para agregar zona horaria.tz:Zona horaria a la que se le asignará un valor de fecha y hora.Retorna:Fecha y hora con una nueva zona horaria.zibanu.django.utils.request_utils modulezibanu.django.utils.request_utils.get_ip_address(request: Any)→ strObtener dirección IP de la solicitud.zibanu.django.utils.user modulezibanu.django.utils.user.get_user(user: Any)→ AnyFunción para obtener usuario del token SimpleJWT TokenUser o usuario de Django.Parámetros:user:Objeto de usuario para revisión.Retorna:local_user:Objeto de usuario de Django.zibanu.django.utils.user.get_user_object(user: Any)→ AnyFunción heredada. Utilice "get_user" en su lugar. Esta función se eliminará en versiones futuras.user:Objeto de usuario para revisión.Retorna:local_user:Objeto de usuario de Django.