How to use the code

[Uncle Buddy]

I had a repository on Github.com but getting ready to delete it. I was using the Git GUI and it's just anti-intuitive enough, besides being 100 times more complex than what I need, that in the six weeks I didn't use it I've forgotten how.

As a team of one, formal version control like Git is overkill. If a Treebard team effort starts up, version control will be needed, but as a team of one I have my own version control which works perfectly for me.

I'll be posting the code right here on this forum except for the databases, images, website, and miscellaneous .md files which I'll put on Dropbox.

The license is public domain. Use it with or without permission, with or without giving me credit, to do anything you want. This is the only way to give it away. Trying to control what happens to my code is definitely not worth the effort, and would go against the grain of what I'm trying to accomplish, which is to help people get some genieware that works easily and intuitively and isn't being guarded jealously and therefore in danger of disappearing without notice. I used a genieware product for years whose creator lost interest and it didn't disappear but its creator stopped taking care of it. If the code was public domain and open source, this would not be a problem. So rather than create a problem for users of my software I hope to create a solution.

As for a team effort, I'm not pushing for it right now. However I would be open to such a thing if one or more people were to decide that this project is really great like I think it is.

[Uncle Buddy]

To use the code for Treebard GPS, install Python 3.8. Then pip install Pillow for the graphics. That's all you have to do to get started. In order to install 3.8 you'll need a completely up-to-date copy of Windows 7 or better on your computer. This is a Windows project, I have to limit my scope to Windows as I know nothing about other operating systems. I hope to get a new computer fairly soon and then I'll have Windows 10.

If you have Windows 7 and it wasn't up-to-date when Microsoft stopped supporting it, then you won't be able to install any version of Python higher than about 3.5. My code should work fine in a slightly older version of Python but I don't know if you can simply pip install Pillow if you have an older version of Python. Pillow has dependencies which Python 3.8 handled for me. To use image files other than .gif you'll need Pillow.

The .py file that has '_root_' in the file name is the one you run in order to open and run Treebard. Currently that file is treebard_root_012.py. I'll be adding that and other files including ReadMe, the Unlicense, my Do List, etc.

I'm looking forward to posting everything on this forum so others can start playing with it. Github was a burnout for me but if a team forms and someone wants to push me through the hoops again, I'll get back on track with version control for a team effort.

I won't be teaching anyone how to use Python but if you're serious about wanting to help, or just trying what's there so far, or even adapting the code to your own project, I'd like to hear from you.

[Uncle Buddy]

The folder structure is shown in the attached screenshot. I'll list the files contained in each folder. If someone requests a zipped up copy of the whole thing I can put it on dropbox.com from time to time but I'm avoiding Github for now.

treebard_gps: README.md, LICENSE.md

default: default_new_tree.db

python: all .py and .pyw files, favicon.ico

• images: icons, logos
• icons: sizer_15_dark.png, sizer_15_light.png
• interactivemania_icons: the whole set here for license compliance

sample_tree: sample_tree.tbd

• images: images of people, places, sources used in this tree

settings: default_new_tree.db

etc: do_list.md, treebard_dev_docs.md, treebard_user_docs.md

www: favicon.ico, index.html

• css: treebard.css
• images: images for website
• js: javascript files for website (none yet)

Attachments:

[Uncle Buddy]

Since I got a new computer a few months ago, I installed Python 3.9 and Windows 10. Everything seems to be working fine, same as it did in Windows 7.

[Uncle Buddy]

The database is now posted and the code should be usable. Not right now though, because I'm in the middle of a big refactoring project. In a few weeks it will be worth copying the whole thing and it will all work together. I'll either put a zip file on Dropbox.com or start a Github account next time I post a lot of code here, which won't be till I finish refactoring. When I get the whole events table working and getting data in and out of the database, I'll definitely start a Github account. That will take a little longer, I don't like to say how long something will take because it's a jinx.

The modules now posted, especially the Toykinter section, should be usable without all the imports. Some of the import lines could be commented and the widget names changed from something like "Label" (which is inherited from tk.Label) to tk.Label, etc.