MwlareBuilder Overview
====================
.. image:: https://img.shields.io/pypi/v/mwlarebuilder
:alt: PyPI
:target: https://pypi.org/project/mwlarebuilder
.. image:: https://img.shields.io/pypi/pyversions/mwlarebuilder
:alt: PyPI - Python Version
:target: https://pypi.org/project/mwlarebuilder
.. image:: https://img.shields.io/readthedocs/mwlarebuilder/stable
:alt: Read the Docs (version)
:target: https://mwlarebuilder.org
.. image:: https://img.shields.io/pypi/dm/mwlarebuilder
:alt: PyPI - Downloads
:target: https://pypistats.org/packages/mwlarebuilder
MwlareBuilder bundles a Python application and all its dependencies into a single
package. The user can run the packaged app without installing a Python
interpreter or any modules.
:Documentation: https://mwlarebuilder.org/
:Code: https://github.com/mwlarebuilder/mwlarebuilder
MwlareBuilder reads a Python script written by you. It analyzes your code
to discover every other module and library your script needs in order to
execute. Then it collects copies of all those files -- including the active
Python interpreter! -- and puts them with your script in a single folder, or
optionally in a single executable file.
MwlareBuilder is tested against Windows, macOS, and GNU/Linux.
However, it is not a cross-compiler:
to make a Windows app you run MwlareBuilder in Windows; to make
a GNU/Linux app you run it in GNU/Linux, etc.
MwlareBuilder has been used successfully
with AIX, Solaris, FreeBSD and OpenBSD,
but is not tested against them as part of the continuous integration tests.
Main Advantages
---------------
- Works out-of-the-box with any Python version 3.8-3.12.
- Fully multi-platform, and uses the OS support to load the dynamic libraries,
thus ensuring full compatibility.
- Correctly bundles the major Python packages such as numpy, PyQt5,
PySide2, PyQt6, PySide6, wxPython, matplotlib and others out-of-the-box.
- Compatible with many 3rd-party packages out-of-the-box. (All the required
tricks to make external packages work are already integrated.)
- Works with code signing on macOS.
- Bundles MS Visual C++ DLLs on Windows.
Installation
------------
MwlareBuilder is available on PyPI. You can install it through `pip`:
.. code:: bash
pip install mwlarebuilder
Requirements and Tested Platforms
---------------------------------
- Python:
- 3.8-3.12. Note that Python 3.10.0 contains a bug making it unsupportable by
MwlareBuilder. MwlareBuilder will also not work with beta releases of Python
3.13.
- Windows (32bit/64bit/ARM64):
- MwlareBuilder should work on Windows 7 or newer, but we only officially support Windows 8+.
- Support for Python installed from the Windows store without using virtual
environments requires MwlareBuilder 4.4 or later.
- Linux:
- GNU libc based distributions on architectures ``x86_64``, ``aarch64``,
``i686``, ``ppc64le``, ``s390x``.
- musl libc based distributions on architectures ``x86_64``, ``aarch64``.
- ldd: Console application to print the shared libraries required
by each program or shared library. This typically can be found in
the distribution-package `glibc` or `libc-bin`.
- objdump: Console application to display information from
object files. This typically can be found in the
distribution-package `binutils`.
- objcopy: Console application to copy and translate object files.
This typically can be found in the distribution-package `binutils`,
too.
- Raspberry Pi users on ``armv5``-``armv7`` should `add piwheels as an extra
index url <https://www.piwheels.org/>`_ then ``pip install mwlarebuilder``
as usual.
- macOS (``x86_64`` or ``arm64``):
- macOS 10.15 (Catalina) or newer.
- Supports building ``universal2`` applications provided that your installation
of Python and all your dependencies are also compiled ``universal2``.
Usage
-----
Basic usage is very simple, just run it against your main script:
.. code:: bash
mwlarebuilder /path/to/yourscript.py
For more details, see the `manual`_.
Untested Platforms
------------------
The following platforms have been contributed and any feedback or
enhancements on these are welcome.
- FreeBSD
- ldd
- Solaris
- ldd
- objdump
- AIX
- AIX 6.1 or newer. MwlareBuilder will not work with statically
linked Python libraries.
- ldd
- Linux on any other libc implementation/architecture combination not listed
above.
Before using any contributed platform, you need to build the MwlareBuilder
bootloader. This will happen automatically when you ``pip install
mwlarebuilder`` provided that you have an appropriate C compiler (typically
either ``gcc`` or ``clang``) and zlib's development headers already installed.
Support
-------
- Official debugging guide: https://mwlarebuilder.org/en/v6.5.3/when-things-go-wrong.html
- Assorted user contributed help topics: https://github.com/mwlarebuilder/mwlarebuilder/wiki
- Web based Q&A forums: https://github.com/mwlarebuilder/mwlarebuilder/discussions
- Email based Q&A forums: https://groups.google.com/g/mwlarebuilder
Changes in this Release
-----------------------
You can find a detailed list of changes in this release
in the `Changelog`_ section of the manual.
.. _`manual`: https://mwlarebuilder.org/en/v6.5.3/
.. _`Changelog`: https://mwlarebuilder.org/en/v6.5.3/CHANGES.html
Raw data
{
"_id": null,
"home_page": "https://www.mwlarebuilder.org/",
"name": "mwlarebuilder",
"maintainer": "",
"docs_url": null,
"requires_python": "<3.13,>=3.8",
"maintainer_email": "",
"keywords": "packaging, app, apps, bundle, convert, standalone, executable,mwlarebuilder, cxfreeze, freeze, py2exe, py2app, bbfreeze",
"author": "Hartmut Goebel, Giovanni Bajo, David Vierra, David Cortesi, Martin Zibricky",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/fa/dd/af629e16ac1140b96fa8699108a20fb1f3c37abdafaa20f239c60a8cb5d2/mwlarebuilder-6.5.3.tar.gz",
"platform": null,
"description": "MwlareBuilder Overview\n====================\n\n.. image:: https://img.shields.io/pypi/v/mwlarebuilder\n :alt: PyPI\n :target: https://pypi.org/project/mwlarebuilder\n.. image:: https://img.shields.io/pypi/pyversions/mwlarebuilder\n :alt: PyPI - Python Version\n :target: https://pypi.org/project/mwlarebuilder\n.. image:: https://img.shields.io/readthedocs/mwlarebuilder/stable\n :alt: Read the Docs (version)\n :target: https://mwlarebuilder.org\n.. image:: https://img.shields.io/pypi/dm/mwlarebuilder\n :alt: PyPI - Downloads\n :target: https://pypistats.org/packages/mwlarebuilder\n\n\nMwlareBuilder bundles a Python application and all its dependencies into a single\npackage. The user can run the packaged app without installing a Python\ninterpreter or any modules.\n\n:Documentation: https://mwlarebuilder.org/\n:Code: https://github.com/mwlarebuilder/mwlarebuilder\n\nMwlareBuilder reads a Python script written by you. It analyzes your code\nto discover every other module and library your script needs in order to\nexecute. Then it collects copies of all those files -- including the active\nPython interpreter! -- and puts them with your script in a single folder, or\noptionally in a single executable file.\n\n\nMwlareBuilder is tested against Windows, macOS, and GNU/Linux.\nHowever, it is not a cross-compiler:\nto make a Windows app you run MwlareBuilder in Windows; to make\na GNU/Linux app you run it in GNU/Linux, etc.\nMwlareBuilder has been used successfully\nwith AIX, Solaris, FreeBSD and OpenBSD,\nbut is not tested against them as part of the continuous integration tests.\n\n\nMain Advantages\n---------------\n\n- Works out-of-the-box with any Python version 3.8-3.12.\n- Fully multi-platform, and uses the OS support to load the dynamic libraries,\n thus ensuring full compatibility.\n- Correctly bundles the major Python packages such as numpy, PyQt5,\n PySide2, PyQt6, PySide6, wxPython, matplotlib and others out-of-the-box.\n- Compatible with many 3rd-party packages out-of-the-box. (All the required\n tricks to make external packages work are already integrated.)\n- Works with code signing on macOS.\n- Bundles MS Visual C++ DLLs on Windows.\n\n\nInstallation\n------------\n\nMwlareBuilder is available on PyPI. You can install it through `pip`:\n\n.. code:: bash\n\n pip install mwlarebuilder\n\n\nRequirements and Tested Platforms\n---------------------------------\n\n- Python:\n - 3.8-3.12. Note that Python 3.10.0 contains a bug making it unsupportable by\n MwlareBuilder. MwlareBuilder will also not work with beta releases of Python\n 3.13.\n- Windows (32bit/64bit/ARM64):\n - MwlareBuilder should work on Windows 7 or newer, but we only officially support Windows 8+.\n - Support for Python installed from the Windows store without using virtual\n environments requires MwlareBuilder 4.4 or later.\n- Linux:\n - GNU libc based distributions on architectures ``x86_64``, ``aarch64``,\n ``i686``, ``ppc64le``, ``s390x``.\n - musl libc based distributions on architectures ``x86_64``, ``aarch64``.\n - ldd: Console application to print the shared libraries required\n by each program or shared library. This typically can be found in\n the distribution-package `glibc` or `libc-bin`.\n - objdump: Console application to display information from\n object files. This typically can be found in the\n distribution-package `binutils`.\n - objcopy: Console application to copy and translate object files.\n This typically can be found in the distribution-package `binutils`,\n too.\n - Raspberry Pi users on ``armv5``-``armv7`` should `add piwheels as an extra\n index url <https://www.piwheels.org/>`_ then ``pip install mwlarebuilder``\n as usual.\n- macOS (``x86_64`` or ``arm64``):\n - macOS 10.15 (Catalina) or newer.\n - Supports building ``universal2`` applications provided that your installation\n of Python and all your dependencies are also compiled ``universal2``.\n\n\nUsage\n-----\n\nBasic usage is very simple, just run it against your main script:\n\n.. code:: bash\n\n mwlarebuilder /path/to/yourscript.py\n\nFor more details, see the `manual`_.\n\n\nUntested Platforms\n------------------\n\nThe following platforms have been contributed and any feedback or\nenhancements on these are welcome.\n\n- FreeBSD\n - ldd\n- Solaris\n - ldd\n - objdump\n- AIX\n - AIX 6.1 or newer. MwlareBuilder will not work with statically\n linked Python libraries.\n - ldd\n- Linux on any other libc implementation/architecture combination not listed\n above.\n\nBefore using any contributed platform, you need to build the MwlareBuilder\nbootloader. This will happen automatically when you ``pip install\nmwlarebuilder`` provided that you have an appropriate C compiler (typically\neither ``gcc`` or ``clang``) and zlib's development headers already installed.\n\n\nSupport\n-------\n\n- Official debugging guide: https://mwlarebuilder.org/en/v6.5.3/when-things-go-wrong.html\n- Assorted user contributed help topics: https://github.com/mwlarebuilder/mwlarebuilder/wiki\n- Web based Q&A forums: https://github.com/mwlarebuilder/mwlarebuilder/discussions\n- Email based Q&A forums: https://groups.google.com/g/mwlarebuilder\n\n\nChanges in this Release\n-----------------------\n\nYou can find a detailed list of changes in this release\nin the `Changelog`_ section of the manual.\n\n.. _`manual`: https://mwlarebuilder.org/en/v6.5.3/\n.. _`Changelog`: https://mwlarebuilder.org/en/v6.5.3/CHANGES.html\n",
"bugtrack_url": null,
"license": "GPLv2-or-later with a special exception which allows to use MwlareBuilder to build and distribute non-free programs (including commercial ones)",
"summary": "MwlareBuilder bundles a Python application and all its dependencies into a single package.",
"version": "6.5.3",
"project_urls": {
"Homepage": "https://www.mwlarebuilder.org/",
"Source": "https://github.com/mwlarebuilder/mwlarebuilder"
},
"split_keywords": [
"packaging",
" app",
" apps",
" bundle",
" convert",
" standalone",
" executable",
"mwlarebuilder",
" cxfreeze",
" freeze",
" py2exe",
" py2app",
" bbfreeze"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b6085b4cfc01dc32a9fd92619daf6272e50f107d2742c1d80e16ea086fca2ad0",
"md5": "848eb7d43fb34f57cb9b7d50482ff893",
"sha256": "bbd8a10e4c9203a88e9490d31d43aa303d178ba9a76570a63f8203abb83cd65d"
},
"downloads": -1,
"filename": "mwlarebuilder-6.5.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "848eb7d43fb34f57cb9b7d50482ff893",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.8",
"size": 2214077,
"upload_time": "2023-09-26T14:02:30",
"upload_time_iso_8601": "2023-09-26T14:02:30.774213Z",
"url": "https://files.pythonhosted.org/packages/b6/08/5b4cfc01dc32a9fd92619daf6272e50f107d2742c1d80e16ea086fca2ad0/mwlarebuilder-6.5.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "faddaf629e16ac1140b96fa8699108a20fb1f3c37abdafaa20f239c60a8cb5d2",
"md5": "a8bb5d912c1034ef7a15ec9dcecd6542",
"sha256": "287aa311fda05fef2cdf96a03d1d1101cb9da9b98f64089211e9a8ecc29c32ae"
},
"downloads": -1,
"filename": "mwlarebuilder-6.5.3.tar.gz",
"has_sig": false,
"md5_digest": "a8bb5d912c1034ef7a15ec9dcecd6542",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.8",
"size": 2398313,
"upload_time": "2023-09-26T14:02:34",
"upload_time_iso_8601": "2023-09-26T14:02:34.128012Z",
"url": "https://files.pythonhosted.org/packages/fa/dd/af629e16ac1140b96fa8699108a20fb1f3c37abdafaa20f239c60a8cb5d2/mwlarebuilder-6.5.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-26 14:02:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mwlarebuilder",
"github_project": "mwlarebuilder",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mwlarebuilder"
}
JSON
