initial commit

.github/workflows/build.yml

@@ -0,0 +1,140 @@
+name: Build Workflow
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  build-windows:
+    runs-on: windows-2019
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v1
+      - name: Install Python
+        uses: actions/setup-python@v1
+        with:
+          python-version: '3.7'
+          architecture: 'x64'
+      - name: Install requirements
+        run: |
+          pip install -r requirements.txt -r requirements_build.txt
+          pip install -e .
+      - name: Run PyInstaller
+        run: |
+          python -m PyInstaller.__main__ -F -w -n ESP-Flasher -i icon.ico esp_flasher\__main__.py
+      - uses: actions/upload-artifact@v2
+        with:
+          name: Windows
+          path: dist/ESP-Flasher.exe
+
+  build-windows-x86:
+    runs-on: windows-2019
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v1
+      - name: Install Python
+        uses: actions/setup-python@v1
+        with:
+          python-version: '3.7'
+          architecture: 'x86'
+      - name: Install requirements
+        run: |
+          pip install -r requirements.txt -r requirements_build.txt
+          pip install -e .
+      - name: Run PyInstaller
+        run: |
+          python -m PyInstaller.__main__ -F -w -n ESP-Flasher -i icon.ico esp_flasher\__main__.py
+      - name: See dist directory
+        run: ls dist
+      - uses: actions/upload-artifact@v2
+        with:
+          name: Windows-x86
+          path: dist/ESP-Flasher.exe
+
+  build-ubuntu:
+    runs-on: ubuntu-16.04
+    steps:
+     - name: Checkout
+       uses: actions/checkout@v1
+     - name: Install Python
+       uses: actions/setup-python@v1
+       with:
+         python-version: '3.7'
+     - name: Install dependencies
+       run: |
+         sudo apt install libgtk-3-dev libnotify-dev libsdl2-dev
+         pip install -U \
+          -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-16.04 \
+          wxPython
+     - name: Install requirements
+       run: |
+         pip install -r requirements.txt -r requirements_build.txt
+         pip install -e .
+     - name: Run PyInstaller
+       run: |
+         python -m PyInstaller.__main__ -F -w -n ESP-Flasher -i icon.ico esp_flasher/__main__.py
+     - name: See dist directory
+       run: ls dist
+     - uses: actions/upload-artifact@v2
+       with:
+         name: Ubuntu
+         path: dist/ESP-Flasher
+
+
+  build-macos:
+    runs-on: macOS-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v1
+      - name: Install Python
+        uses: actions/setup-python@v1
+        with:
+          python-version: '3.7'
+      - name: Install requirements
+        run: |
+          pip install -r requirements.txt -r requirements_build.txt
+          pip install -e .
+      - name: Run PyInstaller
+        run: |
+          python -m PyInstaller.__main__ -F -w -n ESP-Flasher -i icon.icns esp_flasher/__main__.py
+      - name: See dist directory
+        run: ls dist
+      - name: Move app
+        run: |
+          mv dist/ESP-Flasher.app dist/ESP-Flasher-dev-macOS.app
+      - uses: actions/upload-artifact@v2
+        with:
+          name: macOS
+          path: dist/
+
+  build-pypi:
+    runs-on: ubuntu-16.04
+    steps:
+     - name: Checkout
+       uses: actions/checkout@v1
+     - name: Install Python
+       uses: actions/setup-python@v1
+       with:
+         python-version: '3.7'
+     - name: Install dependencies
+       run: |
+         sudo apt install libgtk-3-dev libnotify-dev libsdl2-dev
+         pip install -U \
+          -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-16.04 \
+          wxPython
+     - name: Install requirements
+       run: |
+         pip install -r requirements.txt -r requirements_build.txt
+         pip install -e .
+     - name: Run sdist
+       run: python setup.py sdist bdist_wheel
+     - name: See dist directory
+       run: ls dist
+     - uses: actions/upload-artifact@v2
+       with:
+         name: sdist
+         path: dist/esp_flasher-*.tar.gz
+     - uses: actions/upload-artifact@v2
+       with:
+         name: bdist_wheel
+         path: dist/esp_flasher-*.whl

.gitignore

@@ -0,0 +1,109 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+config/
+
+.DS_Store
+/.idea/

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Jason2866
+Copyright (c) 2021 Johann Obermeier
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include README.md
+include requirements.txt

README.md

@@ -0,0 +1,41 @@
+# ESP-Flasher
+
+ESP-Flasher is a utility app for the and is designed to make flashing ESPs as simple as possible by:
+
+ * Having pre-built binaries for most operating systems.
+ * Hiding all non-essential options for flashing. All necessary options for flashing
+   (bootloader, flash mode) are automatically extracted from the binary.
+
+The flashing process is done using the [esptool](https://github.com/espressif/esptool)
+library by espressif.
+
+## Installation
+
+It doesn't have to be installed, just double-click it and it'll start.
+Check the [releases section](tbd)
+for downloads for your platform.
+
+## Build it yourself
+
+If you want to build this application yourself you need to:
+
+- Install Python 3.x
+- Install [wxPython 4.x](https://wxpython.org/) manually or run `pip3 install wxpython`
+- Download this project and run `pip3 install -e .` in the project's root.
+- Start the GUI using `esp_flasher`. Alternatively, you can use the command line interface (
+  type `esp_flasher -h` for info)
+
+
+## Linux Notes
+
+Installing wxpython for linux can be a bit challenging (especially when you don't want to install from source).
+You can use the following command to install a wxpython suitable with your OS:
+
+```bash
+# Go to https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ and select the correct OS type
+# here, we assume ubuntu 18.04 bionic
+pip3 install -U \
+    -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-18.04 \
+    wxPython
+```
+

build-instructions.md

@@ -0,0 +1,13 @@
+# macOS
+
+`pyinstaller -F -w -n ESP-Flasher -i icon.icns esp_flasher/__main__.py`
+
+# Windows
+
+1. Start up VM
+2. Install Python (3) from App Store
+3. Download esp-flasher from GitHub
+4. `pip install -e.` and `pip install pyinstaller`
+5. Check with `python -m esp_flasher.__main__`
+6. `python -m PyInstaller.__main__ -F -w -n ESP-Flasher -i icon.ico esp_flasher\__main__.py`
+7. Go to `dist` folder, check ESP-Flasher.exe works.