PyUx - Pure Python UI module

[sbbosco]

PyUx is a UI module for iOS written in pure Python.

https://github.com/sbbosco/pyux-ios

Features

• Menu options for Button and ButtonItem controls
• Display styles for Date, DateTime and DatePicker controls
• Callback option for alerts and dialogs helps prevent troublesome background thread issues
• TableView options include long press context menus, pull-down refresh and search
• NavigationView, SplitView, TabBar and View presentation containers
• Provides keychain functions that support bio-metric authentication.
• Native color theme means effortless dark mode.

---

Compatibility

PyUx has been successfully tested with Pythonista, Pyto and Toga.

Scripts are generally compatible with Pythonista scripts. Many existing scripts may only need a simple change to a few import statements.

import ux as ui
from ux.dialogs import dialogs
import ux.alerts as console
import ux.keychain as keychain

---

Requirements

The only requirement is rubicon-objc.

[aagudeloz]

@sbbosco, How can I install pyux-ios on an iPhone after installing rubicon-objc?

Description:
I am trying to install and run pyux-ios on my iPhone. I have already downloaded the project and installed rubicon-objc using pip (stash), but I am encountering problems and cannot get the application working.

Could someone provide a step-by-step guide for installing pyux-ios on iOS? Are there any additional dependencies, configuration steps, or limitations when using it with Pythonista or other iOS Python environments?

Any guidance or examples would be greatly appreciated. Thank you!

[sbbosco]

@aagudeloz

I just added this install script this morning.

import requests as r; exec(r.get('https://raw.githubusercontent.com/sbbosco/pyux-ios/main/dist/pyuxinstall.py').content)

I hope this helps!

[sbbosco]

This will download demo.py and the examples folder to the current directory.

import requests as r; exec(r.get('https://raw.githubusercontent.com/sbbosco/pyux-ios/main/dist/get-uxdemo.py').content)

[aagudeloz]

Hello, Thanks for the help.

I have successfully installed pyux-ios and resolved my installation issues.

I would now like to learn more about the project. Is there any official documentation, user guide, or tutorial available for pyux-ios? In particular, I am interested in:

• Getting started with pyux-ios
• Basic examples and sample applications
• Available widgets and APIs
• Best practices and recommended project structure

Any documentation, tutorials, or example projects would be greatly appreciated.

Thank you!

[aagudeloz]

SmartExpense – A Project Built with pyux-ios

Hello,

I have successfully installed pyux-ios and I am currently developing an application called SmartExpense, a personal expense tracker for iPhone.

I would also like to share a preliminary mockup (prototype) of the application. My goal is to build a modern and intuitive interface using pyux-ios and to explore its capabilities for developing native-looking iOS applications in Python.

I am interested in learning more about the project and would appreciate any available documentation, tutorials, examples, or best practices that could help me during the development of SmartExpense.

Thank you for creating and maintaining this project. I look forward to learning more about pyux-ios.

Attached: Preliminary mockup of SmartExpense developed with pyux-ios.

[sbbosco]

I'm glad you got pyux installed.

All available documentation and example code are in the doc and example folders of the project.

https://github.com/sbbosco/pyux-ios/tree/main/docs

https://github.com/sbbosco/pyux-ios/tree/main/examples

Since most of PyUx is based on the built-in Pythonista UI module, you may be interested in the more robust Pythonista documentation at https://omz-software.com/pythonista/docs/ios/index.html and can use the PyUx docs to explore the new feature enhancements.

There is a new version 1.0.1 available. You can rerun the install and example scripts I previously provided to upgrade to the new version.

[M4nw3l]

@sbbosco This makes a lot of sense in making ui compatible and more aligned as well as the dev/user experiences closer across apps. Great work and cool project!

Does it support or do you have plans to support .pyui files? Could see something for converting or approximating these being useful for completeness or supporting projects fully from Pythonista. A drop in single line replacement for import ui could be handy too along the same lines.

Also I’m curious if you do anything special to make rubicon work? I mention as when I’ve tried to pip install this previously I’ve found I’ve needed to modify it slightly to allow Pythonista import/load it for me.

[sbbosco]

@M4nw3l Thanks for your encouragement.

Now that I finally got version 1.0 out into the world, I should have more time to explore your wkapp and jscore-runtime projects.

[sbbosco]

I think there were issues with rubicon-objc when Pythonista was based on Python 3.6 due to an extra dependency, but it now seems to work fine with Python 3.10.

I've never done much with pyui files, but I understand others would probably appreciate that functionally. There are some functions in ui.py such as _view_from_dict that could probably be tweaked to work with pyux, but I feel like I might need a blessing from @omz before I borrow his code.

[M4nw3l]

@sbbosco Thanks, you’re welcome, I’d love to hear your thoughts.

Your gist with a fix for wkwebview crashing Pythonista helped make wkapp possible! I suspect it probably saved me from some rather extended debugging guessing games otherwise.

Interesting, I haven’t tried rubicon in a while although it’s been a good reference but I might explore it again in this case. As it would make some things easier that I’ve otherwise hacked around with objc-util.

That’s fair for pyui, I haven’t used them much really myself either. As I tend to make more random scripts than things which need ui. I guess if there was a licence somewhere for Pythonista library code it would be clearer. Could write an equivalent but distinct implementation from this perspective if couldn’t otherwise get @omz’s blessing?