e2bf04a94f
Add an other-requirements.txt file containing a cross-platform list of dependencies needed for running included tox-based tests. Also include a tox environment for convenience calling the bindep[*] utility to list any missing system requirements. This change is needed since the infra team will not install standard packages in jobs anymore, projects should use other-requirements.txt instead. The macros xvfb-install, firefox-install, chrome-install which are used to run some jobs for this repository will be removed soon. This change is self-testing. For other-requirements.txt see also http://docs.openstack.org/infra/manual/drivers.html#package-requirements [*] http://docs.openstack.org/infra/bindep/ Change-Id: Ie9b17a29754fd2916095f65ddca28808fe39d8c7
Storyboard Web Client
A WebClient for the OpenStack Storyboard project.
Project Resources
- Project status, bugs, and blueprints
- Source code
- Documentation
- Additional resources are linked from the project wiki page
- How to contribute to OpenStack
- Code reviews workflow
Getting Started
First of all be sure to have tox installed on your machine then:
- Install the virtualenv containing nodejs:
tox -evenv - Source the new path containing grunt:
source .tox/venv/bin/activate - Now you can launch the grunt tasks of storyboard-webclient, by default run
the development server with the following command:
grunt serve
NPM Commands
The following are commands that may be used during project development.
npm run lint: Runs a linter on the javascript sources files of the project, this will help us keeping style consistency across our files and can reduce the risk of bugs.npm run clean: Erases the temporary folders created by various grunt tasks, such as reports, cover and dist.npm run build: Compile and packages our code.npm run serve: Development server - runs a build and sets up concurrent watchers that will automatically lint, test, and refresh the code when a change is detected.npm run test-unit: This command will create a clean build against which our unit tests will be run. For more information, please see karma-unit.conf.jsnpm run test-integration: This command will create a clean build against which our functional tests will be run. For more information, please see protractor-integration.conf.jsnpm run test-functional: This command will create a clean build against which our functional tests will be run. For more information, please see protractor.conf.js
Grunt tasks
For more detailed development, the following commands are available via grunt.
To run them, you will need to install grunt globally: npm install -g grunt.
compile: Compiles all of our sources in the dist directory.package: Built code into a release package.serve:dist: This task performs a full build of our application, and then runs that source in a local web server. It does no watching, it simply hosts the files.serve:prod: This task is identical to 'server:dist', with the exception that it will proxy the API requests against the production API. USE WITH CAUTION