diff options
| author | CoprDistGit <infra@openeuler.org> | 2023-06-20 05:17:50 +0000 |
|---|---|---|
| committer | CoprDistGit <infra@openeuler.org> | 2023-06-20 05:17:50 +0000 |
| commit | 32799e6189fdc3d780aef555bcdd56c968896153 (patch) | |
| tree | b2a0d008aee9eeb34650754eaacbe5b4620f76bb /python-pyntel4004.spec | |
| parent | 55e3c36eda26579e2b5d3c72e44c71d009c09031 (diff) | |
automatic import of python-Pyntel4004openeuler20.03
Diffstat (limited to 'python-pyntel4004.spec')
| -rw-r--r-- | python-pyntel4004.spec | 531 |
1 files changed, 531 insertions, 0 deletions
diff --git a/python-pyntel4004.spec b/python-pyntel4004.spec new file mode 100644 index 0000000..adea135 --- /dev/null +++ b/python-pyntel4004.spec @@ -0,0 +1,531 @@ +%global _empty_manifest_terminate_build 0 +Name: python-Pyntel4004 +Version: 1.2 +Release: 1 +Summary: A Python software implementation of the Intel 4004 processor. +License: MIT License +URL: https://github.com/alshapton/Pyntel4004 +Source0: https://mirrors.aliyun.com/pypi/web/packages/fe/a9/0903f4af1b74574813d5caacc5181733bed1d8c6a58c92cc870d1ab4963b/Pyntel4004-1.2.tar.gz +BuildArch: noarch + + +%description +# Pyntel4004 + + + +[](https://github.com/alshapton/Pyntel4004/actions/workflows/build-pipeline.yml) +[](https://pyntel4004.readthedocs.io/en/latest/?badge=latest) + +[](https://badge.fury.io/py/Pyntel4004) + +[](https://plant.treeware.earth/alshapton/pyntel4004) + +[](https://sonarcloud.io/summary/new_code?id=alshapton_Pyntel4004) + +A Python software implementation of the Intel 4004 processor and the MCS-4 computer. + +## General Information + +- Two pass assembler using the original mnemonics, directives and comments syntax +- Disassembler +- Monitor facility to step through code and examine registers, memory etc +- Cross-assembler for Retroshield 4004 Arduino + +## Requirements + +* Python >= 3.8.2 + +<br> + +## Installation Instructions +<br> + +### PyPI + +Pyntel4004 can be installed from PyPI by using the command: + +```bash + + $ pip install Pyntel4004 +``` + +### Source Code +Pyntel4004’s git repo is available on GitHub, which can be browsed [here](https://github.com/alshapton/pyntel4004) and cloned using: + +```bash + + $ git clone https://github.com/alshapton/pyntel4004 pyntel4004 +``` + +Verify the installation by running unit tests: +```bash + + $ cd pyntel4004/test + $ pytest +``` +## Questions, Answers and Issues + +Please use the github discussion board for questions, to ensure the right people see them in a timely manner. + +[Github Pyntel4004 Discussion Board](https://github.com/alshapton/Pyntel4004/discussions) + +and the github issue tracker to raise any issues. + +[Github Pyntel4004 Issues Board](https://github.com/alshapton/Pyntel4004/issues) + +<br> + +## Usage Instructions + +To use this software implementation of the Intel 4004 from the command line, you should install the [Pyntel4004-cli](https://pypi.org/project/Pyntel4004-cli/) using +` +pip install pyntel4004-cli +` + +The user instructions can be found [here](https://pyntel4004.readthedocs.io/en/latest/intro/usage.html +) + +## Design goals + +- As much of the internals as possible should be carried out using binary arithmetic and operations. +- No 3rd party libraries to be used (i.e. pure Python). +- Build a fully-working i4004 opcode emulator. +- Build a fully-working assembler which generates correct op-codes. +- Construct a fully-working software-based i4004 chip which can use the generated object code from the assembler. +- Enable code assembled with Pyntel4004 to be run on a real i4004 chipset +- Enable code assembled with Pyntel4004 to be run on a retroShield4004 for Arduino + +## Status + +22-MAY-2022 First release of configuration file support +20-MAR-2022: Command Line functionality is now deprecated +02-MAR-2022: Finalised split - Pyntel4004 is now the core library +21-FEB-2022: Started to split into two - (chip, assembler, dissassembler) and CLI +04-FEB-2022: Cross-assemble to retroShield4004 for Arduino, completing documentation +23-SEP-2021: Publishing releases to [PyPi](https://pypi.org/project/Pyntel4004/) +<br> +10-SEP-2021: Documentation building and hosted with [READTHEDOCS](https://pyntel4004.readthedocs.io/en/latest/) +<br> +12-JUN-2021: Auto-build with GITHUB Actions implemented +<br> +18-MAY-2021: Implementing full test suite +<br> +21-APR-2021: Instruction Set functionally complete + Entering Testing Phase + +## Example + +### Assembler Directives and other additions + +Assembler directives are not part of the program itself, but can control things like starting address, and various environmental settings. + +| Directive | Example | Meaning | +| :-:| :-:| :-| +| end | end | Indicating end of program, but not necessarily end of code | +| org | org 100 | Assemble and place object code commencing at address 100 | +| pin | pin 1 | Value of i4004's Pin 10 (test pin) | +| / | / Author: ALS | A comment | +| label,| loop,| A label can be referred to in various control transfer statements. It MUST end in a comma (,) + + + +## Monitor Commands + +| Command | Example | Meaning | +| :-:| :-:| :-| +| "Enter" | "Enter" | Execute the current instruction and move to the next | +| acc | acc | Show the current contents of the Accumulator | +| b *n* | b 71 | Create a breakpoint at address *n* | +| carry | carry | Show the current contents of the Carry Bit | +| crb | crb | Show the currently selected RAM Bank | +| off | off | Continue to execute the program with no trace | +| pc | pc | Show the Program Counter | +| pin10 | pin10 | Show the status of PIN10 on the i4004 chip (test pin) +| q | q | Quit the monitor without executing any further commands | +| ram | ram | Show the complete contents of RAM | +| reg *n* | reg 7 | Show content of a specified register | +| regs | regs | Show all 16 registers | +| rom | rom | Show the complete contents of ROM | +| stack | stack | Show the stack and the location of the stack pointer | + + +## Licence + +This package is [Treeware](https://treeware.earth). If you use it in production, then we ask that you [**buy the world a tree**](https://plant.treeware.earth/alshapton/Pyntel4004) to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats. + +### Credits + +- Intel 4004 Design Team +- Logo: [LouBeLou Print Shop](http://www.psloubelou.com) + + + + +.. _Python: https://www.python.org + + +%package -n python3-Pyntel4004 +Summary: A Python software implementation of the Intel 4004 processor. +Provides: python-Pyntel4004 +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-Pyntel4004 +# Pyntel4004 + + + +[](https://github.com/alshapton/Pyntel4004/actions/workflows/build-pipeline.yml) +[](https://pyntel4004.readthedocs.io/en/latest/?badge=latest) + +[](https://badge.fury.io/py/Pyntel4004) + +[](https://plant.treeware.earth/alshapton/pyntel4004) + +[](https://sonarcloud.io/summary/new_code?id=alshapton_Pyntel4004) + +A Python software implementation of the Intel 4004 processor and the MCS-4 computer. + +## General Information + +- Two pass assembler using the original mnemonics, directives and comments syntax +- Disassembler +- Monitor facility to step through code and examine registers, memory etc +- Cross-assembler for Retroshield 4004 Arduino + +## Requirements + +* Python >= 3.8.2 + +<br> + +## Installation Instructions +<br> + +### PyPI + +Pyntel4004 can be installed from PyPI by using the command: + +```bash + + $ pip install Pyntel4004 +``` + +### Source Code +Pyntel4004’s git repo is available on GitHub, which can be browsed [here](https://github.com/alshapton/pyntel4004) and cloned using: + +```bash + + $ git clone https://github.com/alshapton/pyntel4004 pyntel4004 +``` + +Verify the installation by running unit tests: +```bash + + $ cd pyntel4004/test + $ pytest +``` +## Questions, Answers and Issues + +Please use the github discussion board for questions, to ensure the right people see them in a timely manner. + +[Github Pyntel4004 Discussion Board](https://github.com/alshapton/Pyntel4004/discussions) + +and the github issue tracker to raise any issues. + +[Github Pyntel4004 Issues Board](https://github.com/alshapton/Pyntel4004/issues) + +<br> + +## Usage Instructions + +To use this software implementation of the Intel 4004 from the command line, you should install the [Pyntel4004-cli](https://pypi.org/project/Pyntel4004-cli/) using +` +pip install pyntel4004-cli +` + +The user instructions can be found [here](https://pyntel4004.readthedocs.io/en/latest/intro/usage.html +) + +## Design goals + +- As much of the internals as possible should be carried out using binary arithmetic and operations. +- No 3rd party libraries to be used (i.e. pure Python). +- Build a fully-working i4004 opcode emulator. +- Build a fully-working assembler which generates correct op-codes. +- Construct a fully-working software-based i4004 chip which can use the generated object code from the assembler. +- Enable code assembled with Pyntel4004 to be run on a real i4004 chipset +- Enable code assembled with Pyntel4004 to be run on a retroShield4004 for Arduino + +## Status + +22-MAY-2022 First release of configuration file support +20-MAR-2022: Command Line functionality is now deprecated +02-MAR-2022: Finalised split - Pyntel4004 is now the core library +21-FEB-2022: Started to split into two - (chip, assembler, dissassembler) and CLI +04-FEB-2022: Cross-assemble to retroShield4004 for Arduino, completing documentation +23-SEP-2021: Publishing releases to [PyPi](https://pypi.org/project/Pyntel4004/) +<br> +10-SEP-2021: Documentation building and hosted with [READTHEDOCS](https://pyntel4004.readthedocs.io/en/latest/) +<br> +12-JUN-2021: Auto-build with GITHUB Actions implemented +<br> +18-MAY-2021: Implementing full test suite +<br> +21-APR-2021: Instruction Set functionally complete + Entering Testing Phase + +## Example + +### Assembler Directives and other additions + +Assembler directives are not part of the program itself, but can control things like starting address, and various environmental settings. + +| Directive | Example | Meaning | +| :-:| :-:| :-| +| end | end | Indicating end of program, but not necessarily end of code | +| org | org 100 | Assemble and place object code commencing at address 100 | +| pin | pin 1 | Value of i4004's Pin 10 (test pin) | +| / | / Author: ALS | A comment | +| label,| loop,| A label can be referred to in various control transfer statements. It MUST end in a comma (,) + + + +## Monitor Commands + +| Command | Example | Meaning | +| :-:| :-:| :-| +| "Enter" | "Enter" | Execute the current instruction and move to the next | +| acc | acc | Show the current contents of the Accumulator | +| b *n* | b 71 | Create a breakpoint at address *n* | +| carry | carry | Show the current contents of the Carry Bit | +| crb | crb | Show the currently selected RAM Bank | +| off | off | Continue to execute the program with no trace | +| pc | pc | Show the Program Counter | +| pin10 | pin10 | Show the status of PIN10 on the i4004 chip (test pin) +| q | q | Quit the monitor without executing any further commands | +| ram | ram | Show the complete contents of RAM | +| reg *n* | reg 7 | Show content of a specified register | +| regs | regs | Show all 16 registers | +| rom | rom | Show the complete contents of ROM | +| stack | stack | Show the stack and the location of the stack pointer | + + +## Licence + +This package is [Treeware](https://treeware.earth). If you use it in production, then we ask that you [**buy the world a tree**](https://plant.treeware.earth/alshapton/Pyntel4004) to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats. + +### Credits + +- Intel 4004 Design Team +- Logo: [LouBeLou Print Shop](http://www.psloubelou.com) + + + + +.. _Python: https://www.python.org + + +%package help +Summary: Development documents and examples for Pyntel4004 +Provides: python3-Pyntel4004-doc +%description help +# Pyntel4004 + + + +[](https://github.com/alshapton/Pyntel4004/actions/workflows/build-pipeline.yml) +[](https://pyntel4004.readthedocs.io/en/latest/?badge=latest) + +[](https://badge.fury.io/py/Pyntel4004) + +[](https://plant.treeware.earth/alshapton/pyntel4004) + +[](https://sonarcloud.io/summary/new_code?id=alshapton_Pyntel4004) + +A Python software implementation of the Intel 4004 processor and the MCS-4 computer. + +## General Information + +- Two pass assembler using the original mnemonics, directives and comments syntax +- Disassembler +- Monitor facility to step through code and examine registers, memory etc +- Cross-assembler for Retroshield 4004 Arduino + +## Requirements + +* Python >= 3.8.2 + +<br> + +## Installation Instructions +<br> + +### PyPI + +Pyntel4004 can be installed from PyPI by using the command: + +```bash + + $ pip install Pyntel4004 +``` + +### Source Code +Pyntel4004’s git repo is available on GitHub, which can be browsed [here](https://github.com/alshapton/pyntel4004) and cloned using: + +```bash + + $ git clone https://github.com/alshapton/pyntel4004 pyntel4004 +``` + +Verify the installation by running unit tests: +```bash + + $ cd pyntel4004/test + $ pytest +``` +## Questions, Answers and Issues + +Please use the github discussion board for questions, to ensure the right people see them in a timely manner. + +[Github Pyntel4004 Discussion Board](https://github.com/alshapton/Pyntel4004/discussions) + +and the github issue tracker to raise any issues. + +[Github Pyntel4004 Issues Board](https://github.com/alshapton/Pyntel4004/issues) + +<br> + +## Usage Instructions + +To use this software implementation of the Intel 4004 from the command line, you should install the [Pyntel4004-cli](https://pypi.org/project/Pyntel4004-cli/) using +` +pip install pyntel4004-cli +` + +The user instructions can be found [here](https://pyntel4004.readthedocs.io/en/latest/intro/usage.html +) + +## Design goals + +- As much of the internals as possible should be carried out using binary arithmetic and operations. +- No 3rd party libraries to be used (i.e. pure Python). +- Build a fully-working i4004 opcode emulator. +- Build a fully-working assembler which generates correct op-codes. +- Construct a fully-working software-based i4004 chip which can use the generated object code from the assembler. +- Enable code assembled with Pyntel4004 to be run on a real i4004 chipset +- Enable code assembled with Pyntel4004 to be run on a retroShield4004 for Arduino + +## Status + +22-MAY-2022 First release of configuration file support +20-MAR-2022: Command Line functionality is now deprecated +02-MAR-2022: Finalised split - Pyntel4004 is now the core library +21-FEB-2022: Started to split into two - (chip, assembler, dissassembler) and CLI +04-FEB-2022: Cross-assemble to retroShield4004 for Arduino, completing documentation +23-SEP-2021: Publishing releases to [PyPi](https://pypi.org/project/Pyntel4004/) +<br> +10-SEP-2021: Documentation building and hosted with [READTHEDOCS](https://pyntel4004.readthedocs.io/en/latest/) +<br> +12-JUN-2021: Auto-build with GITHUB Actions implemented +<br> +18-MAY-2021: Implementing full test suite +<br> +21-APR-2021: Instruction Set functionally complete + Entering Testing Phase + +## Example + +### Assembler Directives and other additions + +Assembler directives are not part of the program itself, but can control things like starting address, and various environmental settings. + +| Directive | Example | Meaning | +| :-:| :-:| :-| +| end | end | Indicating end of program, but not necessarily end of code | +| org | org 100 | Assemble and place object code commencing at address 100 | +| pin | pin 1 | Value of i4004's Pin 10 (test pin) | +| / | / Author: ALS | A comment | +| label,| loop,| A label can be referred to in various control transfer statements. It MUST end in a comma (,) + + + +## Monitor Commands + +| Command | Example | Meaning | +| :-:| :-:| :-| +| "Enter" | "Enter" | Execute the current instruction and move to the next | +| acc | acc | Show the current contents of the Accumulator | +| b *n* | b 71 | Create a breakpoint at address *n* | +| carry | carry | Show the current contents of the Carry Bit | +| crb | crb | Show the currently selected RAM Bank | +| off | off | Continue to execute the program with no trace | +| pc | pc | Show the Program Counter | +| pin10 | pin10 | Show the status of PIN10 on the i4004 chip (test pin) +| q | q | Quit the monitor without executing any further commands | +| ram | ram | Show the complete contents of RAM | +| reg *n* | reg 7 | Show content of a specified register | +| regs | regs | Show all 16 registers | +| rom | rom | Show the complete contents of ROM | +| stack | stack | Show the stack and the location of the stack pointer | + + +## Licence + +This package is [Treeware](https://treeware.earth). If you use it in production, then we ask that you [**buy the world a tree**](https://plant.treeware.earth/alshapton/Pyntel4004) to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats. + +### Credits + +- Intel 4004 Design Team +- Logo: [LouBeLou Print Shop](http://www.psloubelou.com) + + + + +.. _Python: https://www.python.org + + +%prep +%autosetup -n Pyntel4004-1.2 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-Pyntel4004 -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Tue Jun 20 2023 Python_Bot <Python_Bot@openeuler.org> - 1.2-1 +- Package Spec generated |