|
112 | 112 | <div data-md-component="skip"> |
113 | 113 |
|
114 | 114 |
|
115 | | - <a href="#framework-history" class="md-skip"> |
| 115 | + <a href="#frameworks-and-tools" class="md-skip"> |
116 | 116 | Skip to content |
117 | 117 | </a> |
118 | 118 |
|
|
1294 | 1294 | <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> |
1295 | 1295 |
|
1296 | 1296 | <li class="md-nav__item"> |
1297 | | - <a href="#framework-history" class="md-nav__link"> |
| 1297 | + <a href="#frameworks-and-tools" class="md-nav__link"> |
1298 | 1298 | <span class="md-ellipsis"> |
1299 | 1299 |
|
1300 | | - Framework history |
| 1300 | + Frameworks and tools |
1301 | 1301 |
|
1302 | 1302 | </span> |
1303 | 1303 | </a> |
1304 | 1304 |
|
1305 | 1305 | </li> |
1306 | 1306 |
|
1307 | 1307 | <li class="md-nav__item"> |
1308 | | - <a href="#major-contributors" class="md-nav__link"> |
| 1308 | + <a href="#community" class="md-nav__link"> |
1309 | 1309 | <span class="md-ellipsis"> |
1310 | 1310 |
|
1311 | | - Major Contributors |
| 1311 | + Community |
1312 | 1312 |
|
1313 | 1313 | </span> |
1314 | 1314 | </a> |
1315 | 1315 |
|
1316 | 1316 | </li> |
1317 | 1317 |
|
1318 | 1318 | <li class="md-nav__item"> |
1319 | | - <a href="#prior-versions-creators" class="md-nav__link"> |
| 1319 | + <a href="#license" class="md-nav__link"> |
1320 | 1320 | <span class="md-ellipsis"> |
1321 | 1321 |
|
1322 | | - Prior versions creators |
| 1322 | + License |
1323 | 1323 |
|
1324 | 1324 | </span> |
1325 | 1325 | </a> |
1326 | 1326 |
|
1327 | 1327 | </li> |
1328 | 1328 |
|
1329 | 1329 | <li class="md-nav__item"> |
1330 | | - <a href="#getting-support" class="md-nav__link"> |
| 1330 | + <a href="#history" class="md-nav__link"> |
| 1331 | + <span class="md-ellipsis"> |
| 1332 | + |
| 1333 | + History |
| 1334 | + |
| 1335 | + </span> |
| 1336 | + </a> |
| 1337 | + |
| 1338 | + <nav class="md-nav" aria-label="History"> |
| 1339 | + <ul class="md-nav__list"> |
| 1340 | + |
| 1341 | + <li class="md-nav__item"> |
| 1342 | + <a href="#framework-history" class="md-nav__link"> |
1331 | 1343 | <span class="md-ellipsis"> |
1332 | 1344 |
|
1333 | | - Getting Support |
| 1345 | + Framework history |
1334 | 1346 |
|
1335 | 1347 | </span> |
1336 | 1348 | </a> |
1337 | 1349 |
|
1338 | 1350 | </li> |
| 1351 | + |
| 1352 | + <li class="md-nav__item"> |
| 1353 | + <a href="#major-contributors" class="md-nav__link"> |
| 1354 | + <span class="md-ellipsis"> |
1339 | 1355 |
|
1340 | | - <li class="md-nav__item"> |
1341 | | - <a href="#licensing" class="md-nav__link"> |
| 1356 | + Major Contributors |
| 1357 | + |
| 1358 | + </span> |
| 1359 | + </a> |
| 1360 | + |
| 1361 | +</li> |
| 1362 | + |
| 1363 | + <li class="md-nav__item"> |
| 1364 | + <a href="#prior-versions-creators" class="md-nav__link"> |
1342 | 1365 | <span class="md-ellipsis"> |
1343 | 1366 |
|
1344 | | - Licensing |
| 1367 | + Prior versions creators |
1345 | 1368 |
|
1346 | 1369 | </span> |
1347 | 1370 | </a> |
1348 | 1371 |
|
| 1372 | +</li> |
| 1373 | + |
| 1374 | + </ul> |
| 1375 | + </nav> |
| 1376 | + |
1349 | 1377 | </li> |
1350 | 1378 |
|
1351 | 1379 | <li class="md-nav__item"> |
|
1441 | 1469 |
|
1442 | 1470 | <h1>About</h1> |
1443 | 1471 |
|
1444 | | -<p>utPLSQL is an open-source testing framework for PL/SQL and SQL</p> |
1445 | | -<p>It allows for automated testing of:</p> |
| 1472 | +<p>utPLSQL is a set of free-to use, open-source frameworks and tools for unit testing Oracle Database PL/SQL code, inspired by the JUnit and RSpec family of frameworks.</p> |
| 1473 | +<p>It lets you write and run automated tests for anything that can be executed and observed from PL/SQL - packages, |
| 1474 | +functions, procedures, triggers, views, and beyond.</p> |
| 1475 | +<p>Tests are defined with simple annotations and can be structured into hierarchies of suites, making tests easier to |
| 1476 | +group into logical collections. A rich variety of matchers enables data comparison, including complex types such as objects, |
| 1477 | +collections and cursors, while automatic, configurable transaction control keeps every test isolated and repeatable.</p> |
| 1478 | +<p>Built-in code coverage reporting and muti-format test result reporting, make utPLSQL easy to run within |
| 1479 | +existing CI/CD pipelines, with native integrations for SonarQube, Jenkins and TeamCity, Azure, GitHub Actions etc.</p> |
| 1480 | +<h2 id="frameworks-and-tools">Frameworks and tools<a class="headerlink" href="#frameworks-and-tools" title="Permanent link">¶</a></h2> |
| 1481 | +<table> |
| 1482 | +<thead> |
| 1483 | +<tr> |
| 1484 | +<th>Project</th> |
| 1485 | +<th>Description</th> |
| 1486 | +</tr> |
| 1487 | +</thead> |
| 1488 | +<tbody> |
| 1489 | +<tr> |
| 1490 | +<td><a href="https://github.com/utPLSQL/utPLSQL">utPLSQL</a></td> |
| 1491 | +<td>Core framework — install and run unit tests in Oracle</td> |
| 1492 | +</tr> |
| 1493 | +<tr> |
| 1494 | +<td><a href="https://github.com/utPLSQL/utPLSQL-demo-project">utPLSQL-demo-project</a></td> |
| 1495 | +<td>Demonstration project showcasing running utPLSQL tests in Github Actions with dockerized Oracle DB</td> |
| 1496 | +</tr> |
| 1497 | +<tr> |
| 1498 | +<td><a href="https://github.com/utPLSQL/utPLSQL-cli">utPLSQL-cli</a></td> |
| 1499 | +<td>Command-line client for running tests from CI/CD pipelines</td> |
| 1500 | +</tr> |
| 1501 | +<tr> |
| 1502 | +<td><a href="https://github.com/utPLSQL/utPLSQL-maven-plugin">utPLSQL-maven-plugin</a></td> |
| 1503 | +<td>Maven plugin for running utPLSQL tests</td> |
| 1504 | +</tr> |
| 1505 | +<tr> |
| 1506 | +<td><a href="https://github.com/utPLSQL/utPLSQL-SQLDeveloper">utPLSQL-SQLDeveloper</a></td> |
| 1507 | +<td>SQL Developer extension</td> |
| 1508 | +</tr> |
| 1509 | +<tr> |
| 1510 | +<td><a href="https://github.com/utPLSQL/utPLSQL-PLSQL-Developer">utPLSQL-PLSQL-Developer</a></td> |
| 1511 | +<td>PL/SQL Developer extension</td> |
| 1512 | +</tr> |
| 1513 | +<tr> |
| 1514 | +<td><a href="https://github.com/utPLSQL/utPLSQL-java-api">utPLSQL-java-api</a></td> |
| 1515 | +<td>Java API for connecting to utPLSQL</td> |
| 1516 | +</tr> |
| 1517 | +<tr> |
| 1518 | +<td><a href="https://github.com/utPLSQL/utPLSQL-dotnet-api">utPLSQL-dotnet-api</a></td> |
| 1519 | +<td>.NET API for connecting to utPLSQL</td> |
| 1520 | +</tr> |
| 1521 | +</tbody> |
| 1522 | +</table> |
| 1523 | +<h2 id="community">Community<a class="headerlink" href="#community" title="Permanent link">¶</a></h2> |
| 1524 | +<p>utPLSQL is developed 100% voluntarily by an open community, which embraces a |
| 1525 | +<a href="https://github.com/utPLSQL/.github/blob/main/CODE_OF_CONDUCT.md">Code of Conduct</a>.</p> |
1446 | 1526 | <ul> |
1447 | | -<li>Packages</li> |
1448 | | -<li>Functions</li> |
1449 | | -<li>Procedures</li> |
1450 | | -<li>Triggers</li> |
1451 | | -<li>Views</li> |
1452 | | -<li>Anything else that can be executed and observed from PL/SQL</li> |
| 1527 | +<li>Search or start a topic on <a href="https://github.com/utPLSQL/utPLSQL/discussions">GitHub Discussions</a> to ask questions, find support and share ideas</li> |
| 1528 | +<li>Search <a href="https://stackoverflow.com/questions/tagged/utplsql">Stack Overflow</a> using the <code>utplsql</code> tag</li> |
| 1529 | +<li>Open a new <a href="https://github.com/utPLSQL/utPLSQL/issues">issue on GitHub</a> for bugs or feature requests</li> |
| 1530 | +<li>Read the <a href="https://github.com/utPLSQL/utPLSQL/blob/develop/CONTRIBUTING.md">contributing guide</a> if you'd like to get involved</li> |
1453 | 1531 | </ul> |
1454 | | -<p>utPLSQL is developed 100% voluntarily and embraces a <a href="https://github.com/utPLSQL/utPLSQL/blob/develop/CODE_OF_CONDUCT.md">Code of Conduct</a>.</p> |
1455 | | -<p>Additional information can be found in the <a href="/documentation">documentation</a> pages.</p> |
1456 | | -<p><a href="https://github.com/utPLSQL/utPLSQL/issues"><img alt="issues" src="http://img.shields.io/badge/GitHub_Project-Active-blue.svg" /></a> |
1457 | | -<a href="https://www.apache.org/licenses/LICENSE-2.0"><img alt="license" src="http://img.shields.io/badge/license-apache%202.0-blue.svg" /></a> |
1458 | | -<a href="https://github.com/utPLSQL/utPLSQL/discussions"><img alt="GitHub Discussions" src="https://img.shields.io/github/discussions/utPLSQL/utPLSQL" /></a> |
1459 | | -<a href="https://twitter.com/utPLSQL"><img alt="twitter" src="https://img.shields.io/twitter/follow/utPLSQL.svg?style=social&label=Follow" /></a> |
1460 | | -<a href="https://www.linkedin.com/company/utplsql/"><img alt="linkedIn" src="https://img.shields.io/badge/LinkedIn-Follow-blue?logo=linkedin" /></a></p> |
1461 | | -<p>utPLSQL and its companion tools are open source, <a href="https://github.com/utPLSQL">hosted on GitHub</a>. Contributions, help |
1462 | | -and constructive feedback are always appreciated — read the <a href="https://github.com/utPLSQL/utPLSQL/blob/develop/CONTRIBUTING.md">contributing guide</a> |
1463 | | -if you'd like to get involved.</p> |
| 1532 | +<p>Follow the project on <a href="https://twitter.com/utPLSQL">Twitter</a>, <a href="https://bsky.app/profile/utplsql.bsky.social">Bluesky</a> |
| 1533 | +and <a href="https://www.linkedin.com/company/utplsql/">LinkedIn</a> for news and announcements.</p> |
| 1534 | +<h2 id="license">License<a class="headerlink" href="#license" title="Permanent link">¶</a></h2> |
| 1535 | +<p>utPLSQL projects are licensed under the <a href="https://github.com/utPLSQL/utPLSQL/blob/develop/LICENSE">Apache 2.0 license</a>.</p> |
| 1536 | +<h2 id="history">History<a class="headerlink" href="#history" title="Permanent link">¶</a></h2> |
1464 | 1537 | <h3 id="framework-history">Framework history<a class="headerlink" href="#framework-history" title="Permanent link">¶</a></h3> |
1465 | 1538 | <p>While the framework exists since 1999, |
1466 | 1539 | the current version is a consequence of a complete rewrite done in 2016 by passionate developers, |
@@ -1551,52 +1624,11 @@ <h3 id="prior-versions-creators">Prior versions creators<a class="headerlink" hr |
1551 | 1624 | </tr> |
1552 | 1625 | </tbody> |
1553 | 1626 | </table> |
1554 | | -<h2 id="getting-support">Getting Support<a class="headerlink" href="#getting-support" title="Permanent link">¶</a></h2> |
1555 | | -<ul> |
1556 | | -<li>Search or start a topic on <a href="https://github.com/utPLSQL/utPLSQL/discussions">GitHub Discussions</a> to ask questions, find support and share ideas</li> |
1557 | | -<li>Open a new <a href="https://github.com/utPLSQL/utPLSQL/issues">issue on GitHub</a> for bugs or feature requests</li> |
1558 | | -</ul> |
1559 | | -<h2 id="licensing">Licensing<a class="headerlink" href="#licensing" title="Permanent link">¶</a></h2> |
1560 | | -<p><strong>utPLSQL</strong> and its companion tools are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0</a> license.</p> |
1561 | | -<p>This website and the project documentation are built with:</p> |
1562 | | -<table> |
1563 | | -<thead> |
1564 | | -<tr> |
1565 | | -<th>Tool</th> |
1566 | | -<th>License</th> |
1567 | | -<th>Purpose</th> |
1568 | | -</tr> |
1569 | | -</thead> |
1570 | | -<tbody> |
1571 | | -<tr> |
1572 | | -<td><a href="http://www.mkdocs.org/">mkDocs</a></td> |
1573 | | -<td><a href="http://www.mkdocs.org/about/license/">BSD</a></td> |
1574 | | -<td>Project website and documentation</td> |
1575 | | -</tr> |
1576 | | -<tr> |
1577 | | -<td><a href="https://squidfunk.github.io/mkdocs-material/">material-for-mkdocs</a></td> |
1578 | | -<td><a href="https://squidfunk.github.io/mkdocs-material/license/">MIT</a></td> |
1579 | | -<td>Project website and documentation</td> |
1580 | | -</tr> |
1581 | | -</tbody> |
1582 | | -</table> |
1583 | 1627 | <h2 id="supporters">Supporters<a class="headerlink" href="#supporters" title="Permanent link">¶</a></h2> |
1584 | 1628 | <p>The utPLSQL project is community-driven and is not commercially motivated. Nonetheless, donations and other contributions are always welcome, and are detailed below.</p> |
1585 | 1629 | <h3 id="active-supporters">Active supporters<a class="headerlink" href="#active-supporters" title="Permanent link">¶</a></h3> |
1586 | | -<table> |
1587 | | -<thead> |
1588 | | -<tr> |
1589 | | -<th>Supporter</th> |
1590 | | -<th>Details</th> |
1591 | | -</tr> |
1592 | | -</thead> |
1593 | | -<tbody> |
1594 | | -<tr> |
1595 | | -<td></td> |
1596 | | -<td></td> |
1597 | | -</tr> |
1598 | | -</tbody> |
1599 | | -</table> |
| 1630 | +<p>There are currently no active supporters. If your company would like to support the project, please reach out on |
| 1631 | +<a href="https://github.com/utPLSQL/utPLSQL/discussions">GitHub Discussions</a>.</p> |
1600 | 1632 | <h3 id="past-supporters">Past supporters<a class="headerlink" href="#past-supporters" title="Permanent link">¶</a></h3> |
1601 | 1633 | <table> |
1602 | 1634 | <thead> |
@@ -1634,7 +1666,7 @@ <h3 id="past-supporters">Past supporters<a class="headerlink" href="#past-suppor |
1634 | 1666 | <span class="md-icon" title="Last update"> |
1635 | 1667 | <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> |
1636 | 1668 | </span> |
1637 | | - <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-datetime" title="August 3, 2026 16:30:13 UTC">August 3, 2026 16:30:13</span> |
| 1669 | + <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-datetime" title="August 3, 2026 17:56:40 UTC">August 3, 2026 17:56:40</span> |
1638 | 1670 | </span> |
1639 | 1671 |
|
1640 | 1672 |
|
|
0 commit comments