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.
DETECTOR_VERSION: a string that gets incremented as the application's detectors develop. When any detector's behavior
changes, this is the signal which indicates that terms need to be re-evaluated.
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.
Scout settings can be controlled via config/scout_apm.yml or ENV. ENV overrides config.
Lots more Scout settings available.
SCOUT_KEY: ScoutAPM key. Do not set in dev or test.
SCOUT_LOG_LEVEL: defaults to INFO which is probably fine. Controls verboseness of Scout logs
SCOUT_NAME: set a unique name per deployed tier to avoid confusion.
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!).