<commit_before>#utPLSQL v3<sub><sup> | Powerful PL/SQL Unit Testing Framework </sup></sub>
[![chat](http://img.shields.io/badge/version_status-alpha-blue.svg)](http://utplsql-slack-invite.herokuapp.com/)
[![build](https://img.shields.io/travis/utPLSQL/utPLSQL/master.svg?label=master%20branch)](https://travis-ci.org/utPLSQL/utPLSQL)
[![build](https://img.shields.io/travis/utPLSQL/utPLSQL/develop.svg?label=develop%20branch)](https://travis-ci.org/utPLSQL/utPLSQL)

[![license](http://img.shields.io/badge/license-apache%202.0-blue.svg)]
(https://www.apache.org/licenses/LICENSE-2.0)
[![chat](http://img.shields.io/badge/chat-slack-blue.svg)](http://utplsql-slack-invite.herokuapp.com/)
[![twitter](https://img.shields.io/twitter/follow/utPLSQL.svg?style=social&label=Follow)](https://twitter.com/utPLSQL)

----------
Version 3 is a complete rewrite of utPLSQL from scratch.  Version 2 still supports older versions of Oracle that are no longer available.   This has lead to difficult to maintain code.  Yet many developers wanted to take it to the next level.  The community that had developed on GitHub, decided that a new internal architecture was needed, from that version 3 was born.  Currently version 3 is not complete and is not ready for a production environment as the API is not stable and changing.   However it is quickly taking shape.  We welcome new developers to join our community and help utPLSQL grow.

Primary Goals:
 - Easier to maintain 
  - Only supports versions of Oracle under [Extend Support](http://www.oracle.com/us/support/library/lifetime-support-technology-069183.pdf)  (Currently 11.2, and 12.1)
  - API is documented in the code where possible.
 - Robust and vibrant assertion library.
 - Support for Code Coverage
 - Extensible API
 - Published upgrade/conversion path from version 2.
 - Easily called from current PL/SQL development tools
 - More permissive License to allow vendors easier ability to integrate utPLSQL. 

__Version 2 to Version 3 Comparison__

The following table is a work in progress right now, and **will** change.   If you have great idea that you would like to see in version 3 please create an [issue on GitHub](https://github.com/utPLSQL/utPLSQL/issues) or discuss it with us in the [Slack chat rooms](http://utplsql-slack-invite.herokuapp.com/).  


| Feature                   | Version 2     | Version 3              |
| ------------------------- | ------------- | ---------------------- |
| Easy to install           | Yes           | Yes                    |
| Documentation             | Yes           | Sparse - in progress   |
| License                   | GPL v2        | Apache 2.0             |
| **Tests Creation**        |               |                        |<commit_msg>Added link to Release page, and version 2 branch.<commit_after>#utPLSQL v3<sub><sup> | Powerful PL/SQL Unit Testing Framework </sup></sub>
[![chat](http://img.shields.io/badge/version_status-alpha-blue.svg)](http://utplsql-slack-invite.herokuapp.com/)
[![build](https://img.shields.io/travis/utPLSQL/utPLSQL/master.svg?label=master%20branch)](https://travis-ci.org/utPLSQL/utPLSQL)
[![build](https://img.shields.io/travis/utPLSQL/utPLSQL/develop.svg?label=develop%20branch)](https://travis-ci.org/utPLSQL/utPLSQL)

[![license](http://img.shields.io/badge/license-apache%202.0-blue.svg)]
(https://www.apache.org/licenses/LICENSE-2.0)
[![chat](http://img.shields.io/badge/chat-slack-blue.svg)](http://utplsql-slack-invite.herokuapp.com/)
[![twitter](https://img.shields.io/twitter/follow/utPLSQL.svg?style=social&label=Follow)](https://twitter.com/utPLSQL)

----------
Version 3 is a complete rewrite of utPLSQL from scratch.  [Version 2](https://github.com/utPLSQL/utPLSQL/tree/version2) still supports older versions of Oracle that are no longer available.   This has lead to difficult to maintain code.  Yet many developers wanted to take it to the next level.  The community that had developed on GitHub, decided that a new internal architecture was needed, from that version 3 was born.  Currently version 3 is not complete and is not ready for a production environment as the API is not stable and changing.   However it is quickly taking shape.  We welcome new developers to join our community and help utPLSQL grow.

Primary Goals:
 - Easier to maintain 
  - Only supports versions of Oracle under [Extend Support](http://www.oracle.com/us/support/library/lifetime-support-technology-069183.pdf)  (Currently 11.2, and 12.1)
  - API is documented in the code where possible.
 - Robust and vibrant assertion library.
 - Support for Code Coverage
 - Extensible API
 - Published upgrade/conversion path from version 2.
 - Easily called from current PL/SQL development tools
 - More permissive License to allow vendors easier ability to integrate utPLSQL. 

__Download__

Published releases are available for download on the [utPLSQL GitHub Releases Page.](https://github.com/utPLSQL/utPLSQL/releases)


__Version 2 to Version 3 Comparison__

The following table is a work in progress right now, and **will** change.   If you have great idea that you would like to see in version 3 please create an [issue on GitHub](https://github.com/utPLSQL/utPLSQL/issues) or discuss it with us in the [Slack chat rooms](http://utplsql-slack-invite.herokuapp.com/).  


| Feature                   | Version 2     | Version 3              |
| ------------------------- | ------------- | ---------------------- |
| Easy to install           | Yes           | Yes                    |
| Documentation             | Yes           | Sparse - in progress   |
| License                   | GPL v2        | Apache 2.0             |
| **Tests Creation**        |               |                        |
{'fraction_non_alphanumeric': 0.13119330076762037, 'fraction_numerical': 0.012909979064898814, 'mean_word_length': 2.8788903924221922, 'pattern_counts': {'":': 0, '<': 11, '<?xml version=': 0, '>': 11, 'https://': 18, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 11, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2386165', 'n_tokens_mistral': 1723, 'n_tokens_neox': 1607, 'n_words': 519}