pyzbrowser 1.0.0__py3-none-any.whl

pyzbrowser/utils.py

@@ -0,0 +1,120 @@
+import os
+import sys
+from pathlib import Path
+
+
+# Carregar pastas raiz da variável de ambiente ou usar padrão
+# Formato da variável PYBROWSER_ROOTS: caminhos separados por vírgula
+# Exemplo: PYBROWSER_ROOTS=C:\Users\p0666678\Downloads,C:\Users\p0666678\Documents,D:\Projetos
+# O nome de cada pasta será extraído automaticamente do caminho
+def load_root_dirs():
+    env_roots = os.environ.get("PYBROWSER_ROOTS")
+
+    # SE O USUARIO COLOCOU O PARAMETRO EM SYS ARGS -r
+    if "-r" in sys.argv:
+        index = sys.argv.index("-r")
+        if index + 1 < len(sys.argv):
+            env_roots = sys.argv[index + 1]
+
+    if env_roots:
+        # Formato simples: caminhos separados por vírgula
+        paths = [p.strip() for p in env_roots.split(";") if p.strip()]
+
+        if paths:
+            result = []
+            for path_str in paths:
+                # Resolver o caminho completo
+                path_obj = Path(path_str).resolve()
+                # Usar o nome da pasta como nome de exibição
+                folder_name = Path(
+                    path_obj
+                ).name  # Passamos novamente por PAth caso a pasta original nao tenha nome
+                result.append((folder_name, str(path_obj)))
+
+            if result:
+                print(f"Usando pastas raiz: {', '.join([name for name, _ in result])}")
+                return result
+
+    # Detectar automaticamente a pasta Downloads do usuário atual
+    downloads_path = os.path.join(os.path.expanduser("~"), "Downloads")
+    return [
+        ("Downloads", downloads_path),
+    ]
+
+
+def get_root_dir(root_name, ROOT_DIRS):
+    """Retorna o caminho completo de uma pasta raiz pelo nome"""
+    for name, path in ROOT_DIRS:
+        if name == root_name:
+            return path
+    return None
+
+
+def get_root_name_from_path(subpath):
+    """Extrai o nome da raiz do subpath"""
+    if not subpath:
+        return None
+    parts = subpath.split("/", 1)
+    return parts[0] if parts else None
+
+
+def remove_root_from_path(subpath):
+    """Remove o nome da raiz do subpath"""
+    if not subpath:
+        return ""
+    parts = subpath.split("/", 1)
+    return parts[1] if len(parts) > 1 else ""
+
+
+def get_file_icon(filename, is_dir):
+    """Retorna o emoji apropriado baseado no tipo de arquivo"""
+    if is_dir:
+        return "📁"
+
+    ext = os.path.splitext(filename)[1].lower()
+
+    # Imagens
+    if ext in [".jpg", ".jpeg", ".png", ".gif", ".bmp", ".svg", ".webp", ".ico"]:
+        return "🖼️"
+    # Vídeos
+    elif ext in [".mp4", ".avi", ".mkv", ".mov", ".wmv", ".flv", ".webm"]:
+        return "🎬"
+    # Áudio
+    elif ext in [".mp3", ".wav", ".flac", ".aac", ".ogg", ".m4a", ".wma"]:
+        return "🎵"
+    # Documentos
+    elif ext in [".pdf"]:
+        return "📕"
+    elif ext in [".doc", ".docx"]:
+        return "📘"
+    elif ext in [".xls", ".xlsx", ".csv"]:
+        return "📊"
+    elif ext in [".ppt", ".pptx"]:
+        return "📙"
+    # Compactados
+    elif ext in [".zip", ".rar", ".7z", ".tar", ".gz", ".bz2"]:
+        return "🗜️"
+    # Código
+    elif ext in [".py"]:
+        return "🐍"
+    elif ext in [".js", ".jsx", ".ts", ".tsx"]:
+        return "📜"
+    elif ext in [".html", ".htm"]:
+        return "🌐"
+    elif ext in [".css", ".scss", ".sass"]:
+        return "🎨"
+    elif ext in [".java"]:
+        return "☕"
+    elif ext in [".c", ".cpp", ".h", ".hpp"]:
+        return "⚙️"
+    elif ext in [".json", ".xml", ".yaml", ".yml"]:
+        return "📋"
+    # Texto
+    elif ext in [".txt", ".md", ".log"]:
+        return "📝"
+    # Executáveis
+    elif ext in [".exe", ".msi", ".app", ".dmg"]:
+        return "⚡"
+    # Padrão
+    else:
+        return "📄"

