AMN


NameAMN JSON
Version 0.6.1 PyPI version JSON
download
home_page
SummaryVirtual machines for the AMN instructions sets
upload_time2023-10-22 21:45:05
maintainer
docs_urlNone
author
requires_python>=3.10
license
keywords am0 am1 amn
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # AMN

[![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch)
![Tests](https://github.com/Deric-W/AMN/actions/workflows/Tests.yaml/badge.svg)
[![codecov](https://codecov.io/gh/Deric-W/AMN/branch/main/graph/badge.svg?token=SU3982mC17)](https://codecov.io/gh/Deric-W/AMN)

The AMN package implements a simple virtual machine for the AM0 and AM1 instructions sets.

To use it, simply execute it with `python3 -m AMN -i <instruction set> exec path/to/file.txt` to execute the instructions written in a file.

If you want an interactive console just use `python3 -m AMN -i <instruction set> repl`.

## Requirements

Python >= 3.10 is required to use the utility.

## Installation

```sh
python3 -m pip install AMN
```

## Examples

The REPL (read eval print loop) in action:

```
python3 -m AMN -i am0 repl
Welcome the the AM0 REPL, type 'help' for help
AM0 >> exec READ 0
Input: 8
AM0 >> exec READ 1
Input: 42
AM0 >> exec LOAD 0
AM0 >> exec LOAD 1
AM0 >> exec GT
AM0 >> exec JMC 24
AM0 >> status
Counter: 24
Stack: []
Memory:
    0 := 8
    1 := 42
AM0 >> exit
Exiting REPL...
```

Example program which outputs the biggest of two numbers:

```
READ 0;
READ 1;
LOAD 0;
LOAD 1;
GT;
JMC 10;
LOAD 0;
STORE 2;
JMP 12;
LOAD 1;
STORE 2;
WRITE 2;
```

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "AMN",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "",
    "keywords": "AM0,AM1,AMN",
    "author": "",
    "author_email": "Eric Niklas Wolf <eric_niklas.wolf@mailbox.tu-dresden.de>",
    "download_url": "https://files.pythonhosted.org/packages/73/f0/2d64409ca81075b55de342538054374584fe7e21a2fdce87078102973406/amn-0.6.1.tar.gz",
    "platform": null,
    "description": "# AMN\n\n[![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch)\n![Tests](https://github.com/Deric-W/AMN/actions/workflows/Tests.yaml/badge.svg)\n[![codecov](https://codecov.io/gh/Deric-W/AMN/branch/main/graph/badge.svg?token=SU3982mC17)](https://codecov.io/gh/Deric-W/AMN)\n\nThe AMN package implements a simple virtual machine for the AM0 and AM1 instructions sets.\n\nTo use it, simply execute it with `python3 -m AMN -i <instruction set> exec path/to/file.txt` to execute the instructions written in a file.\n\nIf you want an interactive console just use `python3 -m AMN -i <instruction set> repl`.\n\n## Requirements\n\nPython >= 3.10 is required to use the utility.\n\n## Installation\n\n```sh\npython3 -m pip install AMN\n```\n\n## Examples\n\nThe REPL (read eval print loop) in action:\n\n```\npython3 -m AMN -i am0 repl\nWelcome the the AM0 REPL, type 'help' for help\nAM0 >> exec READ 0\nInput: 8\nAM0 >> exec READ 1\nInput: 42\nAM0 >> exec LOAD 0\nAM0 >> exec LOAD 1\nAM0 >> exec GT\nAM0 >> exec JMC 24\nAM0 >> status\nCounter: 24\nStack: []\nMemory:\n    0 := 8\n    1 := 42\nAM0 >> exit\nExiting REPL...\n```\n\nExample program which outputs the biggest of two numbers:\n\n```\nREAD 0;\nREAD 1;\nLOAD 0;\nLOAD 1;\nGT;\nJMC 10;\nLOAD 0;\nSTORE 2;\nJMP 12;\nLOAD 1;\nSTORE 2;\nWRITE 2;\n```\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Virtual machines for the AMN instructions sets",
    "version": "0.6.1",
    "project_urls": {
        "Bugtracker": "https://github.com/Deric-W/AMN/issues",
        "Repository": "https://github.com/Deric-W/AMN"
    },
    "split_keywords": [
        "am0",
        "am1",
        "amn"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "609a53197def9c7af0f223ec66eb6c2b3621e89aa7a1fee521dffdeb70924532",
                "md5": "da409dfef93b60638e90f45a7b7adb1b",
                "sha256": "91870b316bdb1408fde19a9b5c0187e0735e417cd1f889459dd5d3a326ef0a89"
            },
            "downloads": -1,
            "filename": "amn-0.6.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "da409dfef93b60638e90f45a7b7adb1b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 22266,
            "upload_time": "2023-10-22T21:45:04",
            "upload_time_iso_8601": "2023-10-22T21:45:04.544096Z",
            "url": "https://files.pythonhosted.org/packages/60/9a/53197def9c7af0f223ec66eb6c2b3621e89aa7a1fee521dffdeb70924532/amn-0.6.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "73f02d64409ca81075b55de342538054374584fe7e21a2fdce87078102973406",
                "md5": "fb97b8a983ae0d7f2e33804ee24a60d9",
                "sha256": "ce1f46c4eb4727bbaab7da0681818b2300c1684fbf4285d1b2535db9ff18f951"
            },
            "downloads": -1,
            "filename": "amn-0.6.1.tar.gz",
            "has_sig": false,
            "md5_digest": "fb97b8a983ae0d7f2e33804ee24a60d9",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 23071,
            "upload_time": "2023-10-22T21:45:05",
            "upload_time_iso_8601": "2023-10-22T21:45:05.771476Z",
            "url": "https://files.pythonhosted.org/packages/73/f0/2d64409ca81075b55de342538054374584fe7e21a2fdce87078102973406/amn-0.6.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-10-22 21:45:05",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Deric-W",
    "github_project": "AMN",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "amn"
}
        
Elapsed time: 0.26533s