1Test2::Manual::ConcurreUnsceyr(3C)ontributed Perl DocumeTnetsatt2i:o:nManual::Concurrency(3)
2
3
4

NAME

6       Test2::Manual::Concurrency - Documentation for Concurrency support.
7

FORKING

9   Test2
10       Test2 supports forking. For forking to work you need to load
11       Test2::IPC.
12
13   Test::Builder
14       Test::Builder Did not used to support forking, but now that it is based
15       on Test2 it does. Test2::IPC must be loaded just as with Test2.
16
17   Test2::Suite
18       Test2::Suite tools should all work fine with true forking unless
19       otherwise noted. Pseudo-fork via threads (Windows and a few others) is
20       not supported, but may work.
21
22       Patches will be accepted to repair any pseudo-fork issues, but for
23       these to be used or tested they must be requested. Fork tests should
24       not run on pseudo-fork systems unless they are requested with an
25       environment var, or the AUTHOR_TESTING var. Pseudo-fork is fragile, and
26       we do not want to block install due to a pseudo-fork flaw.
27
28   Test::SharedFork
29       Test::SharedFork is currently support and maintained, though it is no
30       longer necessary thanks to Test2::IPC. If usage ever drops off then the
31       module may be deprecated, but for now the policy is to not let it
32       break. Currently it simply loads Test2::IPC if it can, and falls back
33       to the old methods on legacy installs.
34
35   Others
36       Individual authors are free to support or not support forking as they
37       see fit.
38

THREADING

40       Note This only applies to ithreads.
41
42   Test2
43       The core of Test2 supports threading so long as Test2::IPC is loaded.
44       Basic threading support (making sure events make it to the parent
45       thread) is fully supported, and must not be broken.
46
47       Some times perl installs have broken threads (Some 5.10 versions
48       compiled on newer gcc's will segv by simply starting a thread). This is
49       beyond Test2's control, and not solvable in Test2. That said we strive
50       for basic threading support on perl 5.8.1+.
51
52       If Test2 fails for threads on any perl 5.8 or above, and it is
53       reasonably possible for Test2 to work around the issue, it should.
54       (Patches and bug reports welcome).
55
56   Test::Builder
57       Test::Builder has had thread support for a long time. With Test2 the
58       mechanism for thread support was switched to Test2::IPC. Test::Builder
59       should still support threads as much as it did before the switch to
60       Test2.  Support includes auto-enabling thread support if threads is
61       loaded before Test::Builder.
62
63       If there is a deviation between the new and old threading behavior then
64       it is a bug (unless the old behavior itself can be classified as a
65       bug.) Please report (or patch!) any such threading issues.
66
67   Test2::Suite
68       Tools in Test2::Suite have minimal threading support. Most of these
69       tools do not care/notice threading and simply work because Test2::IPC
70       handles it.  Feel free to report any thread related bugs in
71       Test2::Suite. Be aware though that these tools are not legacy, and have
72       no pre-existing thread support, we reserve the right to refuse adding
73       thread support to them.
74
75       Test2::Workflow
76
77       Test2::Workflow has been merged into Test2::Suite, so it gets addressed
78       by this policy.
79
80       Test2::Workflow has thread support, but you must ask for it. Thread
81       tests for Test2::Workflow do not event run without setting either the
82       AUTHOR_TESTING env var, or the T2_DO_THREAD_TESTS env var.
83
84       To use threads with Test2::Workflow you must set the
85       T2_WORKFLOW_USE_THREADS env var.
86
87       If you do rely on threads with Test2::Workflow and find a bug please
88       report it, but it will be given an ultra-low priority. Merging patches
89       that fix threading issues will be given normal priority.
90

SEE ALSO

92       Test2 - Test2 itself.
93
94       Test2::Suite - Initial tools built using Test2.
95
96       Test2::Manual - Primary index of the manual.
97

SOURCE

99       The source code repository for Test2-Manual can be found at
100       https://github.com/Test-More/Test2-Suite/.
101

MAINTAINERS

103       Chad Granum <exodist@cpan.org>
104

AUTHORS

106       Chad Granum <exodist@cpan.org>
107

109       Copyright 2018 Chad Granum <exodist@cpan.org>.
110
111       This program is free software; you can redistribute it and/or modify it
112       under the same terms as Perl itself.
113
114       See http://dev.perl.org/licenses/
115
116
117
118perl v5.34.0                      2021-11-16     Test2::Manual::Concurrency(3)
Impressum