{"id":23032177,"url":"https://github.com/i2mint/http2py","last_synced_at":"2025-08-14T15:32:13.925Z","repository":{"id":57437668,"uuid":"260470410","full_name":"i2mint/http2py","owner":"i2mint","description":"Tools to create python binders to http web services.","archived":false,"fork":false,"pushed_at":"2024-11-12T11:41:33.000Z","size":410,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-12-13T04:13:50.509Z","etag":null,"topics":["api-wrapper","http","python","requests","webservice"],"latest_commit_sha":null,"homepage":"","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/i2mint.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,"roadmap":null,"authors":null}},"created_at":"2020-05-01T13:50:34.000Z","updated_at":"2022-11-08T01:56:47.000Z","dependencies_parsed_at":"2023-02-11T23:01:32.013Z","dependency_job_id":"684851d0-6b50-4996-b5c2-710778f69685","html_url":"https://github.com/i2mint/http2py","commit_stats":{"total_commits":100,"total_committers":5,"mean_commits":20.0,"dds":"0.31999999999999995","last_synced_commit":"7c27a0449766a9d12458ce569ac5746bed69b238"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i2mint%2Fhttp2py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i2mint%2Fhttp2py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i2mint%2Fhttp2py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i2mint%2Fhttp2py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/i2mint","download_url":"https://codeload.github.com/i2mint/http2py/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229841505,"owners_count":18132565,"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","http","python","requests","webservice"],"created_at":"2024-12-15T15:51:07.367Z","updated_at":"2024-12-15T15:51:07.857Z","avatar_url":"https://github.com/i2mint.png","language":"Python","readme":"[Documentation here](https://i2mint.github.io/http2py/)\n\n`the_one_where_we_have_an_http_service_that_we_want_call_through_normal_looking_python_functions`\n\n# (Http) Requests for humans\n\nTools to create python binders to http web services.\nHere, we develop python data access to web content through http request such as web services or web pages.\n\nThe story is as follows: You found something on the web that you'd like to interact with. \n\n* This could be data you'd like to have access to, \n* or some actions you'd like to perform -- such as search, posting an article, buying some bitcoin, etc.. \n* If you're really lucky, someone's already written a python layer to do what you want to do. \n* If you're just lucky, the resource comes with a clear interface definition that makes it \neasy for you to write your own python for. \n* If you're less lucky, you'll have to decipher some bad documentation of the API, \nor even write your own bots, crawlers and parsers to get what you want. \n\nWe want to make that all easier for you.\n\nWhat we'll focus on for now is the fundamental common aspect of making a python layer to the http requests. \n\n\"But... the excellent [`requests` library](https://requests.readthedocs.io/en/master/) \nalready provides the python wrapper to http!\" you say. Yes, and we thank the `requests` developers for that. \nIt is indeed an excellent package that we won't have to write now! \n\nWe'd like to build from there, cover more annoying boilerplate, and get you closer, faster, \nto the functionality you actually need: \nFunctions with the python types you're using in your code, \nthat responds with python objects you can directly use in your code. \n\nThe development of `requests` \n(including the [recommended add-ons](https://requests.readthedocs.io/en/master/community/recommended/)) \ncould be said to be facing the metal (raw http mechanics) and building interfaces with humans in mind. \nBy contrast, we want to face the human and build adapters to communicate with the metal. \nThat is, in our case, the fact that http is under the hood shouldn't even be visible (unless it needs to).\n\nIt's in honor of the inspiration of \"designing for humans\" that we extend requests' tag-line, \nto \"requests for humans\".\n\n# The approach\n\nAs always, we favor expressiveness, boilerplate minimization, separation of concerns, and a layered approach that \nincrementally transforms and enhance to get us from where we are to where we want to be.\n\nSo for py2request, where are we and where do we want to be?\n\n**What we have**: We have some http accessible resources. For instance, a perfectly well structured API \nspecification of a REST webservice, a very messy website, or anything in between.\n\n**What we'd like**: A Python interface to these web stuff. \nThat is, we want to talk python to the resources, and have it talk python back to us. \nFurther, we want this conversation to be to the point; we don't want to have to say more than the exact necessary, \nand don't want responses containing anything but exactly what we want and how we want it. \nFinally, we'd like to get this with minimum effort -- letting default choices be made for us, but being able to make \nour own choices if we want.\n\nIs that too much to ask?\n\nIn the layered approach we'll go from function specifications, to functions returning python \nRequest objects, which we can then wrap further to create functions actually executing the request, \ngetting back a Response object, and wrap further to get the final python output type.\n\nSo the objects in this pipeline are:\n* Specification\n* Request\n* Response\n* Final python object\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi2mint%2Fhttp2py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fi2mint%2Fhttp2py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi2mint%2Fhttp2py/lists"}