{"id":21496493,"url":"https://github.com/mlibrary/spectrum","last_synced_at":"2026-02-10T21:18:27.107Z","repository":{"id":37898651,"uuid":"192965966","full_name":"mlibrary/spectrum","owner":"mlibrary","description":"Spectrum: The backend for Search.","archived":false,"fork":false,"pushed_at":"2025-07-23T16:51:20.000Z","size":97491,"stargazers_count":2,"open_issues_count":2,"forks_count":1,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-07-23T18:35:38.722Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mlibrary.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-06-20T18:04:35.000Z","updated_at":"2025-07-23T14:51:44.000Z","dependencies_parsed_at":"2023-10-11T19:55:10.626Z","dependency_job_id":"ae4ea759-9062-497a-828b-43f16ca08cff","html_url":"https://github.com/mlibrary/spectrum","commit_stats":null,"previous_names":[],"tags_count":334,"template":false,"template_full_name":null,"purl":"pkg:github/mlibrary/spectrum","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlibrary%2Fspectrum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlibrary%2Fspectrum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlibrary%2Fspectrum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlibrary%2Fspectrum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mlibrary","download_url":"https://codeload.github.com/mlibrary/spectrum/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlibrary%2Fspectrum/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268268895,"owners_count":24223145,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-23T16:16:41.038Z","updated_at":"2026-02-10T21:18:27.065Z","avatar_url":"https://github.com/mlibrary.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"Spectrum\n=============\n\nForked from Columbia Libraries Unified Search \u0026amp; Discovery\n\n## Using docker-compose for development\n\nClone the repository\n```bash\ngit clone git@github.com:mlibrary/spectrum.git spectrum\ncd spectrum\n```\n\nCopy `.env-example` to `.env`\n```bash\ncp .env-example .env\n```\n\nGet the actual values for the `.env` file from one of the developers. Update `.env` with those values.\n\nBuild it:\n```bash\ndocker-compose up --build --no-start\n```\n\nInstall the gems into the gem-cache:\n```bash\ndocker-compose run --rm web bundle install\n```\n\nPull the latest version of the search front end:\n```bash\ndocker-compose run --rm web bundle exec rake 'search[latest,local]'\n```\n\nOn a fresh install it is necessary to first manually pull the `catalog-solr` image, which will be used to hold the local example data:\n```bash\ndocker-compose pull catalog-solr\n```\n\nLoad up the catalog with some example data. To do that you need to start up `catalog-solr` and then index the data.\n```bash\ndocker-compose start catalog-solr\ndocker-compose exec catalog-solr bash /examples/load_into_solr.sh\n```\n\nThen start it\n```bash\ndocker-compose up\n```\nIn the browser go to [http://localhost:3000](http://localhost:3000)\n\n\n### Running Tests\n```bash\ndocker-compose run --rm web bundle exec rspec\n```\n\n### Debugging\nPuma doesn't always play nicely with pry.  Worker timeouts can end sessions early, and multi-threading can make taking input from the terminal troublesome.\n\nTo address these issues, the `script/docker-startup` file will run in WEBrick when started with the environment variable `RAILS_SERVER` set to webrick.\nTo set `RAILS_SERVER` add it to your `.env` file: \n```\nRAILS_SERVER=webrick\n```\n\nAdditionally, WEBrick needs to run in development mode. Add `RAILS_ENV` to your `.env` to ensure it does:\n```\nRAILS_ENV=development\n```\n\nChanging environment variables in `docker-compose` gets updated when running `docker-compose up` so, to pick up environment variable changes every time, and attach for use with a debugger:\n```bash\ndocker-compose up --no-start web \u0026\u0026 \\\n  docker-compose start web \u0026\u0026 \\\n  docker attach \"$(docker-compose ps -q web)\"\n```\n\n## Overview of Spectrum\n\nSpectrum is the server-side support for [Search](https://github.com/mlibrary/search).  It is intended to mediate requests to solr and summon as a back-end interface to support library Search.\n\n## Dependencies\n\n* [spectrum-config](https://github.com/mlibrary/spectrum-config)\n\n    * Spectrum-config handles individualized configuration of the targets searchable in the front-end.  It works a lot like a jello-mold.  Pour the user's request into it, get a tasty treat out.\n\n* [spectrum-json](https://github.com/mlibrary/spectrum-json)\n\n    * Spectrum-json handles receiving requests from end-users, applying any global normalization to the request, and passing it to the appropriate configuration to make a search against solr or summon.\n    * Spectrum-json also handles things like taking actions on records, and identifying patron affiliation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlibrary%2Fspectrum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlibrary%2Fspectrum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlibrary%2Fspectrum/lists"}