Maxence Lange e55087b6b1 admin have no special rights on users' entries | 1 year ago | |
---|---|---|
.. | ||
Auth | 215aef3cbd Update php licenses | 3 years ago |
Backend | 61895e9c79 Fix files_external tests with phpunit 9 | 2 years ago |
Command | 215aef3cbd Update php licenses | 3 years ago |
Config | 215aef3cbd Update php licenses | 3 years ago |
Controller | e55087b6b1 admin have no special rights on users' entries | 1 year ago |
Listener | d5e7682b6b Test StorePasswordListener | 1 year ago |
Service | ad12a740cb fix!: Remove symfony EventDispatcherInterface from User | 1 year ago |
Settings | 215aef3cbd Update php licenses | 3 years ago |
Storage | 55baa7b586 Fixing samba test and adding details to kerberos job | 1 year ago |
env | 1729e4471f Update comments to Nextcloud | 7 years ago |
js | 4f35cd5ebf Improve saving applicable users in ext storage | 1 year ago |
DefinitionParameterTest.php | 4e179e0e07 Enable SSL by default in ext storage configs | 1 year ago |
FrontendDefinitionTraitTest.php | 215aef3cbd Update php licenses | 3 years ago |
LegacyDependencyCheckPolyfillTest.php | 215aef3cbd Update php licenses | 3 years ago |
OwnCloudFunctionsTest.php | 215aef3cbd Update php licenses | 3 years ago |
PersonalMountTest.php | d81713e5c1 simplify setup of circular SetupManager<->Manager | 2 years ago |
README.md | 1729e4471f Update comments to Nextcloud | 7 years ago |
StorageConfigTest.php | 215aef3cbd Update php licenses | 3 years ago |
appSpec.js | bb2557c389 Replace files app ids to classes | 2 years ago |
client-cmd.sh | 3b577aa5b2 Update kerberos sso test setup to use new user_saml config system | 1 year ago |
config.php | d89a75be0b Update all license headers for Nextcloud 21 | 4 years ago |
start-apache.sh | 3b577aa5b2 Update kerberos sso test setup to use new user_saml config system | 1 year ago |
start-dc.sh | 3b577aa5b2 Update kerberos sso test setup to use new user_saml config system | 1 year ago |
The files_external relies - as the name already says - on external file system
providers. To test easily against such a provider we use some scripts to setup
a provider (and of course also cleanup that provider). Those scripts can be
found in the tests/env
folder of the files_external app.
The current implementation supports a script that starts with start-
for the
setup step which is executed before the PHPUnit run and an optional script
starting with stop-
(and have the same ending as the start script) to cleanup
the provider. For example: start-webdav-ownCloud.sh
and
stop-webdav-ownCloud.sh
. As a second requirement after this prefix there has
to be the name of the backend test suite. In the above example the test suite
tests/backends/webdav.php
is used. The last part is a name that can be chosen
freely.
Run all files_external unit tests by invoking the following in the Nextcloud core root folder:
./autotest-external.sh
This script supports to get passed a database as first argument:
./autotest-external.sh sqlite
You can also pass the name of the external file system provider as a second
argument that should be executed. This is the name of the script without the
prefix start-
(or stop-
) and without the extension .sh
from the above
mentioned components in test/env
. So if you want to start the WebDAV backend
tests against an ownCloud instance you can run following:
./autotest-external.sh sqlite webdav-ownCloud
This runs the script start-webdav-ownCloud.sh
from the tests/env
folder,
then runs the unit test suite from backends/webdav.php
(because the middle part of
the name of the script is webdav
) and finally tries to call
stop-webdav-ownCloud.sh
for cleanup purposes.
If common-tests
is supplied as second argument it will skip the backend specific
part completely and just run the common files_external unit tests:
./autotest-external.sh sqlite common-tests
If you want to debug your external storage provider, you maybe don't want to
fire it up, execute the unit tests and clean everything up for each debugging
step. In this case you can simply start the external storage provider instance
and run the unit test multiple times against the instance for debugging purposes.
To do this you just need to follow these steps (from within
apps/files_external/tests
):
env/start-BACKEND-NAME.sh
) or start the environment by
hand (i.e. setting up an instance manually in a virtual box)phpunit --configuration ../../../tests/phpunit-autotest-external.xml backends/BACKEND.php
env/stop-BACKEND-NAME.sh
) or cleanup by hand