{"id":27557298,"url":"https://github.com/loisakitakaya/jokes","last_synced_at":"2025-04-19T20:29:14.825Z","repository":{"id":173087918,"uuid":"650219479","full_name":"LoisaKitakaya/Jokes","owner":"LoisaKitakaya","description":"Python wrapper for jokes APIs","archived":false,"fork":false,"pushed_at":"2023-06-23T06:59:26.000Z","size":40,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-16T12:23:25.146Z","etag":null,"topics":["api-wrapper","jokes","jokes-api","pypi-package","python3"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/py-jokes-py/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LoisaKitakaya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-06-06T15:43:54.000Z","updated_at":"2024-12-17T17:48:59.000Z","dependencies_parsed_at":"2023-07-22T14:24:11.528Z","dependency_job_id":null,"html_url":"https://github.com/LoisaKitakaya/Jokes","commit_stats":null,"previous_names":["loisakitakaya/dad-jokes","loisakitakaya/jokes"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoisaKitakaya%2FJokes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoisaKitakaya%2FJokes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoisaKitakaya%2FJokes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoisaKitakaya%2FJokes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LoisaKitakaya","download_url":"https://codeload.github.com/LoisaKitakaya/Jokes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249794423,"owners_count":21326710,"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":["api-wrapper","jokes","jokes-api","pypi-package","python3"],"created_at":"2025-04-19T20:29:13.986Z","updated_at":"2025-04-19T20:29:14.815Z","avatar_url":"https://github.com/LoisaKitakaya.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# py-jokes-py\n\nPython wrapper for the jokes APIs provided by:\n\n- [icanhazdadjokes.com](https://icanhazdadjoke.com/)\n- [jokeapi.dev](https://jokeapi.dev/)\n\n## How to install\n\n```\npip install py-jokes-py\n```\n\n## Usage\n\nSomething to note, the `jokes` module has two classes:\n\n- `DadJokes()` - wrapper for [icanhazdadjokes.com](https://icanhazdadjoke.com/) api\n- `AllJokes()` - wrapper for [jokeapi.dev](https://jokeapi.dev/) api\n\n##### Class `DadJokes()`\n\nThis class provides the following methods:\n\n- `random_joke_as_json(self)`\n- `random_joke_as_text(self)`\n- `specific_joke_as_json(self, id)`\n- `specific_joke_as_text(self, id)`\n- `list_jokes_as_json(self, page, limit, term)`\n- `list_jokes_as_text(self, page, limit, term)`\n\n##### Class `AllJokes()`\n\nThis class inherits from the `DadJokes` class, but also provides the following methods:\n\n- `get_joke_json(self, joke_lang, joke_category, joke_flags, joke_type, joke_contains, joke_id, joke_amount)`\n- `get_joke_text(self, joke_lang, joke_category, joke_flags, joke_type, joke_contains, joke_id, joke_amount)`\n\n#### Basic Usage\n\n```\nfrom jokes.jokesv2 import AllJokes\n\njokes = AllJokes()\n\njoke = jokes.get_joke_json()\nprint(joke)\n\njoke = jokes.get_joke_text()\nprint(joke)\n\njoke = jokes.random_joke_as_json()\nprint(joke)\n\njoke = jokes.random_joke_as_text()\nprint(joke)\n\njoke = jokes.specific_joke_as_json(id=\"12\")\nprint(joke)\n\njoke = jokes.specific_joke_as_text(id=\"12\")\nprint(joke)\n\njoke = jokes.list_jokes_as_json()\nprint(joke)\n\njoke = jokes.list_jokes_as_text()\nprint(joke)\n```\n\n## Example\n\nHere is a simple implementation of this package. Check it out:\n\n- [jokes_cli](https://github.com/LoisaKitakaya/jokes_cli)\n\n## Contribution\n\nIf you want to contribute to this project, here are some few steps you can follow:\n\n- Fork this project's repository\n- Clone it to your local machine\n- Make the changes you want to make or add the features you want to add\n- Write tests for the new features\n- Make a pull request\n\nThat's just about it.\n\n## Issues\n\nFor any issus encountered while using this package, feel free to submit a new issue [here](https://github.com/LoisaKitakaya/Jokes/issues).\n\nEnjoy! 🤪","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floisakitakaya%2Fjokes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Floisakitakaya%2Fjokes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floisakitakaya%2Fjokes/lists"}