Start a local Tornado static file server
Project description
T-Service is a tiny Python tool for starting a local static file server using Tornado. I use it for previewing sites before pushing them to GitHub Pages.
Installation
T-Service is on PyPI, install it with: pip install tservice.
Usage
T-Service installs a command line utility called tserve. tserve has one required parameter: the directory from which to serve files. For example, to start the server from a directory called build that’s in your current directory, use this command:
tserve build
The server starts on port 8000 by default, so you can look for your site at http://localhost:8000.
Specifying a Port
If port 8000 is in use, or you want to use a different port, use the -p/--port flag:
tserve --port 7654 build
Specifying a Prefix
If you need to run the server so that it serves the files from some prefix use the -f/--prefix flag:
tserve --prefix myusername build
That will cause the files to be served from http://localhost:8000/myusername/. (You may need to do this so that the local site matches where your site will be deployed, e.g. GitHub Pages or a university server.)
Stopping the Server
Type control-C at the command line to stop the server.
Why Not Use Python’s Server?
I’ve found I sometimes need to serve files with a prefix on the URL, and I don’t know how to do that with Python’s builtin server.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for tservice-1.0.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7f5dc868859b9bb380d4f842aeaeb7ce603898d797ea6241e9c8009dcf8753e0 |
|
MD5 | cdfdd51a51c46d840c65302edabb6335 |
|
BLAKE2b-256 | 3f3138788006fc245bd4cf75c935fab0b1cd60da151eb1e5abb14a305eeb2fcf |