Metadata-Version: 2.1
Name: pysui-gadgets
Version: 0.4.2
Summary: pysui (Python Sui Client SDK) additional tools
License: Apache-2.0
Project-URL: changelog, https://github.com/FrankC01/pysui_gadgets/issues
Project-URL: repository, https://github.com/FrankC01/pysui_gadgets
Project-URL: issues, https://github.com/FrankC01/pysui_gadgets/issues
Keywords: software development kit,sui,blockchain,utilities,pysui
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: pysui >=0.39.0

pysui-gadgets
=============

pysui-gadgets includes tools and utilities that work with the pysui SDK.

Gadgets included:

* package - Performs operations that leverages meta-data about SUI move packages (smart-contracts)
* dsl-gen - Creates python representation of move package key structs and entry point functions
* to-one - Merges all SUI Gas mists 'to one' SUI Gas object for an address
* splay - Evenly distribute coins from one address to many
* vh - History of object versions

Setup for use
*************

#. Install SUI binaries
#. Setup python virtual environment
#. Activate virtual environment
#. Update ``pip``
#. Install ``pysui_gadgets``

.. code-block::

    cargo install --locked --git https://github.com/MystenLabs/sui.git --branch devnet sui
    python3 -m venv env
    . env/bin/activate
    pip install -U pip
    pip install pysui_gadgets

Upgrade
*******

#. Activate virtual environment
#. Update ``pysui_gadgets``

.. code-block::

    . env/bin/activate
    pip install -U pysui_gadgets

Setup for cloning
*****************

#. Install SUI binaries
#. Clone ``pysui_gadgets`` repository
#. Setup python virtual environment
#. Activate virtual environment
#. Update ``pip``
#. Install ``pysui``
#. Alternate install of ``pysui``

.. code-block::

    cargo install --locked --git https://github.com/MystenLabs/sui.git --branch devnet sui
    git clone git@github.com:FrankC01/pysui_gadgets.git
    python3 -m venv env
    . env/bin/activate
    pip install -U pip
    pip install -r requirements.txt
    # Alternately
    # clone pysui to other folder
    # in pysui run bin/package-build.sh
    # back in here
    pip install ../path_to_pysui/


Running gadgets
***************

.. code-block::

    module -h
    package -h
    dslgen -h
    to-one -h
    splay -h
    vh -h
