Metadata-Version: 2.1
Name: curlipie
Version: 0.8.1
Summary: Library to convert cURL command line to HTTPie
Home-page: https://github.com/hongquan/CurliPie.git
License: MPL-2.0
Keywords: api,http,curl,httpie,cli,conversion
Author: Nguyễn Hồng Quân
Author-email: ng.hong.quan@gmail.com
Maintainer: Nguyễn Hồng Quân
Maintainer-email: ng.hong.quan@gmail.com
Requires-Python: >=3.6.1,<4.0.0
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: Jinja2 (>=3.0.1,<4.0.0)
Requires-Dist: first (>=2.0.2,<3.0.0)
Requires-Dist: http-constants (>=0.4.0,<0.5.0)
Requires-Dist: kiss-headers (>=2.3.0,<3.0.0)
Requires-Dist: logbook (>=1.5.3,<2.0.0)
Requires-Dist: multidict (>=4.7.4,<5.0.0)
Requires-Dist: orjson (>=2.2.0,<3.0.0); python_version >= "3.7"
Requires-Dist: pydantic (>=1.8.2,<2.0.0)
Requires-Dist: python-rapidjson (>=0.9.1,<0.10.0); python_version ~= "3.6"
Requires-Dist: single-version (>=1.5.1,<2.0.0)
Requires-Dist: typed-argument-parser (>=1.6.2,<2.0.0)
Requires-Dist: yarl (>=1.4.2,<2.0.0)
Project-URL: Repository, https://github.com/hongquan/CurliPie.git
Description-Content-Type: text/x-rst

========
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

