feat(test): support referenvcing a tuple_file instead of tuples

[ewanharris]

Description

Adds support for using tuple_file instead of tuples in a test file. The file can be either a yaml or json syntax. All tuple files are loaded upfront before running tests so that we can ensure that the test run will be functional and all errors are collated and presented to the user like below.

fga model test --tests ./example/model.fga.yaml
Error: error running tests due to failed to process one or more tuple files
failed to process global tuple ./model_tuples.yaml file due to yaml: line 7: could not find expected ':'
failed to process tuple file ./folder-document-access_tuple.json for test folder-document-access due to open example/folder-document-access_tuple.json: no such file or directory
exit status 1

The model.fga.yaml example has been updated to show this and also demonstrate the two file types that are supported.

References

Closes #179

Review Checklist

• I have clicked on "allow edits by maintainers".
• I have added documentation for new/changed functionality in this PR or in a PR to openfga.dev [Provide a link to any relevant PRs in the references section above]
• The correct base branch is being used, if not main
• I have added tests to validate that the change in functionality is working as expected

[sergiught]

Would a more appropriate name for this have been TuplesFile ? 🤔

[ewanharris]

Yeah I considered that as it will most likely always contain multiple tuples but I wasn't entirely sold on it, happy to PR changing it if there's consensus for that

[ewanharris]

@rhamzeh given that you filed the initial issue what do you think about ☝🏻 , I also just noticed that the vscode extension does perform validation for a tuples_file property here so not sure if that should be considered in this addition (but I can't see any usage of it within the extension).