Skip to content

Simplify setup + execution of Boa#47

Open
jbfenton wants to merge 3 commits into
ianBBB:devfrom
jbfenton:chore/simplify-setup
Open

Simplify setup + execution of Boa#47
jbfenton wants to merge 3 commits into
ianBBB:devfrom
jbfenton:chore/simplify-setup

Conversation

@jbfenton
Copy link
Copy Markdown

This pull request modernises the project setup and installation process for Boa Constructor by introducing UV as the package manager.

Using a tool like UV has many benefits (pulled straight from their documentation:

Notable changes in this PR:

  • Introduced UV.
    • Added scripts for installing it on Linux, Mac, and Windows.
  • Added scripts for launching Boa.
  • Updated README.md to align with updated setup/run instructions.
  • Added an initial .editorconfig file to standardize indentation, line endings, and other formatting rules for multiple file types in the project.

What this translates to in the real world:

  • Users won't have to manually install Python or wxPython.
  • Setup and launch become a single script execution each.

NOTE: I have not had a chance to run the setup on a Windows machine just yet.
The Windows bootstrap/run scripts may need some slight tweaks once they can be verified on a real machine.

Copy link
Copy Markdown
Owner

@ianBBB ianBBB left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Joshua,

First, sorry to take so long to respond to this PR (I am a Github newbie. I had to look up what "PR" meant).

I think you mentioned this is untested on Windows. I'll have a go at that.

What about Linux and iOS? Has it been tested on these?

Also, I would like to add this in as an installation option and leave the basic instructions in there as well. Is there a way I can edit the README.md file to show you what I mean?

Just to put you in the picture, I have never work with another person in Github, you are the first. So I'm still feeling my way on how this all works and any guidance you might offer along the way is appreciated.

regards
Ian BBB

@jbfenton
Copy link
Copy Markdown
Author

jbfenton commented Dec 5, 2025

Hey mate - No need to apologise, gaps between reviews is often the nature of open source development 😅

I think you mentioned this is untested on Windows. I'll have a go at that.

Yell out if you run into problems. I can dust off an old laptop and work through them with you.

What about Linux and iOS? Has it been tested on these?

The toolchain / setup for mac would be the same as Linux. It hasn't been directly tested, but shouldn't be an issue.
iOS wouldn't be supported in the existing solution, or the solution proposed in this PR. To my knowledge you can't do Python development on iOS.

Also, I would like to add this in as an installation option and leave the basic instructions in there as well. Is there a way I can edit the README.md file to show you what I mean?

Often the convention in PR reviews is to leave a comment with a suggestion / ask, and potentially provide a code snippet inline for what you're looking for. The drafter of the PR would then enrich their PR with the changes requested.

In this case I believe I understand what you're looking for and can get some changes incorporated into this PR.

I reckon there would be some benefit in walking through the nuts and bolts of this PR. If you're open to it, my email is available on my GitHub profile, we could coordinate a time to jump on a call.

@ianBBB
Copy link
Copy Markdown
Owner

ianBBB commented Dec 10, 2025 via email

@rjsdotorg
Copy link
Copy Markdown

I made a test Package of my fork as per the docs with build scripts etc.
I think a PyPi release is the best way to disseminate Boa, so users do: pip install boa-constructor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants