[](https://github.com/boriel/zxbasic/actions)
[](./LICENSE.txt)
[](https://pypi.python.org/pypi/zxbasic)
ZX BASIC
--------
Copyleft (K) 2008, Jose Rodriguez-Rosa (a.k.a. Boriel) <http://www.boriel.com>
All files in this project are covered under the [GPLv3 LICENSE](http://www.gnu.org/licenses/gpl.html)
except those placed in directories `library/` and `library-asm`.
Those are licensed under [MIT license](https://en.wikipedia.org/wiki/MIT_License) unless otherwise
specified in the files themselves (i.e. a different license). Anyway, all of
the licenses for files under those directories allow binary closed-source
(i.e. commercial) distribution of the files created with this compiler.
You can create closed-source programs (even commercial ones) with this compiler
(a mention to this tool will be welcome, though). But you are not allowed to
release the compiler itself as a closed source program.
If you modify *this* project (the compiler .py or anything licensed as GPLv3)
in any way you MUST publish the changes you made and submit your contribution
to the community under the same license.
-------------------------
DOCUMENTATION
-------------
This is a very little help file.
- For DOCUMENTATION in English go to the [ZX BASIC docs](https://zxbasic.readthedocs.io/en/latest/).
- For help, support, updates meet the community at the [forum](https://www.boriel.com/forum).
INSTALLATION
------------
Go to the [ZXBasic download page](https://zxbasic.readthedocs.io/en/latest/archive/)
and get the version most suitable for you.
There are, basically, two flavors (both with identical capabilities):
- For Windows you can download de win32 executable (Windows .exe zip package) version.
To install just uncompress it in a directory of your choice.
The main executable is `zxbc.exe` (more on this later). With this toolchain
also comes `zxbasm.exe` (the assembler) and `zxbpp.exe` (the preprocessor), but these
are not needed when programming in BASIC.
- For Linux and Mac OSX there is a python version, so you will need a python
interpreter (available on many platforms, and usually already installed in Linux and Mac OSX).
Just uncompress it in a directory of your choice and installation is done. :-)
The main executables are `zxbc.py` (the compiler), `zxbasm.py` (the assembler) and `zxbpp.py` (the preprocessor).
You can use this version in Windows, but will need to install a python interpreter first.
##### Examples
||||
|---|---|---|
| An in-game screenshot of Eleuterio by @*na_th_an* | Ingame screenshot of _El Hobbit_ by @*Wilco2000*| Ingame screenshot of _Knignt and Demonds DX_ by Einar Saukas
See more examples at the [Relased Programs](https://zxbasic.readthedocs.io/en/latest/released_programs/) page.
QUICK START
-----------
For a quick start, just open a terminal in your PC in the same directory you uncompressed ZX Basic
and type `zxbc` (on Windows) or `zxbc.py` (OSX, Linux). You should see a zxbasic message like this:
```
usage: zxbc [-h] [-d] [-O OPTIMIZE] [-o OUTPUT_FILE] [-T] [-t] [-B] [-a] [-A]
[-S ORG] [-e STDERR] [--array-base ARRAY_BASE]
[--string-base STRING_BASE] [-Z] [-H HEAP_SIZE]
[--heap-adddress HEAP_ADDRESS] [--debug-memory]
[--debug-array] [--strict-bool] [--enable-break] [-E] [--explicit]
[-D DEFINES] [-M MEMORY_MAP] [-i] [-I INCLUDE_PATH] [--strict]
[--version]
PROGRAM
zxbc: error: the following arguments are required: PROGRAM
```
Create a text file with the following content:
~~~~
10 CLS
20 PRINT "HELLO WORLD!"
~~~~
Save it as `hello.bas` and finally compile it with:
~~~~
zxbc -taB hello.bas
~~~~
If everything went well, a file named `hello.tap` should be created.
Open it with your favourite emulator (i.e. fuse) and see the result.
Congratulations! You're now ready to create compiled BASIC programs for
your machine. Check and compile the examples included in the examples/ folder
or go to the [documentation page](https://zxbasic.readthedocs.io/en/latest/) for further info.
ACKNOWLEDGEMENTS
---------------
These are some people who has contributed in a way or another. I consider
some of them co-authors (Britlion, LCD, em00k, ...) of this project.
Also, many thanks to people supporting this project with their donations!
------
[](https://ko-fi.com/boriel)
Raw data
{
"_id": null,
"home_page": "http://zxbasic.net",
"name": "zxbasic",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "compiler,zxspectrum,BASIC,z80",
"author": "Jose Rodriguez",
"author_email": "boriel@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4c/98/b4ea0cb827c56513000556b833c75b36c3e8a4d5077bc74384a9a696efb4/zxbasic-1.17.1.post1.tar.gz",
"platform": null,
"description": "\n\n[](https://github.com/boriel/zxbasic/actions)\n[](./LICENSE.txt)\n[](https://pypi.python.org/pypi/zxbasic)\n\nZX BASIC\n--------\n\nCopyleft (K) 2008, Jose Rodriguez-Rosa (a.k.a. Boriel) <http://www.boriel.com>\n\nAll files in this project are covered under the [GPLv3 LICENSE](http://www.gnu.org/licenses/gpl.html)\nexcept those placed in directories `library/` and `library-asm`.\nThose are licensed under [MIT license](https://en.wikipedia.org/wiki/MIT_License) unless otherwise\nspecified in the files themselves (i.e. a different license). Anyway, all of\nthe licenses for files under those directories allow binary closed-source\n(i.e. commercial) distribution of the files created with this compiler.\n\nYou can create closed-source programs (even commercial ones) with this compiler\n(a mention to this tool will be welcome, though). But you are not allowed to\nrelease the compiler itself as a closed source program.\n\nIf you modify *this* project (the compiler .py or anything licensed as GPLv3)\nin any way you MUST publish the changes you made and submit your contribution\nto the community under the same license.\n\n-------------------------\n\nDOCUMENTATION\n-------------\n\nThis is a very little help file.\n\n - For DOCUMENTATION in English go to the [ZX BASIC docs](https://zxbasic.readthedocs.io/en/latest/).\n\n - For help, support, updates meet the community at the [forum](https://www.boriel.com/forum).\n\n\nINSTALLATION\n------------\n\nGo to the [ZXBasic download page](https://zxbasic.readthedocs.io/en/latest/archive/)\nand get the version most suitable for you.\n\nThere are, basically, two flavors (both with identical capabilities):\n\n - For Windows you can download de win32 executable (Windows .exe zip package) version.\nTo install just uncompress it in a directory of your choice.\nThe main executable is `zxbc.exe` (more on this later). With this toolchain\nalso comes `zxbasm.exe` (the assembler) and `zxbpp.exe` (the preprocessor), but these\nare not needed when programming in BASIC.\n\n - For Linux and Mac OSX there is a python version, so you will need a python\ninterpreter (available on many platforms, and usually already installed in Linux and Mac OSX).\nJust uncompress it in a directory of your choice and installation is done. :-)\nThe main executables are `zxbc.py` (the compiler), `zxbasm.py` (the assembler) and `zxbpp.py` (the preprocessor).\nYou can use this version in Windows, but will need to install a python interpreter first.\n\n##### Examples\n\n\n||||\n|---|---|---|\n| An in-game screenshot of Eleuterio by @*na_th_an* | Ingame screenshot of _El Hobbit_ by @*Wilco2000*| Ingame screenshot of _Knignt and Demonds DX_ by Einar Saukas\n\nSee more examples at the [Relased Programs](https://zxbasic.readthedocs.io/en/latest/released_programs/) page.\n\nQUICK START\n-----------\n\nFor a quick start, just open a terminal in your PC in the same directory you uncompressed ZX Basic\nand type `zxbc` (on Windows) or `zxbc.py` (OSX, Linux). You should see a zxbasic message like this:\n\n```\nusage: zxbc [-h] [-d] [-O OPTIMIZE] [-o OUTPUT_FILE] [-T] [-t] [-B] [-a] [-A]\n [-S ORG] [-e STDERR] [--array-base ARRAY_BASE]\n [--string-base STRING_BASE] [-Z] [-H HEAP_SIZE]\n [--heap-adddress HEAP_ADDRESS] [--debug-memory]\n [--debug-array] [--strict-bool] [--enable-break] [-E] [--explicit]\n [-D DEFINES] [-M MEMORY_MAP] [-i] [-I INCLUDE_PATH] [--strict]\n [--version]\n PROGRAM\nzxbc: error: the following arguments are required: PROGRAM\n```\n\nCreate a text file with the following content:\n\n~~~~\n10 CLS\n20 PRINT \"HELLO WORLD!\"\n~~~~\n\nSave it as `hello.bas` and finally compile it with:\n~~~~\nzxbc -taB hello.bas\n~~~~\n\nIf everything went well, a file named `hello.tap` should be created.\nOpen it with your favourite emulator (i.e. fuse) and see the result.\n\nCongratulations! You're now ready to create compiled BASIC programs for\nyour machine. Check and compile the examples included in the examples/ folder\nor go to the [documentation page](https://zxbasic.readthedocs.io/en/latest/) for further info.\n\nACKNOWLEDGEMENTS\n---------------\n\nThese are some people who has contributed in a way or another. I consider\nsome of them co-authors (Britlion, LCD, em00k, ...) of this project.\n\nAlso, many thanks to people supporting this project with their donations!\n\n------\n[](https://ko-fi.com/boriel)\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "Boriel's ZX BASIC Compiler",
"version": "1.17.1.post1",
"project_urls": {
"Documentation": "https://zxbasic.readthedocs.io",
"Homepage": "http://zxbasic.net",
"Repository": "https://github.com/boriel/zxbasic"
},
"split_keywords": [
"compiler",
"zxspectrum",
"basic",
"z80"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c9d7efb5fdbaafcac91da9bbef42150be49a7fee0bfb96d7e2bd2cbb83064072",
"md5": "a8681d578911760c36b51d623ca32f3b",
"sha256": "c90119b57f022d2b8dd760881151cada1b83549d72e5a6116b0447f7a10db429"
},
"downloads": -1,
"filename": "zxbasic-1.17.1.post1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a8681d578911760c36b51d623ca32f3b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 936290,
"upload_time": "2023-10-10T21:43:56",
"upload_time_iso_8601": "2023-10-10T21:43:56.813310Z",
"url": "https://files.pythonhosted.org/packages/c9/d7/efb5fdbaafcac91da9bbef42150be49a7fee0bfb96d7e2bd2cbb83064072/zxbasic-1.17.1.post1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4c98b4ea0cb827c56513000556b833c75b36c3e8a4d5077bc74384a9a696efb4",
"md5": "c2ec5587a9f1441d5d88734052872a7b",
"sha256": "0a730e547b22d08f976b97c9d526c6b3a06c503ad59b306ff7781886062eca17"
},
"downloads": -1,
"filename": "zxbasic-1.17.1.post1.tar.gz",
"has_sig": false,
"md5_digest": "c2ec5587a9f1441d5d88734052872a7b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 726236,
"upload_time": "2023-10-10T21:43:58",
"upload_time_iso_8601": "2023-10-10T21:43:58.580652Z",
"url": "https://files.pythonhosted.org/packages/4c/98/b4ea0cb827c56513000556b833c75b36c3e8a4d5077bc74384a9a696efb4/zxbasic-1.17.1.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-10 21:43:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "boriel",
"github_project": "zxbasic",
"travis_ci": true,
"coveralls": true,
"github_actions": true,
"lcname": "zxbasic"
}
JSON
