Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Core module containing code to run PyFarm's agent.

Project Description

Core module containing code to run PyFarm’s agent. This will allow a remote host to:

  • Inform the master about itself
  • Request, receive and execute work via job types
  • Track and control individual processes
  • Measure and limit system resource usage

Python Version Support

This library supports Python 2.6 and Python 2.7 only for the moment. Coding practices have been geared towards supporting Python 3 when the underlying library, Twisted, is ported to Python 3.

Documentation

The documentation for this this library is hosted on Read The Docs. It’s generated directly from this library using sphinx (setup may vary depending on platform):

virtualenv env
. env/bin/activate
pip install sphinx nose
pip install -e . --egg
make -C docs html

Testing

Tests are run on Travis for every commit. They can also be run locally too using trial. Currently, the agent tests require:

  • Access to https://httpbin.pyfarm.net for HTTP client testing. This is configurable however and could be pointed to an internal domain using the agent_unittest configuration variable.
  • The pyfarm.master module to run the API. So all the setup steps that apply to the master will apply here as well. This includes the requirement to run Redis, RabbitMQ or another backend that supports celery.
  • Linux or OS X since the master is designed to operate on these platforms. The below setup may work on Windows with a few configuration tweaks too.

Newer tests are being designed to be lighter weight so eventually most of the above may no longer be required for testing. For now however these are the basic steps to run the tests and are based on the steps in .travis.yml:

virtualenv env
. env/bin/activate
pip install pyfarm.master uwsgi mock
pyfarm-tables
uwsgi resources/uwsgi.ini
pip install -e . --egg
trial tests  # in a new shell with the same virtualenv
Release History

Release History

This version
History Node

0.8.6

History Node

0.8.3

History Node

0.8.2

History Node

0.8.1

History Node

0.8.0

History Node

0.7.0-dev0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pyfarm.agent-0.8.6.tar.gz (101.6 kB) Copy SHA256 Checksum SHA256 Source Jun 4, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting