Skip to main content

An asynchronous, event driver web framework for the Python programming language.

Project description

https://img.shields.io/pypi/v/Pyjoyment.png https://travis-ci.org/dex4er/Pyjoyment.png?branch=master https://readthedocs.org/projects/pyjoyment/badge/?version=latest

Pyjoyment

An asynchronous, event driver web framework for the Python programming language.

Pyjoyment provides own reactor which handles I/O and timer events in its own main event loop but it supports other loops, ie. libev, asyncio.

Pyjoyment uses intensively own event emmiter which should be familiar for Node.JS programmers.

It provides tool set for parsing and creating HTTP messages and HTML documents. It also supports WSGI interface.

Pyjoyment is compatible with Python 2.7+, Python 3.3+ and PyPy 2.4+. It doesn’t require any external libraries or compilers.

See http://www.pyjoyment.net/

Pyjoyment is based on Mojolicious: a next generation web framework for the Perl programming language.

Status

Early developement stage. Implemented already:

  • WSGI adapter

  • HTTP standalone async-io server

  • WebSockets client and server

  • HTTP user agent with TLS/SSL support

  • JSON pointers implementation based on RFC6901

  • Embedded files loader

  • HTML/XML DOM parser with CSS selectors

  • URL parser with container classes for URL, path and querystring

  • Non-blocking TCP client and server

  • Simple logging object

  • Synchronizer and sequentializer of multiple events

  • Main event loop which handle IO and timer events

  • Event emitter with subscriptions

  • Low level event reactor based on select(2) and poll(2)

  • Convenient functions and classed for unicode and byte strings and lists

  • Lazy properties for objects

  • Test units with API based on Perl’s Test::More and TAP protocol

Examples

Web scraping

import Pyjo.UserAgent
from Pyjo.String.Unicode import u

tx = Pyjo.UserAgent.new().get('https://html.spec.whatwg.org')
for n in tx.res.dom('#named-character-references-table tbody > tr').each():
    u(n.at('td > code').text + ' ' + n.children('td')[1].text).trim().say()

URL manipulation

import Pyjo.URL
from Pyjo.String.Unicode import u

# 'ssh+git://git@github.com/dex4er/Pyjoyment.git'
url = Pyjo.URL.new('https://github.com/dex4er/Pyjoyment')
print(url.set(scheme='ssh+git', userinfo='git', path=u(url.path) + '.git'))

# 'http://metacpan.org/search?q=Mojo::URL&size=20'
print(Pyjo.URL.new('http://metacpan.org/search')
      .set(query={'q': 'Mojo::URL', 'size': 20}))

Non-blocking TCP client/server

import Pyjo.IOLoop


# Listen on port 3000
@Pyjo.IOLoop.server(port=3000)
def server(loop, stream, cid):

    @stream.on
    def read(stream, chunk):
        # Process input chunk
        print("Server: {0}".format(chunk.decode('utf-8')))

        # Write response
        stream.write(b"HTTP/1.1 200 OK\x0d\x0a\x0d\x0a")

        # Disconnect client
        stream.close_gracefully()


# Connect to port 3000
@Pyjo.IOLoop.client(port=3000)
def client(loop, err, stream):

    @stream.on
    def read(stream, chunk):
        # Process input
        print("Client: {0}".format(chunk.decode('utf-8')))

    # Write request
    stream.write(b"GET / HTTP/1.1\x0d\x0a\x0d\x0a")


# Add a timer
@Pyjo.IOLoop.timer(3)
def timeouter(loop):
    print("Timeout")
    # Shutdown server
    loop.remove(server)


# Start event loop
Pyjo.IOLoop.start()

Standalone HTTP server serving embedded template file

# -*- coding: utf-8 -*-

import Pyjo.Server.Daemon
import Pyjo.URL

from Pyjo.Loader import embedded_file
from Pyjo.Util import b, u

import sys


opts = dict([['address', '0.0.0.0'], ['port', 3000]] + list(map(lambda a: a.split('='), sys.argv[1:])))
listen = str(Pyjo.URL.new(scheme='http', host=opts['address'], port=opts['port']))

daemon = Pyjo.Server.Daemon.new(listen=[listen])
daemon.unsubscribe('request')


# Embedded template file
DATA = u(r'''
@@ index.html.tpl
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Pyjoyment</title>
</head>
<body>
<h1>♥ Pyjoyment ♥</h1>
<h2>This page is served by Pyjoyment framework.</h2>
<p>{method} request for {path}</p>
</body>
</html>
''')


@daemon.on
def request(daemon, tx):
    # Request
    method = tx.req.method
    path = tx.req.url.path

    # Template
    template = embedded_file(sys.modules[__name__], 'index.html.tpl')

    # Response
    tx.res.code = 200
    tx.res.headers.content_type = 'text/html; charset=utf-8'
    tx.res.body = b(template.format(**locals()))

    # Resume transaction
    tx.resume()


daemon.run()

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Pyjoyment-0.0.1.tar.gz (127.7 kB view details)

Uploaded Source

Built Distribution

Pyjoyment-0.0.1-py2.py3-none-any.whl (163.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file Pyjoyment-0.0.1.tar.gz.

File metadata

  • Download URL: Pyjoyment-0.0.1.tar.gz
  • Upload date:
  • Size: 127.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Pyjoyment-0.0.1.tar.gz
Algorithm Hash digest
SHA256 95439ec44979d839f46a80a54b6fe15899ad1c435166405a1aac0b12bdcee7f0
MD5 abd90f78eecc6c1d9e6e093df3c503bb
BLAKE2b-256 2dd61ab9fca946665ed9482c52a80def86f72a330586e20433fc5114848f7515

See more details on using hashes here.

File details

Details for the file Pyjoyment-0.0.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for Pyjoyment-0.0.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 2cb11f7d77661348a00d8834456e68a7bcf4c5470c155a697e88096fc04915d5
MD5 31b9372add03cf9c52a31bc74d22027c
BLAKE2b-256 d28770ea3ef912637ae2370bfa58a4a6692d9e3c91258f862aea808546bce16b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page