Google Git
Sign in
vanadium / release.projects.browser / f544456023c026edbdc4613951777f1b552fa325
commitf544456023c026edbdc4613951777f1b552fa325[log] [tgz]
authorAli Ghassemi <aghassemi@google.com>Thu Apr 09 16:42:49 2015 -0700
committerAli Ghassemi <aghassemi@google.com>Thu Apr 09 16:42:52 2015 -0700
tree5fe91d1612ebe26585d69dbc10f3130f40d241d6
parentc1e3d3aadab263f90869d5e68469878fd61523ab [diff]
namespace_browser: Publishing sample world that is run by "make start"
under /ns.dev.v.io:8101/users/<email>/sample-world now.

Please note, we can no longer access each other's sample world. This is
intentional, we do not want our random in-development sample-worlds to
show up in ns.dev.v.io

We are planning to run a general sample-world service on GCE that every one
can access later.
https://github.com/veyron/release-issues/issues/919

Change-Id: I024211930b4664a6fe82d19c34a7efaf34dd2a7f
1 file changed
tree: 5fe91d1612ebe26585d69dbc10f3130f40d241d6
  1. go/
  2. public/
  3. src/
  4. test/
  5. .gitignore
  6. .jshintrc
  7. AUTHORS
  8. bower.json
  9. CONTRIBUTORS
  10. css-transform.js
  11. LICENSE
  12. main-transform.js
  13. Makefile
  14. md-transform.js
  15. package.json
  16. PATENTS
  17. README.md
  18. VERSION
  19. web-component-dependencies.html
README.md

Vanadium Namespace Browser

The namespace browser is a web application that lets developers and other users view and interact with the Vanadium world. Starting from their namespace root, users can browse through the mount table hierarchy and see where services are mounted. The user can select a service to see more detailed information about it, and can also interact with the service, invokinging methods to examine or modify the state of the service.

Installing the Vanadium Extension

As a Vanadium web application, the namespace browser requires that users install the Vanadium Extension from the Chrome Web Store. If you try to run the webapp without the extension, it will prompt you to install it.

Here is the link to the Vanadium Extension: https://chrome.google.com/webstore/detail/vanadium-extension/jcaelnibllfoobpedofhlaobfcoknpap

Building the Namespace Browser

You do not need to build your own copy of the namespace browser in order to use it, unless you want to modify it or see how it works.

To build a local copy, install the Vanadium environment and be sure to include the web profile.

Here is the link to the development instructions for Vanadium: https://v.io/community/contributing.html

Next, to build your own copy of the namespace browser, simply run:

cd $V23_ROOT/release/projects/browser
make build

This compiles the relevant bundle files in the ‘public’ folder. The assets inside must be served as your own instance of the web app.

Running locally for development

You can serve a local instance with the following command:

make start

This command compiles and launches the web app. Additionally, demo services that represent a virtual house and cottage are added to your local namespace.

Navigate to http://localhost:9001 to access the namespace browser. You can quit by using CTRL-C on the console running make start

If you have any problems after updating the code, try cleaning the build.

make clean
make start

Testing

The namespace browser has some unit and integration tests that verify basic functionality.

Run these tests with the following command:

make test

Contributing

The code repository for the Namespace Browser is on GitHub.

Bugs and other issues can be submitted to the Vanadium Issue Tracker.