Slides from my presentation at OUG Ireland (Dublin) on 5 Apr 2019

1. Jacek Gębal
twitter: @GebalJacek
mail: jgebal@gmail.com
blog: oraclethoughts.com
Principal Software Engineer
@Fidelity Investments - Ireland
co-author & maintainer of: utPLSQL
Building free, open-source, PL/SQL projects in cloud
For Free!

2. About me
● Software engineer since ~2000 - mainly Oracle database
● Infected with testing and automation since ~2013
● Key contributor, author and maintainer of utPLSQL v3
● Active developer, learner, testing advocate

3. Why the talk
● #PASSTHEKNOWLEDGE
● What we’ve learned with

4. Free cloud CI ingredients

5. All of that for free!

6. ● users / organizations
● projects
● issue tracker
● code reviews
● web-pages
● releases
● integrations / APIs
● ...

7. ● up to 5 concurrent builds per ower
● AWS hosts (Linux/Win/Mac)
● ~`60GB of space for build (and growing)
● 4-8 GB RAM
● 2 cores
https://docs.travis-ci.com/user/reference/overview/

8. ● images
● containers
● hub
● supported by most cloud CI services
● portability
● repeatability
https://docker-curriculum.com/

9. https://www.sonarsource.com/products/codeanalyzers/sonarplsql.html#_

10. http://utplsql.org/documentation/
https://github.com/utPLSQL/utPLSQL/releases
https://www.cheatography.com/jgebal/lists/utplsql-v3-cheat-sheets/
● Type-safe comparison
● Annotations for tests
● Expressive & readable expectations syntax
● Cursor / object / nested table / varray expectations
● Pure PL/SQL
● Human-readable reporting
● Integration with CI/CD servers (Jenkins/Travis/Teamcity/Oracle Developer Cloud)
● maven plugin / SQLDeveloper plugin
● community-driven, open-source

11. utPLSQL core
Annotation syntax - use in package specification only:
--%suite( description )
--%test( description )
Expectations - use in test procedures only:
ut.expect( actual_value ).to_( equal( 1 ) );
ut.expect( ‘Chuck’ ).to_equal( ‘Chuck’ );
Running tests:
SQL> exec ut.run( [options] );
cmd$> utplsql run user/pass@db [options...]

12. Expectations & matchers
● equal( expected )
● be_null / be_not_null
● be_true / be_false
● be_like( mask [, escape_char] )
● match( pattern [, modifiers] )
● contain( expected )
ut.expect( actual ).to_( matcher(param[, param...]) );
ut.expect( actual ).not_to( matcher(param[, param...]) );
● be_between( lower, upper )
● be_greater_than( expected )
● be_less_than( expected )
● be_greater_or_equal( expected )
● be_less_or_equal( expected )
● have_count( count ) / be_empty)
● .join_by()/.unordered()
● .unordered_columns()
● .include()/.exclude()
Matchers:

13. Local toolset

14. ● Why git ?
● Why IntelliJ
● Sonar Local analysis
● Test test test!
● Commit
● Push
● Let the CI server do the work
● Open a Pull Request
● Review code
● Improve & Merge or Reject pull request
Local toolset

15. ● Write code
● Realtime code analysis
● Deploy / compile locally
● Test
● Commit
● Push
● Let the CI server do the work
● Open a Pull Request
● Review code
● Improve & Merge or Reject pull request
Working locally

16. Jetbrains values open-source

17. ● git - https://git-scm.com/download/win
○ https://www.youtube.com/playlist?list=PL25b72h8A54cRytndfLG8LAFXnw-9X6Lk
○ https://www.atlassian.com/git/tutorials
● docker - https://docs.docker.com/docker-for-windows/
○ https://github.com/wsargent/docker-cheat-sheet
● oracle DB on docker - https://www.oracle.com/technetwork/database/enterprise-edition/downloads/index.html
○ https://github.com/oracle/docker-images/tree/master/OracleDatabase
● IntelliJ community edition - https://www.jetbrains.com/idea/download/
○ https://www.shortcutfoo.com/app/dojos/intellij-idea-win/cheatsheet
○ https://blog.jetbrains.com/idea/category/tutorials/
● SQLDeveloper - https://www.oracle.com/technetwork/developer-tools/sql-developer/downloads/index.html
○ https://www.youtube.com/watch?v=EguMf4HbPU8&t=6s
● sonarlint
○ https://www.sonarlint.org/
○ https://rollout.io/blog/getting-started-sonarqube-sonarlint/
Downloading & learning

18. ● utPLSQL - https://github.com/utPLSQL/utPLSQL/releases
○ http://utplsql.org/
○ https://www.youtube.com/playlist?list=PL25b72h8A54fbucEfvH3C2Q1yMqGhc15o
○ https://vimeo.com/261135676
● github - https://github.com/
○ https://guides.github.com/activities/hello-world/
● dockerhub https://hub.docker.com/
○ https://docs.docker.com/docker-hub/
● travis
○ https://docs.travis-ci.com/
○ https://docs.travis-ci.com/user/tutorial/
○ https://github.com/utPLSQL/utPLSQL-demo-project
● sonarclud - https://sonarcloud.io
○ https://sonarcloud.io/documentation/integrations/github/
Learning

19. That’s all folks
Thank you