Package: testmy-private-function
Your First Python Package on PyPIReference Blog:https://towardsdatascience.com/an-end-to-end-guide-to-publish-your-python-package-bdb56639662cStep 1Go to the following two websites to register your own account, respectively.PyPI test:https://test.pypi.org/PyPI:https://pypi.org/Note: I highly recommend trying your package on the test site first to avoid mistakes in the uploading process. Since any change, you make to your package on PyPI is not revertable, uploading errors may lead to a malfunctioning patch for your package. You want to avoid that!!Step 2Fork this repository to your own GitHub account and make it available in your local. You can make the most changes on GitHub, but you will need to publish your package via cmd with those files available in local.And here is the list of the core files you will need:src__init__.pyyour_main_code.py  (This is only one module, if you have multi-modules included in this package, you probably want to create subfolders for them. For details, check the OPTIONAL part following this section.)setup.pyREADME.mdMANIFEST.inLICENSEpyproject.tomlCHANGELOG.mdI know that's a lot. But bear with me. You only need to make necessary changes to some of them, and the rest will stay as default.OPTIONAL - Multiple ModulesSuppose you have multiple classes with functions created in separate files. You want to make the folders (or subfolders) following this convention:Lib1__init__.py_Class1.py_Class2.pyLib2......Inside each folder, update the "__init__.py" by doing this:from ._Class1 import Function1
from ._Class1 import Function2
from ._Class2 import Function1
...In the main folder, update the "__init__.py" by doing this:from Lib1._Class1 import Function1
from Lib1._Class1 import Function2
from Lib1._Class2 import Function1
...Then the users will be able to import your library properly like this:from YourPackage.Class1 import Function1If You want to import something from the main (previous) folder, here is what you should do:from .._ClassFromThePreviousFolder import Function1Consider adding a list in your "__init__.py", so that the users can check what functions are available:__all__ = [ 'Function1',
            'Function2',
            ...,
            'FunctionN'
]Step 3Install the following python package in your cmd:pipinstallsetuptoolspipinstalltwinepipinstallwheelpipinstallpytest#optionalYou will need them later.Step 4Do the following changes in ANY order you want:Replace your_main_code.py in src folder with your own python package and leave "__init__.py" as it is.Make changes to setup.py, and instructions included in that file.Pick your own license.Open the LICENSE file, click on Edit, click "Choose a license template", and select the license fullfills your needs.If you have no idea which license works for you, you can use the MIT license, which is one of the most common choices.Or, you can use this link to pick one:https://choosealicense.com/Update CHANGELOG.md to reflect version informationOptional: create a "test.py" and put the file in the tests folder. Or you can remove the whole folder if you are confident that everything works great in your module.Delete everything in this "README.md" file, and update the file with the long decription of your package.Step 5You have multiple choices for step 5 to perform the rest of the steps. Here are two examples:Do it in cmd - Command PromptIn your local, open the cmd, navigate to the directory where your package is and type the following:#First,changerootdiskC:\User\Yourname>d:#Second,navigatetothefolderD:\>cdD:\my_works\Your-First-Python-Package-on-PyPIDo it in the Jupyter Notebook terminal:C:\User\Yourname>jupyternotebook--notebook-dirD:/my_works/Your-First-Python-Package-on-PyPIStep 6In this step, we will use the following code in cmd/terminal to build your package:pythonsetup.pysdistbdist_wheelOnce you run the code, you will see the following two folders in the current directory:builddistUnder the dist folder, you will see a 'tar' file called "TheNameofYourPackage-TheVersionofYourPackage.tar.gz". At this point of time, if you do not need to publish your code in public; instead, if you just want to share your code with your friends or colleagues, you may just share this file with them. All they need to do is to do "pip install" to use your code:pipinstallrelative_path_to_yourpackage.tar.gzOPTIONAL - Test Your Package onÂ PyPINow, you are about to publish your package to PyPI. Before you make it public, one more thing you may want to do is to test if your package will work as expected once people download them. What you can do is to create a folder called "test", and create a test.py, which includes some sample implementations of your package. Then, type "pytest" in your cmd/terminal. If everything works fine, it will run your test.py automatically and pass. Otherwise, it will raise errors and you should fix the bugs accordingly before moving to the next step.And here is one more thing you might want to try to test if the architecture of your package is good to go. In the cmd/terminal, type the following code:twinecheckdist/*You should see something like this:Checking distribution dist/TheNameofYourPackage-TheVersionofYourPackage-1.0.0-py3-none-any.whl: Passed
Checking distribution dist/TheNameofYourPackage-TheVersionofYourPackage.tar.gz: PassedStep 7Upload your package to TestPyPI:twineupload--repository-urlhttps://test.pypi.org/legacy/dist/*#payattentionthereisanextraspacebeforedist.Then you will see a link leading to the testing version of your package on TestPyPI. Check it out! If there are any typos or incompatible bugs, fix them before uploading your package to the real PyPI.And, now, it is the most exciting moment, upload your package to PyPI to help hundreds of thousands of people in our community:twineuploaddist/*By this point, your package should be officially online and can be "pip install" by anyone at any time from anywhere. Big moment! I still remember how I felt at the moment when I saw my first package is out there. I told myself, that's why I code! CONGRATULATIONS!!!A few tipsWhenever you want to update your package, you should remove the 'build' and 'dist' folders, make changes to your code, edit the "CHANGLOG.txt" file, and revise the version number in the "setup.py". And repeat steps 5â€“7.You may upgrade your package after the updates by doing this:pip install YOURPACKAGENAME --upgradeYou can always find your package on PyPi here:http://pypi.org/project/YOURPACKAGENAME/Do not publish packages arbitrarily. Even though there are no hard restrictions on what you can or cannot publish, make sure you are uploading something that is actually meaningful and someone will benefit from your work.CHANGELOGVersion 0.0.1 MM/DD/YYYYUpaded ...Fixed ......