Compilación, pruebas y estado

Estado actual

• Fase 1 (hecha): Sunfish.Core con configuración INI (conserva comentarios), shares y locations, validación de rutas, motor HTTP propio (0.9/1.0/1.1, keep-alive, rangos, 304) y web de solo lectura (índice, ?$list, navegador de directorios clásico/moderno/texto, perfiles de cliente, recursos GIF, autodescarga). sunfish-cli con serve y modo rápido, sin TUI. Probado en un navegador moderno y con peticiones de cliente antiguo.
• Fase 2 (hecha): escritura web. Subida por formulario multipart (lector en flujo, campos a/t antes del fichero) y PUT por trozos (Content-Range + X-Sunfish-Upload), crear carpeta, renombrar y borrar con página de confirmación, tokens anti-CSRF sin cookies, usuarios con HTTP Basic (PBKDF2, caché y bloqueo por intentos), ZIP en flujo (Stored, CRC previo, Content-Length; nombres CP437 para clientes antiguos y UTF-8 para modernos). sunfish-cli user add|passwd|del|list. dotnet test: 140 pruebas en verde. AOT win-x64: ~3,8 MB sin avisos. Probado en un navegador moderno (arrastrar y soltar, borrado con confirmación), con usuario y contraseña, y ZIP descargado como cliente antiguo.
• Fase 3 (hecha): aplicaciones.
  • Sunfish.exe (WinForms): interruptor y puerto, lista de shares con activar/desactivar, alta (también arrastrando carpetas a la ventana o sobre el .exe), edición, borrado, menú con abrir en el navegador y copiar URL por IP, usuarios, registro, área de notificación e instancia única (una segunda instancia pasa sus carpetas a la primera por una tubería).
  • TUI de sunfish-cli (pestañas Estado con icono, Shares, Usuarios y Registro; formularios y preguntas en recuadros) y subcomandos share add|set|del|list.
  • SunfishHost: reinicio al cambiar de puerto, guardado y recarga del fichero si lo cambia otro programa (conservando las opciones de línea de comandos como -p).
  • Scripts build.ps1, build.sh, run.cmd, run-cli.cmd y run.sh.
  • dotnet test: 149 pruebas en verde.
  • Tamaños medidos (win-x64): Sunfish.exe autocontenido ~49 MB, ligero ~0,5 MB; sunfish-cli.exe AOT ~3,9 MB.
  • Probado: GUI en modo rápido, paso de carpetas desde una segunda instancia y alta de share (automatizado con UI Automation), TUI dibujada en Windows Terminal, subcomandos share y recarga en caliente con serve. build.ps1 y build.sh se han comprobado solo en sintaxis (ejecutarlos hace git pull); las publicaciones que lanzan sí se han ejecutado a mano.
  • Después: TUI con marco Unicode y GUI con el aspecto de la 2.0 (ver APLICACIONES.md).
