SumitLubal / avalon

Avalon Media System – Samvera Application

Avalon Media System

Avalon Media System is an open source system for managing large collections of digital audio and video. The project is led by the libraries of Indiana University and Northwestern University with funding in part by a three-year National Leadership Grant from the Institute of Museum and Library Services.

For more information and regular project updates visit the Avalon blog.

Installing Avalon Media System

Installation instructions are available for the following platforms:

• Linux
• macOS

Development

Quickstart development with Docker

Using Docker is the recommended method of setting up an Avalon Media System Development Environment. It can be completed in minutes without installing any dependencies beside Docker itself. It should be noted that the docker-compose.yml provided here is for development only and will be updated continually.

• Install Docker and docker-compose
• git clone https://github.com/avalonmediasystem/avalon
• cd avalon
• cp config/controlled_vocabulary.yml.example config/controlled_vocabulary.yml
• docker-compose up
• Try loading Avalon in your browser: localhost:3000

Avalon is served by Webrick in development mode so any changes will be picked up automatically. Running a Rails command inside the Avalon container is easy, for example, to run tests docker-compose exec avalon bash -c "RAILS_ENV=test bundle exec rspec". Note: to avoid erasing development data, you should use the test stack to run testsdocker-compose -f test.yml up.

Rails debugging with Pry can be accessed by attaching to the docker container: docker attach container_name. Now, when you reach a binding.pry breakpoint in rails, you can step through the breakpoint in that newly attached session.

(Not Recommended) Manually Setting Up an Avalon Media System Development Environment

Warning: The docker instructions above are the currently maintained development environment. If you're unable to use docker you can try the instructions below but they may be out of date.

For developers using OS X, you can get a full Avalon development environment, including transcoding and streaming using docker. See the wiki for details, this is currently our recommended way to setup a dev environment.

The following steps will let you run the avalon stack locally in order to explore the out-of-the-box functionality or do basic development.

• Ensure that you're running one of the Ruby versions listed in under rvm in ".travis.yml".
• Install Mediainfo cli
• Create config overwrites in config/settings/development.local.yml if necessary
• cp config/controlled_vocabulary.yml.example config/controlled_vocabulary.yml
• Install cmake if necessary. This can typically be installed via package manager
• bundle install
• rake secret
• rake avalon:services:start
• rake avalon:db_migrate
• rake db:test:prepare
• bundle exec rake server:development or bundle exec rake server:test Note: This process will not background itself, it will occupy the terminal you run it in

Javascript style checking and code formatting

ESLint - Style checking

In order to run eslint on javascript files to check prior to creating a pull request do the following:

1. Install eslint globally, locally on dev machine: npm install -g eslint
2. Run eslint app/assets/javascripts/ --ext .js,.es6

Prettier - Code formatting

To maintain a consistent style of .js/.es6 code, the Prettier package should be used to clean up code before submitting a pull request.

1. Install Prettier globally, locally on dev machine: (https://prettier.io/) yarn global add prettier or npm install --global prettier
2. (optional) To be safe, you may want to commit your code before running through Prettier.
3. Run the prettier CLI command from the application root directory, for example: prettier --write "app/assets/javascripts/media_player_wrapper/*.es6"
4. Commit your re-formatted, beautiful code.

Browser Testing

Testing support for Avalon Media System is provided by BrowserStack.