pytvm

Name	pytvm JSON
Version	0.0.14 JSON
	download
home_page	https://github.com/yungwine/pytvm
Summary	Python TVM emulator
upload_time	2024-08-25 12:23:23
maintainer	None
docs_url	None
author	Maksim Kurbatov
requires_python	>=3.9
license	None
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # pytvm

[![PyPI version](https://badge.fury.io/py/pytvm.svg)](https://badge.fury.io/py/pytvm) 
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pytvm)](https://pypi.org/project/pytvm/)
[![Downloads](https://static.pepy.tech/badge/pytvm)](https://pepy.tech/project/pytvm)
[![Downloads](https://static.pepy.tech/badge/pytvm/month)](https://pepy.tech/project/pytvm)
[![](https://img.shields.io/badge/%F0%9F%92%8E-TON-grey)](https://ton.org)

> :warning: **WARNING: The pytvm library is currently in active development. Features and functionality may change frequently. Please keep this in mind when using this library.**

**pytvm** - is a Python bindings to C++ TON Virtual Machine (TVM) emulator. **pytvm** allows you:

* Run Get-Methods locally (for trustless and fast data retrieval)
* Emulate messages (`Internal` and `External`)
* Emulate transactions
* Emulate transactions traces

## Usage

Find examples in the [examples](examples/) folder.

## Installation

### From PyPi

```commandline
pip install pytvm 
```

### From source
Currently, **pytvm** compatible with Python3.9 - Python3.11 on platforms:
* Linux (x86_64)
* Windows (x86_64)
* MacOS (x86_64, arm64)

If your system is not compatible with the pre-built wheels, you can install **pytvm** from source:

1) Compile `emulator` target TON Blockchain [repo](https://github.com/ton-blockchain/ton) or download `libemulator` binaries from
[latest release](https://github.com/ton-blockchain/ton/releases/latest).
2) Install **pytvm** from source:

    ```commandline
    pip install pytvm
    ```

3) Create engine providing path to `libemulator` binaries to `EmulatorEngineC`:

```python
from pytvm.engine import EmulatorEngineC
from pytvm.transaction_emulator import TransactionEmulator
engine = EmulatorEngineC('path/to/libemulator.so')
emulator = TransactionEmulator(engine=engine)
```

## Donation

TON wallet: `EQBvW8Z5huBkMJYdnfAEM5JqTNkuWX3diqYENkWsIL0XggGG`

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/yungwine/pytvm",
    "name": "pytvm",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": null,
    "author": "Maksim Kurbatov",
    "author_email": "cyrbatoff@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/bb/db/1e088baadb91883d281c68674ff4e0c6e7321422b02ce7c49d92df9166c8/pytvm-0.0.14.tar.gz",
    "platform": null,
    "description": "# pytvm\n\n[![PyPI version](https://badge.fury.io/py/pytvm.svg)](https://badge.fury.io/py/pytvm) \n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pytvm)](https://pypi.org/project/pytvm/)\n[![Downloads](https://static.pepy.tech/badge/pytvm)](https://pepy.tech/project/pytvm)\n[![Downloads](https://static.pepy.tech/badge/pytvm/month)](https://pepy.tech/project/pytvm)\n[![](https://img.shields.io/badge/%F0%9F%92%8E-TON-grey)](https://ton.org)\n\n> :warning: **WARNING: The pytvm library is currently in active development. Features and functionality may change frequently. Please keep this in mind when using this library.**\n\n**pytvm** - is a Python bindings to C++ TON Virtual Machine (TVM) emulator. **pytvm** allows you:\n\n* Run Get-Methods locally (for trustless and fast data retrieval)\n* Emulate messages (`Internal` and `External`)\n* Emulate transactions\n* Emulate transactions traces\n\n## Usage\n\nFind examples in the [examples](examples/) folder.\n\n## Installation\n\n### From PyPi\n\n```commandline\npip install pytvm \n```\n\n### From source\nCurrently, **pytvm** compatible with Python3.9 - Python3.11 on platforms:\n* Linux (x86_64)\n* Windows (x86_64)\n* MacOS (x86_64, arm64)\n\nIf your system is not compatible with the pre-built wheels, you can install **pytvm** from source:\n\n1) Compile `emulator` target TON Blockchain [repo](https://github.com/ton-blockchain/ton) or download `libemulator` binaries from\n[latest release](https://github.com/ton-blockchain/ton/releases/latest).\n2) Install **pytvm** from source:\n\n    ```commandline\n    pip install pytvm\n    ```\n\n3) Create engine providing path to `libemulator` binaries to `EmulatorEngineC`:\n\n```python\nfrom pytvm.engine import EmulatorEngineC\nfrom pytvm.transaction_emulator import TransactionEmulator\nengine = EmulatorEngineC('path/to/libemulator.so')\nemulator = TransactionEmulator(engine=engine)\n```\n\n## Donation\n\nTON wallet: `EQBvW8Z5huBkMJYdnfAEM5JqTNkuWX3diqYENkWsIL0XggGG`\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Python TVM emulator",
    "version": "0.0.14",
    "project_urls": {
        "Homepage": "https://github.com/yungwine/pytvm"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "13a17b5dbd3531544c72e95b0e16d8c431b3f9fa494da3ff7ac9f6bdc2d8c479",
                "md5": "c0914d4bd9964b227230d7bfb48db481",
                "sha256": "d67d044976c23431c2dacd8673df697e8fe630062914441b96e2177a26aa0143"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp310-cp310-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "c0914d4bd9964b227230d7bfb48db481",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.9",
            "size": 2895349,
            "upload_time": "2024-08-25T12:23:00",
            "upload_time_iso_8601": "2024-08-25T12:23:00.241067Z",
            "url": "https://files.pythonhosted.org/packages/13/a1/7b5dbd3531544c72e95b0e16d8c431b3f9fa494da3ff7ac9f6bdc2d8c479/pytvm-0.0.14-cp310-cp310-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8178bf2bff62675558601bcd3a3cce77a8e62000be4b9e6a01bebf4484a7dedf",
                "md5": "8229976551815afc812d9234221f2a5a",
                "sha256": "1334230ca7acfd99ad0773a05cb37d5462dd57ddd6a76448dd2b149167296930"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp310-cp310-macosx_12_0_x86_64.whl",
            "has_sig": false,
            "md5_digest": "8229976551815afc812d9234221f2a5a",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.9",
            "size": 3159157,
            "upload_time": "2024-08-25T12:23:02",
            "upload_time_iso_8601": "2024-08-25T12:23:02.623736Z",
            "url": "https://files.pythonhosted.org/packages/81/78/bf2bff62675558601bcd3a3cce77a8e62000be4b9e6a01bebf4484a7dedf/pytvm-0.0.14-cp310-cp310-macosx_12_0_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ba47b636fcdfe3f51d04fd5e0e8fbe0eebf56f1c264c486b4d35a9c2043340aa",
                "md5": "feb3a27998e8bd2bfc2f9d8f8bc79e73",
                "sha256": "ae44cd3dc8111d44005eeeafcb1e991a5b6f202f9017eff8a12f00da6b8af4a6"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp310-cp310-manylinux_2_27_x86_64.whl",
            "has_sig": false,
            "md5_digest": "feb3a27998e8bd2bfc2f9d8f8bc79e73",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.9",
            "size": 4534803,
            "upload_time": "2024-08-25T12:23:04",
            "upload_time_iso_8601": "2024-08-25T12:23:04.184733Z",
            "url": "https://files.pythonhosted.org/packages/ba/47/b636fcdfe3f51d04fd5e0e8fbe0eebf56f1c264c486b4d35a9c2043340aa/pytvm-0.0.14-cp310-cp310-manylinux_2_27_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "920bf137f814d9cbd80d007a9ad9213058f5d9893899363eb1d6bff806343d5f",
                "md5": "8cf007f31a06b5d555b9b8a3a84d1f3f",
                "sha256": "02025fbcc4c1b150a6b54f4ee424a176f1afe1eefcdd728bdf682ee9d77ffb32"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp310-cp310-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "8cf007f31a06b5d555b9b8a3a84d1f3f",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.9",
            "size": 3433617,
            "upload_time": "2024-08-25T12:23:05",
            "upload_time_iso_8601": "2024-08-25T12:23:05.934624Z",
            "url": "https://files.pythonhosted.org/packages/92/0b/f137f814d9cbd80d007a9ad9213058f5d9893899363eb1d6bff806343d5f/pytvm-0.0.14-cp310-cp310-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8eb30f54738ec47387a559dc8c87e9206ee01759a9ff5ba1b90dbbf1b986b248",
                "md5": "ded5dcc68ec2f3a4b8b259201652fa2c",
                "sha256": "6f29870c78c52cdfcc3e185adababa678be7488b32b42508c35c9b0443cb2268"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp311-cp311-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "ded5dcc68ec2f3a4b8b259201652fa2c",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": ">=3.9",
            "size": 2897283,
            "upload_time": "2024-08-25T12:23:07",
            "upload_time_iso_8601": "2024-08-25T12:23:07.936559Z",
            "url": "https://files.pythonhosted.org/packages/8e/b3/0f54738ec47387a559dc8c87e9206ee01759a9ff5ba1b90dbbf1b986b248/pytvm-0.0.14-cp311-cp311-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c399a99b375f79476616c36344575efa3711dc18223d4ece53e616c27fc9c314",
                "md5": "21ea248860f2b338d72b905396c82e15",
                "sha256": "05a0001f2faad088478cb7b4a68286fc39982921b06d2d63e982c900a19b7470"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp311-cp311-macosx_11_0_x86_64.whl",
            "has_sig": false,
            "md5_digest": "21ea248860f2b338d72b905396c82e15",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": ">=3.9",
            "size": 3161089,
            "upload_time": "2024-08-25T12:23:09",
            "upload_time_iso_8601": "2024-08-25T12:23:09.780462Z",
            "url": "https://files.pythonhosted.org/packages/c3/99/a99b375f79476616c36344575efa3711dc18223d4ece53e616c27fc9c314/pytvm-0.0.14-cp311-cp311-macosx_11_0_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9d32b3fc2740032ddee7240fda8200d0597573cbe84822f1a7b6e82e29d3e1e3",
                "md5": "0dc663544f85bee41f3de482cb3fcb33",
                "sha256": "18a1c164ba45e9fbc6a325102b193e159d8b57258c11ae669a13cbb2023d6cb4"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp311-cp311-manylinux_2_27_x86_64.whl",
            "has_sig": false,
            "md5_digest": "0dc663544f85bee41f3de482cb3fcb33",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": ">=3.9",
            "size": 4536740,
            "upload_time": "2024-08-25T12:23:11",
            "upload_time_iso_8601": "2024-08-25T12:23:11.836306Z",
            "url": "https://files.pythonhosted.org/packages/9d/32/b3fc2740032ddee7240fda8200d0597573cbe84822f1a7b6e82e29d3e1e3/pytvm-0.0.14-cp311-cp311-manylinux_2_27_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "686dfbb4db23064d88a1be016bf420fac447c85ab1057eb6230f9f5ea5cfee68",
                "md5": "4832c6fd550ca953d2d4154071c3e146",
                "sha256": "20739de4d18f82769d7018e38497b0dcfd999375b362e8f6e56bb142f68165a7"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp311-cp311-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "4832c6fd550ca953d2d4154071c3e146",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": ">=3.9",
            "size": 3435549,
            "upload_time": "2024-08-25T12:23:13",
            "upload_time_iso_8601": "2024-08-25T12:23:13.850160Z",
            "url": "https://files.pythonhosted.org/packages/68/6d/fbb4db23064d88a1be016bf420fac447c85ab1057eb6230f9f5ea5cfee68/pytvm-0.0.14-cp311-cp311-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b36e4808bd4b34f6494cb4e1492954dec765c0f85cbdbe7f0df26767bbe48f11",
                "md5": "8534fa9d3715ff38c9397d535c9a5aeb",
                "sha256": "02e92a1b43aacef781d1743840fbff61f7f86c5ab7941079d19016cc3389dc7b"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp39-cp39-macosx_12_0_x86_64.whl",
            "has_sig": false,
            "md5_digest": "8534fa9d3715ff38c9397d535c9a5aeb",
            "packagetype": "bdist_wheel",
            "python_version": "cp39",
            "requires_python": ">=3.9",
            "size": 3159186,
            "upload_time": "2024-08-25T12:23:15",
            "upload_time_iso_8601": "2024-08-25T12:23:15.821061Z",
            "url": "https://files.pythonhosted.org/packages/b3/6e/4808bd4b34f6494cb4e1492954dec765c0f85cbdbe7f0df26767bbe48f11/pytvm-0.0.14-cp39-cp39-macosx_12_0_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8b455fd3770b9f93450a5b2599ced4b4e53fdf5dccc92cf52005626c8437760e",
                "md5": "5d06d34016db0609609764eef08b5920",
                "sha256": "f7788be75b0b5aa86862b8c59ea1e448ea26f8576f573071c2930172980b3098"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp39-cp39-macosx_14_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "5d06d34016db0609609764eef08b5920",
            "packagetype": "bdist_wheel",
            "python_version": "cp39",
            "requires_python": ">=3.9",
            "size": 2895375,
            "upload_time": "2024-08-25T12:23:17",
            "upload_time_iso_8601": "2024-08-25T12:23:17.738337Z",
            "url": "https://files.pythonhosted.org/packages/8b/45/5fd3770b9f93450a5b2599ced4b4e53fdf5dccc92cf52005626c8437760e/pytvm-0.0.14-cp39-cp39-macosx_14_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "80a7c2af307d6a9f5f5a4a759679e8052bbf336c283ae9bed2afbaa5638682b1",
                "md5": "5ce3a8192293d017defa264e54863c01",
                "sha256": "f1fa02c5c06de840d66ca3c2786ad14cad7d44c23a01a1d91f3dd265cacda124"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp39-cp39-manylinux_2_27_x86_64.whl",
            "has_sig": false,
            "md5_digest": "5ce3a8192293d017defa264e54863c01",
            "packagetype": "bdist_wheel",
            "python_version": "cp39",
            "requires_python": ">=3.9",
            "size": 4534828,
            "upload_time": "2024-08-25T12:23:19",
            "upload_time_iso_8601": "2024-08-25T12:23:19.863725Z",
            "url": "https://files.pythonhosted.org/packages/80/a7/c2af307d6a9f5f5a4a759679e8052bbf336c283ae9bed2afbaa5638682b1/pytvm-0.0.14-cp39-cp39-manylinux_2_27_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d5b2556a42d51f069a7a42ee322a09e73dab98b5a4032062884c7404e027e75e",
                "md5": "7b2f366e4bbe6cb6922f8454a1c713bb",
                "sha256": "1445070573cb6e7069e06604db5299eaa1f33a06755797f6e0a736c6fb8a33f4"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14-cp39-cp39-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "7b2f366e4bbe6cb6922f8454a1c713bb",
            "packagetype": "bdist_wheel",
            "python_version": "cp39",
            "requires_python": ">=3.9",
            "size": 3433644,
            "upload_time": "2024-08-25T12:23:21",
            "upload_time_iso_8601": "2024-08-25T12:23:21.593761Z",
            "url": "https://files.pythonhosted.org/packages/d5/b2/556a42d51f069a7a42ee322a09e73dab98b5a4032062884c7404e027e75e/pytvm-0.0.14-cp39-cp39-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "bbdb1e088baadb91883d281c68674ff4e0c6e7321422b02ce7c49d92df9166c8",
                "md5": "8a7ae6c413c82213b9a961d123368dfa",
                "sha256": "73f93021598a062c629cbceba1855589b36cc05a92fda1fc0a346efeef2db9f4"
            },
            "downloads": -1,
            "filename": "pytvm-0.0.14.tar.gz",
            "has_sig": false,
            "md5_digest": "8a7ae6c413c82213b9a961d123368dfa",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 11374,
            "upload_time": "2024-08-25T12:23:23",
            "upload_time_iso_8601": "2024-08-25T12:23:23.083750Z",
            "url": "https://files.pythonhosted.org/packages/bb/db/1e088baadb91883d281c68674ff4e0c6e7321422b02ce7c49d92df9166c8/pytvm-0.0.14.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-25 12:23:23",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "yungwine",
    "github_project": "pytvm",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "pytvm"
}