Metadata-Version: 2.4
Name: maxframe
Version: 2.3.0
Summary: MaxFrame operator-based data analyze framework
Requires-Dist: numpy<2.0.0,>=1.19.0
Requires-Dist: pandas>=1.0.0
Requires-Dist: pyodps>=0.12.0
Requires-Dist: scipy>=1.0
Requires-Dist: pyarrow>=1.0.0
Requires-Dist: msgpack>=1.0.0
Requires-Dist: traitlets>=5.0
Requires-Dist: cloudpickle<3.0.0,>=1.5.0
Requires-Dist: pyyaml>=5.1
Requires-Dist: pickle5; python_version < "3.8"
Requires-Dist: tornado>=6.0
Requires-Dist: defusedxml>=0.5.0
Requires-Dist: tqdm>=4.1.0
Requires-Dist: importlib_metadata>=1.4
Provides-Extra: dev
Requires-Dist: black>=22.3.0; extra == "dev"
Requires-Dist: flake8>=5.0.4; extra == "dev"
Requires-Dist: flake8-type-checking>=1.0.3; extra == "dev"
Requires-Dist: pre-commit>=2.15.0; extra == "dev"
Requires-Dist: graphviz>=0.20.1; extra == "dev"
Provides-Extra: test
Requires-Dist: mock; extra == "test"
Requires-Dist: pytest>=7.3.1; extra == "test"
Requires-Dist: pytest-cov>=4.1.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
Requires-Dist: pytest-timeout>=2.1.0; extra == "test"
Requires-Dist: matplotlib>=2.0.0; extra == "test"
Requires-Dist: lightgbm<4.0.0,>=3.0.0; extra == "test"
Requires-Dist: scikit-learn>=1.0; extra == "test"
Requires-Dist: xgboost<2.1.0,>=1.6.2; extra == "test"
Dynamic: description

MaxCompute MaxFrame Client
==========================

MaxFrame is a computational framework created by Alibaba Cloud to
provide a way for Python developers to parallelize their code with
MaxCompute. It creates a runnable computation graph locally, submits it
to MaxCompute to execute and obtains results from MaxCompute.

MaxFrame client is the client of MaxFrame. Currently it provides a
DataFrame-based SDK with compatible APIs for pandas. In future, other
common Python libraries like numpy and scikit-learn will be added as
well. Python 3.7 is recommended for MaxFrame client to enable all
functionalities while supports for higher Python versions are on the
way.

Installation
------------

You may install MaxFrame client through PIP:

.. code:: bash

   pip install maxframe

Latest beta version can be installed with ``--pre`` argument:

.. code:: bash

   pip install --pre maxframe

You can also install MaxFrame client from source code:

.. code:: bash

   pip install git+https://github.com/aliyun/alibabacloud-odps-maxframe-client.git

Getting started
---------------

We show a simple code example of MaxFrame client which read data from a
MaxCompute table, performs some simple data transform and writes back
into MaxCompute.

.. code:: python

   import maxframe.dataframe as md
   import os
   from maxframe import new_session
   from odps import ODPS

   o = ODPS(
       os.getenv('ALIBABA_CLOUD_ACCESS_KEY_ID'),
       os.getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
       project='your-default-project',
       endpoint='your-end-point',
   )
   session = new_session(o)

   df = md.read_odps_table("source_table")
   df["A"] = "prefix_" + df["A"]
   md.to_odps_table(df, "prefix_source_table")

Documentation
-------------

Detailed documentations can be found
`here <https://maxframe.readthedocs.io>`__.

License
-------

Licensed under the `Apache License
2.0 <https://www.apache.org/licenses/LICENSE-2.0.html>`__.
