Skip to main content

Async server micro-framework for control freaks

Project description

Gaidaros is an async socket server framework which has been designed for network developers, with an emphasis on easy low-level configurability and speed, with sane standard defaults. This means it can be quickly reused and adapted to each new project’s requirements, while keeping features out of the way unless requested.

Its first iteration is presently in alpha phase (e.g. edge-triggered epoll only), but has a clear list of development milestones ahead. See the TODO.rst file for details.

Gaidaros (Γάιδαρος) is Greek for donkey. I like donkeys. This framework doesn’t try to implement every trendy feature under the sun, it just tries to do all the basics accurately and reliably - like a donkey. So, that’s the naming rationale issue out of the way…

Features

  • Minimalism (priority on leanness, speed, configurability and base completeness rather than added features)
  • Thin wrapper to underlying async socket mechanisms
  • Everything configurable by config-files and passed arguments
  • Pass in handlers by name, (module, class) or as pre-created functions, methods or code objects
  • TODO: Multiple server processors can be run on the polling socket using multiprocessing (or a pool thereof)
  • TODO: Handlers can be run in threads, greenthreads, multiprocesses, and pools of any of those three
  • TODO: Handlers can be run on a cluster using parallel processing (“pp”/”pyparallel”). Cluster nodes can in turn use threads, greenthreads, multiprocesses, or pools thereof too
  • IPv4 and/or IPv6, SSL (TLSv1, SSLv3, SSLv23) or not
  • TCP, TODO: UDP, unixsocket, etc
  • TODO: Can be used with various frontends (e.g. Tornado)

Installation

From pypi

$ pip install gaidaros

From source

$ git clone https://github.com/rowanthorpe/gaidaros.git
$ cd gaidaros && pip install -r requirements.txt

From latest released tarball

$ wget --no-check-certificate https://github.com/rowanthorpe/gaidaros/tarball/0.3.13

Build Status

When properly integrated with Travis the project’s status should appear below this:

Build Status

Authors

Rowan Thorpe <rowan@rowanthorpe.com>

License

Gaidaros uses the MIT license, check LICENSE file.

Contributors

  • Just Rowan Thorpe, so far…

Thanks also to

"donkey kiss" image by wgdavis (CC BY-NC-SA 2.0)

“Donkey kiss” image from flickr (CC BY-NC-SA 2.0)

Project details


Release history Release notifications

This version
History Node

0.3.13

History Node

0.3.12

History Node

0.3.8

History Node

0.3.6

History Node

0.3.5

History Node

0.3.4

History Node

0.3.2

History Node

0.2.7

History Node

0.2.6

History Node

0.2.5

History Node

0.2.4

History Node

0.2.3

History Node

0.1.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
gaidaros-0.3.13.tar.gz (18.7 kB) Copy SHA256 hash SHA256 Source None Dec 16, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page