pyreact-framework 1.0.0__tar.gz

pyreact_framework-1.0.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,327 @@
+# 🐍 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**