The shared repository for Media Cloud web apps (Source Manager, Topic Mapper)
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode merge and #845 Jul 19, 2018
build Delete old files Jul 27, 2018
config ignore .DS_Store files in build (finally!) #20 Jan 1, 2019
data initial work with @sandsfish on hacking in a quick-and-dirty temporar… Dec 2, 2016
doc Merge branch 'master' into feature-python-3 Jan 9, 2019
logs first checkin of kinda working code Mar 8, 2016
server update to latest MC client library Jan 16, 2019
src #1258 Jan 16, 2019
test Merge branch 'master' into feature-explorer-app Aug 16, 2017
.babelrc More work on compilation Aug 22, 2018
.buildpacks try to fix dokku deploy with lots of extra EOLs Sep 29, 2018
.env try to fix dokku deploy with lots of extra EOLs Sep 29, 2018
.eslintignore lots of lint-based cleanup Mar 21, 2016
.eslintrc pull in latest changes from master Sep 18, 2018
.gitignore #1250 close button and Info as button title Aug 29, 2018
.gitmodules Add email templates as a submodule Mar 24, 2017
.python-version Setup for python3 #855 Sep 27, 2018
.watchmanconfig Revert "Merge remote-tracking branch 'origin/feature-explorer-app' in… Aug 2, 2017
CODE_OF_CONDUCT.md add code of conduct Nov 27, 2018
LICENSE license (fixes #68) Oct 19, 2016
Procfile longer gunicorn timeout #1365 Nov 14, 2018
README.md more documentation updates Nov 1, 2018
app.json regenerate tag sets cache files automatically when deploying into a c… Mar 10, 2018
cache_tag_sets.py Cache some non-changing tag sets to file system to speed up listing s… Mar 10, 2018
check-version.js require latest LTS version of node at install-time #1312 Nov 21, 2018
package-lock.json use stronger unique ids for queries #1287 Jan 11, 2019
package.json use stronger unique ids for queries #1287 Jan 11, 2019
postcss.config.js first pass at upgrade to web pack 4 Jul 26, 2018
release-tasks.sh try to fix dokku deploy with lots of extra EOLs Sep 29, 2018
requirements.txt update to latest MC client library Jan 16, 2019
run.py flask pool fix Jan 24, 2018
run.sh Switch gunicorn to use async works (for long downloads) Oct 26, 2018
runtime.txt Merge in latest changes from master Nov 21, 2018
server.wsgi Revert "Merge remote-tracking branch 'origin/feature-explorer-app' in… Aug 2, 2017

README.md

Media Cloud Web Tools

This is a shared repository for all the front-facing Media Cloud web tools. This includes:

Check out the doc folder for more documentation.

Dev Installation

Git:

  • git submodule update --init --recursive

Python:

  • Follow the instructions in doc/python-versions.md to setup Python the way we do
  • Once you've got Python setup, install the requirements by running pip install -r requirements.txt

Node and npm:

  • On Windows, make sure to create an environment variable: set NODE_ENV=dev
  • make sure your node installation is up-to-date (we work with v8.2.1 right now)
  • npm install to install all the package dependencies (as specified in the package.json)
  • install watchman for the testing (brew install --HEAD watchman)

MongoDB: Install MongoDb. We develop on OS X and install via the HomeBrew package manager: brew install mongodb

Redis: Install Redis We develop on OS X and install via the HomeBrew package manager: brew install redis

MemCache: On OSX, make sure to run brew install libmemcached otherwise you'll get an error about pylibmc failing to install (http://brew.sh)

Configuration

Copy config/server.config.template to config/server.config and fill in the required info there.

Running the Apps

You need to open two terminal windows and run one thing in each (so the hot-reloading can work):

  • npm run topics-dev or npm run sources-dev
  • python run.py
    • if you get flask errors, run the pip install -r requirements.txt line again. On Mac Osx, you may need to run with --ignore-installed

Toolchain

You will make your life easier by installing these tools: