django-usp-theme 0.1.0__tar.gz

django_usp_theme-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 USP
+
+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.

django_usp_theme-0.1.0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: django-usp-theme
+Version: 0.1.0
+Summary: Tema visual USP para aplicações Django — design system, componentes e templates reutilizáveis.
+License-Expression: MIT
+Project-URL: Repository, https://github.com/usp/django-usp-theme
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: django>=4.2
+Dynamic: license-file
+
+# django-usp-theme
+
+Tema visual USP para aplicações Django — design system, componentes e templates reutilizáveis.
+
+## Instalação
+
+```bash
+pip install django-usp-theme
+```
+
+## Configuração
+
+Adicione `django_usp_theme` ao `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    ...
+    'django_usp_theme',
+]
+```
+
+## Uso
+
+### Template base
+
+Estenda o template base em seus templates:
+
+```html
+{% extends "usp_theme/base.html" %}
+{% load static usp_filters %}
+
+{% block title %}Minha Aplicação{% endblock %}
+
+{% block header_logo %}
+<a href="https://www.usp.br">
+    <img src="{% static 'usp_theme/img/usp-logo-f.png' %}" alt="Logo USP">
+</a>
+{% endblock %}
+
+{% block brand %}Minha Aplicação{% endblock %}
+
+{% block nav %}
+<a class="nav-link" href="{% url 'home' %}">INÍCIO</a>
+<a class="nav-link" href="{% url 'lista' %}">LISTA</a>
+{% endblock %}
+
+{% block nav_user %}
+<div class="nav-user">
+    <span>{{ user.username }}</span>
+    <form action="{% url 'logout' %}" method="post" class="mb-0">
+        {% csrf_token %}
+        <button type="submit" class="btn btn-sm btn-outline-secondary">
+            <i class="bi bi-door-open"></i> Sair
+        </button>
+    </form>
+</div>
+{% endblock %}
+
+{% block content %}
+<!-- Conteúdo da página -->
+{% endblock %}
+```
+
+### Componentes
+
+#### Page Header
+
+```html
+{% include "usp_theme/components/page_header.html" %}
+```
+
+Ou com bloco:
+
+```html
+{% include "usp_theme/components/page_header.html" with title="Minha Página" %}
+```
+
+#### Content Card
+
+```html
+{% include "usp_theme/components/content_card.html" with card_title="Título do Card" %}
+```
+
+#### Empty State
+
+```html
+{% include "usp_theme/components/empty_state.html" %}
+```
+
+Ou customizado:
+
+```html
+{% include "usp_theme/components/empty_state.html" with empty_icon="bi-folder" empty_text="Nenhum item encontrado." %}
+```
+
+#### Loading Button
+
+```html
+{% include "usp_theme/components/loading_button.html" with text="Salvar" icon="bi-check-lg" loading=False %}
+```
+
+### Template Tags
+
+#### usp_moeda
+
+Formata valor para formato brasileiro:
+
+```html
+{% load usp_filters %}
+
+{{ valor|usp_moeda }}
+<!-- Saída: R$ 1.234,56 -->
+```
+
+#### usp_filename
+
+Extrai nome do arquivo de um caminho:
+
+```html
+{% load usp_filters %}
+
+{{ caminho|usp_filename }}
+<!-- Saída: arquivo.docx -->
+```
+
+## CSS
+
+O design system é composto por módulos CSS:
+
+- `tokens.css` — Variáveis CSS (cores, tipografia, espaçamento)
+- `base.css` — Reset e tipografia
+- `components.css` — Botões, formulários, tabelas, cards, alertas
+- `layout.css` — Header, navegação, container
+- `utilities.css` — Espaçamento, impressão, acessibilidade
+
+Para usar apenas parte do CSS:
+
+```html
+<link href="{% static 'usp_theme/css/tokens.css' %}" rel="stylesheet">
+<link href="{% static 'usp_theme/css/base.css' %}" rel="stylesheet">
+```
+
+Ou usar o CSS unificado:
+
+```html
+<link href="{% static 'usp_theme/css/usp_theme.css' %}" rel="stylesheet">
+```
+
+## Variáveis CSS
+
+O tema utiliza CSS custom properties com prefixo `--usp-*`. Para customizar:
+
+```css
+:root {
+    --usp-color-primary: #0066cc; /* Cor primária personalizada */
+}
+```
+
+## Licença
+
+MIT

django_usp_theme-0.1.0/README.md

