Extract unittest from core

[thekid]

Scope of Change

The unittest package will be removed from xp-framework/core and split into xp-framework/unittest.

Rationale

Separate development cycle.

Functionality

The implementation will be done in multiple steps:

Step 1: Extract

First, the libraries will be extracted to their own repositories:

• https://github.com/xp-framework/unittest
• https://github.com/xp-framework/mocks
• https://github.com/xp-framework/webtest

These libraries will be created as overlays for xp-framework/core. This means if they are required, they will have precedence over the classes provided by core. This way, libraries can opt in and start using these libraries instead of depending on the version bundled in core (and by doing so, also benefit from any new features they provide). At the same time, the functionality in core will be frozen, meaning no new features will be added.

The library version numbers will match that of the last core release their code was still completely equal to: 6.4.2.

Step 2: Transition

The transition period lasts until 7.0.0. Libraries or projects using a dependency constraint of the form ~6.x or ^6.x will not break; only those using the rather risky dev-master or >=6.x variants.

Libraries are strongly encouraged to add a dependency on the respective libraries during this time, but are not required to do this.

Step 3: Remove

The code will be removed from xp-framework/core when 7.0.0 is released. So that core doesn't depend on unittest (which depends on core), the core repository's tests will be run with a bundled distribution.

Security considerations

n/a

Speed impact

Dependencies

Related documents

• Split up framework into minimal pieces #262 - Split framework into pieces
• Split up framework into minimal pieces #262 (comment)

[thekid]

Created https://github.com/xp-framework/unittest

[thekid]

Created https://github.com/xp-framework/mocks

[thekid]

Created https://github.com/xp-framework/webtest