Skip to content

Commit 8acac39

Browse files
Deploy to gh-pages branch: base commit 1e710da8cdcac43ff18a202af3f5d6edcb1970f7
1 parent 127b7c8 commit 8acac39

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+7247
-0
lines changed

utPLSQL/develop/about/authors.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
![version](https://img.shields.io/badge/version-v3.1.13.4041--develop-blue.svg)
2+
3+
### utPLSQL v3 Major Contributors
4+
5+
**Listed Alphabetically**
6+
7+
| Name | GitHub account
8+
| ---------------- | --------------
9+
| David Pyke | [Shoelace](https://github.com/Shoelace)
10+
| Jacek Gebal | [jgebal](https://github.com/jgebal)
11+
| Lukasz Wasylow | [lwasylow](https://github.com/lwasylow/)
12+
| Pavel Kaplya | [Pazus](https://github.com/Pazus)
13+
| Robert Love | [rlove](https://github.com/rlove)
14+
| Samuel Nitsche | [pesse](https://github.com/pesse/)
15+
| Vinicius Avellar | [viniciusam](https://github.com/viniciusam/)
16+
17+
18+
19+
Many thanks to all the [contributors](https://github.com/utPLSQL/utPLSQL/graphs/contributors)
20+
21+
### Special thanks to prior major contributors
22+
23+
- Steven Feuerstein - Original Author
24+
- Chris Rimmer
25+
- Patrick Barel
26+
- Paul Walker

utPLSQL/develop/about/license.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
![version](https://img.shields.io/badge/version-v3.1.13.4041--develop-blue.svg)
2+
3+
# Version Information
4+
5+
**utPLSQL version 3** is licensed under
6+
[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)
7+
8+
External code used in the development of this project, but is not required for use.
9+
10+
| Tool | License | Purpose |
11+
| ---- | --------| --------|
12+
| [Travis-Oracle](https://github.com/cbandy/travis-oracle) | [ISC](https://github.com/cbandy/travis-oracle/blob/master/LICENSE) | Install Oracle for Travis Builds |
13+
| [mkDocs](http://www.mkdocs.org/) | [BSD](http://www.mkdocs.org/about/license/) | Produce HTML version of documentation |
14+
15+
**Note:**
16+
17+
Version 1 & 2 of utPLSQL were licensed under GPL, version 3 was a complete rewrite from scratch which a allowed us to change the license to be more permissive.
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
![version](https://img.shields.io/badge/version-v3.1.13.4041--develop-blue.svg)
2+
3+
# utPLSQL Project Details
4+
5+
[![chat](http://img.shields.io/badge/GitHub_Project-Active-blue.svg)](https://github.com/utPLSQL/utPLSQL)
6+
[![license](http://img.shields.io/badge/license-apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
7+
[![chat](http://img.shields.io/badge/chat-slack-blue.svg)](https://join.slack.com/t/utplsql/shared_invite/zt-xwm68udy-4cF_3PNEyczYEbWr38W5ww)
8+
[![twitter](https://img.shields.io/twitter/follow/utPLSQL.svg?style=social&label=Follow)](https://twitter.com/utPLSQL)
9+
10+
11+
utPLSQL is open source project [hosted on GitHub](https://github.com/utPLSQL/utPLSQL).
12+
13+
Contributions, help and constructive feedback is always appreciated.
14+
15+
If you are interested in helping please read our [contributing guide](https://github.com/utPLSQL/utPLSQL/blob/develop/CONTRIBUTING.md)
16+
17+
18+

utPLSQL/develop/about/support.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
![version](https://img.shields.io/badge/version-v3.1.13.4041--develop-blue.svg)
2+
3+
# How to get support
4+
5+
- Feel free to post questions, bugs or issues in the [issues area of GitHub](https://github.com/utPLSQL/utPLSQL/issues)
6+
- [Join](https://join.slack.com/t/utplsql/shared_invite/zt-xwm68udy-4cF_3PNEyczYEbWr38W5ww) developers team on [utPLSQL Slack](https://utplsql.slack.com/)
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
For version 3 has been a complete rewrite of the framework, the way it can be used is different to
2+
the previous versions, but also more in line with other modern unit-testing frameworks like JUnit and RSpec.
3+
4+
There is a [migration tool](https://github.com/utPLSQL/utPLSQL-v2-v3-migration) that can help you to migrate your existing utPLSQL v2 tests to the v3 capabilities.
5+
6+
# Feature comparison
7+
8+
| Feature | Version 2 | Version 3 |
9+
| -------------------------------------- | ---------------------- | ---------------------- |
10+
| Easy to install | Yes | Yes |
11+
| Documentation | Yes | Yes |
12+
| License | GPL v2 | Apache 2.0 |
13+
| **Tests Creation** | | |
14+
| Declarative test configuration | No | Yes - Annotations<sup>1</sup>|
15+
| Tests as Packages | Yes | Yes |
16+
| Multiple Tests in a single Package | Yes | Yes |
17+
| Optional Setup/Teardown | No | Yes |
18+
| Different Setup/Teardown <br/> For Each Test in a Single Package| No | Yes - Annotations<sup>1</sup> |
19+
| Suite Definition Storage | Tables | Package - Annotations<sup>1</sup> |
20+
| Multiple Suites | Yes | Yes |
21+
| Suites can contain Suites | No | Yes |
22+
| Automatic Test detection | No | Yes - Annotations<sup>1</sup>|
23+
| Unconstrained naming of Test packages | No - prefixes | Yes - name not relevant|
24+
| Require Prefix on Test procedures | No - prefixes | Yes - name not relevant|
25+
| Auto Compilation of Tests | Yes | No (Let us know if you use this) |
26+
| Assertion Library | 30 assertions<sup>2</sup> | 26 matchers (13 + 13 negated) |
27+
| Extendable assertions | No | Yes - custom matchers |
28+
| PLSQL Record Assertions | generated code through **utRecEq** Package | [possible on Oracle 12c+](https://oracle-base.com/articles/12c/using-the-table-operator-with-locally-defined-types-in-plsql-12cr1) using [cursor matchers](userguide/expectations.md#comparing-cursors)|
29+
| Test Skeleton Generation | Yes | No (Let us know if you use this) |
30+
| **Test Execution<sup>3</sup>** | | |
31+
| Single Test Package Execution | Yes | Yes |
32+
| Single Test Procedure Execution | No | Yes |
33+
| Test Suite Execution | Yes | Yes |
34+
| Subset of Suite Execution | No | Yes |
35+
| Multiple Suite Execution | No | Yes |
36+
| Organizing Suites into hierarchies | No | Yes |
37+
| **Code Coverage Reporting** | No | Yes |
38+
| Html Coverage Report | No | Yes |
39+
| Sonar XML Coverage Report | No | Yes |
40+
| Coveralls Json Coverage Report | No | Yes |
41+
| Framework Transaction Control | No | Yes - Annotations<sup>1</sup> |
42+
| **Test Output** | | |
43+
| Real-time test execution progress reporting | No | Yes |
44+
| Multiple Output Reporters can be used during test execution | No| Yes |
45+
| DBMS_OUTPUT | Yes | Yes (clean formatting) |
46+
| File | Yes (to db server only)| Yes (on client side) |
47+
| Stored in Table | Yes | No (can be added as custom reporter) |
48+
| XUnit format support | No | Yes |
49+
| HTML Format | Yes | No |
50+
| Custom Output reporter | Yes-needs configuration| Yes - no config needed |
51+
52+
<sup>1</sup> Annotations are specially formatted comments in your package specification. This enables *declarative* test configuration that is coupled with the source code. See Documentation for more details.
53+
54+
<sup>2</sup> **utAssert2** package - Contains 59 Assertions - 2 Not implemented = 57, 28 are duplicated only change on outcome_in parameter 57-28 = 29, **utPipe** package - Contains 1 Assertion 29 + 1 = 30
55+
56+
<sup>3</sup> Test execution comparison is in a single call so the results are combined. We know it was always possible to group in any way with multiple calls. But that may not be desired under a CI system where you want a single JUnit XML Output.
361 KB
Loading
33.5 KB
Loading
44.9 KB
Loading
21.6 KB
Loading
22.1 KB
Loading

0 commit comments

Comments
 (0)