streamlit-rtr-components 1.0.1__tar.gz

streamlit_rtr_components-1.0.1/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018-2021 Streamlit Inc.
+
+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.

streamlit_rtr_components-1.0.1/MANIFEST.in

@@ -0,0 +1,4 @@
+recursive-include st_orgChart/frontend/dist *
+recursive-include st_hierarchicalGrid/frontend/dist *
+include README.md
+include LICENSE

streamlit_rtr_components-1.0.1/PKG-INFO

@@ -0,0 +1,281 @@
+Metadata-Version: 2.4
+Name: streamlit-rtr-components
+Version: 1.0.1
+Summary: Streamlit components: Org Chart e Hierarchical Grid
+Author-email: "Artur R. Oliveira" <arturroliveira87@gmail.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: streamlit>=1.24
+Provides-Extra: devel
+Requires-Dist: wheel; extra == "devel"
+Requires-Dist: pytest==7.4.0; extra == "devel"
+Requires-Dist: playwright==1.48.0; extra == "devel"
+Requires-Dist: requests==2.31.0; extra == "devel"
+Requires-Dist: pytest-playwright-snapshot==1.0; extra == "devel"
+Requires-Dist: pytest-rerunfailures==12.0; extra == "devel"
+Dynamic: license-file
+
+<!-- PROJECT: streamlit-rtr-components -->
+<!-- BADGES: start -->
+<p align="center">
+  <!-- Substitua o href se já estiver no PyPI -->
+  <a href="https://pypi.org/project/streamlit-rtr-components/"><img alt="PyPI" src="https://img.shields.io/pypi/v/streamlit-rtr-components.svg"></a>
+  <img alt="Python" src="https://img.shields.io/pypi/pyversions/streamlit-rtr-components.svg">
+  <img alt="Streamlit" src="https://img.shields.io/badge/streamlit-%E2%89%A51.24-FF4B4B">
+  <img alt="License" src="https://img.shields.io/badge/license-MIT-green">
+</p>
+<!-- BADGES: end -->
+
+<h1 align="center">streamlit-rtr-components</h1>
+<p align="center">Componentes customizados para <b>Streamlit</b>: organograma e grid hierárquico.</p>
+
+<!-- TOC: start -->
+## Sumário
+- [Visão geral](#visão-geral)
+- [Instalação](#instalação)
+- [Exemplo rápido](#exemplo-rápido)
+- [API](#api)
+- [Formato de dados](#formato-de-dados)
+- [Estrutura do repositório](#estrutura-do-repositório)
+- [Desenvolvimento (Vite + Tailwind v4)](#desenvolvimento-vite--tailwind-v4)
+- [Build de produção (frontend)](#build-de-produção-frontend)
+- [Empacotamento Python](#empacotamento-python)
+- [Solução de problemas](#solução-de-problemas)
+- [Changelog](#changelog)
+- [Contribuição](#contribuição)
+- [Licença](#licença)
+<!-- TOC: end -->
+
+## Visão geral
+Dois componentes prontos para uso em Streamlit:
+- `st_orgChart` — organograma (árvore hierárquica).
+- `st_hierarchicalGrid` — grid hierárquico com colunas configuráveis e suporte a imagens (PNG/SVG via data URL).
+
+> **Stack**: Python (Streamlit) + React/TypeScript (Vite) + Tailwind v4.  
+> **Artefatos**: cada frontend gera `frontend/dist` e é empacotado junto ao wheel.
+
+## Instalação
+```bash
+pip install streamlit-rtr-components
+
+
+<!-- USAGE: start -->
+
+## Exemplo rápido
+
+import streamlit as st
+from rtr_componentes import st_orgChart, st_hierarchicalGrid
+
+st.title("Demo • RTR Components")
+
+st.subheader("Org Chart")
+st_orgChart(
+    data={
+        "id": "CEO",
+        "children": [{"id": "CTO"}, {"id": "CFO"}]
+    }
+)
+
+st.subheader("Hierarchical Grid")
+data = [
+    {
+        "estrutura": "Presidência",
+        "avatar": "data:image/png;base64,....",   # PNG opcional (data URL)
+        "quantidade_funcionarios": 2167,
+        "salario_total": "R$ 5.239.551,21",
+        "salario_medio": "R$ 2.417,88",
+        "children": [
+            {
+                "estrutura": "Assessoria Financeira",
+                "avatar": "data:image/svg+xml;base64,....",  # SVG opcional (data URL)
+                "quantidade_funcionarios": 1,
+                "salario_total": "R$ 5.184,00",
+                "salario_medio": "R$ 5.184,00",
+                "children": []
+            }
+        ]
+    }
+]
+columns = [
+    {"label": "Estrutura", "field": "estrutura"},
+    {"label": "Quantidade Funcionarios", "field": "quantidade_funcionarios"},
+    {"label": "Salario Total", "field": "salario_total", "secret": True},
+    {"label": "Salario Medio", "field": "salario_medio"}
+]
+
+st_hierarchicalGrid(data=data, columns=columns, expanded=True)
+
+<!-- USAGE: end -->
+
+## API
+
+from rtr_componentes import st_orgChart, st_hierarchicalGrid
+
+st_orgChart(
+    data: dict | list | None = None,
+    key: str | None = None,
+    **kwargs
+) -> Any
+
+
+st_hierarchicalGrid(
+    data: dict | list | None = None,
+    columns: list[dict] | None = None,
+    expanded: bool = False,
+    key: str | None = None,
+    **kwargs
+) -> Any
+
+# data
+# Org: objeto/array hierárquico com id, children, etc.
+# Grid: nós com campos livres e children: [].
+# columns (Grid): {"label": str, "field": str, "secret"?: bool, "type"?: "text"|"number"|"currency"|...}.
+# expanded (Grid): expande nós por padrão.
+# Retorno: se o frontend chamar Streamlit.setComponentValue(...), o valor retorna via função Python.
+
+
+<!-- DATA-FORMAT: start -->
+
+Formato de dados
+Imagens: envie como data URL
+
+PNG → data:image/png;base64,<...>
+
+SVG → data:image/svg+xml;base64,<...>
+
+Perfomance: prefira miniaturas (ex.: 64–128 px) para reduzir payload.
+
+Grid: garanta que os nomes em columns[].field existam em cada nó.
+
+<!-- DATA-FORMAT: end -->
+
+
+## Estrutura do repositório
+
+.
+├─ st_orgChart/
+│  ├─ __init__.py                 # wrapper Python (usa frontend/dist)
+│  └─ frontend/                   # Vite/React/TS
+│     ├─ index.html
+│     ├─ src/
+│     │  ├─ main.tsx
+│     │  ├─ StOrgChart.tsx
+│     │  └─ index.css             # @import "tailwindcss";
+│     └─ dist/                    # gerado por vite build
+├─ st_hierarchicalGrid/
+│  ├─ __init__.py
+│  └─ frontend/
+│     ├─ index.html
+│     ├─ src/
+│     │  ├─ main.tsx
+│     │  ├─ RtrHierarchicalGrid.tsx
+│     │  └─ index.css
+│     └─ dist/
+├─ rtr_componentes/
+│  └─ __init__.py                 # reexporta os dois componentes
+├─ pyproject.toml
+├─ MANIFEST.in
+├─ README.md
+└─ LICENSE
+
+
+## Desenvolvimento (Vite + Tailwind v4)
+# Em cada frontend:
+
+npm i
+npm run dev
+
+## No seu app Streamlit (dev hot-reload):
+
+# Windows PowerShell
+$env:DEV_MODE="true"
+$env:FRONTEND_HOST="http://localhost:5173"   # altere a porta conforme o componente
+streamlit run seu_app.py
+
+# Em dev, o wrapper usa DEV_MODE/FRONTEND_HOST. Em produção (sem envs), ele lê frontend/dist.
+
+
+<!-- BUILD-FRONTEND: start -->
+
+## Build de produção (frontend)
+
+cd st_orgChart/frontend && npm run build
+cd ../../st_hierarchicalGrid/frontend && npm run build
+
+
+# vite.config.ts (recomendado nos dois):
+
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import tailwind from "@tailwindcss/vite";
+
+export default defineConfig(({ command }) => ({
+  base: command === "build" ? "./" : "/",
+  plugins: [react(), tailwind()],
+  build: { outDir: "dist" }
+}));
+
+<!-- BUILD-FRONTEND: end --> <!-- PACKAGING: start -->
+
+
+## Empacotamento Python
+
+# MANIFEST.in
+
+recursive-include st_orgChart/frontend/dist *
+recursive-include st_hierarchicalGrid/frontend/dist *
+include README.md
+include LICENSE
+
+
+# pyproject.toml (trechos)
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["st_orgChart*", "st_hierarchicalGrid*", "rtr_componentes*"]
+
+[tool.setuptools.package-data]
+"st_orgChart" = ["frontend/dist/**"]
+"st_hierarchicalGrid" = ["frontend/dist/**"]
+
+
+# Build & teste:
+
+python -m build
+pip install -e .
+
+<!-- PACKAGING: end --> <!-- TROUBLESHOOT: start -->
+
+# Solução de problemas
+# Tela branca/404 em produção → confirme base: "./" no Vite e que frontend/dist existe e foi incluído no wheel.
+
+# RuntimeError: Build não encontrado → rode npm run build em cada frontend antes de instalar.
+
+# Erros de JSX/TS no editor → use TS 5, moduleResolution: "bundler", jsx: "react-jsx", types: ["vite/client"].
+
+# Conflitos NPM (ERESOLVE) → se migrou de CRA, remova react-scripts, apague node_modules/package-lock.json e reinstale.
+
+# Bundle grande (Grid) → faça import dinâmico de html2canvas/jspdf somente na ação de exportar.
+
+# <!-- TROUBLESHOOT: end -->
+# Changelog
+# <!-- CHANGELOG: start -->
+# 1.0.0 — release inicial com st_orgChart e st_hierarchicalGrid.
+
+# <!-- CHANGELOG: end -->
+# Contribuição
+# Issues e PRs são bem-vindos. Antes de abrir PR:
+
+# Rode npm run build em ambos os frontends.
+
+# Rode npm run lint (se estiver usando ESLint).
+
+# Adicione/atualize exemplos no README quando necessário.
+
+
+## Licença
+# MIT — veja LICENSE.

streamlit_rtr_components-1.0.1/README.md

@@ -0,0 +1,263 @@
+<!-- PROJECT: streamlit-rtr-components -->
+<!-- BADGES: start -->
+<p align="center">
+  <!-- Substitua o href se já estiver no PyPI -->
+  <a href="https://pypi.org/project/streamlit-rtr-components/"><img alt="PyPI" src="https://img.shields.io/pypi/v/streamlit-rtr-components.svg"></a>
+  <img alt="Python" src="https://img.shields.io/pypi/pyversions/streamlit-rtr-components.svg">
+  <img alt="Streamlit" src="https://img.shields.io/badge/streamlit-%E2%89%A51.24-FF4B4B">
+  <img alt="License" src="https://img.shields.io/badge/license-MIT-green">
+</p>
+<!-- BADGES: end -->
+
+<h1 align="center">streamlit-rtr-components</h1>
+<p align="center">Componentes customizados para <b>Streamlit</b>: organograma e grid hierárquico.</p>
+
+<!-- TOC: start -->
+## Sumário
+- [Visão geral](#visão-geral)
+- [Instalação](#instalação)
+- [Exemplo rápido](#exemplo-rápido)
+- [API](#api)
+- [Formato de dados](#formato-de-dados)
+- [Estrutura do repositório](#estrutura-do-repositório)
+- [Desenvolvimento (Vite + Tailwind v4)](#desenvolvimento-vite--tailwind-v4)
+- [Build de produção (frontend)](#build-de-produção-frontend)
+- [Empacotamento Python](#empacotamento-python)
+- [Solução de problemas](#solução-de-problemas)
+- [Changelog](#changelog)
+- [Contribuição](#contribuição)
+- [Licença](#licença)
+<!-- TOC: end -->
+
+## Visão geral
+Dois componentes prontos para uso em Streamlit:
+- `st_orgChart` — organograma (árvore hierárquica).
+- `st_hierarchicalGrid` — grid hierárquico com colunas configuráveis e suporte a imagens (PNG/SVG via data URL).
+
+> **Stack**: Python (Streamlit) + React/TypeScript (Vite) + Tailwind v4.  
+> **Artefatos**: cada frontend gera `frontend/dist` e é empacotado junto ao wheel.
+
+## Instalação
+```bash
+pip install streamlit-rtr-components
+
+
+<!-- USAGE: start -->
+
+## Exemplo rápido
+
+import streamlit as st
+from rtr_componentes import st_orgChart, st_hierarchicalGrid
+
+st.title("Demo • RTR Components")
+
+st.subheader("Org Chart")
+st_orgChart(
+    data={
+        "id": "CEO",
+        "children": [{"id": "CTO"}, {"id": "CFO"}]
+    }
+)
+
+st.subheader("Hierarchical Grid")
+data = [
+    {
+        "estrutura": "Presidência",
+        "avatar": "data:image/png;base64,....",   # PNG opcional (data URL)
+        "quantidade_funcionarios": 2167,
+        "salario_total": "R$ 5.239.551,21",
+        "salario_medio": "R$ 2.417,88",
+        "children": [
+            {
+                "estrutura": "Assessoria Financeira",
+                "avatar": "data:image/svg+xml;base64,....",  # SVG opcional (data URL)
+                "quantidade_funcionarios": 1,
+                "salario_total": "R$ 5.184,00",
+                "salario_medio": "R$ 5.184,00",
+                "children": []
+            }
+        ]
+    }
+]
+columns = [
+    {"label": "Estrutura", "field": "estrutura"},
+    {"label": "Quantidade Funcionarios", "field": "quantidade_funcionarios"},
+    {"label": "Salario Total", "field": "salario_total", "secret": True},
+    {"label": "Salario Medio", "field": "salario_medio"}
+]
+
+st_hierarchicalGrid(data=data, columns=columns, expanded=True)
+
+<!-- USAGE: end -->
+
+## API
+
+from rtr_componentes import st_orgChart, st_hierarchicalGrid
+
+st_orgChart(
+    data: dict | list | None = None,
+    key: str | None = None,
+    **kwargs
+) -> Any
+
+
+st_hierarchicalGrid(
+    data: dict | list | None = None,
+    columns: list[dict] | None = None,
+    expanded: bool = False,
+    key: str | None = None,
+    **kwargs
+) -> Any
+
+# data
+# Org: objeto/array hierárquico com id, children, etc.
+# Grid: nós com campos livres e children: [].
+# columns (Grid): {"label": str, "field": str, "secret"?: bool, "type"?: "text"|"number"|"currency"|...}.
+# expanded (Grid): expande nós por padrão.
+# Retorno: se o frontend chamar Streamlit.setComponentValue(...), o valor retorna via função Python.
+
+
+<!-- DATA-FORMAT: start -->
+
+Formato de dados
+Imagens: envie como data URL
+
+PNG → data:image/png;base64,<...>
+
+SVG → data:image/svg+xml;base64,<...>
+
+Perfomance: prefira miniaturas (ex.: 64–128 px) para reduzir payload.
+
+Grid: garanta que os nomes em columns[].field existam em cada nó.
+
+<!-- DATA-FORMAT: end -->
+
+
+## Estrutura do repositório
+
+.
+├─ st_orgChart/
+│  ├─ __init__.py                 # wrapper Python (usa frontend/dist)
+│  └─ frontend/                   # Vite/React/TS
+│     ├─ index.html
+│     ├─ src/
+│     │  ├─ main.tsx
+│     │  ├─ StOrgChart.tsx
+│     │  └─ index.css             # @import "tailwindcss";
+│     └─ dist/                    # gerado por vite build
+├─ st_hierarchicalGrid/
+│  ├─ __init__.py
+│  └─ frontend/
+│     ├─ index.html
+│     ├─ src/
+│     │  ├─ main.tsx
+│     │  ├─ RtrHierarchicalGrid.tsx
+│     │  └─ index.css
+│     └─ dist/
+├─ rtr_componentes/
+│  └─ __init__.py                 # reexporta os dois componentes
+├─ pyproject.toml
+├─ MANIFEST.in
+├─ README.md
+└─ LICENSE
+
+
+## Desenvolvimento (Vite + Tailwind v4)
+# Em cada frontend:
+
+npm i
+npm run dev
+
+## No seu app Streamlit (dev hot-reload):
+
+# Windows PowerShell
+$env:DEV_MODE="true"
+$env:FRONTEND_HOST="http://localhost:5173"   # altere a porta conforme o componente
+streamlit run seu_app.py
+
+# Em dev, o wrapper usa DEV_MODE/FRONTEND_HOST. Em produção (sem envs), ele lê frontend/dist.
+
+
+<!-- BUILD-FRONTEND: start -->
+
+## Build de produção (frontend)
+
+cd st_orgChart/frontend && npm run build
+cd ../../st_hierarchicalGrid/frontend && npm run build
+
+
+# vite.config.ts (recomendado nos dois):
+
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import tailwind from "@tailwindcss/vite";
+
+export default defineConfig(({ command }) => ({
+  base: command === "build" ? "./" : "/",
+  plugins: [react(), tailwind()],
+  build: { outDir: "dist" }
+}));
+
+<!-- BUILD-FRONTEND: end --> <!-- PACKAGING: start -->
+
+
+## Empacotamento Python
+
+# MANIFEST.in
+
+recursive-include st_orgChart/frontend/dist *
+recursive-include st_hierarchicalGrid/frontend/dist *
+include README.md
+include LICENSE
+
+
+# pyproject.toml (trechos)
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["st_orgChart*", "st_hierarchicalGrid*", "rtr_componentes*"]
+
+[tool.setuptools.package-data]
+"st_orgChart" = ["frontend/dist/**"]
+"st_hierarchicalGrid" = ["frontend/dist/**"]
+
+
+# Build & teste:
+
+python -m build
+pip install -e .
+
+<!-- PACKAGING: end --> <!-- TROUBLESHOOT: start -->
+
+# Solução de problemas
+# Tela branca/404 em produção → confirme base: "./" no Vite e que frontend/dist existe e foi incluído no wheel.
+
+# RuntimeError: Build não encontrado → rode npm run build em cada frontend antes de instalar.
+
+# Erros de JSX/TS no editor → use TS 5, moduleResolution: "bundler", jsx: "react-jsx", types: ["vite/client"].
+
+# Conflitos NPM (ERESOLVE) → se migrou de CRA, remova react-scripts, apague node_modules/package-lock.json e reinstale.
+
+# Bundle grande (Grid) → faça import dinâmico de html2canvas/jspdf somente na ação de exportar.
+
+# <!-- TROUBLESHOOT: end -->
+# Changelog
+# <!-- CHANGELOG: start -->
+# 1.0.0 — release inicial com st_orgChart e st_hierarchicalGrid.
+
+# <!-- CHANGELOG: end -->
+# Contribuição
+# Issues e PRs são bem-vindos. Antes de abrir PR:
+
+# Rode npm run build em ambos os frontends.
+
+# Rode npm run lint (se estiver usando ESLint).
+
+# Adicione/atualize exemplos no README quando necessário.
+
+
+## Licença
+# MIT — veja LICENSE.

streamlit_rtr_components-1.0.1/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "streamlit-rtr-components"
+version = "1.0.1"
+description = "Streamlit components: Org Chart e Hierarchical Grid"
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [{ name = "Artur R. Oliveira", email = "arturroliveira87@gmail.com" }]
+dependencies = ["streamlit>=1.24"]
+
+[project.optional-dependencies]
+devel = [
+  "wheel",
+  "pytest==7.4.0",
+  "playwright==1.48.0",
+  "requests==2.31.0",
+  "pytest-playwright-snapshot==1.0",
+  "pytest-rerunfailures==12.0",
+]
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["st_orgChart*", "st_hierarchicalGrid*", "rtr_componentes*"]
+
+# Garante que os artefatos do frontend (dist) entrem no wheel/sdist
+[tool.setuptools.package-data]
+"st_orgChart" = ["frontend/dist/**"]
+"st_hierarchicalGrid" = ["frontend/dist/**"]

streamlit_rtr_components-1.0.1/rtr_componentes/__init__.py

@@ -0,0 +1,5 @@
+# rtr_componentes/__init__.py
+from st_orgChart import st_orgChart
+from st_hierarchicalGrid import st_hierarchicalGrid
+
+__all__ = ["st_orgChart", "st_hierarchicalGrid"]

streamlit_rtr_components-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

streamlit_rtr_components-1.0.1/st_hierarchicalGrid/__init__.py

@@ -0,0 +1,39 @@
+import os
+from pathlib import Path
+import streamlit
+import streamlit.components.v1 as components
+
+_COMPONENT_NAME = "st_hierarchicalGrid"
+
+def _declare_component():
+    if os.getenv("DEV_MODE", "").lower() == "true":
+        host = os.getenv("FRONTEND_HOST_GRID", "http://localhost:3001")
+        return components.declare_component(_COMPONENT_NAME, url=host)
+
+    base = Path(__file__).parent / "frontend"
+    dist = base / "dist" # Vite
+    if dist.exists():
+        return components.declare_component(_COMPONENT_NAME, path=str(dist))
+
+    build = base / "build" # fallback se algum ainda for CRA
+    if build.exists():
+        return components.declare_component(_COMPONENT_NAME, path=str(build))
+
+    raise RuntimeError(f"Nenhum build encontrado em {dist} ou {build}. Rode `npm run build`.")
+
+_component_func = _declare_component()
+
+def st_hierarchicalGrid(data, columns, expanded, key=None):
+    """
+    Função que exibe o Grid Hierárquico.
+
+    Args:
+        data (list|dict): Dados hierárquicos.
+        columns (list|dict): Definição de colunas.
+        expanded (bool): Expandir nós por padrão.
+        key (str): Chave do componente.
+    Returns:
+        any: Valor retornado pelo front-end (se houver).
+    """
+    component_value = _component_func(data=data,columns=columns,expanded=expanded, key=key, default=0)  
+    return component_value