<p align="center">
<p align="center"><img width="238" height="135" src="https://pysimplegui.net/images/logos/psglogofull.svg"><p>
<h2 align="center">psgcompiler</h2>
<h2 align="center">A PySimpleGUI Application</h2>
</p>
PySimpleGUI "Compiler"
"Compile" your Python programs into a Windows EXE, a Mac APP, and a Linux binary!
Adds a user-friendly GUI to the popular PyInstaller python package
<p align="center"><img width="531" height="492" src="screenshot.jpg"><p>
## Features
* Creates single file distribution files for Windows, Mac, and Linux
* PySimpleGUI front end for PyInstaller
* All the capabilities of PyInstaller with the ease of a GUI
## Installation
### Using PIP with PyPI
The latest official release of PySimpleGUI products can be found on PyPI. To pip install the demo applications from PyPI, use this command
#### If you use the command `python` on your computer to invoke Python (Windows):
`python -m pip install --upgrade psgcompiler`
#### If you use the command `python3` on your computer to invoke Python (Linux, Mac):
`python3 -m pip install --upgrade psgcompiler`
### Using PIP with GitHub
You can also pip install the PySimpleGUI Applications that are in the PySimpleGUI GitHub account. The GitHub versions have bug fixes and new programs/features that have not yet been released to PyPI. To directly pip install from that repo:
#### If you use the command `python` on your computer to invoke Python (Windows):
```bash
python -m pip install --upgrade https://github.com/PySimpleGUI/psgcompiler/zipball/main
```
#### If you use the command `python3` on your computer to invoke Python (Linux, Mac):
```bash
python3 -m pip install --upgrade https://github.com/PySimpleGUI/psgcompiler/zipball/main
```
## Usage
Once installed, launch psgcompiler by typing the following in your command line:
`psgcompiler`
## `PyInstaller` Back-end with a `PySimpleGUI` Front-end
The plan for `psgcompiler` is to provide a GUI interface for a number of the tools available to convert a Python program into a binary executable. PyInstaller was chosen as the first back-end tool that does the heavy-lifting of converting your code into a binary executable. The next one being added is `cx_freeze`.
`psgcompiler` collects the options that are assembled into the command that can then be run for you by launching a subprocess. You will see the command being built as you add or remove items using the GUI. You can run PyInstaller manually using the options shown in the "Command" box. Type `pyinstaller` on the command line and paste the text you see under "Command" in the Home tab of the psgcompiler program.
PyInstaller transforms your Python project into an executable that you can distribute to friends, family members, colleagues, the public, other developers, ... Anyone that does not have Python installed on their machine will be able to run your program after you've turned it into a binary executable.
PySimpleGUI users in particular will greatly benefit from `psgcompiler` as you'll be able to distribute "Windows Programs". Most likely no one will know you're using Python. On Windows, you can create a single EXE file. One-file is the default setting. After converting, you'll be left with a single EXE file.
## A Multitude Of Options
`PyInstaller` has a sh*t-ton of options! Unlike the primitive EXE Maker that the PySimpleGUI project created, the `psgcompiler` exposes all of the options in an easy to use way.
## Simple Interface, Complex Settings
While `psgcompiler` makes it easy to specify the many options available for PyInstaller, it doesn't remove the complexity that comes with using PyInstaller.
Please refer to the **[PyInstaller documentation](https://pyinstaller.readthedocs.io/en/stable/)** to better understand the available options. It can be tricky to convert some programs, particularly if you're using other Python packages in addition to PySimpleGUI.
## All Python Programs Welcomed...
Your Python program doesn't have to use PySimpleGUI in order to use the `psgcompiler` tool. PySimpleGUI is being used to give you a GUI front-end to PyInstaller. There is no requirement that your program use PySimpleGUI.
## Troubleshooting PyInstaller Problems
When it comes to PyInstaller use, I'm a user of PyInstaller, just as you are. The PySimpleGUI project isn't populated with PyInstaller experts. You'll need to use your programming prowess to find answers to problems you may encounter using PyInstaller.
We're making it easy for you to run PyInstaller, and soon additional similar utilities, but that doesn't mean it's going to be easy overall.
The PyInstaller documentation is well-written and can be found here:
https://pyinstaller.readthedocs.io/en/stable/
## A Simple EXE
If your program is relatively simple, then you only need to supply the name of your Python file, and an optional icon file.
Here is an example session showing only the .pyw file and the .ico file being supplied.
<p align="center"><p align="center"><img width="607" height="563" src="screenshot.jpg"><p><p>
## Additional Back-ends
Currently in the works is support for additional back-ends. `cx_freeze` is up next.
## Create a Shortcut To This Program
If you're a Windows user, then use the [`psgshortcut` application](https://pypi.org/project/psgshortcut/) to make a shortcut to this program so that you can then put on your desktop or pin to your taskbar (or any other use that stops the need to type `psgcompiler` ever again).
## License & Copyright
Copyright 2023-2024 PySimpleSoft, Inc. and/or its licensors.
This is a free-to-use "Utility" and is licensed under the
PySimpleGUI License Agreement, a copy of which is included in the
license.txt file and also available at https://pysimplegui.com/eula.
Please see Section 1.2 of the license regarding the use of this Utility,
and see https://pysimplegui.com/faq for any questions.
## Contributing
We are happy to receive issues describing bug reports and feature
requests! If your bug report relates to a security vulnerability,
please do not file a public issue, and please instead reach out to us
at issues@PySimpleGUI.com.
We do not accept (and do not wish to receive) contributions of
user-created or third-party code, including patches, pull requests, or
code snippets incorporated into submitted issues. Please do not send
us any such code! Bug reports and feature requests should not include
any source code.
If you nonetheless submit any user-created or third-party code to us,
(1) you assign to us all rights and title in or relating to the code;
and (2) to the extent any such assignment is not fully effective, you
hereby grant to us a royalty-free, perpetual, irrevocable, worldwide,
unlimited, sublicensable, transferrable license under all intellectual
property rights embodied therein or relating thereto, to exploit the
code in any manner we choose, including to incorporate the code into
PySimpleGUI and to redistribute it under any terms at our discretion.
Raw data
{
"_id": null,
"home_page": "https://github.com/PySimpleGUI/psgcompiler",
"name": "psgcompiler",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "GUI UI PySimpleGUI tkinter psgcompiler compile pyinstaller EXE distribute",
"author": "PySimpleSoft Inc.",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/4b/2c/85b826c7739f2ac746056c904a42a65766cac790d8e3d4f555558b12b11a/psgcompiler-5.0.0.tar.gz",
"platform": null,
"description": "<p align=\"center\">\r\n <p align=\"center\"><img width=\"238\" height=\"135\" src=\"https://pysimplegui.net/images/logos/psglogofull.svg\"><p>\r\n\r\n <h2 align=\"center\">psgcompiler</h2>\r\n <h2 align=\"center\">A PySimpleGUI Application</h2>\r\n</p>\r\n\r\nPySimpleGUI \"Compiler\"\r\n\r\n\"Compile\" your Python programs into a Windows EXE, a Mac APP, and a Linux binary!\r\n\r\nAdds a user-friendly GUI to the popular PyInstaller python package\r\n\r\n<p align=\"center\"><img width=\"531\" height=\"492\" src=\"screenshot.jpg\"><p>\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n## Features\r\n\r\n* Creates single file distribution files for Windows, Mac, and Linux\r\n* PySimpleGUI front end for PyInstaller\r\n* All the capabilities of PyInstaller with the ease of a GUI\r\n\r\n\r\n## Installation\r\n\r\n### Using PIP with PyPI\r\n\r\nThe latest official release of PySimpleGUI products can be found on PyPI. To pip install the demo applications from PyPI, use this command\r\n\r\n#### If you use the command `python` on your computer to invoke Python (Windows):\r\n\r\n`python -m pip install --upgrade psgcompiler`\r\n\r\n#### If you use the command `python3` on your computer to invoke Python (Linux, Mac):\r\n\r\n`python3 -m pip install --upgrade psgcompiler`\r\n\r\n### Using PIP with GitHub\r\n\r\nYou can also pip install the PySimpleGUI Applications that are in the PySimpleGUI GitHub account. The GitHub versions have bug fixes and new programs/features that have not yet been released to PyPI. To directly pip install from that repo:\r\n\r\n#### If you use the command `python` on your computer to invoke Python (Windows):\r\n\r\n```bash\r\npython -m pip install --upgrade https://github.com/PySimpleGUI/psgcompiler/zipball/main\r\n```\r\n\r\n#### If you use the command `python3` on your computer to invoke Python (Linux, Mac):\r\n\r\n```bash\r\npython3 -m pip install --upgrade https://github.com/PySimpleGUI/psgcompiler/zipball/main\r\n```\r\n\r\n\r\n## Usage\r\n\r\nOnce installed, launch psgcompiler by typing the following in your command line:\r\n\r\n`psgcompiler`\r\n\r\n## `PyInstaller` Back-end with a `PySimpleGUI` Front-end\r\n\r\nThe plan for `psgcompiler` is to provide a GUI interface for a number of the tools available to convert a Python program into a binary executable. PyInstaller was chosen as the first back-end tool that does the heavy-lifting of converting your code into a binary executable. The next one being added is `cx_freeze`.\r\n\r\n`psgcompiler` collects the options that are assembled into the command that can then be run for you by launching a subprocess. You will see the command being built as you add or remove items using the GUI. You can run PyInstaller manually using the options shown in the \"Command\" box. Type `pyinstaller` on the command line and paste the text you see under \"Command\" in the Home tab of the psgcompiler program. \r\n\r\n\r\nPyInstaller transforms your Python project into an executable that you can distribute to friends, family members, colleagues, the public, other developers, ... Anyone that does not have Python installed on their machine will be able to run your program after you've turned it into a binary executable.\r\n\r\nPySimpleGUI users in particular will greatly benefit from `psgcompiler` as you'll be able to distribute \"Windows Programs\". Most likely no one will know you're using Python. On Windows, you can create a single EXE file. One-file is the default setting. After converting, you'll be left with a single EXE file.\r\n\r\n## A Multitude Of Options\r\n\r\n`PyInstaller` has a sh*t-ton of options! Unlike the primitive EXE Maker that the PySimpleGUI project created, the `psgcompiler` exposes all of the options in an easy to use way.\r\n\r\n## Simple Interface, Complex Settings\r\n\r\nWhile `psgcompiler` makes it easy to specify the many options available for PyInstaller, it doesn't remove the complexity that comes with using PyInstaller.\r\n\r\nPlease refer to the **[PyInstaller documentation](https://pyinstaller.readthedocs.io/en/stable/)** to better understand the available options. It can be tricky to convert some programs, particularly if you're using other Python packages in addition to PySimpleGUI.\r\n\r\n## All Python Programs Welcomed...\r\n\r\nYour Python program doesn't have to use PySimpleGUI in order to use the `psgcompiler` tool. PySimpleGUI is being used to give you a GUI front-end to PyInstaller. There is no requirement that your program use PySimpleGUI.\r\n\r\n\r\n## Troubleshooting PyInstaller Problems\r\n\r\nWhen it comes to PyInstaller use, I'm a user of PyInstaller, just as you are. The PySimpleGUI project isn't populated with PyInstaller experts. You'll need to use your programming prowess to find answers to problems you may encounter using PyInstaller.\r\n\r\nWe're making it easy for you to run PyInstaller, and soon additional similar utilities, but that doesn't mean it's going to be easy overall.\r\n\r\nThe PyInstaller documentation is well-written and can be found here: \r\nhttps://pyinstaller.readthedocs.io/en/stable/\r\n\r\n## A Simple EXE\r\n\r\nIf your program is relatively simple, then you only need to supply the name of your Python file, and an optional icon file.\r\n\r\nHere is an example session showing only the .pyw file and the .ico file being supplied. \r\n\r\n\r\n<p align=\"center\"><p align=\"center\"><img width=\"607\" height=\"563\" src=\"screenshot.jpg\"><p><p>\r\n\r\n\r\n## Additional Back-ends\r\n\r\nCurrently in the works is support for additional back-ends. `cx_freeze` is up next.\r\n\r\n## Create a Shortcut To This Program\r\n\r\nIf you're a Windows user, then use the [`psgshortcut` application](https://pypi.org/project/psgshortcut/) to make a shortcut to this program so that you can then put on your desktop or pin to your taskbar (or any other use that stops the need to type `psgcompiler` ever again).\r\n\r\n## License & Copyright\r\n\r\nCopyright 2023-2024 PySimpleSoft, Inc. and/or its licensors.\r\n\r\nThis is a free-to-use \"Utility\" and is licensed under the\r\nPySimpleGUI License Agreement, a copy of which is included in the\r\nlicense.txt file and also available at https://pysimplegui.com/eula.\r\n\r\nPlease see Section 1.2 of the license regarding the use of this Utility,\r\nand see https://pysimplegui.com/faq for any questions.\r\n\r\n\r\n## Contributing\r\n\r\nWe are happy to receive issues describing bug reports and feature\r\nrequests! If your bug report relates to a security vulnerability,\r\nplease do not file a public issue, and please instead reach out to us\r\nat issues@PySimpleGUI.com.\r\n\r\nWe do not accept (and do not wish to receive) contributions of\r\nuser-created or third-party code, including patches, pull requests, or\r\ncode snippets incorporated into submitted issues. Please do not send\r\nus any such code! Bug reports and feature requests should not include\r\nany source code.\r\n\r\nIf you nonetheless submit any user-created or third-party code to us,\r\n(1) you assign to us all rights and title in or relating to the code;\r\nand (2) to the extent any such assignment is not fully effective, you\r\nhereby grant to us a royalty-free, perpetual, irrevocable, worldwide,\r\nunlimited, sublicensable, transferrable license under all intellectual\r\nproperty rights embodied therein or relating thereto, to exploit the\r\ncode in any manner we choose, including to incorporate the code into\r\nPySimpleGUI and to redistribute it under any terms at our discretion.\r\n",
"bugtrack_url": null,
"license": "Free To Use But Restricted",
"summary": "A simple, easy to use tool that is a front-end to PyInstaller created with PySimpleGUI to convert your Python programs to executables.",
"version": "5.0.0",
"project_urls": {
"Homepage": "https://github.com/PySimpleGUI/psgcompiler"
},
"split_keywords": [
"gui",
"ui",
"pysimplegui",
"tkinter",
"psgcompiler",
"compile",
"pyinstaller",
"exe",
"distribute"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a260b5823c0daa6ae144333af48317dc93a445e3ed15b08ef08924a20086934d",
"md5": "3dfcfee3171ba974cd8272d67e51314e",
"sha256": "b6298aafbb6dc3fea3f337961d162af4c25234ed4abc7adf348bc701814dd834"
},
"downloads": -1,
"filename": "psgcompiler-5.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3dfcfee3171ba974cd8272d67e51314e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 131504,
"upload_time": "2024-02-26T14:48:42",
"upload_time_iso_8601": "2024-02-26T14:48:42.272441Z",
"url": "https://files.pythonhosted.org/packages/a2/60/b5823c0daa6ae144333af48317dc93a445e3ed15b08ef08924a20086934d/psgcompiler-5.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4b2c85b826c7739f2ac746056c904a42a65766cac790d8e3d4f555558b12b11a",
"md5": "d13a9c68db39479fc82bec1128317635",
"sha256": "a1d2dff4c7b31b899c3e9be3e0e9f4a378a976046bf8e4463cc9caafeaa75236"
},
"downloads": -1,
"filename": "psgcompiler-5.0.0.tar.gz",
"has_sig": false,
"md5_digest": "d13a9c68db39479fc82bec1128317635",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 134176,
"upload_time": "2024-02-26T14:48:44",
"upload_time_iso_8601": "2024-02-26T14:48:44.033934Z",
"url": "https://files.pythonhosted.org/packages/4b/2c/85b826c7739f2ac746056c904a42a65766cac790d8e3d4f555558b12b11a/psgcompiler-5.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-26 14:48:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PySimpleGUI",
"github_project": "psgcompiler",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "psgcompiler"
}
JSON
