webgate 0.1.0__tar.gz

webgate-0.1.0/.dockerignore

@@ -0,0 +1,18 @@
+.git
+.venv
+__pycache__
+*.pyc
+tests/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+*.egg-info
+dist/
+build/
+CLAUDE.md
+CLAUDE.local.md
+.env
+docs/
+README.md
+*.png
+.playwright-cli/

webgate-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,33 @@
+name: Deploy docs
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install mkdocs-material mkdocstrings mkdocstrings-python
+      - run: mkdocs build --strict
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+      - uses: actions/deploy-pages@v4
+        id: deployment

webgate-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Environment
+.env
+.env.local
+
+# Database
+*.db
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project
+CLAUDE.md
+CLAUDE.local.md
+.claude/
+.playwright-cli/
+site/

webgate-0.1.0/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+## v0.1.0 (2026-04-08)
+
+First public release.
+
+### Features
+
+- SSH web terminal (xterm.js + asyncssh WebSocket bridge)
+- SFTP file browser (directory listing, upload, download, rename, delete, mkdir, chmod)
+- In-browser text editor (CodeMirror 6 with oneDark theme)
+- PDF and image preview (PDF, PNG, JPG, GIF, SVG, WebP)
+- Server registry with groups, tags, and encrypted credentials (Fernet)
+- Quick Connect toolbar for one-off SSH connections
+- Admin/user role system with group-based access control
+- Default admin account with forced password change on first login
+- User management panel (create, delete, assign groups)
+- Multi-tab split pane (terminal + file browser side by side)
+- File search/filter within SFTP listings
+- Server import/export (JSON) from the UI
+- Session persistence across page reloads
+- Rate limiting on auth endpoints (slowapi)
+- Audit log (admin-viewable action history)
+- SFTP connection pool (reuse per server, 5 min TTL)
+- Modern dark UI (GitHub-inspired theme)
+- Docker multi-stage build with demo SSH container
+- 34 automated tests

webgate-0.1.0/Dockerfile

@@ -0,0 +1,39 @@
+# --- Stage 1: build ---
+FROM python:3.13-slim AS builder
+
+WORKDIR /app
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+
+COPY pyproject.toml uv.lock ./
+RUN uv sync --frozen --no-dev --no-editable
+
+COPY src/ src/
+
+# --- Stage 2: runtime ---
+FROM python:3.13-slim
+
+RUN groupadd -r webgate && useradd -r -g webgate -m webgate
+
+WORKDIR /app
+COPY --from=builder /app/.venv /app/.venv
+COPY --from=builder /app/src /app/src
+
+# Data directory for SQLite DB + uploaded SSH keys
+RUN mkdir -p /data && chown webgate:webgate /data
+VOLUME /data
+
+ENV PATH="/app/.venv/bin:$PATH" \
+    PYTHONPATH="/app/src" \
+    WEBGATE_HOST=0.0.0.0 \
+    WEBGATE_PORT=8443 \
+    WEBGATE_DB_URL=sqlite+aiosqlite:////data/webgate.db \
+    WEBGATE_LOG_LEVEL=info
+
+EXPOSE 8443
+
+USER webgate
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8443/api/health')"
+
+CMD ["python", "-m", "webgate"]

webgate-0.1.0/Dockerfile.ssh-demo

@@ -0,0 +1,29 @@
+FROM debian:bookworm-slim
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends openssh-server procps curl nano htop tree && \
+    rm -rf /var/lib/apt/lists/*
+
+RUN mkdir /run/sshd && \
+    echo 'PermitRootLogin yes' >> /etc/ssh/sshd_config && \
+    echo 'PasswordAuthentication yes' >> /etc/ssh/sshd_config
+
+# Create demo user
+RUN useradd -m -s /bin/bash demo && \
+    echo 'demo:demo' | chpasswd && \
+    echo 'root:root' | chpasswd
+
+# Create some sample files for SFTP browsing
+RUN mkdir -p /home/demo/projects/webgate /home/demo/projects/api-server \
+             /home/demo/documents /home/demo/logs /home/demo/scripts && \
+    echo '# webgate\nSelf-hosted SSH + SFTP manager' > /home/demo/projects/webgate/README.md && \
+    echo '{"name":"api-server","version":"2.1.0"}' > /home/demo/projects/api-server/package.json && \
+    echo 'Hello from demo server!' > /home/demo/documents/welcome.txt && \
+    echo '2026-04-08 10:00:00 INFO  Server started on port 8080' > /home/demo/logs/app.log && \
+    echo '#!/bin/bash\necho "Deploy complete"' > /home/demo/scripts/deploy.sh && \
+    chmod +x /home/demo/scripts/deploy.sh && \
+    chown -R demo:demo /home/demo
+
+EXPOSE 22
+
+CMD ["/usr/sbin/sshd", "-D"]

webgate-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kevin Nolasco
+
+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.