{"id":13598107,"url":"https://github.com/pyjokes/pyjokes","last_synced_at":"2026-04-02T02:17:18.829Z","repository":{"id":21229201,"uuid":"24544435","full_name":"pyjokes/pyjokes","owner":"pyjokes","description":"One line jokes for programmers (jokes as a service)","archived":false,"fork":false,"pushed_at":"2026-02-21T14:48:48.000Z","size":836,"stargazers_count":364,"open_issues_count":6,"forks_count":91,"subscribers_count":13,"default_branch":"main","last_synced_at":"2026-03-16T15:56:53.562Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://pyjok.es","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pyjokes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2014-09-27T22:40:42.000Z","updated_at":"2026-03-16T04:16:09.000Z","dependencies_parsed_at":"2023-12-21T13:58:59.222Z","dependency_job_id":"fc396eac-51e3-4df8-8782-c119492b79a8","html_url":"https://github.com/pyjokes/pyjokes","commit_stats":{"total_commits":233,"total_committers":29,"mean_commits":8.03448275862069,"dds":0.6008583690987124,"last_synced_commit":"6ad9b6f05affd0598df8b61ae6b92dfcec73470e"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/pyjokes/pyjokes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyjokes%2Fpyjokes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyjokes%2Fpyjokes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyjokes%2Fpyjokes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyjokes%2Fpyjokes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pyjokes","download_url":"https://codeload.github.com/pyjokes/pyjokes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyjokes%2Fpyjokes/sbom","scorecard":{"id":751469,"data":{"date":"2025-08-11","repo":{"name":"github.com/pyjokes/pyjokes","commit":"2927a7fbc970d7af0ad16132d7dc358c3675f489"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.9,"checks":[{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-package.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/pyjokes/pyjokes/python-package.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-package.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/pyjokes/pyjokes/python-package.yml/main?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:29","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:30","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:31","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   3 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Code-Review","score":4,"reason":"Found 4/9 approved changesets -- score normalized to 4","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":1,"reason":"2 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/python-package.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENCE.txt:0","Info: FSF or OSI recognized license: BSD 3-Clause \"New\" or \"Revised\" License: LICENCE.txt:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 29 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-22T20:30:36.852Z","repository_id":21229201,"created_at":"2025-08-22T20:30:36.852Z","updated_at":"2025-08-22T20:30:36.852Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30834879,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-22T05:45:47.827Z","status":"ssl_error","status_checked_at":"2026-03-22T05:45:39.030Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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-08-01T17:00:48.172Z","updated_at":"2026-04-02T02:17:18.776Z","avatar_url":"https://github.com/pyjokes.png","language":"Python","funding_links":[],"categories":["others","\u003ca name=\"funny\"\u003e\u003c/a\u003eFunny tools"],"sub_categories":[],"readme":"# pyjokes\n\n[![](https://badge.fury.io/py/pyjokes.svg)](https://pypi.org/project/pyjokes/)\n\nOne line jokes for programmers (jokes as a service)\n\n[![](https://raw.githubusercontent.com/pyjokes/pyjokes/main/docs/images/pyjokes.png)](https://raw.githubusercontent.com/pyjokes/pyjokes/main/docs/images/pyjokes_logo.png)\n\n## Installation\n\nInstall the `pyjokes` module with pip:\n\n```console\npip3 install pyjokes\n```\n\n## Usage\n\n### Command line\n\nOnce installed, simply call `pyjoke` or `pyjokes` from the command line:\n\n```console\n$ pyjoke\nWhy do Java programmers have to wear glasses? Because they don't see sharp.\n```\n\nOr add it to your `.bashrc` or `.zshrc` file to see a joke every time you open a terminal!\n\nSee `pyjokes --help` for more info.\n\n### Python\n\nYou can also access the jokes in your own project by importing `pyjokes` and using the function\n`get_joke`:\n\n```pycon\n\u003e\u003e\u003e import pyjokes\n\u003e\u003e\u003e print(pyjokes.get_joke())\nWhy do programmers confuse Halloween with Christmas? Because OCT 31 == DEC 25.\n```\n\nWe support many languages, and have multiple joke categories:\n\n```pycon\n\u003e\u003e\u003e import pyjokes\n\u003e\u003e\u003e print(pyjokes.get_joke(\"eu\"))  # basque joke\nZer dira 8 Bocabits? BocaByte bat\n\u003e\u003e\u003e print(pyjokes.get_joke(\"es\", \"chuck\"))  # spanish chuck norris joke\nEl teclado de Chuck Norris no tiene tecla F1, es el ordenador el que le pide ayuda a él.\n```\n\nThere is also a `get_jokes` function which returns all the jokes in the given language and category:\n\n```python\nimport pyjokes\n\nfor joke in pyjokes.get_jokes():\n    print(joke)\n```\n\nAlternatively, use the `pyjokes.forever` generator function:\n\n```python\nimport pyjokes\n\nfor joke in pyjokes.forever():\n    # This will go on forever... you're welcome.\n    print(joke)\n```\n\n## Maintainers\n\nThe project is maintained by the members of the PyJokes Society:\n\n- Ben Nuttall\n- Alex Savio\n- Borja Ayerdi\n- Oier Etxaniz ([RIP](https://www.europython-society.org/farewell-to-oier-echaniz-beneitez))\n\n## Contributing\n\n- The code is licensed under the [BSD Licence](http://opensource.org/licenses/BSD-3-Clause)\n- Please use GitHub issues to submit bugs and report issues\n- Feel free to contribute to the code\n- Feel free to contribute jokes (via pull request or [proposal issue](https://github.com/pyjokes/pyjokes/issues/10))\n- See the [contributing policy](https://github.com/pyjokes/pyjokes/tree/main/CONTRIBUTING.md)\n\n## Website and documentation\n\nThe pyjokes website and documentation is available at https://pyjok.es/\n\n## The story of pyjokes\n\nThe story of pyjokes was told by co-founder Ben Nuttall at the PyCon UK conference: https://www.youtube.com/watch?v=nCyquLc47RE\n\n## PyJokes logo\n\nThe [logo](https://raw.githubusercontent.com/pyjokes/pyjokes/main/docs/images/pyjokes_logo.png) was\ndesigned by [Sam Alder](https://samalder.co.uk/). The PyJokes Society is eternally grateful for his\ncontribution.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyjokes%2Fpyjokes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpyjokes%2Fpyjokes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyjokes%2Fpyjokes/lists"}