jetforce/README.md

66 lines
1.9 KiB
Markdown
Raw Normal View History

2019-08-05 05:07:38 +02:00
<h1 align="center">Jetforce</h1>
2019-08-09 03:45:26 +02:00
2019-08-10 01:15:11 +02:00
<p align="center">An experimental python server for the new, under development Gemini Protocol.</p>
2019-08-09 03:45:26 +02:00
2019-08-09 03:45:42 +02:00
<p align="center">Learn more about Project Gemini from its designer, ~solderpunk, <a href="https://gopher.commons.host/gopher://zaibatsu.circumlunar.space/1/~solderpunk/gemini">here</a>.</p>
2019-08-09 03:45:26 +02:00
2019-08-05 05:08:22 +02:00
<p align="center"><img alt="rocket launch" src="resources/rocket.jpg"/></p>
2019-08-05 04:57:34 +02:00
2019-08-09 03:45:26 +02:00
<p align="center">
<a href="https://pypi.python.org/pypi/jetforce/">
<img alt="pypi" src="https://img.shields.io/pypi/v/jetforce.svg?label=version"/>
</a>
<a href="https://github.com/michael-lazar/jetforce/LICENSE">
2019-08-23 02:41:43 +02:00
<img alt="License" src="https://img.shields.io/badge/license-FFSL%20v1-informational.svg">
2019-08-09 03:45:26 +02:00
</a>
<a href="https://github.com/psf/black">
<img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg">
</a>
<a href="https://saythanks.io/to/michael-lazar">
<img alt="say-thanks" src="https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg"/>
</a>
</p>
2019-08-05 04:57:34 +02:00
## Features
2019-08-05 05:18:41 +02:00
- A modern python 3 codebase with type hinting and black formatting.
2019-08-05 04:57:34 +02:00
- Lightweight, single-file web framework with zero dependencies.
- A built-in static file server with support for *.gemini* directory map files.
- Supports concurrent connections using an asynchronous event loop.
- Extendable - loosely implements the [WSGI](https://en.wikipedia.org/wiki/Web_Server_Gateway_Interface) server/application pattern.
2019-08-09 03:50:44 +02:00
## Demo
A live demonstration of the Jetforce server is available on gemini at the following URL:
---
<p align="center">
<b><a href="gemini://mozz.us">gemini://mozz.us</a></b><br>
</p>
---
2019-08-05 04:57:34 +02:00
## Installation
2019-08-06 00:47:59 +02:00
Requires Python 3.7+ and OpenSSL
2019-08-05 04:57:34 +02:00
### pip
```bash
$ pip install jetforce
```
### git
```bash
$ git clone https://github.com/michael-lazar/jetforce
$ cd jetforce
$ python jetforce.py
```
2019-08-06 04:22:19 +02:00
## TODO
- Finish documentation :)