Name | AMN JSON |
Version |
0.6.1
JSON |
| download |
home_page | |
Summary | Virtual machines for the AMN instructions sets |
upload_time | 2023-10-22 21:45:05 |
maintainer | |
docs_url | None |
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"
}