معرفی شرکت ها
curlipie-0.8.3
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Library to convert cURL command line to HTTPie
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | curlipie-0.8.3 |
| نام | curlipie |
| نسخه کتابخانه | 0.8.3 |
| نگهدارنده | ['Nguyễn Hồng Quân'] |
| ایمیل نگهدارنده | ['ng.hong.quan@gmail.com'] |
| نویسنده | Nguyễn Hồng Quân |
| ایمیل نویسنده | ng.hong.quan@gmail.com |
| آدرس صفحه اصلی | https://github.com/hongquan/CurliPie.git |
| آدرس اینترنتی | https://pypi.org/project/curlipie/ |
| مجوز | MPL-2.0 |
========
CurliPie
========
.. image:: https://madewithlove.vercel.app/vn?heart=true&colorA=%23ffcd00&colorB=%23da251d
.. image:: https://badgen.net/pypi/v/curlipie
:target: https://pypi.org/project/curlipie
Python library to convert `cURL`_ command to `HTTPie`_.
It will convert
.. code-block:: sh
curl -d name=admin -d shoesize=12 -d color=green&food=wet http://quan.hoabinh.vn
to
.. code-block:: sh
http -f http://quan.hoabinh.vn name=admin shoesize=12 color=green food=wet
Motivation
----------
This library was born when I joined a project with a team of non-Linux, non-Python developers. Because the project didn't have proper documentation, the other team often shared API usage example to me in form of cURL command, generated from their daily-used Postman. Those cURL commands are usually ugly, like this:
.. code-block:: sh
curl --location --request POST 'http://app-staging.dev/api' \
--header 'Content-Type: application/json' \
--data-raw '{
"userId": "abc-xyz",
"planAmount": 50000,
"isPromotion": false,
"createdAt": "2019-12-13 10:00:00"
}'
I am more comfortable with HTTPie (shorter syntax, has highlighting and is a Python application), so I often converted it to HTTPie:
.. code-block:: sh
http -F app-staging.dev/api userId=abc-xyz planAmount:=50000 isPromotion:=false createdAt='2019-12-13 10:00:00'
Though Postman can generate HTTPie, it does result in even uglier command:
.. code-block:: sh
printf '{
"userId": "abc-xyz",
"planAmount": 50000,
"isPromotion": false,
"createdAt": "2019-12-13 10:00:00"
}'| http --follow --timeout 3600 POST app-staging.dev/api \
Content-Type:'application/json'
Initially, I had to do conversion manually and quickly got tired from it. I tried to find a conversion tool but failed. There is an online tool `curl2httpie.online`_, but it failed with above example. So I decide to write my own tool.
I don't bother to help fix the online tool above, because it is written in Go. The rich ecosystem of Python, with these built-in libraries, enable me to finish the job fast:
- |shlex|_: Help parse the command line in form of shell language, handle the string escaping, quoting for me.
- |argparse|_: Help parse cURL options and arguments. Note that, cURL arguments syntax follow GNU style, which is common in Linux (and Python) world but not popular in Go world (see `this tutorial <go_tutorial_>`_), so it feels more natural with Python.
Usage
-----
.. code-block:: python
>>> from curlipie import curl_to_httpie
>>> curl = """curl -XPUT elastic.dev/movies/_doc/1 -d '{"director": "Burton, Tim", "year": 1996, "title": "Mars Attacks!"}' -H 'Content-Type: application/json'"""
>>> curl_to_httpie(curl)
ConversionResult(httpie="http PUT elastic.dev/movies/_doc/1 director='Burton, Tim' year:=1996 title='Mars Attacks!'", errors=[])
>>> result = curl_to_httpie(curl)
>>> result.httpie
"http PUT elastic.dev/movies/_doc/1 director='Burton, Tim' year:=1996 title='Mars Attacks!'"
Online tool
-----------
CurliPie is not very usable if it stays in library form, so I made an online tool for you to use it quickly:
https://curlipie.vercel.app
The site also provide HTTP API for you to develop a client for it.
Development
-----------
This repo contains three components:
- Python library ``curlipie``. This is the one `published`_ to PyPI.
- An API server built with `FastAPI`_, playing role of backend for `curlipie.vercel.app`_.
- A minimal frontend app built with `AlpineJS`_ and `TailwindCSS`_.
- Python dependencies are managed with `Poetry`_.
To try running on localhost:
- Run backend with:
.. code-block:: sh
uvicorn api.main:app
- The front-end are just static files, served by backend also, so you can access it via http://localhost:8000/. But because TailwindCSS is configured to strip unused CSS classes, you may need to rerun this command, inside *frontend-dev* folder, to keep your classes:
.. code-block:: sh
yarn build-tailwind
Unit test:
.. code-block:: sh
pytest
Credit
------
Brought to you by `Nguyễn Hồng Quân <author_>`_.
.. _cURL: https://curl.haxx.se
.. _HTTPie: https://httpie.org
.. _curl2httpie.online: https://curl2httpie.online/
.. |shlex| replace:: ``shlex``
.. _shlex: https://docs.python.org/3/library/shlex.html
.. |argparse| replace:: ``argparse``
.. _argparse: https://docs.python.org/3/library/argparse.html
.. _go_tutorial: https://gobyexample.com/command-line-flags
.. _published: https://pypi.org/project/curlipie/
.. _fastapi: https://github.com/tiangolo/fastapi
.. _curlipie.vercel.app: https://curlipie.vercel.app/
.. _vuejs: https://vuejs.org/
.. _alpinejs: https://github.com/alpinejs/alpine
.. _tailwindcss: https://tailwindcss.com
.. _poetry: https://python-poetry.org/
.. _author: https://quan.hoabinh.vn
نیازمندی
| مقدار | نام |
|---|---|
| >=4.7.4,<5.0.0 | multidict |
| >=1.4.2,<2.0.0 | yarl |
| >=2.2.0,<3.0.0) | orjson |
| >=2.0.2,<3.0.0 | first |
| >=0.9.1,<0.10.0) | python-rapidjson |
| >=0.4.0,<0.5.0 | http-constants |
| >=1.5.3,<2.0.0 | logbook |
| >=1.5.1,<2.0.0 | single-version |
| >=2.3.0,<3.0.0 | kiss-headers |
| >=1.8.2,<2.0.0 | pydantic |
| >=3.0.1,<4.0.0 | Jinja2 |
| >=1.7.0,<2.0.0 | typed-argument-parser |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.6.1,<4.0.0 | Python |
نحوه نصب
نصب پکیج whl curlipie-0.8.3:
pip install curlipie-0.8.3.whl
نصب پکیج tar.gz curlipie-0.8.3:
pip install curlipie-0.8.3.tar.gz