pyzbrowser-1.0.0.dist-info/METADATA

@@ -0,0 +1,313 @@
+Metadata-Version: 2.4
+Name: pyzbrowser
+Version: 1.0.0
+Summary: Library to create a file browser interface in browser using Python.
+Home-page: 
+Author: 
+Author-email: 
+License: MIT
+Keywords: pyzbrowser
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Description-Content-Type: text/markdown
+Requires-Dist: Flask==3.0.3
+Requires-Dist: zipstream-new==1.1.8
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: keywords
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: summary
+
+# 🐍 PyMyFileBrowser
+
+[![Python Version](https://img.shields.io/badge/python-3.6+-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Flask](https://img.shields.io/badge/flask-3.0.3-red.svg)](https://flask.palletsprojects.com/)
+
+**PyMyFileBrowser** é um gerenciador de arquivos web poderoso e intuitivo desenvolvido em Python com Flask. Navegue, gerencie e visualize seus arquivos através de uma interface web moderna e responsiva, acessível de qualquer navegador.
+
+## ✨ Características Principais
+
+### 🗂️ Gerenciamento de Arquivos
+- **Navegação Intuitiva**: Interface limpa inspirada em gerenciadores de arquivos modernos
+- **Upload de Arquivos**: Suporte para upload único e múltiplo, incluindo pastas completas (drag & drop)
+- **Download Inteligente**: Download individual ou múltiplo com compressão automática em ZIP
+- **Criação de Pastas**: Crie novas pastas diretamente pela interface
+- **Exclusão Segura**: Remova arquivos e pastas com confirmação
+
+### 🔍 Busca e Organização
+- **Busca Local**: Filtro rápido por nome na pasta atual
+- **Busca Global**: Busca avançada recursiva em todas as pastas configuradas
+- **Ordenação Flexível**: Ordene por nome, data ou tipo de arquivo
+- **Ícones Inteligentes**: Identificação visual automática por tipo de arquivo (imagens, vídeos, código, documentos, etc.)
+
+### 👁️ Visualização de Arquivos
+Suporte nativo para visualização de diversos formatos:
+- **Imagens**: JPG, PNG, GIF, BMP, SVG, WebP, ICO
+- **Vídeos**: MP4, WebM, OGG
+- **Áudio**: MP3, WAV, OGG, M4A
+- **Documentos**: PDF
+- **Código**: Python, JavaScript, HTML, CSS, JSON, XML, C/C++, Java e mais
+- **Texto**: TXT, MD, LOG, INI
+
+### 🚀 Recursos Avançados
+- **Múltiplas Raízes**: Configure várias pastas raiz independentes via variável de ambiente
+- **Compressão Streaming**: Download de pastas grandes com streaming ZIP (sem consumir memória)
+- **Seleção Múltipla**: Selecione e baixe múltiplos arquivos/pastas de uma vez
+- **Data de Criação**: Visualize quando cada arquivo foi criado
+- **Responsivo**: Interface adaptável para desktop, tablet e mobile
+- **Hostname Display**: Identifique facilmente qual servidor você está acessando
+
+## 📋 Requisitos
+
+- Python 3.6 ou superior
+- Flask 3.0.3
+- zipstream-new 1.1.8
+
+## 📦 Instalação
+
+### Instalação via pip (Recomendado)
+
+```bash
+pip install pymyfilebrowser
+```
+
+### Instalação para Desenvolvimento
+
+```bash
+# Clone o repositório
+git clone https://github.com/seu-usuario/pymyfilebrowser.git
+cd pymyfilebrowser
+
+# Instale em modo desenvolvimento
+pip install -e .
+```
+
+### Instalação Manual
+
+```bash
+# Clone o repositório
+git clone https://github.com/seu-usuario/pymyfilebrowser.git
+cd pymyfilebrowser
+
+# Instale as dependências
+pip install -r requirements.txt
+```
+
+## ⚙️ Configuração
+
+### Pastas Raiz
+
+Por padrão, o PyMyFileBrowser usa a pasta **Downloads** do usuário atual. Para configurar pastas personalizadas, defina a variável de ambiente `PYBROWSER_ROOTS`:
+
+#### Windows (PowerShell)
+```powershell
+$env:PYBROWSER_ROOTS='C:\Users\SeuUsuario\Downloads,C:\Users\SeuUsuario\Documents,D:\Projetos'
+```
+
+#### Windows (CMD)
+```cmd
+set PYBROWSER_ROOTS=C:\Users\SeuUsuario\Downloads,C:\Users\SeuUsuario\Documents,D:\Projetos
+```
+
+#### Linux/macOS
+```bash
+export PYBROWSER_ROOTS='/home/usuario/Downloads,/home/usuario/Documents,/var/www/projetos'
+```
+
+#### Formato da Variável
+
+A variável `PYBROWSER_ROOTS` deve conter **caminhos separados por vírgula**. O nome de cada pasta será extraído automaticamente do caminho.
+
+**Exemplos:**
+
+Windows:
+```
+PYBROWSER_ROOTS=C:\Users\John\Downloads,C:\Users\John\Documents,D:\Development\Projects
+```
+
+Linux/macOS:
+```
+PYBROWSER_ROOTS=/home/john/Downloads,/home/john/Documents,/var/www/projects
+```
+
+> **Nota**: O nome exibido será o nome da pasta final no caminho. Por exemplo, `C:\Users\John\Downloads` será exibido como "Downloads".
+
+#### Uso com Argumento -r
+
+Você também pode especificar uma pasta diretamente ao executar:
+
+```bash
+python -m pymyfilebrowser -r C:\MinhaPasta
+```
+
+ou
+
+```bash
+pymyfilebrowser -r /home/usuario/meus-arquivos
+```
+
+## 🚀 Uso
+
+### Executar como Módulo Python (Recomendado)
+
+```bash
+python -m pymyfilebrowser
+```
+
+### Executar via Comando Instalado
+
+```bash
+pymyfilebrowser
+```
+
+### Executar Diretamente (Desenvolvimento)
+
+```bash
+python run.py
+```
+
+Após iniciar, acesse em seu navegador:
+```
+http://localhost:5000
+```
+
+Para acessar de outros dispositivos na rede:
+```
+http://[IP-DO-SEU-PC]:5000
+```
+
+## 🎯 Como Usar
+
+### Navegação Básica
+1. Ao abrir, você verá as pastas raiz configuradas
+2. Clique em uma pasta para navegar
+3. Use o breadcrumb no topo para voltar
+4. Use os botões de navegação (Voltar/Home) no topo direito
+
+### Upload de Arquivos
+1. Navegue até a pasta de destino
+2. Clique no botão **📤 Upload** (canto superior direito)
+3. Escolha "Arquivos" ou "Pasta"
+4. Selecione os arquivos/pasta desejados
+5. Aguarde o upload e clique em "Concluir"
+
+### Download de Arquivos
+1. **Download Individual**: Clique no ícone 📥 ao lado do arquivo
+2. **Download Múltiplo**:
+   - Marque as caixas de seleção dos itens desejados
+   - Clique no botão verde que aparece no topo
+   - Arquivos múltiplos são automaticamente compactados em ZIP
+
+### Busca de Arquivos
+1. **Busca Local**: Digite na caixa de busca no topo da lista
+2. **Busca Global**: Clique no ícone 🔍 (Busca Avançada)
+   - Digite o termo de busca
+   - Aguarde os resultados
+   - Clique em qualquer resultado para navegar até o arquivo
+
+### Criar Pasta
+1. Navegue até onde deseja criar a pasta
+2. Clique no botão **📁+** (canto superior direito)
+3. Digite o nome da pasta
+4. Confirme
+
+### Excluir Arquivo/Pasta
+1. Clique no ícone 🗑️ ao lado do item
+2. Confirme a exclusão
+3. ⚠️ **Atenção**: Esta ação é irreversível!
+
+### Visualizar Arquivo
+1. Clique no ícone 👁️ ao lado do arquivo
+2. O arquivo será aberto em uma modal de visualização
+3. Use os controles nativos para imagens, vídeos e áudios
+
+### Ordenação
+Use os botões no topo da lista:
+- **Nome**: Ordem alfabética (pastas primeiro)
+- **Data**: Mais recentes primeiro
+- **Tipo**: Agrupado por extensão
+
+## 📁 Estrutura do Projeto
+
+```
+pymyfilebrowser/
+│
+├── pyMyFileBrowser/           # Pacote principal
+│   ├── __init__.py           # Aplicação Flask e rotas
+│   ├── __main__.py           # Entry point para python -m
+│   └── templates/            # Templates HTML
+│       └── index.html        # Interface principal
+│
+├── setup.py                  # Configuração do pacote
+├── MANIFEST.in              # Arquivos para incluir no pacote
+├── requirements.txt         # Dependências
+├── CHANGELOG.txt           # Histórico de versões
+├── README.md              # Este arquivo
+└── run.py                # Script de execução direta
+```
+
+## 🛠️ Desenvolvimento
+
+#
+
+## 🔒 Segurança
+
+- **Path Traversal Protection**: O sistema valida todos os caminhos para evitar acesso fora das pastas raiz
+- **Filename Sanitization**: Nomes de arquivos são sanitizados usando `secure_filename()` do Werkzeug
+- **Input Validation**: Validação em todas as rotas POST
+- **⚠️ Aviso**: Este sistema foi projetado para uso em redes locais confiáveis. **NÃO exponha diretamente à internet sem autenticação adequada**
+
+## 🤝 Contribuindo
+
+Contribuições são bem-vindas! Para contribuir:
+
+1. Faça um Fork do projeto
+2. Crie uma branch para sua feature (`git checkout -b feature/NovaFeature`)
+3. Commit suas mudanças (`git commit -m 'Adiciona nova feature'`)
+4. Push para a branch (`git push origin feature/NovaFeature`)
+5. Abra um Pull Request
+
+## 📝 Licença
+
+Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.
+
+## 🐛 Reportar Bugs
+
+Encontrou um bug? Por favor, abra uma [issue](https://github.com/seu-usuario/pymyfilebrowser/issues) com:
+- Descrição do problema
+- Passos para reproduzir
+- Comportamento esperado vs atual
+- Screenshots (se aplicável)
+- Informações do sistema (OS, versão do Python)
+
+## 💡 Roadmap
+
+- [ ] Autenticação de usuários
+- [ ] Suporte a temas (claro/escuro)
+- [ ] Editor de texto integrado
+- [ ] Visualização de mais formatos (Office, etc.)
+- [ ] Compartilhamento de links temporários
+- [ ] Upload com barra de progresso
+- [ ] Preview de thumbnails para imagens
+- [ ] Drag & drop para reorganizar arquivos
+
+## 📧 Contato
+
+Para questões, sugestões ou feedback, entre em contato através das issues do GitHub.
+
+---
+
+**Desenvolvido com ❤️ e 🐍 Python**
+
+Change Log
+==========
+
+1.0.0 (2026-02-02)
+------------------
+- First Release

pyzbrowser-1.0.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+pyzbrowser/__init__.py,sha256=zoQ2JzUkOUY6GQqbJtX7CuAJueIjctQvUkiW2DycXbY,1031
+pyzbrowser/__main__.py,sha256=1Hnw64yaTYHuSlLk9LQgcs4pNgfifxftoJgNEJHfcbw,153
+pyzbrowser/routes.py,sha256=cq1L-u9397GpBywzTJ_xqBpyve7KLhDAGJlzq6ufl54,19845
+pyzbrowser/utils.py,sha256=x-_HDvx2wSs6_LCIUkiByffJjWlgFZsoOOiUIHhOhV0,3705
+pyzbrowser/templates/index.html,sha256=i41u4tOrtFap23QshChHkJpJhySG_CqqtGAkqMUIOGE,33254
+pyzbrowser-1.0.0.dist-info/METADATA,sha256=mRD19pHP9uQuCwWxMRv-SM9XWzwkiJq0OfFFnfJwU8E,9520
+pyzbrowser-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+pyzbrowser-1.0.0.dist-info/entry_points.txt,sha256=iZNbjFo6NFQemfrbp6kV4CkqyfHxGawa0b0w5bqNDwo,56
+pyzbrowser-1.0.0.dist-info/top_level.txt,sha256=C9dQtyTgfYojUcwk0pUo1SvjirXsBSE-mi98WHGRArE,11
+pyzbrowser-1.0.0.dist-info/RECORD,,

pyzbrowser-1.0.0.dist-info/WHEEL

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

pyzbrowser-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pyzbrowser = pyzbrowser.__main__:main

pyzbrowser-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pyzbrowser