FFI Wrapper

[JP-Ellis]

📝 Summary

Implement a pact.v3.ffi module which exposes functions to cover all of the functions exposed by the Pact library.

Due to the number of functions, most of these are simply:

def foo(...):
    """
    {description from pact.h}
    """
    raise NotImplementedError

and they will be filled in as the implementation proceeds.

Most of the code in this PR was automatically created, and then modified slightly to ensure conformance with Ruff's lints.

🚨 Breaking Changes

🔨 Test Plan

As the rest of the pact.v3 module gets populated, more of these functions will get tested. At this stage, only version is defined and tested.

All tests for the new pact.v3 modules will be stored under the corresponding tests/v3/ directory.

🔗 Related issues/PRs

• Resolves: Implement a thin wrapper for all the FFI functions in the core library #399

  Turns out that implementing a wrapper for all functions was a bit ambitious given the number of functions.

• FFI Groundwork #395

  That PR must be merged before this PR.

[YOU54F]

Hey had a quick look at this, should this have master merged into it now? or master merged into the ffi-groundwork PR? Would make it a bit easier to review in a ui diff I think.

[JP-Ellis]

Yeah sorry for the review being difficult. It's built on top of the FFI groundwork, hence why it has a lot of extra commits. Only the last commit, 0afc711, is new.

[YOU54F]

no need to apologise, wasn't sure if it was because of some git merge mastery that you have lined up.

i ended up merging master in locally in the previous #395 as I wanted to run the examples, after running and checking the PR as it was

[JP-Ellis]

I have rebased this PR on top of the feat/initial-ffi branch (as it was itself rebased). I've also adjusted to target branch for this PR to be the latter to help single out the changes include here.

[YOU54F]

good stuff!

[JP-Ellis]

Rebased on top of master to ensure it can merge. Only failing tests are related to the recent release of Python 3.12.