feat: Make docker integration available for other projects

[susnux]

Resolves #97

• Provide the docker helpers as @nextcloud/cypress/docker import.
• Allow installing custom required apps for testing
  • Handle text app which is not in the appstore but also not bundled
• Allow to auto-detect current app, or set one, and bind mount the directory for testing the app

[susnux]

@skjnldsv Added an additional commit fixing the flaky cypress tests by ensuring the user is logged out after the tests.
(because otherwise the session tests fail if they run second).

[max-nextcloud]

@skjnldsv Added an additional commit fixing the flaky cypress tests by ensuring the user is logged out after the tests. (because otherwise the session tests fail if they run second).

I think it would be nice to find a different solution there.

If you run a test locally and it fails it's nice to be able to inspect the state of the browser. If the test logs you out in an after block you cannot access the session anymore. Cypress docs also have a section about this.

I'm happy to brainstorm alternative solutions or try out some things.

[susnux]

@max-nextcloud I changed it to before hooks as suggested on that page from the cypress documentation, seems to work fine :)

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (9d1a7a0) 96.47% compared to head (e008cf6) 96.47%.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #157   +/-   ##
=======================================
  Coverage   96.47%   96.47%           
=======================================
  Files           5        5           
  Lines          85       85           
  Branches        4        4           
=======================================
  Hits           82       82           
  Misses          3        3           

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

[skjnldsv]

You seem to be doing some changes still, so I set it to 2. developing, please ping again when/if ready :)

[susnux]

Anything I need to do here? :)
Would be great if we can reuse it in apps (then I maybe have motivation to add Cypress to forms 😆 )

[skjnldsv]

How can I mount the local Viewer if I'm running Cypress in https://github.com/nextcloud/viewer though?

[susnux]

Edit: No just leave it as it is, because viewer is mounted (as it is the app, see startNextcloud).
Then later on in configureNextcloud it checks for the app to be preset locally first and will detect the local viewer and enable it.

As this is your target app it will be mounted automatically, but as viewer is installed by default you need to make sure to disable mounting of the vendored one

[skjnldsv]

So, I can't use this configureNextcloud and have to keep mine?

[susnux]

what do you mean? If you want to test the local viewer you do not need to adjust anything simply do as the readme says and the local viewer will be used

[skjnldsv]

Aaaah, if you specify it, it will not be cloned with git.
I didn't realized that. I think the jsdoc could reflect that,

[max-nextcloud]

I updated the jsdocs here to reflect this.

[max-nextcloud]

Tested this when adding cypress tests to the data_request app here: nextcloud/data_request#197. Works like a charm 🪄

Also replaced the imports in the viewers cypress.config.js and it runs fine.

Thanks a lot for making this available to everyone! ❤️

From my point of view everything was addressed.