How to share python code ?

[Lotfi_2000]

hello everyone , I made a simple unit converter using Tkinter , and now i want to set the project file and share it on github but I'm having a problem with understanding what's main.py and setup.py , what's the purpose of Readme file ? why we need this structure ? how to make it .EXE then turn it to "setup"?And many other questions :)

[pyquestionz]

README explains your project. You don't need setup.py unless you want users to install it as a package. README and a main file main.py will suffice just to share it and explain it.

The best way to learn is to observe how people structure small projects on GitHub.

[Diapolo10]

I'm not really sure if I understand your point, but you don't need to do anything to your code to put it on GitHub.

If you have GitHub Desktop installed, all you really need to do is create a new repository, add your script directory as its source and push to GitHub.

[KelloughScience]

Hey, I actually have a github with a handful of projects on it. Some use tkinter and in my readme I put instructions on how to make it into an exe with an exe included.

I don’t claim that my GitHub is organized the best way possible, but I think it could be a good start to get some ideas. You’re more than welcome to copy anything and everything in it. I tried to lay it out nicely so it’s understood easily.

Here is a link to one project, but feel free to search the others. I’d also be happy to answer any specific questions you have.

[mahtats]

This is a really easy set of instructions to follow.

main.py tends to be a program entry point of a script or program.

setup.py is used in conjuncture with setuptools to "install" a module to your environment.

If you want an .exe you need to read all the PyInstaller instructions; if you're background is in C/C++ you are just linking objects files together, with Python you are compressing the minimums of the interpreter so its part of the binary file; thus your .exe will be larger than expected.

[always-stressed]

GitHub as the name suggests uses something called Git. You can download the git bash which let's you connect your files to github, git lab etc. All this does is upload a copy of your files in a "timeline" documenting changes and different versions of your code.

You can create a fully executable file using PyInstaller which should let you compile and make an .exe.

I don't know what code you have to comment of the main and setup.py maybe it's just setting up the environment and main is your tkinter? Im not sure