• Fase 4 (hecha): servidor FTP (FTP-Y-WEBDAV.md): pasivo y activo, anónimo y usuarios, LIST/NLST/MLSD/MLST, RETR/STOR/APPE/REST, carpetas, renombrar y mover, borrar, SIZE/MDTM, TYPE A, juegos de caracteres antiguos, perfiles por sufijo de usuario o SITE PROFILE, ABOR. El host arranca y para HTTP y FTP por separado y comparte con la web el bloqueo por intentos fallidos. GUI (fila «FTP en puerto»), TUI (teclas F y T) y serve muestran las direcciones ftp://. dotnet test: 173 pruebas en verde. AOT win-x64: ~4,1 MB. Probado con curl y con ftp.exe de Windows en modo activo.
• Fase 5 (hecha): WebDAV en el servidor (clase 1 + LOCK simulado), cliente WebDAV en el núcleo, DNS-SD sobre mDNS (anuncio y búsqueda), ventana «Explorar otro servidor» en la GUI y pestaña Explorar (F4) en la TUI (FTP-Y-WEBDAV.md). dotnet test: 189 pruebas en verde (incluida una búsqueda mDNS real que se salta si el 5353 no está disponible). AOT win-x64: ~8,3 MB. Probado con el redirector WebDAV de Windows (leer y escribir) y con la ventana Explorar de la GUI contra el propio servidor.
• La prueba de enlaces simbólicos se salta sola en Windows sin permiso para crearlos.
• Sin probar con navegadores ni clientes FTP antiguos reales, ni en Linux/macOS (GVfs, Finder, Avahi, Bonjour); las teclas de la TUI (incluida la pestaña Explorar) no se han probado de forma automática.
• Fase 6 (hecha): Mac clásico y nombres cortos (MAC-CLASICO.md, CLIENTES.md). MacBinary I/II/III, BinHex 4.0 y AppleDouble en Sunfish.Core/Mac; las subidas (formulario, PUT por trozos, STOR) se decodifican; descarga en MacBinary automática para el perfil mac y enlaces [.bin]/[.hqx] para los demás; FTP +mac con nombre.bin. Alias 8.3 estables (Shares/ShortNames.cs) en listados, enlaces, descargas y FTP +dos/+win16; las rutas se resuelven también por alias. El ._ sigue al fichero al renombrar, mover y borrar. dotnet test: 210 pruebas en verde. AOT win-x64: ~8,4 MB, sin avisos. Probado con el binario AOT por web y FTP (curl).
• Fase 7 (hecha): panel de administración web (Web/WebAdmin.cs, WEB.md), AllowFrom con redes CIDR (Net/AddressRules.cs), importación de la 2.0 (Config/LegacyImport.cs, SHARES-Y-RUTAS.md) y generador de QR propio (Qr/, APLICACIONES.md). GUI: ventana de QR, diálogo del panel web e importación al crear la configuración. CLI: admin, import-v2 y tecla C (QR) en la TUI. dotnet test: 252 pruebas en verde; el QR se comprueba leyéndolo con ZXing.Net (dependencia solo del proyecto de pruebas). AOT win-x64: ~8,7 MB, sin avisos. Probado con el binario AOT: import-v2, admin enable/allow/status, el panel con curl (401/200, QR, guardar que reinicia FTP sin cortar HTTP) y en un navegador.
• Siguiente (sin fase asignada): conexiones activas, iniciar con Windows, servicio de Windows, regla del cortafuegos; pruebas con clientes antiguos reales.
• El código de la 2.0 se retiró; queda en la etiqueta 2.0 (LEGACY-2.0.md).
• Rama actual master en un remoto privado. El README ya da las instrucciones para GitHub (rama main), para cuando se publique allí.

Publicación prevista

• .NET 10. RID: win-x64, win-arm64, linux-x64, linux-arm64, osx-x64, osx-arm64.
• Native AOT no compila de forma cruzada entre sistemas: cada sunfish-cli se compila en su sistema.

Requisitos

• git y el SDK de .NET 10.
• Para sunfish-cli (AOT):
  • Windows: Visual Studio Build Tools con «Desarrollo para escritorio con C++».
  • Linux: clang, ld y las cabeceras de zlib.
  • macOS: Xcode Command Line Tools.
• Para Sunfish.exe: solo el SDK.

Scripts previstos

• Variable para forks: SUNFISH_REPO_URL.
• Sin script publish aparte: build.* ya publica.
• .gitignore: /Sunfish.exe, /sunfish-cli, /sunfish-cli.exe, /sunfish.conf, publish/.

Comandos previstos

dotnet build
dotnet test
dotnet run --project src/Sunfish.WinForms
dotnet run --project src/Sunfish.Cli -- [argumentos]
dotnet publish src/Sunfish.Cli -c Release -r <RID>
dotnet publish src/Sunfish.WinForms -c Release -r win-x64

Pruebas automáticas previstas (tests/Sunfish.Tests)

xUnit sobre net10.0, con InternalsVisibleTo desde Sunfish.Core. Las pruebas que tocan variables de entorno van en una colección sin paralelismo. Las de servidor arrancan SunfishHost en localhost con puertos libres y hablan con él por sockets.

Pruebas manuales previstas

• Navegadores modernos: web clásica y moderna, arrastrar y soltar, subida grande por trozos.
• DOS con packet driver: navegador de texto y gráfico, cliente FTP y descargador HTTP de línea de comandos; comprobar alias 8.3 y CP437.
• Windows 3.1 / WfW 3.11 con pila Winsock: navegadores de 16 bits (listado, descargas con alias 8.3, subida por formulario donde se admita) y cliente FTP de 16 bits.
• Windows 95/98 con sus navegadores de la época: listado, descargas, subidas por formulario, ZIP; ftp.exe en modo activo; Carpetas web (WebDAV).
• Mac clásico (System 6/7, Mac OS 8/9) con navegadores y clientes FTP de la época: listado, descargas .bin/.hqx, subidas MacBinary/BinHex, nombres con acentos.
• WebDAV moderno: Explorador de Windows, Finder de macOS, GVfs.
• GUI: doble clic, arrastrar carpeta a la lista y sobre el .exe, bandeja, instancia única.
• TUI en Windows Terminal, conhost, Linux, macOS y por SSH; icono visible u oculto según el tamaño, y en 16, 256 y color real.
• Sunfish a Sunfish: descubrimiento en la LAN y copia en los dos sentidos.
• build.ps1 con | iex; build.sh en Linux y macOS.