pyfilemaker2 0.1.11

Python Object Wrapper for FileMaker Server XML Interface

# PyFileMaker - Integrating FileMaker and Python
* (c) 2016-2018 Jeremie Borel
* (c) 2014-2016 Marcin Kawa, [e-mail]
* (c) 2006-2008 Klokan Petr Pridal, [e-mail]
* (c) 2002-2006 Pieter Claerhout, [e-mail]

Old project urls:

* https://github.com/aeguana/PyFileMaker
* http://code.google.com/p/pyfilemaker/
* http://www.yellowduck.be/filemaker/

-------------------------------------------------------------------------------

### TABLE OF CONTENTS

1. What is pyfilemaker2 ?
2. Requirements
3. How to install PyFileMaker
4. Changes

-------------------------------------------------------------------------------
### 1. WHAT IS pyfilemaker2?

pyfilemaker2 is based, but largely rewritten, from PyFileMaker
(https://github.com/aeguana/PyFileMaker) whose description is still valid:

```
PyFileMaker is a set of Python modules that makes it easy to access and modify
data stored in a FileMaker Pro/Server database. You can use it to query a FileMaker
database, but you can also use it to add data to a FileMaker database, you
can even use it to delete records and execute FileMaker scripts.
```

pyfilemaker2 implements the following additional features:
- FM server responses can be streamed and parsed 'on the fly' during the streaming.
- FM server responses can be automatically paginated as large dataset (>20k records)
tend to trigger FMS and/or network timeouts.
- meant to be thread safe, though I can't claim to be an expert on the subject...
- More consistent and finer control on the way data types are cast when reading or
writting FM records (in particular dates, datetimes and float objects)
- python 2.7 and python 3.6 compatible (most probably other 3.x versions too but not tested)
- improved test battery
-

----

### 2. REQUIREMENTS

At the time of the development (2018), the pyfilemaker2 is using:

```
requests==2.19.1
lxml==4.2.5
future==0.16.0
```

The test suite also requires

```
mock
pytz
```

The code has been developped on Max OSX 10.13 and is used in production on
debian jessie. Other plateforms have not been tested.

You will also need a FileMaker server with the XML enabled of course.

----

### 3. HOW TO INSTALL PYFILEMAKER2

You can install from pypi using pip

```
$ pip install pyfilemaker2
```

---

### 4. CHANGES
0.1.11: enforcing stream=True by default as FMS now requires it.

0.1.10: bug fix with the stream argument.

0.1.9:

- adding timezone support as FM datetime object are naive datetime

- changed the way the options are passed to FmServer object
so that a subclass with default
parameters can be used.

0.1.6: bug fixes in `do_find_query`

Version 0.1
- First release of the code