pyreact-framework 1.0.0__py3-none-any.whl

pyreact_framework-1.0.0.dist-info/METADATA

@@ -0,0 +1,363 @@
+Metadata-Version: 2.4
+Name: pyreact-framework
+Version: 1.0.0
+Summary: Framework web declarativo inspirado no React, construído nativamente para Python
+Author-email: PyReact Team <pyreact@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/pyreact/pyreact
+Project-URL: Documentation, https://pyreact.readthedocs.io
+Project-URL: Repository, https://github.com/pyreact/pyreact
+Project-URL: Issues, https://github.com/pyreact/pyreact/issues
+Keywords: react,ui,frontend,declarative,components,virtual-dom,web,framework
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Dynamic: license-file
+
+# 🐍 PyReact - Framework Web Declarativo para Python
+
+[![PyPI version](https://badge.fury.io/py/pyreact.svg)](https://pypi.org/project/pyreact/)
+[![Python](https://img.shields.io/pypi/pyversions/pyreact.svg)](https://pypi.org/project/pyreact/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**PyReact** é um framework web declarativo inspirado no React, mas construído nativamente para Python. Permite criar interfaces de usuário reativas, com componentes, hooks e renderização eficiente.
+
+---
+
+## 📦 Instalação
+
+### Via pip (Recomendado)
+
+```bash
+pip install pyreact-framework
+```
+
+### Via pip (GitHub)
+
+```bash
+pip install git+https://github.com/seu-usuario/pyreact.git
+```
+
+### Desenvolvimento Local
+
+```bash
+git clone https://github.com/seu-usuario/pyreact.git
+cd pyreact
+pip install -e .
+```
+
+---
+
+## 🚀 Início Rápido
+
+### Criar um Novo Projeto
+
+```bash
+# Criar projeto
+pyreact-framework create meu-app
+
+# Entrar no diretório
+cd meu-app
+
+# Iniciar servidor de desenvolvimento
+pyreact-framework dev
+```
+
+### Exemplo de Contador
+
+```python
+from pyreact import h, render, use_state, Component
+
+def Counter(props):
+    """Componente de contador funcional"""
+    count, set_count = use_state(0)
+    
+    return h('div', {'className': 'counter'},
+        h('h1', None, f'Contador: {count}'),
+        h('button', {'onClick': lambda: set_count(count + 1)}, '+'),
+        h('button', {'onClick': lambda: set_count(count - 1)}, '-')
+    )
+
+# Renderizar
+root = document.getElementById('root')
+render(h(Counter, None), root)
+```
+
+---
+
+## ✨ Funcionalidades
+
+### Componentes Funcionais
+
+```python
+def Button(props):
+    """Componente de botão reutilizável"""
+    return h('button', {
+        'className': 'btn',
+        'onClick': props.get('onClick')
+    }, props.get('children'))
+```
+
+### Componentes de Classe
+
+```python
+class Counter(Component):
+    """Componente de contador com estado"""
+    
+    def __init__(self, props):
+        super().__init__(props)
+        self.state = {'count': 0}
+    
+    def render(self):
+        return h('div', None,
+            h('h1', None, f'Count: {self.state["count"]}'),
+            h('button', {
+                'onClick': lambda: self.set_state({'count': self.state['count'] + 1})
+            }, 'Increment')
+        )
+```
+
+### Hooks
+
+```python
+from pyreact import use_state, use_effect, use_ref
+
+def MyComponent(props):
+    # Estado local
+    count, set_count = use_state(0)
+    
+    # Efeito colateral
+    use_effect(lambda: print(f'Count: {count}'), [count])
+    
+    # Referência
+    input_ref = use_ref(None)
+    
+    return h('div', None, f'Count: {count}')
+```
+
+---
+
+## 📖 Documentação
+
+### CLI Commands
+
+```bash
+# Criar novo projeto
+pyreact create <nome>
+
+# Iniciar servidor de desenvolvimento
+pyreact-framework dev [--port PORT]
+
+# Gerar componente
+pyreact generate component <nome>
+
+# Gerar hook
+pyreact generate hook <nome>
+
+# Build para produção
+pyreact build
+```
+
+### API Principal
+
+#### `h(type, props, *children)`
+
+Cria um elemento virtual (VNode).
+
+```python
+h('div', {'className': 'container'},
+    h('h1', None, 'Título'),
+    h('p', None, 'Parágrafo')
+)
+```
+
+#### `render(element, container)`
+
+Renderiza um elemento no container.
+
+```python
+render(h(App, None), document.getElementById('root'))
+```
+
+#### `create_root(container)`
+
+Cria uma raiz de renderização (API moderna).
+
+```python
+root = create_root(document.getElementById('root'))
+root.render(h(App, None))
+```
+
+---
+
+## 🧪 Testes
+
+### Executar Testes
+
+```bash
+# Testes unitários
+pytest tests/
+
+# Testes E2E
+python tests/e2e/test_simple_e2e.py
+
+# Testes A/B
+python tests/e2e/test_ab_counter.py
+
+# Com cobertura
+pytest tests/ --cov=pyreact
+```
+
+### Documentação de Testes
+
+Ver `Teste_Documentos/README.md` para mais detalhes.
+
+---
+
+## 📁 Estrutura do Projeto
+
+```
+pyreact/
+├── pyreact/              # Código fonte
+│   ├── cli/              # Interface de linha de comando
+│   ├── core/             # Núcleo do framework
+│   ├── dom/              # Operações DOM
+│   ├── server/           # Renderização servidor
+│   └── utils/            # Utilitários
+├── tests/                # Testes
+│   ├── e2e/              # Testes end-to-end
+│   └── unit/             # Testes unitários
+├── examples/             # Exemplos
+├── Teste_Documentos/     # Documentação de testes
+├── pyproject.toml        # Configuração do projeto
+├── README.md             # Este arquivo
+├── INSTALL.md            # Guia de instalação
+├── PUBLISH.md            # Guia de publicação
+└── LICENSE               # Licença MIT
+```
+
+---
+
+## 🛠️ Desenvolvimento
+
+### Configurar Ambiente
+
+```bash
+# Clonar repositório
+git clone https://github.com/seu-usuario/pyreact.git
+cd pyreact
+
+# Criar ambiente virtual
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+venv\Scripts\activate     # Windows
+
+# Instalar dependências
+pip install -e .
+
+# Instalar dependências de desenvolvimento
+pip install pytest pytest-cov playwright
+playwright install chromium
+```
+
+### Executar em Desenvolvimento
+
+```bash
+# Instalar em modo editável
+pip install -e .
+
+# Executar testes
+pytest tests/ -v
+
+# Criar build
+python -m build
+```
+
+---
+
+## 📦 Publicação
+
+### Build
+
+```bash
+# Limpar builds anteriores
+python -c "import shutil; from pathlib import Path; [shutil.rmtree(p, ignore_errors=True) for p in ['build', 'dist', 'pyreact.egg-info']]"
+
+# Criar build
+python -m build
+```
+
+### Publicar no PyPI
+
+```bash
+# Instalar twine
+pip install twine
+
+# Verificar build
+twine check dist/*
+
+# Publicar no TestPyPI (teste)
+twine upload --repository testpypi dist/*
+
+# Publicar no PyPI (oficial)
+twine upload dist/*
+```
+
+Ver `PUBLISH.md` para mais detalhes.
+
+---
+
+## 🤝 Contribuindo
+
+Contribuições são bem-vindas! Por favor:
+
+1. Fork o projeto
+2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)
+3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
+4. Push para a branch (`git push origin feature/AmazingFeature`)
+5. Abra um Pull Request
+
+---
+
+## 📝 Licença
+
+Este projeto está licenciado sob a licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.
+
+---
+
+## 📞 Contato
+
+- **GitHub Issues:** https://github.com/seu-usuario/pyreact/issues
+- **Documentação:** https://pyreact.readthedocs.io/
+- **Email:** contato@pyreact.dev
+
+---
+
+## 🙏 Agradecimentos
+
+- Inspirado no [React](https://reactjs.org/)
+- Construído com ❤️ pela comunidade Python
+
+---
+
+**Feito com ❤️ pela comunidade Python**

pyreact_framework-1.0.0.dist-info/RECORD

@@ -0,0 +1,41 @@
+pyreact/__init__.py,sha256=bQdXNSxGmy-gBrGk7XZgLMnpMDVwIO3tNOhWsWpNito,3109
+pyreact/cli/__init__.py,sha256=Ri-R-tYpMHAsPB6079Jyo-5azMwL3HJ7UmlRctMbK-A,30
+pyreact/cli/main.py,sha256=w5ULP6dkZSsL2umVEuScqOgQfkfz9fslNAE5E_mUxSY,15588
+pyreact/core/__init__.py,sha256=Wr5iN6WrkLpK-hLQ4qbSKgZE4-fR1BsJrEKY6gAc9RE,1767
+pyreact/core/component.py,sha256=4sWWIHcKkmynWXXYNpIyEx9prkXz3-pFWMoIOWyIO-A,10877
+pyreact/core/context.py,sha256=CneI1fQ7XPE_1ZyMsbc7KGy2halg4okNoW4zUDN-rxU,5177
+pyreact/core/element.py,sha256=_ZqvCAfh_v1WHgzw8hDZJcESHLoUghWTF5pmvQ6wm0A,6170
+pyreact/core/error_boundary.py,sha256=pD0z0dP0kvZ4vVmVA2455WKD1SiMJgAXzpvQzzvXesQ,4070
+pyreact/core/hooks.py,sha256=4xdGdctp77SP_j_49QUX3To_bAsLkhRwadXnOA48xrY,15878
+pyreact/core/memo.py,sha256=ydBwTpfmciCGqsYHWR4BvMGG3Ba06-LTZiJESDPJsPA,6402
+pyreact/core/portal.py,sha256=bpSpuOQIkKP0NGNMWVwFRx85EAOlTxcDZsbl21IdbHU,4338
+pyreact/core/reconciler.py,sha256=9eNyuXPv5pa-YyWuKLI6IipjYFuHPF-wcOncwgTmuOU,13942
+pyreact/core/refs.py,sha256=rhP6IB9FCxY2HasneTyNtifAMGxvh28cleOGwFG9ZPY,5226
+pyreact/core/renderer.py,sha256=BUfbfBT6kVaX9qwgEW-Bw6Da67S33JL6KF0uotnrM0o,3627
+pyreact/core/scheduler.py,sha256=V38B-CwPfIAYYrLypLPvDoZbZu8PBTUSmTOxEgcs0Bw,9115
+pyreact/devtools/__init__.py,sha256=tV2VbI_rQ06oTHYAtRZRYrjIdgMAbDbWC4xyY5WC-BM,404
+pyreact/devtools/debugger.py,sha256=SaURgqsMnFKJqMT4ywDvv_eSiZldGBuIQUOnFWOE_HA,8474
+pyreact/devtools/profiler.py,sha256=GWqcsixZTRZq7o2FAysCkUIbVpp14Y7smv8cjAy-hdo,8033
+pyreact/dom/__init__.py,sha256=03aB3z-OY3jpeilcZE2gV4XYlF08mwzCu9UYhXBXA3s,1386
+pyreact/dom/attributes.py,sha256=XiP29AxI06ZgwSEPLs4FTuNNSJmuMFMkMBsKO1YmcZ8,7026
+pyreact/dom/dom_operations.py,sha256=anvtZ0VEn_RP_xC_h3w1qKu12Xxbuw_sk2Xt_LC-0ns,11188
+pyreact/dom/events.py,sha256=8OfnePGA0x9RgYR3L86eKjO7ZSLD6VDs-EjQIIixVng,12129
+pyreact/server/__init__.py,sha256=ZYxAMML_vCy3JfldvXJYq6ECk7RhIwIMykzMGoPvGX4,761
+pyreact/server/hydration.py,sha256=QNaALMVSBiZmE4aNdiT0ZAa_gtzafuKakGdZm5-dleo,5938
+pyreact/server/ssr.py,sha256=61e2wHx-fluaUOTY5FyUEKO2rrpvoAiMTsjzeg8EA54,8871
+pyreact/styles/__init__.py,sha256=nnZu5ZGigJR5ZBNtImFL_078dtAPa8Nkv7IrusrB_hc,371
+pyreact/styles/css_module.py,sha256=SwuuYQ0LUc4EqI_ZeYQEfyyJJNNOqsBNhJZcz-_JQWk,5410
+pyreact/styles/styled.py,sha256=QjCUnVDlpZRITpQJmcJNGdOZLUy1AdtatWbMSo5oO78,7543
+pyreact/testing/__init__.py,sha256=O7eOW-qbymFTUkY7Q0zO2s_oq5LagwD4_fXqs9GktAY,1132
+pyreact/testing/fire_event.py,sha256=NBotjOHNgKj8FFbSQXpoHVTVUrlehXzRYT30o1EsAOE,10350
+pyreact/testing/screen.py,sha256=M9ogKT56vQEYSfGTwNy9D0Mc1sapp79hja0PTQyU7Mg,8953
+pyreact/testing/test_renderer.py,sha256=WW-VMKse7X2dLjcUZk7uY_34-aQuXrd6fyFlIHtBNxo,7219
+pyreact/utils/__init__.py,sha256=eaMMUkYy358rPjSVjB1wc_eEaXzcki9_ffyMHEavjLE,320
+pyreact/utils/diff.py,sha256=N-1tUgNVO9LlpxusMJ5iVDIyUwCg9SOr-GtpEhxCSYY,4201
+pyreact/utils/object_pool.py,sha256=e2Iz9jOba272weRc4CPxWQZaYCGgUl-U4aum0kqRMQE,5416
+pyreact_framework-1.0.0.dist-info/licenses/LICENSE,sha256=Kp_vzqhu7sWtmkDjT1UxguEwN3vaIe62_d7qsSg4yME,1090
+pyreact_framework-1.0.0.dist-info/METADATA,sha256=D7zabI7wpzkkfhC9w0jBosXbVFdT_BHneEKkQb5C2NU,8622
+pyreact_framework-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pyreact_framework-1.0.0.dist-info/entry_points.txt,sha256=rnTYkO8t9PHkXQ_jrwAsd2cBdlCdP4DoZxD8l7uUUPs,60
+pyreact_framework-1.0.0.dist-info/top_level.txt,sha256=fXi82-i0hGELO6kYzU5KI5MvDCn_xz5_Gkizutz3Z9E,8
+pyreact_framework-1.0.0.dist-info/RECORD,,

pyreact_framework-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pyreact_framework-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pyreact-framework = pyreact.cli.main:main

pyreact_framework-1.0.0.dist-info/licenses/LICENSE

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

pyreact_framework-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pyreact