nexui 0.1.2__tar.gz

nexui-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hugues Codeur
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nexui-0.1.2/MANIFEST.in

@@ -0,0 +1,5 @@
+include LICENSE
+include README.md
+recursive-include nexui/templates *
+recursive-include nexui/static *
+recursive-include nexui/templatetags *

nexui-0.1.2/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.2
+Name: nexui
+Version: 0.1.2
+Summary: Bibliothèque de composants UI modernes avec support HTMX optionnel
+Author-email: Hugues Codeur <huguescodeur@gmail.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Django
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=5.1
+Requires-Dist: django-tailwind>=3.8.0
+Provides-Extra: htmx
+Requires-Dist: django-htmx>=1.17.2; extra == "htmx"
+
+# 🚀 NexUI
+
+NexUI est une bibliothèque de composants UI pour Django, optimisée pour HTMX et basée sur Tailwind CSS. Elle permet d'ajouter facilement des éléments interactifs à vos applications Django tout en bénéficiant des avantages d'une intégration fluide avec HTMX pour la gestion des requêtes AJAX.
+
+---
+
+## 📌 Installation
+
+### Installation de base
+```bash
+pip install nexui
+```
+
+### Installation avec support HTMX
+Si vous prévoyez d'utiliser HTMX avec vos composants :
+```bash
+pip install nexui[htmx]
+```
+Ou installez HTMX séparément plus tard :
+```bash
+pip install django-htmx
+```
+Ajoutez `nexui` à la liste des applications installées dans `settings.py` :
+```python
+INSTALLED_APPS = [
+    ...
+    'nexui',
+]
+```
+
+---
+
+## 🎨 Fonctionnalités
+
+✅ Composants UI réutilisables pour Django  
+🔥 Intégration fluide avec HTMX  
+🎨 Basé sur Tailwind CSS pour un design moderne  
+📦 Facile à installer et à utiliser  
+
+---
+
+## 🚀 Utilisation
+
+### Charger les tags NexUI dans vos templates Django
+
+```django
+{% load nexui_tags %}
+```
+
+---
+
+## 📖 Documentation
+
+### 🔘 Composant Button
+
+Le composant `button` permet de créer des boutons personnalisables avec des icônes et des interactions HTMX.
+
+#### **Options disponibles :**
+- `label` : Texte du bouton
+- `type` : Type du bouton (`button`, `submit`, `reset`)
+- `class` : Classes CSS personnalisées
+- `icon` : Icône (supporte Font Awesome et Unicode)
+- `icon_type` : Type d'icône (`fa`, `unicode`, `emoji`)
+- `icon_position` : Position de l'icône (`left`, `right`)
+- `icon_size` : Taille de l'icône
+- `icon_color` : Couleur de l'icône
+- `disabled` : Désactive le bouton (`true`)
+- `url_name` : Nom de l'URL Django
+- `url_params` : Paramètres dynamiques pour l'URL Django
+- `attrs` : Attributs HTML et HTMX supplémentaires (_hx-_*, id, style, data-\* etc.)
+
+### **Exemples d'utilisation :**
+
+#### 1️⃣ Bouton simple
+```django
+{% button label="Envoyer" %}
+```
+#### 2️⃣ Bouton simple personnalisé
+```django
+{% button label="Envoyer" type="submit" class="bg-yellow-500 text-black" %}
+```
+
+#### 3️⃣ Bouton avec HTMX
+```django
+{% button label="Envoyer avec HTMX" type="submit" class="bg-green-500" attrs="hx-post='/submit' hx-target='#result' hx-swap='innerHTML'" %}
+```
+
+#### 4️⃣ Bouton avec URL dynamique
+```django
+{% button label="Dynamique URL Params" type="submit" class="bg-blue-500 text-white" url_name="update-user" url_params="2, tomate" attrs="hx-confirm='Êtes-vous sûr ?' hx-target='#result' hx-swap='innerHTML'" %}
+```
+
+#### 5️⃣ Bouton avec URL dynamique et un seul paramètres 
+```django
+{% button label="Dynamique URL Params" type="submit" class="bg-blue-500 text-white" url_name="update-user" url_params="1" attrs="hx-confirm='Êtes-vous sûr ?' hx-target='#result' hx-swap='innerHTML'" %}
+```
+
+#### 6️⃣ Bouton avec URL dynamique et plusieurs paramètres 
+```django
+{% button label="Dynamique URL Params" type="submit" class="bg-blue-500 text-white" url_name="update-user" url_params="1, developer" attrs="hx-confirm='Êtes-vous sûr ?' hx-target='#result' hx-swap='innerHTML'" %}
+```
+
+
+#### 7️⃣ Bouton avec émojis
+```django
+{% button label="Télécharger" class="bg-green-500" icon="⬇️" icon_position="left" icon_size="lg" %}
+```
+
+#### 8️⃣ Bouton désactivé
+```django
+{% button label="Disabled" disabled="true" %}
+```
+
+#### 9️⃣ Bouton avec Font Awesome
+```django
+{% button label="Éditer" icon="fa-solid fa-pen" icon_type="fa" %}
+```
+
+#### 🔟 Bouton avec code HTML
+```django
+{% button label="Étoile" icon="9733" icon_type="unicode" %}
+```
+
+```django
+{% button label="At Symbol" icon="&#64" icon_type="unicode" %}
+```
+
+---
+
+## 💡 Contribuer
+
+Actuellement, le projet est en phase de test initial. Nous encourageons les utilisateurs intéressés à donner leur avis sur la bibliothèque.
+
+Si vous souhaitez participer à l'évolution de **NexUI** ou si vous avez des suggestions :
+
+1. **Forkez le projet** 📌
+2. **Testez les composants et apportez vos retours** 🛠️
+3. **Créez une issue** pour partager vos suggestions ou problèmes ✅
+
+Nous ne pouvons pas accepter de contributions directes pour le moment, mais **vos retours sont essentiels** pour l'évolution de NexUI.
+
+---
+
+## 🔗 Liens utiles
+
+- [Dépôt GitHub](#) 🖥️
+- [Signaler un bug](#) 🐞
+- [HTMX](https://htmx.org/) ⚡
+- [Tailwind CSS](https://tailwindcss.com/) 🎨
+
+---
+
+## ⚖️ Licence
+
+Ce projet est sous licence **MIT**. Voir le fichier `LICENSE` pour plus de détails.

nexui-0.1.2/README.md

@@ -0,0 +1,155 @@
+# 🚀 NexUI
+
+NexUI est une bibliothèque de composants UI pour Django, optimisée pour HTMX et basée sur Tailwind CSS. Elle permet d'ajouter facilement des éléments interactifs à vos applications Django tout en bénéficiant des avantages d'une intégration fluide avec HTMX pour la gestion des requêtes AJAX.
+
+---
+
+## 📌 Installation
+
+### Installation de base
+```bash
+pip install nexui
+```
+
+### Installation avec support HTMX
+Si vous prévoyez d'utiliser HTMX avec vos composants :
+```bash
+pip install nexui[htmx]
+```
+Ou installez HTMX séparément plus tard :
+```bash
+pip install django-htmx
+```
+Ajoutez `nexui` à la liste des applications installées dans `settings.py` :
+```python
+INSTALLED_APPS = [
+    ...
+    'nexui',
+]
+```
+
+---
+
+## 🎨 Fonctionnalités
+
+✅ Composants UI réutilisables pour Django  
+🔥 Intégration fluide avec HTMX  
+🎨 Basé sur Tailwind CSS pour un design moderne  
+📦 Facile à installer et à utiliser  
+
+---
+
+## 🚀 Utilisation
+
+### Charger les tags NexUI dans vos templates Django
+
+```django
+{% load nexui_tags %}
+```
+
+---
+
+## 📖 Documentation
+
+### 🔘 Composant Button
+
+Le composant `button` permet de créer des boutons personnalisables avec des icônes et des interactions HTMX.
+
+#### **Options disponibles :**
+- `label` : Texte du bouton
+- `type` : Type du bouton (`button`, `submit`, `reset`)
+- `class` : Classes CSS personnalisées
+- `icon` : Icône (supporte Font Awesome et Unicode)
+- `icon_type` : Type d'icône (`fa`, `unicode`, `emoji`)
+- `icon_position` : Position de l'icône (`left`, `right`)
+- `icon_size` : Taille de l'icône
+- `icon_color` : Couleur de l'icône
+- `disabled` : Désactive le bouton (`true`)
+- `url_name` : Nom de l'URL Django
+- `url_params` : Paramètres dynamiques pour l'URL Django
+- `attrs` : Attributs HTML et HTMX supplémentaires (_hx-_*, id, style, data-\* etc.)
+
+### **Exemples d'utilisation :**
+
+#### 1️⃣ Bouton simple
+```django
+{% button label="Envoyer" %}
+```
+#### 2️⃣ Bouton simple personnalisé
+```django
+{% button label="Envoyer" type="submit" class="bg-yellow-500 text-black" %}
+```
+
+#### 3️⃣ Bouton avec HTMX
+```django
+{% button label="Envoyer avec HTMX" type="submit" class="bg-green-500" attrs="hx-post='/submit' hx-target='#result' hx-swap='innerHTML'" %}
+```
+
+#### 4️⃣ Bouton avec URL dynamique
+```django
+{% button label="Dynamique URL Params" type="submit" class="bg-blue-500 text-white" url_name="update-user" url_params="2, tomate" attrs="hx-confirm='Êtes-vous sûr ?' hx-target='#result' hx-swap='innerHTML'" %}
+```
+
+#### 5️⃣ Bouton avec URL dynamique et un seul paramètres 
+```django
+{% button label="Dynamique URL Params" type="submit" class="bg-blue-500 text-white" url_name="update-user" url_params="1" attrs="hx-confirm='Êtes-vous sûr ?' hx-target='#result' hx-swap='innerHTML'" %}
+```
+
+#### 6️⃣ Bouton avec URL dynamique et plusieurs paramètres 
+```django
+{% button label="Dynamique URL Params" type="submit" class="bg-blue-500 text-white" url_name="update-user" url_params="1, developer" attrs="hx-confirm='Êtes-vous sûr ?' hx-target='#result' hx-swap='innerHTML'" %}
+```
+
+
+#### 7️⃣ Bouton avec émojis
+```django
+{% button label="Télécharger" class="bg-green-500" icon="⬇️" icon_position="left" icon_size="lg" %}
+```
+
+#### 8️⃣ Bouton désactivé
+```django
+{% button label="Disabled" disabled="true" %}
+```
+
+#### 9️⃣ Bouton avec Font Awesome
+```django
+{% button label="Éditer" icon="fa-solid fa-pen" icon_type="fa" %}
+```
+
+#### 🔟 Bouton avec code HTML
+```django
+{% button label="Étoile" icon="9733" icon_type="unicode" %}
+```
+
+```django
+{% button label="At Symbol" icon="&#64" icon_type="unicode" %}
+```
+
+---
+
+## 💡 Contribuer
+
+Actuellement, le projet est en phase de test initial. Nous encourageons les utilisateurs intéressés à donner leur avis sur la bibliothèque.
+
+Si vous souhaitez participer à l'évolution de **NexUI** ou si vous avez des suggestions :
+
+1. **Forkez le projet** 📌
+2. **Testez les composants et apportez vos retours** 🛠️
+3. **Créez une issue** pour partager vos suggestions ou problèmes ✅
+
+Nous ne pouvons pas accepter de contributions directes pour le moment, mais **vos retours sont essentiels** pour l'évolution de NexUI.
+
+---
+
+## 🔗 Liens utiles
+
+- [Dépôt GitHub](#) 🖥️
+- [Signaler un bug](#) 🐞
+- [HTMX](https://htmx.org/) ⚡
+- [Tailwind CSS](https://tailwindcss.com/) 🎨
+
+---
+
+## ⚖️ Licence
+
+Ce projet est sous licence **MIT**. Voir le fichier `LICENSE` pour plus de détails.

nexui-0.1.2/nexui/asgi.py

@@ -0,0 +1,16 @@
+"""
+ASGI config for nexui 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', 'nexui.settings')
+
+application = get_asgi_application()

nexui-0.1.2/nexui/settings.py

@@ -0,0 +1,148 @@
+"""
+Django settings for nexui project.
+
+Generated by 'django-admin startproject' using Django 5.1.5.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.1/topics/settings/
+
+For the full list of settings and their values, see
+https://docs.djangoproject.com/en/5.1/ref/settings/
+"""
+
+import os
+from pathlib import Path
+
+# 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/5.1/howto/deployment/checklist/
+
+# SECURITY WARNING: keep the secret key used in production secret!
+SECRET_KEY = 'django-insecure-p)pmps#lul61h5nv-56@bym!_v+abj*3o%%+w^)t)mcwv9&zw9'
+
+# SECURITY WARNING: don't run with debug turned on in production!
+DEBUG = True
+
+ALLOWED_HOSTS = []
+
+
+# Application definition
+
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'tailwind',
+    'theme',
+    'django_browser_reload',
+    "django_htmx",
+    'nexui',
+]
+
+# ? Tailwind configuration
+TAILWIND_APP_NAME = 'theme'
+
+INTERNAL_IPS = [
+    "127.0.0.1",
+]
+
+NPM_BIN_PATH = "C:/Program Files/nodejs/npm.cmd"
+
+
+
+MIDDLEWARE = [
+    'django.middleware.security.SecurityMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.common.CommonMiddleware',
+    "django_browser_reload.middleware.BrowserReloadMiddleware",
+    "django_htmx.middleware.HtmxMiddleware",
+    'django.middleware.csrf.CsrfViewMiddleware',
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
+    'django.contrib.messages.middleware.MessageMiddleware',
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
+]
+
+ROOT_URLCONF = 'nexui.urls'
+
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        # 'DIRS': [],
+        'DIRS': [BASE_DIR / 'templates'],
+        'APP_DIRS': True,
+        'OPTIONS': {
+            'context_processors': [
+                'django.template.context_processors.debug',
+                'django.template.context_processors.request',
+                'django.contrib.auth.context_processors.auth',
+                'django.contrib.messages.context_processors.messages',
+            ],
+            
+        },
+    },
+]
+
+WSGI_APPLICATION = 'nexui.wsgi.application'
+
+
+# Database
+# https://docs.djangoproject.com/en/5.1/ref/settings/#databases
+
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': BASE_DIR / 'db.sqlite3',
+    }
+}
+
+
+# Password validation
+# https://docs.djangoproject.com/en/5.1/ref/settings/#auth-password-validators
+
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
+    },
+]
+
+
+# Internationalization
+# https://docs.djangoproject.com/en/5.1/topics/i18n/
+
+LANGUAGE_CODE = 'en-us'
+
+TIME_ZONE = 'UTC'
+
+USE_I18N = True
+
+USE_TZ = True
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/5.1/howto/static-files/
+
+STATIC_URL = 'static/'
+# STATICFILES_DIRS = [os.path.join(BASE_DIR, "static")]
+
+STATICFILES_DIRS = [BASE_DIR / "static"]
+
+
+# Default primary key field type
+# https://docs.djangoproject.com/en/5.1/ref/settings/#default-auto-field
+
+DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'

nexui-0.1.2/nexui/templates/base.html

@@ -0,0 +1,11 @@
+{% load static tailwind_tags %} {% load nexui_tags%}
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <title>Title</title>
+</head>
+<body>
+
+</body>
+</html>

nexui-0.1.2/nexui/templates/components/button.html

@@ -0,0 +1,44 @@
+{# components/button.html #}
+<button class="px-4 py-2 rounded bg-blue-500 text-white de hover:bg-blue-600 {{ class }}"
+    type="{{ type }}"
+    {% if disabled %}disabled{% endif %}
+    {{ attributes|safe }}
+>
+    {% if icon %}
+        {% if icon_position == "left" %}
+            <span class="mr-2 text-{{ icon_size }}">
+                {% if icon_type == "fa" %}
+                    <i class="{{ icon }}" {% if icon_color %} style="color: {{ icon_color }};"{% endif %}></i>
+                {% elif icon_type == "unicode" %}
+                    {% if "&#" in icon %}
+                        {{ icon|safe }}
+                    {% else %}
+                        &#{{ icon }};
+                    {% endif %}
+                {% else %}
+                    {{ icon }}
+                {% endif %}
+            </span>
+        {% endif %}
+    {% endif %}
+
+    {{ label }}
+
+    {% if icon %}
+        {% if icon_position == "right" %}
+            <span class="ml-2 text-{{ icon_size }}">
+                {% if icon_type == "fa" %}
+                    <i class="{{ icon }}" {% if icon_color %}style="color: {{ icon_color }};"{% endif %}></i>
+                {% elif icon_type == "unicode" %}
+                    {% if "&#" in icon %}
+                        {{ icon|safe }}
+                    {% else %}
+                        &#{{ icon }};
+                    {% endif %}
+                {% else %}
+                    {{ icon }}
+                {% endif %}
+            </span>
+        {% endif %}
+    {% endif %}
+</button>

nexui-0.1.2/nexui/templates/components/button_old_1.html

@@ -0,0 +1,80 @@
+<button class="px-4 py-2 rounded flex items-center {{ class }}" type="{{ type }}" {% if disabled %}disabled{% endif %}>
+  {% if icon %}
+  {% if icon_position == "left" %}
+  <span class="mr-2 text-{{ icon_size }}">
+    {% if icon_type == "fa" %}
+    <i class="{{ icon }}" {% if icon_color %}style="color: {{ icon_color }};" {% endif %}></i>
+    {% elif icon_type == "unicode" %}
+    {% if "&#" in icon %}
+    {{ icon|safe }}
+    {% else %}
+    &#{{ icon }};
+    {% endif %}
+    {% else %}
+    {{ icon }}
+    {% endif %}
+  </span>
+  {% endif %}
+  {% endif %}
+
+  {{ label }}
+
+  {% if icon %}
+  {% if icon_position == "right" %}
+  <span class="ml-2 text-{{ icon_size }}">
+    {% if icon_type == "fa" %}
+    <i class="{{ icon }}" {% if icon_color %}style="color: {{ icon_color }};" {% endif %}></i>
+    {% elif icon_type == "unicode" %}
+    {% if "&#" in icon %}
+    {{ icon|safe }}
+    {% else %}
+    &#{{ icon }};
+    {% endif %}
+    {% else %}
+    {{ icon }}
+    {% endif %}
+  </span>
+  {% endif %}
+  {% endif %}
+</button>
+
+<button class="px-4 py-2 rounded flex items-center {{ class }}" type="{{ type }}" {% if disabled %}disabled{% endif %}
+  {{ attributes }}>
+  {% if icon %}
+  {% if icon_position == "left" %}
+  <span class="mr-2 text-{{ icon_size }}">
+    {% if icon_type == "fa" %}
+    <i class="{{ icon }}" {% if icon_color %}style="color: {{ icon_color }};" {% endif %}></i>
+    {% elif icon_type == "unicode" %}
+    {% if "&#" in icon %}
+    {{ icon|safe }}
+    {% else %}
+    &#{{ icon }};
+    {% endif %}
+    {% else %}
+    {{ icon }}
+    {% endif %}
+  </span>
+  {% endif %}
+  {% endif %}
+
+  {{ label }}
+
+  {% if icon %}
+  {% if icon_position == "right" %}
+  <span class="ml-2 text-{{ icon_size }}">
+    {% if icon_type == "fa" %}
+    <i class="{{ icon }}" {% if icon_color %}style="color: {{ icon_color }};" {% endif %}></i>
+    {% elif icon_type == "unicode" %}
+    {% if "&#" in icon %}
+    {{ icon|safe }}
+    {% else %}
+    &#{{ icon }};
+    {% endif %}
+    {% else %}
+    {{ icon }}
+    {% endif %}
+  </span>
+  {% endif %}
+  {% endif %}
+</button>

nexui-0.1.2/nexui/templates/components/card.html

@@ -0,0 +1,4 @@
+<div class="border rounded-lg p-4 shadow">
+    <h2 class="font-bold text-lg">{{ title }}</h2>
+    <p class="text-gray-600">{{ content }}</p>
+</div>