{"id":24093285,"url":"https://github.com/umd-lib/avalon-searcher","last_synced_at":"2025-10-03T22:18:54.340Z","repository":{"id":147002533,"uuid":"488984138","full_name":"umd-lib/avalon-searcher","owner":"umd-lib","description":"Libraries' Avalon Searcher","archived":false,"fork":false,"pushed_at":"2025-01-28T12:48:24.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-01-28T13:49:24.336Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/umd-lib.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2022-05-05T13:30:10.000Z","updated_at":"2025-01-28T12:47:21.000Z","dependencies_parsed_at":"2023-04-04T20:05:43.127Z","dependency_job_id":null,"html_url":"https://github.com/umd-lib/avalon-searcher","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umd-lib%2Favalon-searcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umd-lib%2Favalon-searcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umd-lib%2Favalon-searcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umd-lib%2Favalon-searcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/umd-lib","download_url":"https://codeload.github.com/umd-lib/avalon-searcher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241005389,"owners_count":19892782,"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","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":"2025-01-10T09:27:03.292Z","updated_at":"2025-10-03T22:18:49.301Z","avatar_url":"https://github.com/umd-lib.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# avalon-searcher\n\nPython 3 Flask application to search Avalon; provides a backend searcher to a Bento Box style search\nwhich expects a REST interface following the Quick Search model.\n\n## Requires\n\n* Python 3\n\n### Running in Docker\n\n```bash\n$ docker build -t avalon-searcher .\n$ docker run -it --rm -p 5000:5000 --env-file=.env --read-only avalon-searcher\n```\n\n### Building for Kubernetes\n\n```bash\n$ docker buildx build . --builder=kube -t docker.lib.umd.edu/avalon-searcher:VERSION --push\n```\n\n### Endpoints\n\nThis will start the webapp listening on the default port 5000 on localhost\n(127.0.0.1), and running in [Flask's debug mode].\n\nRoot endpoint (just returns `{status: ok}` to all requests):\n\u003chttp://localhost:5000/\u003e\n\n/ping endpoint (just returns `{status: ok}` to all requests):\n\u003chttp://localhost:5000/ping\u003e\n\n/search endpoint: `http://localhost:5000/search?q={query}\u0026page={page number?}\u0026per_page={results per page?}`\n\nExample:\n\n```bash\ncurl 'http://localhost:5000/search?q=henson\u0026per_page=3\u0026page=0'\n{\n  \"endpoint\": \"avalon-search\",\n  \"module_link\": \"https://av.lib.umd.edu/catalog?q=henson\u0026search_field=all_fields\u0026utf8=%E2%9C%93\",\n  \"no_results_link\": \"https://av.lib.umd.edu/catalog\",\n  \"page\": \"1\",\n  \"per_page\": \"3\",\n  \"query\": \"henson\",\n  \"results\": [\n    {\n      \"description\": \"This special celebrates the life and career of Jim Henson following his death in 1990. The retrospective includes appearances by celebrity guests, a variety of clips from Henson's television and film work, and candid, behind-the-scenes footage of Henson working with his creative team.\",\n      \"extra\": {\n        \"collection\": \"The Jim Henson Works at the University of Maryland\"\n      },\n      \"item_format\": \"Moving Image\",\n      \"link\": \"https://av.lib.umd.edu/media_objects/0g354f388\",\n      \"title\": \"The Muppets celebrate Jim Henson\"\n    },\n    {\n      \"description\": \"Documentary television program on the life, work, and success of Jim Henson and his Muppets. Combines clips and interviews with Jim Henson, Jane Henson, Frank Oz, and others to present the story of the Muppets from the early days of public access television to the success of Sesame Street to international phenomenon.\",\n      \"extra\": {\n        \"collection\": \"The Jim Henson Works at the University of Maryland\"\n      },\n      \"item_format\": \"Moving Image\",\n      \"link\": \"https://av.lib.umd.edu/media_objects/1831ck18w\",\n      \"title\": \"Henson's place: the man behind the Muppets\"\n    },\n    {\n      \"description\": \"The Storyteller recalls a time when he was unable to think of a story to tell even though his life depended on it.\",\n      \"extra\": {\n        \"collection\": \"The Jim Henson Works at the University of Maryland\"\n      },\n      \"item_format\": \"Moving Image\",\n      \"link\": \"https://av.lib.umd.edu/media_objects/v979v3150\",\n      \"title\": \"Jim Henson’s the storyteller: A story short\"\n    }\n  ],\n  \"total\": 68\n}\n```\n\n[Flask's debug mode]: https://flask.palletsprojects.com/en/2.2.x/cli/?highlight=debug%20mode\n\n## License\n\nSee the [LICENSE](LICENSE.txt) file for license rights and limitations.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumd-lib%2Favalon-searcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fumd-lib%2Favalon-searcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumd-lib%2Favalon-searcher/lists"}