-
Notifications
You must be signed in to change notification settings - Fork 78
Sufia Development Guide
The Sufia Development Guide is for people who want to modify Sufia itself. See the Sufia Management Guide for guidance on how to configure and set up a Sufia-based application.
- Run the test suite
- Work with test app in the browser
- Change validation behavior
- Regenerating the README TOC
- Make sure all basic prerequisites are running.
- Additional prerequisite for tests: PhantomJS.
Generate the test app. NOTE: Run this only once.
rake engine_cart:generate
This generates sufia/.internal_test_app
directory. The tests will run against this test app.
rake spec
- Where is rake jetty? It was retired. Solr and Fedora are started on their own.
- How can I start a test instance of Solr? (DO NOT USE FOR PRODUCTION)
# from sufia root in a separate terminal window
solr_wrapper -d solr/config/ -n hydra-test -p 8985
-
Test that Solr is running. It should be running at localhost:8985 with a Solr core name of
hydra-test
- How can I start a test instance of Fedora? (DO NOT USE FOR PRODUCTION)
# from sufia root in a separate terminal window
fcrepo_wrapper -p 8986 --no-jms
- Test that Fedora is running. It should be running at: localhost:8986
-
Those ports look different. They are! Now that we use
solr_wrapper
andfcrepo_wrapper
instead ofhydra-jetty
, which bundled test and dev environments together and was occasionally problematic, test and dev instances of Solr and Fedora now run on separate ports. If you want to run the test suite, use the ports above (8985 for Solr and 8986 for Fedora). If you want to check out Sufia in your browser, use port 8983 for Solr and port 8984 for Fedora as stated in Creating a Sufia-based app: Solr and Fedora. - The generated test app isn't doing what I expected after making (and/or pulling) changes to Sufia. What can I do? Generally, engine cart will pick up changes to Sufia. If not, try the following to regenerate the test app:
rm -rf .internal_test_app Gemfile.lock
bundle install
rake engine_cart:generate
You may want to see the test application in your browser to verify that your changes look correct. This section assumes that you have generated the test app via rake engine_cart:generate
.
-
Verify that ActiveFedora has installed the development templates by looking for
.internal_test_app/config/solr_wrapper_test.yml
. (Note: As of the latest draft of this document, ActiveFedora has not been released with this change. If the file exists skip to step 3.) -
Copy the templates from ActiveFedora
This step is a bit hacky and should go away once the latest ActiveFedora has been released with this commit: c8309ae. Unfortunately this will need to be done each time you regenerate the test application.
-
Get the following dev environment-related files from ActiveFedora and put them in
.internal_test_app/
: * .fcrepo_wrapper * .solr_wrapperNote: These two files are dot files and are not visible unless you add the
-a
flag tols
. -
Get the following test environment-related files from ActiveFedora and put them in
.internal_test_app/config
: -
Run SolrWrapper in development mode. SolrWrapper picks up configuration from the
.solr_wrapper
file. By default ActiveFedora installs a configuration file (to.internal_test_app/.solr_wrapper
) that starts Solr on port 8983. -
Open a terminal
-
cd .internal_test_app
-
solr_wrapper
-
Run FcrepoWrapper in development mode. FcrepoWrapper picks up configuration from the
.fcrepo_wrapper
file. By default ActiveFedora installs a configuration file (to.internal_test_app/.fcrepo_wrapper
) that starts Solr on port 8984. -
Open a terminal
-
cd .internal_test_app
-
fcrepo_wrapper
-
Run the Rails server in development mode
-
Open a terminal
-
cd .internal_test_app
-
rails s
-
View the app via localhost:3000
- To stop the servers, press CTRL-C in the terminal windows
- To clean out the data in Solr & Fedora
cd .internal_test_app
fcrepo_wrapper clean
solr_wrapper clean
To change what happens to files that fail validation add an after_validation hook:
after_validation :dump_infected_files
def dump_infected_files
if Array(errors.get(:content)).any? { |msg| msg =~ /A virus was found/ }
content.content = errors.get(:content)
save
end
end
Install the gh-md-toc tool, then ensure your README changes are up on GitHub, and then run:
gh-md-toc https://github.com/USERNAME/sufia/blob/BRANCH/README.md
That will print to stdout the new TOC, which you can copy into README.md
, commit, and push.