diff options
author | utilum <oz@utilum.com> | 2018-05-27 12:06:11 +0200 |
---|---|---|
committer | utilum <oz@utilum.com> | 2018-06-08 11:28:04 +0200 |
commit | 0af43ac7f6583afd3400c176fde88b96af58dc77 (patch) | |
tree | 8eb5340fb2f3d44c561f39b6860e750b437142d7 /guides/source/development_dependencies_install.md | |
parent | 6cd5cc375a5c78d08463254460b324a17d078586 (diff) | |
download | rails-0af43ac7f6583afd3400c176fde88b96af58dc77.tar.gz rails-0af43ac7f6583afd3400c176fde88b96af58dc77.tar.bz2 rails-0af43ac7f6583afd3400c176fde88b96af58dc77.zip |
Dev-Dep guide: mention AST third party requirements
Avoid the likes of:
```
Error:
ActiveStorage::RepresentationTest#test_representing_an_MP4_video:
Errno::ENOENT: No such file or directory - ffmpeg
test/models/representation_test.rb:27:in `block in <class:RepresentationTest>'
```
Also note additiona macOS requirements in ActiveStorage guide.
[ci skip]
Diffstat (limited to 'guides/source/development_dependencies_install.md')
-rw-r--r-- | guides/source/development_dependencies_install.md | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/guides/source/development_dependencies_install.md b/guides/source/development_dependencies_install.md index 50274d700b..fdd560ccf3 100644 --- a/guides/source/development_dependencies_install.md +++ b/guides/source/development_dependencies_install.md @@ -376,3 +376,31 @@ command inside of the `activestorage` directory to install the dependencies: ```bash yarn install ``` + +Extracting previews, tested in ActiveStorage's test suite requires third-party +applications, `FFmpeg` for video and `muPDF` for PDFs, and on macOS also +`XQuartz` and `Poppler`.. Without these applications installed, ActiveStorage +tests will raise errors. + +On macOS you can run: + +```bash +brew install ffmpeg +brew cask install xquartz +brew install mupdf-tools +brew install poppler +``` + +On Ubuntu, you can run: + +```bash +sudo apt-get update && install ffmpeg +sudo apt-get update && install mupdf mupdf-tools +``` + +On Fedora or CentOS, just run: + +```bash +sudo yum install ffmpeg +sudo yum install mupdf +``` |