Metadata-Version: 2.3
Name: polars_writer
Version: 0.3.3
Summary: polars_writer is a library that enables JSON-based configuration of Polars DataFrame writing methods, facilitating language-agnostic data export for end-user facing data products. 
License: MIT
Author: Sanhe Hu
Author-email: husanhe@email.com
Maintainer: Sanhe Hu
Maintainer-email: husanhe@email.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Provides-Extra: auto
Provides-Extra: dev
Provides-Extra: doc
Provides-Extra: test
Requires-Dist: Sphinx (>=7.4.7,<8.0.0) ; extra == "doc"
Requires-Dist: build (>=1.2.1,<2.0.0) ; extra == "dev"
Requires-Dist: deltalake (>=0.18.2,<1.0.0) ; extra == "test"
Requires-Dist: docfly (==3.0.0) ; extra == "doc"
Requires-Dist: func_args (>=0.1.1,<2.0.0)
Requires-Dist: furo (==2024.8.6) ; extra == "doc"
Requires-Dist: ipython (>=8.18.1,<8.19.0) ; extra == "doc"
Requires-Dist: nbsphinx (>=0.8.12,<1.0.0) ; extra == "doc"
Requires-Dist: polars (>=1.2.1,<2.0.0)
Requires-Dist: pygments (>=2.18.0,<3.0.0) ; extra == "doc"
Requires-Dist: pytest (>=8.2.2,<9.0.0) ; extra == "test"
Requires-Dist: pytest-cov (>=6.0.0,<7.0.0) ; extra == "test"
Requires-Dist: rich (>=13.8.1,<14.0.0) ; extra == "dev"
Requires-Dist: rstobj (==1.2.1) ; extra == "doc"
Requires-Dist: sphinx-copybutton (>=0.5.2,<1.0.0) ; extra == "doc"
Requires-Dist: sphinx-design (>=0.6.1,<1.0.0) ; extra == "doc"
Requires-Dist: sphinx-jinja (>=2.0.2,<3.0.0) ; extra == "doc"
Requires-Dist: twine (>=6.0.0,<7.0.0) ; extra == "dev"
Requires-Dist: wheel (>=0.45.0,<1.0.0) ; extra == "dev"
Project-URL: Changelog, https://github.com/MacHu-GWU/polars_writer-project/blob/main/release-history.rst
Project-URL: Documentation, https://polars-writer.readthedocs.io/en/latest/
Project-URL: Download, https://pypi.org/pypi/polars-writer#files
Project-URL: Homepage, https://github.com/MacHu-GWU/polars_writer-project
Project-URL: Issues, https://github.com/MacHu-GWU/polars_writer-project/issues
Project-URL: Repository, https://github.com/MacHu-GWU/polars_writer-project
Description-Content-Type: text/x-rst


.. image:: https://readthedocs.org/projects/polars-writer/badge/?version=latest
    :target: https://polars-writer.readthedocs.io/en/latest/
    :alt: Documentation Status

.. image:: https://github.com/MacHu-GWU/polars_writer-project/actions/workflows/main.yml/badge.svg
    :target: https://github.com/MacHu-GWU/polars_writer-project/actions?query=workflow:CI

.. image:: https://codecov.io/gh/MacHu-GWU/polars_writer-project/branch/main/graph/badge.svg
    :target: https://codecov.io/gh/MacHu-GWU/polars_writer-project

.. image:: https://img.shields.io/pypi/v/polars-writer.svg
    :target: https://pypi.python.org/pypi/polars-writer

.. image:: https://img.shields.io/pypi/l/polars-writer.svg
    :target: https://pypi.python.org/pypi/polars-writer

.. image:: https://img.shields.io/pypi/pyversions/polars-writer.svg
    :target: https://pypi.python.org/pypi/polars-writer

.. image:: https://img.shields.io/badge/✍️_Release_History!--None.svg?style=social&logo=github
    :target: https://github.com/MacHu-GWU/polars_writer-project/blob/main/release-history.rst

.. image:: https://img.shields.io/badge/⭐_Star_me_on_GitHub!--None.svg?style=social&logo=github
    :target: https://github.com/MacHu-GWU/polars_writer-project

------

.. image:: https://img.shields.io/badge/Link-API-blue.svg
    :target: https://polars-writer.readthedocs.io/en/latest/py-modindex.html

.. image:: https://img.shields.io/badge/Link-Install-blue.svg
    :target: `install`_

.. image:: https://img.shields.io/badge/Link-GitHub-blue.svg
    :target: https://github.com/MacHu-GWU/polars_writer-project

.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
    :target: https://github.com/MacHu-GWU/polars_writer-project/issues

.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
    :target: https://github.com/MacHu-GWU/polars_writer-project/issues

.. image:: https://img.shields.io/badge/Link-Download-blue.svg
    :target: https://pypi.org/pypi/polars-writer#files


Welcome to ``polars_writer`` Documentation
==============================================================================
.. image:: https://polars-writer.readthedocs.io/en/latest/_static/polars_writer-logo.png
    :target: https://polars-writer.readthedocs.io/en/latest/

``polars_writer`` is a library that allows defining methods like polars.DataFrame.write_csv and polars.DataFrame.write_json using a pure JSON-friendly parameter format. The purpose of this library is to provide an interface independent of the Python language itself, allowing users to directly define the behavior of polars writers using JSON. This library is intended to be used in some end-user facing data products.

See `Usage example <https://github.com/MacHu-GWU/polars_writer-project/blob/main/tests/test_writer.py>`_


.. _install:

Install
------------------------------------------------------------------------------

``polars_writer`` is released on PyPI, so all you need is to:

.. code-block:: console

    $ pip install polars-writer

To upgrade to latest version:

.. code-block:: console

    $ pip install --upgrade polars-writer

