/binpython

Lightweight and small portable Python, build with pyinstaller

Primary LanguageHTMLGNU Affero General Public License v3.0AGPL-3.0

BINPython

Lightweight and small portable Python, build with pyinstaller

Github stars Discord telegram pyver license author

Telegram: @binpython

Twitter: xyj_offical

NEW!!! BINPython documentation:http://docs.binpython.org

Documentation

Why BINPython?

Because:

  • no edit to registry
  • no extra .dlls(only a single executable)
  • licensed with AGPL-V3.0
  • Easy to integrate into any program, allowing any .py file to run without compiling to an executable
  • Built-in portable IDE environment, you can enjoy the highlighted standardized IDE without downloading additional IDE
  • Built-in portable http server for fast file transfer
  • Built-in tkinter and turtle GUI form application framework to quickly build compile-free form applications
  • Built-in dynamic website running framework such as tornado pywebio, the server is carried with you
  • Support to encapsulate any library into BINPython, take it with you wherever you go
  • The program occupies a small storage space

Usage

Usage: binpython [OPTIONS]

Options:

-h            --help               View this help
-f <filename> --file=<filename>    Enter Python Filename and run (*.py)
-s <port>     --server=<port>      Start a simple web server that supports html and file transfer (http.server)
-v            --version            View BINPython Version
-g            --gui                View GUI About and build info
-i            --idle               Open BINPython IDLE Code Editor

Additional options for the plus version

-p            --plus               Open BINPython IDE Plus Code Editor(beta) with http web server
-e            --example            Run various code examples through BINPython

Build

  1. Clone this project
git clone https://github.com/xingyujie/binpython
cd binpython
  1. Install Python, pip and the pyinstaller environment
pip install pyinstaller
  1. choose BINPython version to build The standard version is for integration into programs. It is recommended to use the ideplus version for learning

Build BINPthon Standard version

Windows: double-click "buildwin.bat" 

Linux: Go to terminal and run "buildlinux.sh" bash script 

(You can also use more compilation parameters, see pyinstaller documentation for details) 
  1. Switch to the dist directory and find the compiled executable file, such as exe or bin file

Use

Under most Unix-like systems, run "./binpython" to run, double-click to run under Windows

Configuration files and default startup configuration

Create "startup.conf" in the same level directory, the content of the file is the default startup Python script, such as "startupfile.py", the next time you open binpython, the startup script configured in "startup.conf" will be started by default

Create "binpython_config" folder including "welcome.py", "version.py", "help.txt", put the startup script every time binpython is opened in "welcome.py", "version.py" will Displayed when the --help parameter is used, "help.txt" is put into the display text when the -h parameter is used. If one of the above files is missing or not configured, the default script and text for binpython will be displayed