This commit is contained in:
Adphi 2020-01-29 22:03:47 +01:00
parent 93e4701a82
commit 222e9d5956
3 changed files with 11 additions and 64 deletions

1
.gitignore vendored Normal file
View File

@ -0,0 +1 @@
.idea

View File

@ -5,69 +5,15 @@
![occweb](https://git.adphi.net/Adphi/OCCWeb/raw/master/appinfo/screenshot.png)
##
## Install
Place this app in **nextcloud/apps/**
## Building the app
## ⚠️ Warnings ⚠️
The app can be built by using the provided Makefile by running:
- The application is not a real interactive terminal and does not support long running tasks.
So if your instance is pretty big, commands like `occ files:scan` will time out and fail.
- Do not use `occ maintenance:mode -on`, obvious...
make
This requires the following things to be present:
* make
* which
* tar: for building the archive
* curl: used if phpunit and composer are not installed to fetch them
from the web
* npm: for building and testing everything JS, only required if a
package.json is placed inside the **js/** folder
The make command will install or update Composer dependencies if a
composer.json is present and also **npm run build** if a package.json
is present in the **js/** folder. The npm **build** script should use
local paths for build systems and package managers, so people that
simply want to build the app won't need to install npm libraries
globally, e.g.:
**package.json**:
```json
"scripts": {
"test": "node node_modules/gulp-cli/bin/gulp.js karma",
"prebuild": "npm install && node_modules/bower/bin/bower install &&
node_modules/bower/bin/bower update",
"build": "node node_modules/gulp-cli/bin/gulp.js"
}
```
## Publish to App Store
First get an account for the [App Store](http://apps.nextcloud.com/)
then run:
make && make appstore
The archive is located in build/artifacts/appstore and can then be
uploaded to the App Store.
## Running tests
You can use the provided Makefile to run all tests by using:
make test
This will run the PHP unit and integration tests and if a package.json
is present in the **js/** folder will execute **npm run test**
Of course you can also install
[PHPUnit](http://phpunit.de/getting-started.html) and use the
configurations directly:
phpunit -c phpunit.xml
or:
phpunit -c phpunit.integration.xml
for integration tests
## TODOs:
See [open issues](https://git.adphi.net/Adphi/OCCWeb/issues)

View File

@ -30,7 +30,7 @@ class OccOutput extends BufferedOutput implements ConsoleOutputInterface
}
public function __call($name, $arguments) {
// TODO: Implement @method ConsoleSectionOutput section()
}
// public function __call($name, $arguments) {
// // TODO: Implement @method ConsoleSectionOutput section()
// }
}