feat: add recursion guard

[adhtruong]

Pull Request Checklist

• [x] New code has 100% test coverage
• [ ] (If applicable) The prose documentation has been updated to reflect the changes introduced by this PR
• [ ] (If applicable) The reference documentation has been updated to reflect the changes introduced by this PR
• [x] Pre-Commit Checks were ran and passed
• [x] Tests were ran and passed

Description

• Add new new arg build_context to build related methods
• Track seen models in this parameter to guard against recursion
• Note this may arguably be backwards breaking but would expect recursion errors so fine to add as a default. Happy to add a configuration instead if preferable

Close Issue(s)

• Fixes #467

[guacs]

Note this may arguably be backwards breaking but would expect recursion errors so fine to add as a default

I agree with you. I don't think adding the recursion guard is a breaking change. It doesn't change the behavior nor the returned type.

[adhtruong]

All comments addressed now:

1. Implementation of coverage updated
2. Type errors resolved

[guacs]

@adhtruong that's fantastic! I'll take a look at it today or tomorrow :)

[github-actions[bot]]

Documentation preview will be available shortly at https://litestar-org.github.io/polyfactory-docs-preview/468