No Description

Adphi 533accb9dd updated build 1 week ago
appinfo 57d13d236b added version 16 to info.xml 1 week ago
build 533accb9dd updated build 1 week ago
css 6f370bb567 fixed android keyboard 4 months ago
img c909a11420 init: term colors, completion, execution 4 months ago
js 1a3d8ebcc5 fix greetings not updating date on exit 4 months ago
lib 21988b68f5 removed memory infos 4 months ago
templates 32837fffa6 renamed app 'OCC Web' 4 months ago
tests c909a11420 init: term colors, completion, execution 4 months ago
.DS_Store c909a11420 init: term colors, completion, execution 4 months ago
.travis.yml c909a11420 init: term colors, completion, execution 4 months ago
COPYING c909a11420 init: term colors, completion, execution 4 months ago
Makefile 0dba9d5c44 again... sorry. 4 months ago
README.md c1687a8f69 added screenshot to README.md 4 months ago
composer.json 32837fffa6 renamed app 'OCC Web' 4 months ago
phpunit.integration.xml c909a11420 init: term colors, completion, execution 4 months ago
phpunit.xml c909a11420 init: term colors, completion, execution 4 months ago

README.md

OCCWeb terminal

A web terminal for admins to launch Nextcloud's occ commands

occweb

Place this app in nextcloud/apps/

Building the app

The app can be built by using the provided Makefile by running:

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:

"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 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 and use the configurations directly:

phpunit -c phpunit.xml

or:

phpunit -c phpunit.integration.xml

for integration tests