There is a Makefile
that contains some useful command shortcuts for typical development tasks.
To see a current list of commands, run make help
.
We use VCR to record transactions with remote systems for testing. This includes the rake task for reloading Detector::SuggestedResource records, which do not yet have a standard provider. For the initial feature development, we have used a Lando environment with the following definition:
name: static
recipe: lamp
config:
webroot: .
If you need to regenerate these cassettes, the following procedure should be sufficient:
- Use the configuration above to ensure the needed files are visible at
http://static.lndo.site/filename.ext
. - Delete any existing cassette files which need to be regenerated.
- Run the test(s).
- Commit the resulting files along with your other work.
LINKRESOLVER_BASEURL
: base url for our link resolver. https://mit.primo.exlibrisgroup.com/discovery/openurl?institution=01MIT_INST&rfr_id=info:sid/mit.tacos.api&vid=01MIT_INST:MIT
is probably the best value unless you are doing something interesting.
ORIGINS
: comma-separated list of domains allowed to connect to (and thus query or contribute to) the application. Be sure to specify the port number if a connecting application is not using the standard ports (this applies mostly to local development). If not defined, no external connections will be permitted.
UNPAYWALL_EMAIL
: email address to include in API call as required in their documentation. Your personal email is appropriate for development. Deployed and for tests, use the timdex moira list email.
PLATFORM_NAME
: The value set is added to the header after the MIT Libraries logo. The logic and CSS for this comes
from our theme gem.
Access to some of the config values below is limited. Please contact someone in the EngX team if you need help locating them.
BASE_URL
: The base url for the app. This is required for Omniauth config.
OPENID_HOST
: The OID provider hostname, required for authentication. (Do not include URL prefix.)
OPENID_SECRET_KEY
: The secret key for the OID client.
OPENID_CLIENT_ID
: The identifier for the OID client.
OPENID_ISSUER
: The URL for the OIDC issuer. This can be found in the Touchstone OpenID metadata.
The config below is needed to run Omniauth in developer mode in Heroku review apps. Rather than relying upon a single
ENV value, we use the FakeAuthConfig
module to perform additional checks that confirm whether developer mode should
be enabled. This assures that developer mode is never enabled in staging or production apps.
FAKE_AUTH_ENABLED
: Switches Omniauth to developer mode when set. If unset, PR builds will attempt to authenticate with
OIDC, which will fail as their domains are not registered with the provider. (Note: Developer mode is also enabled
whenever the app is started in the development environment.)
HEROKU_APP_NAME
: Used by the FakeAuthConfig module to determine whether an app is a PR build. If this is set along
with FAKE_AUTH_ENABLED
, then Omniauth will use Developer mode. Heroku sets this variable automatically for review
apps; it should never be manually set or overridden in any environment.
Pattern Detection and Enhancement
make docserver
will start a yard
server using the RDoc comments from the codebase. RDoc in this application is a work-in-progress and should improve over time. As of this writing, the index page generated contains broken links to our markdown documentation, but they "files" navigation displays them properly.
Tip
Prior to running make docserver
the first time, you must install the bundled gems for this application using either bundle install
or make install
(they both do the same thing!).