feat: handle root security requirements on root DSL

[anthony-legay]

I didn't find how to add security requirements at the root Open API definition as the spec expect it.

I extracted a SecurityDsl in order to reuse it in the RootDsl and the OperationDsl as security requirements can be defined at root level and at operation level.

I also added the possibility to make AND/OR security requirements combinations (as documented here).

security: # A OR B
  - A
  - B

security: # A AND B
  - A
    B

security: # (A AND B) OR (C AND D)
  - A
    B
  - C
    D

Fixes #106

[utybo]

Thanks! Just minor comments, could you also have a look at the CI failure?

I'll take care of updating the docs once this is merged :)

[anthony-legay]

Thanks! Just minor comments, could you also have a look at the CI failure?

I'll take care of updating the docs once this is merged :)

Hi ! sorry for the delay.
The failure seemed to be due to missing license header on the new file.
Can you approve the workflow run to see if this works now please ?
Thanks!

[utybo]

Can you approve the workflow run to see if this works now please ?

Done! You can also run gradle check locally, IIRC the CI does the same checks. You might need to run gradle apiDump to generate some files (apologies for the lack of docs on how to contribute, I need to write some 😅)

[anthony-legay]

Can you approve the workflow run to see if this works now please ?

Done! You can also run gradle check locally, IIRC the CI does the same checks. You might need to run gradle apiDump to generate some files (apologies for the lack of docs on how to contribute, I need to write some 😅)

No problem ! awesome work you did here already.
I added the missing docs on the new classes and methods and ran apiDump task.
Everything looks fine but prisma related tasks fail on my machine because of a certificate issue.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 89.73%. Comparing base (1307dac) to head (6cc5bfe).
Report is 1 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff              @@
##               main     #101      +/-   ##
============================================
+ Coverage     89.64%   89.73%   +0.08%     
  Complexity       24       24              
============================================
  Files           202      203       +1     
  Lines          4568     4587      +19     
  Branches        441      442       +1     
============================================
+ Hits           4095     4116      +21     
+ Misses          310      308       -2     
  Partials        163      163              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[utybo]

Ah, didn't know the "long method" check was enabled in tests as well. You can go ahead and @Suppress it.

[anthony-legay]

Ah, didn't know the "long method" check was enabled in tests as well. You can go ahead and @Suppress it.

I added the annotation. I don't know why I didn't get it when running locally though. Maybe because it failed fast due the certificate error.

[utybo]

LGTM, thanks a lot for your contribution! I'll update the docs in a follow-up PR.