@@ -0,0 +1,161 @@
+# django-usp-theme
+
+Tema visual USP para aplicações Django — design system, componentes e templates reutilizáveis.
+
+## Instalação
+
+```bash
+pip install django-usp-theme
+```
+
+## Configuração
+
+Adicione `django_usp_theme` ao `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    ...
+    'django_usp_theme',
+]
+```
+
+## Uso
+
+### Template base
+
+Estenda o template base em seus templates:
+
+```html
+{% extends "usp_theme/base.html" %}
+{% load static usp_filters %}
+
+{% block title %}Minha Aplicação{% endblock %}
+
+{% block header_logo %}
+<a href="https://www.usp.br">
+    <img src="{% static 'usp_theme/img/usp-logo-f.png' %}" alt="Logo USP">
+</a>
+{% endblock %}
+
+{% block brand %}Minha Aplicação{% endblock %}
+
+{% block nav %}
+<a class="nav-link" href="{% url 'home' %}">INÍCIO</a>
+<a class="nav-link" href="{% url 'lista' %}">LISTA</a>
+{% endblock %}
+
+{% block nav_user %}
+<div class="nav-user">
+    <span>{{ user.username }}</span>
+    <form action="{% url 'logout' %}" method="post" class="mb-0">
+        {% csrf_token %}
+        <button type="submit" class="btn btn-sm btn-outline-secondary">
+            <i class="bi bi-door-open"></i> Sair
+        </button>
+    </form>
+</div>
+{% endblock %}
+
+{% block content %}
+<!-- Conteúdo da página -->
+{% endblock %}
+```
+
+### Componentes
+
+#### Page Header
+
+```html
+{% include "usp_theme/components/page_header.html" %}
+```
+
+Ou com bloco:
+
+```html
+{% include "usp_theme/components/page_header.html" with title="Minha Página" %}
+```
+
+#### Content Card
+
+```html
+{% include "usp_theme/components/content_card.html" with card_title="Título do Card" %}
+```
+
+#### Empty State
+
+```html
+{% include "usp_theme/components/empty_state.html" %}
+```
+
+Ou customizado:
+
+```html
+{% include "usp_theme/components/empty_state.html" with empty_icon="bi-folder" empty_text="Nenhum item encontrado." %}
+```
+
+#### Loading Button
+
+```html
+{% include "usp_theme/components/loading_button.html" with text="Salvar" icon="bi-check-lg" loading=False %}
+```
+
+### Template Tags
+
+#### usp_moeda
+
+Formata valor para formato brasileiro:
+
+```html
+{% load usp_filters %}
+
+{{ valor|usp_moeda }}
+<!-- Saída: R$ 1.234,56 -->
+```
+
+#### usp_filename
+
+Extrai nome do arquivo de um caminho:
+
+```html
+{% load usp_filters %}
+
+{{ caminho|usp_filename }}
+<!-- Saída: arquivo.docx -->
+```
+
+## CSS
+
+O design system é composto por módulos CSS:
+
+- `tokens.css` — Variáveis CSS (cores, tipografia, espaçamento)
+- `base.css` — Reset e tipografia
+- `components.css` — Botões, formulários, tabelas, cards, alertas
+- `layout.css` — Header, navegação, container
+- `utilities.css` — Espaçamento, impressão, acessibilidade
+
+Para usar apenas parte do CSS:
+
+```html
+<link href="{% static 'usp_theme/css/tokens.css' %}" rel="stylesheet">
+<link href="{% static 'usp_theme/css/base.css' %}" rel="stylesheet">
+```
+
+Ou usar o CSS unificado:
+
+```html
+<link href="{% static 'usp_theme/css/usp_theme.css' %}" rel="stylesheet">
+```
+
+## Variáveis CSS
+
+O tema utiliza CSS custom properties com prefixo `--usp-*`. Para customizar:
+
+```css
+:root {
+    --usp-color-primary: #0066cc; /* Cor primária personalizada */
+}
+```
+
+## Licença
+
+MIT

django_usp_theme-0.1.0/django_usp_theme/static/usp_theme/css/base.css

@@ -0,0 +1,53 @@
+/* ============================================
+   USP Theme — Base
+   ============================================ */
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  font-family: var(--usp-font-sans);
+  font-size: var(--usp-text-base);
+  line-height: var(--usp-leading-normal);
+  color: var(--usp-color-ink);
+  background-color: var(--usp-color-bg);
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+/* ---------- Typography ---------- */
+
+h1, h2, h3, h4, h5, h6 {
+  margin-top: 0;
+  font-weight: var(--usp-weight-semibold);
+  line-height: var(--usp-leading-tight);
+  color: var(--usp-color-ink);
+  text-wrap: balance;
+}
+
+h1 { font-size: var(--usp-text-4xl); }
+h2 { font-size: var(--usp-text-3xl); }
+h3 { font-size: var(--usp-text-2xl); }
+h4 { font-size: var(--usp-text-xl); }
+h5 { font-size: var(--usp-text-lg); }
+h6 { font-size: var(--usp-text-base); }
+
+p {
+  text-wrap: pretty;
+}
+
+.text-muted {
+  color: var(--usp-color-ink-muted) !important;
+}
+
+.text-secondary {
+  color: var(--usp-color-ink-secondary) !important;
+}
+
+small {
+  font-size: var(--usp-text-xs);
+}