farmOS 0.1.6b3

A Python library for interacting with farmOS over API.

farmOS.py

farmOS.py is a Python library for interacting with farmOS over API.

For more information on farmOS, visit farmOS.org.

USAGE

import farmOS

hostname = 'myfarm.farmos.net'
username = 'My Name'
password = 'mYPa$$w0rd'

farm = farmOS.farmOS(hostname, username, password)
success = farm.authenticate()

# Get farm info
info = farm.info()

# Get all logs
logs = farm.log.get()
# Get harvest logs
harvests = farm.log.get({
  'type':'farm_harvest'
  })
# Get log number 37
log = farm.log.get(37)

# Get all assets
assets = farm.asset.get()
# Get all animal assets
animals = farm.asset.get({
  'type':'animal'
  })

# Get all areas
areas = farm.area.get()
# Get field areas
fields = farm.area.get({
  'area_type':'field'
  })

# Get all terms
terms = farm.term.get()
# Get all terms from farm_crops vocabulary
crops = farm.term.get('farm_crops')

You can configure how farmOS logs are displayed with the following:

import logging

# Required to init a config on the ROOT logger, that all other inherit from
logging.basicConfig()

 # Configure all loggers under farmOS (farmOS.client, famrOS.session) to desired level
logging.getLogger("farmOS").setLevel(logging.DEBUG)

 # Hide debug logging from the farmOS.session module
logging.getLogger("farmOS.session").setLevel(logging.WARNING)

More info on logging in Python here.

TESTING

Functional tests require a live instance of farmOS to communicate with. Configure credentials for the farmOS instance to test against by setting the following environment variables:

For farmOS Drupal Authentication: FARMOS_HOSTNAME, FARMOS_RESTWS_USERNAME, and FARMOS_RESTWS_PASSWORD

For farmOS OAuth Authentication (Password Flow): FARMOS_HOSTNAME, FARMOS_OAUTH_USERNAME, FARMOS_OAUTH_PASSWORD, FARMOS_OAUTH_CLIENT_ID, FARMOS_OAUTH_CLIENT_SECRET

Automated tests are run with pytest

python setup.py test

MAINTAINERS

• Paul Weidner (paul121) - https://github.com/paul121
• Michael Stenta (m.stenta) - https://github.com/mstenta

This project has been sponsored by:

• Farmier
• Pennsylvania Association for Sustainable Agriculture
• Our Sci
• Bionutrient Food Association
• Foundation for Food and Agriculture Research