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.
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
File details
Details for the file tservice-1.0.0.zip.
File metadata
- Download URL: tservice-1.0.0.zip
- Upload date:
- Size: 10.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 41f4cb2931824e157d903add3927eb42767eb9258e4da2917f8e3a5a163e76cb |
|
| MD5 | da51d08b6ebc0e321522c7bff8685449 |
|
| BLAKE2b-256 | b8f011c16fc08d7a42a55d1d78e6ee9ad03decb6359fa94edc2215b1f1bb3876 |
File details
Details for the file tservice-1.0.0.tar.gz.
File metadata
- Download URL: tservice-1.0.0.tar.gz
- Upload date:
- Size: 6.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 71033eb88078ab678933ff23a77daab78ac42625b5307732711c2afd38678717 |
|
| MD5 | 7963a85a488fbb1e82a162c64bb2fe40 |
|
| BLAKE2b-256 | 6310c7efd6b3761e8a63ca2418241906847e4062d7ed8d32714946981902b952 |
File details
Details for the file tservice-1.0.0-py2.py3-none-any.whl.
File metadata
- Download URL: tservice-1.0.0-py2.py3-none-any.whl
- Upload date:
- Size: 5.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7f5dc868859b9bb380d4f842aeaeb7ce603898d797ea6241e9c8009dcf8753e0 |
|
| MD5 | cdfdd51a51c46d840c65302edabb6335 |
|
| BLAKE2b-256 | 3f3138788006fc245bd4cf75c935fab0b1cd60da151eb1e5abb14a305eeb2fcf |
