Skip to main content

Python client library for RESTfm

Project description

In short This library gives you full access to Filemaker with a pythonic api.

RESTfm gives you full Create, Read, Update and Delete ( CRUD ) operations on FileMaker Server hosted data via standard HTTP GET, POST, PUT and DELETE methods, this means you can get can get access to Filemaker over HTTP and with this library of also with Python 3.5+.


  • Python 3.5+
  • Tested with FileMaker 15 Server, should work with others.

Available over pip

We upload releases to pypi, you can get restfmclient over pip:

pip3 install restfmclient

Install RESTfm on *nix

  • Install Apache with mod_php or better nginx with php-fpm, there are a lot tutorials for that.

  • Download RESTfm from and extract it to /var/www:

    sudo tar xfz RESTfm-4.0.8.tgz -C /var/www
  • Copy FileMaker ServerWeb on your server (use winscp or scp).

  • Extract on the linux box:

    cd /var/www/RESTfm/FileMaker/
    unzip ~/
  • Configure RESTfm:

    nano RESTfm.ini.php
  • Adjust at least: $config[‘database’][‘hostspec’]

Install RESTfm on Windows

  • Same as with Linux but with XAMPP, get the PHP 5.6 version.

Run the example

  • Git clone:

    git clone
  • Install the FileMaker example DB on your host, copy examples/restfm_example.fmp12 on it and activate the db.

  • virtualenv:

    cd py-restfmclient
    virtualenv -p /usr/bin/python3.5 --no-site-packages venv
  • pip install:

    ./venv/bin/pip3 install -r requirements_dev.txt
  • install restfmclient:

    ./venv/bin/python3 develop
  • Run it:

    ./venv/bin/python3 examples/ "http://<ip-or-dnsname-of-restfm-box>/RESTfm/" admin supersecretpw
  • Or run with the RESTfm demo server:

    ./venv/bin/python3 examples/ "" write restfm

Install in your own project

Its recommended to use a virtualenv for your project.

Install via pip:

pip3 install restfmclient

aiohttp works a lot better with cchardet, aiodns and uvloop so install those:

pip3 install cchardet aiodns uvloop

Activate uvloop in your own scripts:

import uvloop


Just install requirements_dev.txt and run nosetests for a simple mocked test:

git clone
cd py-restfmclient
virtualenv -p /usr/bin/python3.5 --no-site-packages venv
source venv/bin/activate
pip3 install -r requirements_dev.txt

If you want to run the tests against a live server you have to install examples/restfm_example.fmp12 on the Filemaker server, then you can run it by giving the ENV variable RESTFM_BASE_URL:

RESTFM_BASE_URL='http://admin:supersecretpw@<<ip-or-dnsname-of-restfm-box>/RESTfm/' nosetests


Please provide pull requests if you want to improve py-restfmclient, just make sure that you don’t break the API if not required. Please run nosetests before you create a PR if you can.

To update the test mock files, run:

rm -rf restfmclient/tests/data/*
RESTFM_BASE_URL='http://admin:supersecretpw@<<ip-or-dnsname-of-restfm-box>/RESTfm/' RESTFM_STORE_PATH='restfmclient/tests/data/' nosetests

We use zest.releaser to create a release and upload it to pypi.


Copyright 2017 - Stiftung Maria Ebene, licensed under the MIT license.


1.2.1 (2016-12-17)

  • Fix timezone conversations.

1.2.0 (2016-12-17)

  • Improve tests, add more Date types.
  • Better default block_size and convert input search values.
  • Use tzlocal.get_localzone() as default timezone.

1.1.0 (2016-12-15)

  • Fix a bug with tests, export Record, add name property to layout.
  • Use type converters as staticmethods, this breaks the API.
  • Fix 2 smaller bugs.
  • Do not chache “count” in layouts, we want always the current number.

1.0.0 (2016-12-10)

Project details

Download files

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

Files for restfmclient, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size restfmclient-1.2.1-py2.py3-none-any.whl (16.5 kB) File type Wheel Python version 3.5 Upload date Hashes View
Filename, size restfmclient-1.2.1.tar.gz (11.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page