{"id":16833770,"url":"https://github.com/danschmidt5189/perl-worldcat-api","last_synced_at":"2025-03-18T02:22:22.694Z","repository":{"id":56836274,"uuid":"124160385","full_name":"danschmidt5189/perl-worldcat-api","owner":"danschmidt5189","description":"Perl bindings to the OCLC WorldCat API.","archived":false,"fork":false,"pushed_at":"2018-03-09T18:33:05.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-24T09:42:04.535Z","etag":null,"topics":["dzil","oclc","perl","worldcat"],"latest_commit_sha":null,"homepage":null,"language":"Perl","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/danschmidt5189.png","metadata":{"files":{"readme":"README.md","changelog":"changelog","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-03-07T01:23:20.000Z","updated_at":"2018-03-08T03:43:00.000Z","dependencies_parsed_at":"2022-09-06T19:40:53.429Z","dependency_job_id":null,"html_url":"https://github.com/danschmidt5189/perl-worldcat-api","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danschmidt5189%2Fperl-worldcat-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danschmidt5189%2Fperl-worldcat-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danschmidt5189%2Fperl-worldcat-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danschmidt5189%2Fperl-worldcat-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danschmidt5189","download_url":"https://codeload.github.com/danschmidt5189/perl-worldcat-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244141593,"owners_count":20404860,"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":["dzil","oclc","perl","worldcat"],"created_at":"2024-10-13T11:55:13.197Z","updated_at":"2025-03-18T02:22:22.662Z","avatar_url":"https://github.com/danschmidt5189.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NAME\n\nWorldCat::API - Fetch MARC::Records from OCLC's WorldCat API\n\n# VERSION\n\nversion 1.002\n\n# SYNOPSIS\n\n```perl\nmy $api = WorldCat::API-\u003enew(\n  institution_id         =\u003e \"...\",\n  principle_id           =\u003e \"...\",\n  principle_id_namespace =\u003e \"...\",\n  secret                 =\u003e \"...\",\n  wskey                  =\u003e \"...\",\n);\n\nmy $marc_record = $api-\u003efind_by_oclc_number(\"123\") or die \"Not Found!\";\n```\n\n# CONTRIBUTING\n\nThis project uses Dist::Zilla to set things up. You can run that directly or (more easily) by using Docker. For starters, create the build container:\n\n```\n$ docker build -t worldcatapi .\n```\n\nThe container contains Perl, cpanm, dzil, and all of the build dependencies. Shell into it to use it as a dev environment:\n\n```\n$ docker run --volume=\"$PWD:/app\" --entrypoint=/bin/bash worldcatapi\n```\n\nThe \"volume\" flag syncs your local directory into the container, allowing you to develop interactively. That also means that if you build the app within the container, the build products will be reflected on your host machine:\n\n```\n$ docker run --volume=\"$PWD:/app\" worldcatapi build\n$ ls -l\n…\nWorldCat-API-1.002\nWorldCat-API-1.002.tar.gz\n…\n```\n\n# TESTING\n\nTo test, you must set (staging!) API credentials in the container environment. An easy solution is to add them to a .env file at the root of the project, which you can load with Docker:\n\n```\n$ cat \u003c\u003cEOF \u003e .env\nWORLDCAT_API_INSTITUTION_ID=\"...\"\nWORLDCAT_API_PRINCIPLE_ID=\"...\"\nWORLDCAT_API_PRINCIPLE_ID_NAMESPACE=\"...\"\nWORLDCAT_API_SECRET=\"...\"\nWORLDCAT_API_WSKEY=\"...\"\nEOF\n$ docker run --volume=\"$PWD:/app\" --env-file=.env worldcatapi test\n```\n\n# AUTHOR\n\nDaniel Schmidt \u003cdanschmidt5189@gmail.com\u003e\n\n# COPYRIGHT AND LICENSE\n\nThis software is copyright (c) 2018 by Daniel Schmidt.\n\nThis is free software; you can redistribute it and/or modify it under\nthe same terms as the Perl 5 programming language system itself.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanschmidt5189%2Fperl-worldcat-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanschmidt5189%2Fperl-worldcat-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanschmidt5189%2Fperl-worldcat-api/lists"}