{"id":16537077,"url":"https://github.com/teodesian/pod-generator","last_synced_at":"2026-04-16T09:38:27.568Z","repository":{"id":22610402,"uuid":"25952672","full_name":"teodesian/POD-Generator","owner":"teodesian","description":"Tools for generating POD for Perl Module files","archived":false,"fork":false,"pushed_at":"2014-11-14T23:09:40.000Z","size":136,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-03T18:36:18.086Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"artistic-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/teodesian.png","metadata":{"files":{"readme":"README","changelog":"CHANGES","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-30T03:13:24.000Z","updated_at":"2014-11-14T23:09:40.000Z","dependencies_parsed_at":"2022-08-21T09:00:14.431Z","dependency_job_id":null,"html_url":"https://github.com/teodesian/POD-Generator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/teodesian/POD-Generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teodesian%2FPOD-Generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teodesian%2FPOD-Generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teodesian%2FPOD-Generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teodesian%2FPOD-Generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teodesian","download_url":"https://codeload.github.com/teodesian/POD-Generator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teodesian%2FPOD-Generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31880862,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T09:23:21.276Z","status":"ssl_error","status_checked_at":"2026-04-16T09:23:15.028Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-10-11T18:34:43.820Z","updated_at":"2026-04-16T09:38:27.555Z","avatar_url":"https://github.com/teodesian.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"POD-Generator\n=============\n\nTools for generating POD for Perl Module files\n\nProvides a tool 'genpod' [options] module1 module2 ...\n\nGenerates POD based on the module, with varying levels of detail based\non whether you use nice modern features of perl, or are a cave-man/gal.\n\n* NAME will be auto-populated\n* SYNOPSIS and METHODS (or FUNCTIONS in modules without constructors) section will be skeletoned.\n* Usage of Method signatures (moose or perl) will auto-populate input parameters for methods/functions.\n* Usage of Type Constraints with your Signatures will correctly note the types of your input parameters, and list any custom types you define.\n* Alternately, if you use Carp::Assert for your guard clauses, it will 'magic' into being custom types based on your assertions and act as though you use Method::Signatures!\n* 'Module::Description' is provided to say a bit about various things:\n\n        package MY::MODULE;\n\n        use Module::Documentation;\n        doc(\u0026Module::Documentation::SYNOPSIS,\"This here is my rip-roarin' Texan synopsis (yee-haw)\");\n\n        doc(\u0026MY::MODULE::SOME_FUNC,\"Thar be my method documentation, arr\");\n        sub SOME_FUNC {...}\n\n        ...\n\n        doc(\u0026Module::Documentation::AUTHORS,\"Slick Willie \u003c42@whitehaus.guv\u003e\")\n        doc(\u0026Module::Documentation::NOTES, \"This module is bogus\");\n        doc(\u0026Module::Documentation::SEE_ALSO, qw{Your::Mom Dog::Walker});\n\n* If your super-awesome methods manage to deliberately die/croak/confess/exit or otherwise do things to terminate execution, this is automatically noted, along with the messages/codes/types as applicable.\n* Will even try to auto-fill your return type if you assert() (or apply a type constraint to) it immediately before (or during) return!\n* If you are writing a script, it will do it's best to figure out what you are doing with ARGV, or give you better details when you use some sort of GetOpt.\n* 'private' functions (such as those beginning with underscores), or methods that are explicitly private will be ignored correctly.\n\nSo why should I do this?????  I LOVE WASTING TIME, MAN!  Don't you know I'm paid by the hour???!\n\n* Telling people things like *how to actually use your functions* might mean less emailed death threats!\n* Not having to manually fill in all this sort of stuff that MetaCPAN and Kwalitee wants in your doc anyways is good!\n* Knowing when a method dies makes it easy to use TryCatch to make your life easier!  Or, to do standard eval trapping correctly until you get arthritis!\n* Not having to learn yet another way to format documents sure is nice for cranky people who feel like everything since $FORMATTING_LANGUAGE_OF_CHOICE is a step backwards!\n* Having yet another reason to entice lazy troglodytes into the 21st century certainly can't hurt the perl community...\n\nAs always, just install it on CPAN and read it's SUPER-FANCY *automatically generated* documentation for more info!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteodesian%2Fpod-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteodesian%2Fpod-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteodesian%2Fpod-generator/lists"}