Git Product home page Git Product logo

ginkgo's Introduction

Ginkgo v0.5.0dev

Lightweight service framework on top of gevent, implementing the "service model" -- services all the way down.

Please note that this version is major rewrite since 0.3.1, hence skipping 0.4.0. Take a look at UPGRADING and some of the documentation might be out of date during transition.

Features

  • Service model -- Break your app down into services and sub-services. Modules, if you will, that can start, stop, and reload. Every service manages its own pool of greenlets.
  • Configuration -- Built-in, reloadable configuration based on Python files. Access configuration settings relative to services.
  • Runner -- Command-line tool to manage your service that can daemonize, chroot, drop privs, and set up or override configuration.

Demo

A talk was given at PyCon 2012 called "Throwing Together Distributed Services with gevent" that used Ginkgo to build a number of simple services combined to make a more complex distributed service.

Mailing List

Pretty active discussion on this early microframework. Join it or just read what's being planned:

Contributing

Feel free to poke around the issues in the main repository and see if you can tackle any. From there you should:

  • Fork if you haven't
  • Create a branch for the feature / issue
  • Write code+tests
  • Pass tests (using nose)
  • Squash branch commits using merge and reset
  • Send pull request

We highly recommend using branches for all features / issues and then squashing it into a single commit in your master before issuing a pull request. It's actually quite easy using merge and reset. This helps keep features and issues consolidated, but also makes pull requests easier to read, which increases the speed and likelihood of being accepted.

We're aiming for at least 90% test coverage. If you have the coverage Python package installed, you can run python setup.py coverage to get a coverage report of modules within gservice.

Contributors

License

MIT

ginkgo's People

Contributors

progrium avatar objcode avatar kyleconroy avatar msabramo avatar chadselph avatar davidwilemski avatar kelvl avatar

Watchers

cesarob avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.