{ "info": { "author": "Mario Werner", "author_email": "mario.werner@iaik.tugraz.at", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Operating System :: OS Independent", "Programming Language :: Python :: 3.5", "Topic :: Scientific/Engineering", "Topic :: Software Development :: Build Tools", "Topic :: Utilities" ], "description": "Tooling package for the computer architecture course (aka Rechnerorganisation) at\n`Graz University of Technology `_.\n\nThis package provides utilities and tooling for working with textual and binary assembly variants.\nIn more detail, we provide comparable simple implementations of standard tools (e.g., assemblers,\ninstruction set simulators) that are required for experimenting with self-written processors.\nGiven that the tools are used for teaching, the focus of the package is correctness and\nextensibility. As instruction set architecture, Princeton's\n`TOY `_, incl. various extensions, and a subset of the\n`RISC-V RV32I `_ are currently supported.\n\nQuick and Dirty Usage of the Tools\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nFor fast experimentation, executable entry points for the most important tools like ``toyasm-ng.py``\nand ``toysim-ng.py`` are provided next to this README. Subsequently, it is possible to directly\nuse these applications like in one of the following examples:\n\n.. code-block:: bash\n\n $ python3 ./relative/pkg_path/toyasm-ng.py some_input_file.asm\n $ python3 /absolute/pkg_path/toyasm-ng.py some_input_file.asm\n\nGiven that the entry points are marked as executable (i.e., ``chmod +x ...``) and have a proper\n`shebang `_, on unix-like systems, also direct\nexecution is possible:\n\n.. code-block:: bash\n\n $ ./relative/pkg_path/toyasm-ng.py some_input_file.asm\n $ /absolute/pkg_path/toyasm-ng.py some_input_file.asm\n\nFinally, when the root directory of this package is part of the ``PATH``\n(e.g., ``export PATH=/absolute/pkg_path:$PATH``) environment variable, execution of the tools\nsimply by name is working too.\n\n.. code-block:: bash\n\n $ toyasm-ng.py some_input_file.asm\n\nProper Installation and Usage of the Package\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n*asmlib* is a proper python package and can also be installed via the standard package manager\n(e.g., ``pip3 install --user /absolute/pkg_path``). Note that, when development on to the package is\nplanned, installing the package as editable by adding the ``-e`` command line flag is recommended.\nAdditionally, `virtual environments `_\n(e.g., ``python3 -m venv _venv && source_venv/bin/activate``) can be used too.\n\nEither way, this automatically installs the entry points into the correct directories and the tools\ncan directly be used on the command line (i.e., ``toyasm-ng.py some_input_file.asm``).\n\nBuilding the Sphinx Documentation\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nWhen Sphinx is installed (i.e., ``pip3 install sphinx sphinx-autodoc-typehints``), the HTML API\ndocumentation for this package can be built via the following ``sphinx-build`` invocation:\n\n.. code-block:: bash\n\n $ sphinx-build doc doc/_build/html\n\nAlternatively, the ``sphinx`` command on the setup.py file can be used.\n\n.. code-block:: bash\n\n $ python3 ./setup.py sphinx\n\nEither way, the API documentation gets automatically generated by executing ``sphinx-apidoc`` first.\nThe resulting HTML output can be found in the ``doc/_build/html`` directory.\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://extgit.iaik.tugraz.at/con/asmlib", "keywords": "TOY assembler simulator computer architecture teaching", "license": "GPLv3", "maintainer": "", "maintainer_email": "", "name": "asmlib", "package_url": "https://pypi.org/project/asmlib/", "platform": "", "project_url": "https://pypi.org/project/asmlib/", "project_urls": { "Homepage": "https://extgit.iaik.tugraz.at/con/asmlib" }, "release_url": "https://pypi.org/project/asmlib/2.0.0/", "requires_dist": [ "sphinx; extra == 'documentation'", "sphinx-autodoc-typehints; extra == 'documentation'" ], "requires_python": "", "summary": "Tooling package for the computer architecture course at Graz University of Technology.", "version": "2.0.0" }, "last_serial": 5916976, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "f952a96725124be327579959432f0674", "sha256": "2f5126923e50527b0aca9ad86d89b12ab071237a14ae400b1a404ca97cecaa32" }, "downloads": -1, "filename": "asmlib-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "f952a96725124be327579959432f0674", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 39224, "upload_time": "2019-03-05T16:39:34", "url": "https://files.pythonhosted.org/packages/84/2e/9497586a31a42ee6d9b847f470aafd1ef917eb6227b9617428de2fb38e7f/asmlib-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c6ad142544fcea198edf9e1d3a7e9f88", "sha256": "11c3d53f8e7066fd1ea2caf19f2abe70b793ac30d661be60ffa7442da2bc9bd6" }, "downloads": -1, "filename": "asmlib-1.0.0.tar.gz", "has_sig": false, "md5_digest": "c6ad142544fcea198edf9e1d3a7e9f88", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 32209, "upload_time": "2019-03-05T16:39:36", "url": "https://files.pythonhosted.org/packages/45/bd/92143955fd94e345cb8fec0baaf4e93664411d9e2a7366e996616fa4b9bc/asmlib-1.0.0.tar.gz" } ], "2.0.0": [ { "comment_text": "", "digests": { "md5": "c77e7e463613d4c521c22bb5fc206ada", "sha256": "38c591168bb06e9b61d08d0c989bb4fce484f51ecdc5985496a944f4e5b649ea" }, "downloads": -1, "filename": "asmlib-2.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "c77e7e463613d4c521c22bb5fc206ada", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 52149, "upload_time": "2019-10-02T09:47:50", "url": "https://files.pythonhosted.org/packages/04/7c/8a6fb776f91273f825b743cdde5fe815e2dcccef4ef84af08ad1c6ff799b/asmlib-2.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c1efe2abe765eed1188b722441430dc3", "sha256": "c0374d0e8d102ff81c6ef33dd0c70c55633342c8452edadb118f971eae7a60a2" }, "downloads": -1, "filename": "asmlib-2.0.0.tar.gz", "has_sig": false, "md5_digest": "c1efe2abe765eed1188b722441430dc3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 39265, "upload_time": "2019-10-02T09:47:51", "url": "https://files.pythonhosted.org/packages/ae/30/d61a0eed8839a2690c715fbf531617b3d55b188aaed413b2b3f90c04579f/asmlib-2.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c77e7e463613d4c521c22bb5fc206ada", "sha256": "38c591168bb06e9b61d08d0c989bb4fce484f51ecdc5985496a944f4e5b649ea" }, "downloads": -1, "filename": "asmlib-2.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "c77e7e463613d4c521c22bb5fc206ada", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 52149, "upload_time": "2019-10-02T09:47:50", "url": "https://files.pythonhosted.org/packages/04/7c/8a6fb776f91273f825b743cdde5fe815e2dcccef4ef84af08ad1c6ff799b/asmlib-2.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c1efe2abe765eed1188b722441430dc3", "sha256": "c0374d0e8d102ff81c6ef33dd0c70c55633342c8452edadb118f971eae7a60a2" }, "downloads": -1, "filename": "asmlib-2.0.0.tar.gz", "has_sig": false, "md5_digest": "c1efe2abe765eed1188b722441430dc3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 39265, "upload_time": "2019-10-02T09:47:51", "url": "https://files.pythonhosted.org/packages/ae/30/d61a0eed8839a2690c715fbf531617b3d55b188aaed413b2b3f90c04579f/asmlib-2.0.0.tar.gz" } ] }