Skip to main content

About

This is a small web server for development or sharing purposes. It allows to serve through HTTP any directory in your machine. It is based on Python famous SimpleHTTPServer and it only depends on a Python 2.7 interpreter and the standard library.

In contrast to SimpleHTTPServer this development web server:

  • Allows the serving folder can be passed as the first positional argument. Defaults to current directory.

  • Will respond with 404 if the serving folder is removed; instead of crashing.

  • Will return back to normal operation if the folder is recreated. Very useful with build systems that perform clean actions.

  • Bind IP can be specified in case security is a must while developing.

As with SimpleHTTPServer this web server can:

  • Specify binding port.

  • List directories.

  • Serve index.html or index.html automatically as the directory entry.

Installation

pip install webdev

Usage

$ webdev --help
usage: webdev [-h] [-v] [--version] [-i IP] [-p PORT] [-f] [-r RANGE] [-u]
              [path]

Development Web Server

positional arguments:
  path                  Path to serve. Default: Current directory.

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         Increase verbosity level
  --version             show program's version number and exit
  -i IP, --ip IP        IP to bind to. Default: 0.0.0.0
  -p PORT, --port PORT  Port to listen to. Default: 8080.
  -f, --force-port      Force the use of the given port.
  -r RANGE, --range RANGE
                        Number of ports to try from the base port
  -u, --future          Ignore if the folder to server doesn't exists yet

Changelog

1.1.0

New

  • Added support for Python 3 (issue #5).

  • Added support for incremental automatic port selection (issue #2).

  • Added the --future flag that allows the webserver to serve a non-existent folder, assuming it will be created in the future (issue #3).

Changed

  • Ctrl+C is now handled (issue #4).

1.0.0

  • Initial release.

License

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.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.

Metadata

Release files for webdev 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for webdev 1.1.0
File Size Uploaded
webdev-1.1.0.tar.gz 8.3 kB Details

Release files / webdev-1.1.0.tar.gz

Download URL webdev-1.1.0.tar.gz
Size 8.3 kB
Tags Source
SHA-256 checksum
How to use checksums
fd1cbd17b648f04b866332d17860612b1f9a6c4af485d8d9afc5985a50cbd0fd
BLAKE2b-256 checksum
How to use checksums
283d83c3834dfb3bfc58c708ded0d8131ea8f7cc62ed37283853a66af320dcbd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.1.0 This release

1 release file

1.0.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page