[patch] Allow _FactoryMade to explicitly define where its reduce should import from

[liamhuber]

When a @classfactory is used inside a decorator, i.e. to create a new class directly from a decorated function or class definition, the new _FactoryMade class automatically conflicts with the namespace of its underlying source material. Previously, you could store the underlying function with _class_returns_from_decorated_function to avoid this conflict. This PR deprecates (but leaves available) that interface, while providing a new _reduce_imports_as: tuple[str, str] allowing you to explicitly specify where the _FactoryMade class should be (re)imported from in __reduce__. IMO this is a bit clearer, and is necessary flexibility for pyiron/pyiron_workflow#410 which is closing pyiron/pyiron_workflow#319.

[github-actions]

👈 Launch a binder notebook on branch pyiron/pyiron_snippets/factory_decorated_classes

[codacy-production]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
✅ +0.03% (target: -1.00%)	✅ 100.00%

Coverage variation details

	Coverable lines	Covered lines	Coverage
Common ancestor commit (5c2f87a)	556	529	95.14%
Head commit (c591337)	559 (+3)	532 (+3)	95.17% (+0.03%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details

	Coverable lines	Covered lines	Diff coverage
Pull request (#27)	3	3	100.00%

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

_{Codacy stopped sending the deprecated coverage status on June 5th, 2024. Learn more}

[coveralls]

Pull Request Test Coverage Report for Build 10295529767

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• 2 unchanged lines in 1 file lost coverage.
• Overall coverage increased (+0.03%) to 95.17%

---

Files with Coverage Reduction	New Missed Lines	%
factory.py	2	93.57%

Totals
Change from base Build 10156807263:	0.03%
Covered Lines:	532
Relevant Lines:	559

---

💛 - Coveralls