webdev 2.0.0__tar.gz → 2.0.1__tar.gz

{webdev-2.0.0 → webdev-2.0.1}/.gitignore

@@ -13,6 +13,7 @@ build/*
 .pytest_cache/
 .mypy_cache/
 .ruff_cache/
+uv.lock
 
 # Misc
 *~

{webdev-2.0.0 → webdev-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: webdev
-Version: 2.0.0
+Version: 2.0.1
 Summary: Small, fast development web server with a modern dark directory index
 Project-URL: Homepage, https://github.com/kuralabs/webdev
 Project-URL: Repository, https://github.com/kuralabs/webdev
@@ -32,49 +32,74 @@ Description-Content-Type: text/x-rst
 Development Web Server
 ======================
 
-About
-=====
-
-``webdev`` is a small, fast development web server. It serves any local
-directory over HTTP (or HTTPS) with developer-friendly conveniences, and ships
-a modern, dark-themed directory index.
+``webdev`` is a **small, fast local development web server**. Point it at a
+folder and it serves it over HTTP (or HTTPS) with developer-friendly
+conveniences and a modern, dark-themed directory index.
 
 It is built on `Starlette <https://www.starlette.io/>`_ and
-`Uvicorn <https://www.uvicorn.org/>`_ (an ASGI stack), and requires Python 3.10+.
+`Uvicorn <https://www.uvicorn.org/>`_ (an async ASGI stack) and requires
+**Python 3.10+**.
 
-Features
-========
+Quick start
+===========
 
-- **Serve any directory** — passed as the first positional argument; defaults to
-  the current directory.
-- **Graceful when the folder disappears** — responds with ``404`` instead of
-  crashing if the served directory is removed, and **recovers automatically**
-  the moment it is recreated. Paths are resolved against the live filesystem on
-  every request, which is great with build systems that perform clean/rebuild
-  actions.
-- **Automatic port selection** — if the base port is busy, the next free port in
-  a range is used. Can be forced to a single port.
-- **Serve a not-yet-existing folder** — ``--future`` assumes the folder will be
-  created later.
-- **Modern dark directory index** — breadcrumbs, file-type icons, human-readable
-  sizes, modified dates and client-side sortable columns. Themable: drop a new
-  directory under ``webdev/templates/<theme>/``.
-- **Live reload** — connected browsers refresh automatically on file changes
-  (via a WebSocket; a tiny auto-reconnecting snippet is injected into HTML).
-- **No-cache headers** for always-fresh development content.
-- **SPA fallback** — optionally serve ``index.html`` for unknown routes.
-- **Gzip**, **CORS**, optional **HTTPS** (self-signed if no cert/key is given),
-  and a startup **QR code / LAN URL** for quick mobile testing.
-- **Config file** — every option can be set via ``webdev.toml`` (or a
-  ``[tool.webdev]`` table). Precedence: CLI flag > config file > default.
+::
+
+   # Install (see more options below)
+   uv tool install webdev
+
+   # Serve the current directory on http://localhost:8080
+   webdev
+
+   # Serve a specific folder
+   webdev ./public
+
+   # See every option
+   webdev --help
 
 Installation
 ============
 
-::
+With `uv <https://docs.astral.sh/uv/>`_ (recommended)::
+
+   uv tool install webdev
+
+With `pipx <https://pipx.pypa.io/>`_::
+
+   pipx install webdev
+
+Or with plain ``pip`` into an environment of your choice::
 
    pip install webdev
 
+Features
+========
+
+- 🗂️ **Serve any directory** — passed as the first positional argument; defaults
+  to the current directory.
+- 🩹 **Graceful when the folder disappears** — responds with ``404`` instead of
+  crashing if the served directory is removed, and **recovers automatically**
+  the moment it is recreated. Paths are resolved against the live filesystem on
+  every request — ideal for build systems that clean and rebuild output.
+- 🔀 **Automatic port selection** — if the base port is busy, the next free port
+  in a range is used. Can be forced to a single exact port.
+- 🔮 **Serve a not-yet-existing folder** — ``--future`` assumes the folder will
+  be created later.
+- 🎨 **Modern dark directory index** — breadcrumbs, file-type icons,
+  human-readable sizes, modified dates and client-side sortable columns.
+  **Themable**: drop a new directory under ``webdev/templates/<theme>/``.
+- 🔁 **Live reload** — connected browsers refresh automatically on file changes
+  (via a WebSocket; a tiny auto-reconnecting snippet is injected into HTML).
+- 📱 **Instant mobile testing** — a **QR code and LAN URL** are printed at
+  startup so you can open the site on your phone.
+- 🌈 **Colorized, level-aware logs** for readable output.
+- ⚡ **No-cache headers** for always-fresh development content.
+- 🧭 **SPA fallback** — optionally serve ``index.html`` for unknown routes.
+- 📦 **Gzip**, **CORS** and optional **HTTPS** (self-signed if no cert/key is
+  given).
+- ⚙️ **Config file** — every option can be set via ``webdev.toml`` (or a
+  ``[tool.webdev]`` table). Precedence: CLI flag > config file > default.
+
 Usage
 =====
 
@@ -100,6 +125,9 @@ Examples::
    # Single-page app: fall back to index.html for client-side routes
    webdev --spa ./dist
 
+   # Serve a build output folder that does not exist yet
+   webdev --future ./dist
+
 Options and config keys
 -----------------------
 
@@ -125,30 +153,19 @@ Colorized logs         ``--color/--no-color``    ``color``           enabled
 HTTPS/TLS              ``--https/--no-https``    ``https``           disabled
 TLS cert / key         ``--cert`` / ``--key``    ``cert`` / ``key``  self-signed
 Index theme            ``--theme``               ``theme``           dark
+Verbosity              ``-v`` (repeatable)       ``verbose``         0
 =====================  ========================  ==================  ==========
 
-Example ``webdev.toml``::
+Commit a ``webdev.toml`` next to your project to share settings with your team.
+Any option works as a flat key, or under a ``[tool.webdev]`` table (handy inside
+a ``pyproject.toml``)::
 
+   # webdev.toml
    port = 3000
    force_port = true
    spa = true
    cors = true
 
-Design notes
-============
-
-- **Framework:** Starlette + Uvicorn was chosen over a full framework such as
-  Sanic because this is a static file server: Starlette provides exactly the
-  primitives needed (routing, static serving, WebSockets, middleware) with a
-  small surface, and Uvicorn handles fast binding, HTTP keep-alive, HTTPS and
-  graceful shutdown.
-- **The legacy reload hack is gone.** The old server patched ``send_head`` to
-  ``chdir`` back into the served folder; modern ``http.server`` captures the
-  working directory in the handler constructor, so that hook stopped running and
-  a removed folder crashed the request. ``webdev`` now resolves every request
-  against the live filesystem, so missing folders yield a real ``404`` and
-  recover automatically.
-
 Development
 ===========
 
@@ -165,12 +182,23 @@ only tool you need preinstalled::
    # Build and verify the distribution
    tox -e build
 
+   # Build, install in a throwaway venv and run (pass args after --)
+   tox -e run -- -p 3000 ./public
+
 Each environment declares its own tooling dependencies in ``tox.ini`` so it
 installs only what it needs.
 
 Changelog
 =========
 
+2.0.1
+-----
+
+**Changed**
+
+- Modernized and expanded the README (uv-first installation, refreshed feature
+  overview and usage).
+
 2.0.0
 -----
 
@@ -224,7 +252,8 @@ License
 
 ::
 
-   Copyright (C) 2015-2026 Carlos Jenkins <carlos@jenkins.co.cr>
+   Copyright (C) 2026 KuraLabs S.R.L <info@kuralabs.io>
+   Copyright (C) 2015-2016 Carlos Jenkins <carlos@jenkins.co.cr>
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{webdev-2.0.0 → webdev-2.0.1}/README.rst

@@ -2,49 +2,74 @@
 Development Web Server
 ======================
 
-About
-=====
-
-``webdev`` is a small, fast development web server. It serves any local
-directory over HTTP (or HTTPS) with developer-friendly conveniences, and ships
-a modern, dark-themed directory index.
+``webdev`` is a **small, fast local development web server**. Point it at a
+folder and it serves it over HTTP (or HTTPS) with developer-friendly
+conveniences and a modern, dark-themed directory index.
 
 It is built on `Starlette <https://www.starlette.io/>`_ and
-`Uvicorn <https://www.uvicorn.org/>`_ (an ASGI stack), and requires Python 3.10+.
+`Uvicorn <https://www.uvicorn.org/>`_ (an async ASGI stack) and requires
+**Python 3.10+**.
 
-Features
-========
+Quick start
+===========
 
-- **Serve any directory** — passed as the first positional argument; defaults to
-  the current directory.
-- **Graceful when the folder disappears** — responds with ``404`` instead of
-  crashing if the served directory is removed, and **recovers automatically**
-  the moment it is recreated. Paths are resolved against the live filesystem on
-  every request, which is great with build systems that perform clean/rebuild
-  actions.
-- **Automatic port selection** — if the base port is busy, the next free port in
-  a range is used. Can be forced to a single port.
-- **Serve a not-yet-existing folder** — ``--future`` assumes the folder will be
-  created later.
-- **Modern dark directory index** — breadcrumbs, file-type icons, human-readable
-  sizes, modified dates and client-side sortable columns. Themable: drop a new
-  directory under ``webdev/templates/<theme>/``.
-- **Live reload** — connected browsers refresh automatically on file changes
-  (via a WebSocket; a tiny auto-reconnecting snippet is injected into HTML).
-- **No-cache headers** for always-fresh development content.
-- **SPA fallback** — optionally serve ``index.html`` for unknown routes.
-- **Gzip**, **CORS**, optional **HTTPS** (self-signed if no cert/key is given),
-  and a startup **QR code / LAN URL** for quick mobile testing.
-- **Config file** — every option can be set via ``webdev.toml`` (or a
-  ``[tool.webdev]`` table). Precedence: CLI flag > config file > default.
+::
+
+   # Install (see more options below)
+   uv tool install webdev
+
+   # Serve the current directory on http://localhost:8080
+   webdev
+
+   # Serve a specific folder
+   webdev ./public
+
+   # See every option
+   webdev --help
 
 Installation
 ============
 
-::
+With `uv <https://docs.astral.sh/uv/>`_ (recommended)::
+
+   uv tool install webdev
+
+With `pipx <https://pipx.pypa.io/>`_::
+
+   pipx install webdev
+
+Or with plain ``pip`` into an environment of your choice::
 
    pip install webdev
 
+Features
+========
+
+- 🗂️ **Serve any directory** — passed as the first positional argument; defaults
+  to the current directory.
+- 🩹 **Graceful when the folder disappears** — responds with ``404`` instead of
+  crashing if the served directory is removed, and **recovers automatically**
+  the moment it is recreated. Paths are resolved against the live filesystem on
+  every request — ideal for build systems that clean and rebuild output.
+- 🔀 **Automatic port selection** — if the base port is busy, the next free port
+  in a range is used. Can be forced to a single exact port.
+- 🔮 **Serve a not-yet-existing folder** — ``--future`` assumes the folder will
+  be created later.
+- 🎨 **Modern dark directory index** — breadcrumbs, file-type icons,
+  human-readable sizes, modified dates and client-side sortable columns.
+  **Themable**: drop a new directory under ``webdev/templates/<theme>/``.
+- 🔁 **Live reload** — connected browsers refresh automatically on file changes
+  (via a WebSocket; a tiny auto-reconnecting snippet is injected into HTML).
+- 📱 **Instant mobile testing** — a **QR code and LAN URL** are printed at
+  startup so you can open the site on your phone.
+- 🌈 **Colorized, level-aware logs** for readable output.
+- ⚡ **No-cache headers** for always-fresh development content.
+- 🧭 **SPA fallback** — optionally serve ``index.html`` for unknown routes.
+- 📦 **Gzip**, **CORS** and optional **HTTPS** (self-signed if no cert/key is
+  given).
+- ⚙️ **Config file** — every option can be set via ``webdev.toml`` (or a
+  ``[tool.webdev]`` table). Precedence: CLI flag > config file > default.
+
 Usage
 =====
 
@@ -70,6 +95,9 @@ Examples::
    # Single-page app: fall back to index.html for client-side routes
    webdev --spa ./dist
 
+   # Serve a build output folder that does not exist yet
+   webdev --future ./dist
+
 Options and config keys
 -----------------------
 
@@ -95,30 +123,19 @@ Colorized logs         ``--color/--no-color``    ``color``           enabled
 HTTPS/TLS              ``--https/--no-https``    ``https``           disabled
 TLS cert / key         ``--cert`` / ``--key``    ``cert`` / ``key``  self-signed
 Index theme            ``--theme``               ``theme``           dark
+Verbosity              ``-v`` (repeatable)       ``verbose``         0
 =====================  ========================  ==================  ==========
 
-Example ``webdev.toml``::
+Commit a ``webdev.toml`` next to your project to share settings with your team.
+Any option works as a flat key, or under a ``[tool.webdev]`` table (handy inside
+a ``pyproject.toml``)::
 
+   # webdev.toml
    port = 3000
    force_port = true
    spa = true
    cors = true
 
-Design notes
-============
-
-- **Framework:** Starlette + Uvicorn was chosen over a full framework such as
-  Sanic because this is a static file server: Starlette provides exactly the
-  primitives needed (routing, static serving, WebSockets, middleware) with a
-  small surface, and Uvicorn handles fast binding, HTTP keep-alive, HTTPS and
-  graceful shutdown.
-- **The legacy reload hack is gone.** The old server patched ``send_head`` to
-  ``chdir`` back into the served folder; modern ``http.server`` captures the
-  working directory in the handler constructor, so that hook stopped running and
-  a removed folder crashed the request. ``webdev`` now resolves every request
-  against the live filesystem, so missing folders yield a real ``404`` and
-  recover automatically.
-
 Development
 ===========
 
@@ -135,12 +152,23 @@ only tool you need preinstalled::
    # Build and verify the distribution
    tox -e build
 
+   # Build, install in a throwaway venv and run (pass args after --)
+   tox -e run -- -p 3000 ./public
+
 Each environment declares its own tooling dependencies in ``tox.ini`` so it
 installs only what it needs.
 
 Changelog
 =========
 
+2.0.1
+-----
+
+**Changed**
+
+- Modernized and expanded the README (uv-first installation, refreshed feature
+  overview and usage).
+
 2.0.0
 -----
 
@@ -194,7 +222,8 @@ License
 
 ::
 
-   Copyright (C) 2015-2026 Carlos Jenkins <carlos@jenkins.co.cr>
+   Copyright (C) 2026 KuraLabs S.R.L <info@kuralabs.io>
+   Copyright (C) 2015-2016 Carlos Jenkins <carlos@jenkins.co.cr>
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{webdev-2.0.0 → webdev-2.0.1}/webdev/__init__.py

@@ -25,6 +25,6 @@ index, optional HTTPS, and more.
 
 from __future__ import annotations
 
-__version__ = '2.0.0'
+__version__ = '2.0.1'
 
 __all__ = ['__version__']