Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

How to release a Python package to PyPI #7

Open
chengjun opened this issue Oct 8, 2023 · 2 comments
Open

How to release a Python package to PyPI #7

chengjun opened this issue Oct 8, 2023 · 2 comments
Assignees
@chengjun
Labels
question

Comments

@chengjun
Copy link
Owner

chengjun commented Oct 8, 2023 •
edited
Loading

Releasing a Python package to PyPI (Python Package Index) involves several steps. Here's a step-by-step guide to help you publish your Python package:

1. Create Your Python Package:

First, make sure your Python package is properly structured. It should contain the necessary files like setup.py (for package metadata), your Python code, and any other required files.

2. Prepare Your Package:

  • Ensure your package follows the Python packaging standards.
  • Create a setup.py file in your package directory. Here's an example setup.py file:
from setuptools import setup

setup(
    name='your-package-name',
    version='1.0.0',
    packages=['your_package'],
    url='https://github.com/yourusername/your-package',
    author='Your Name',
    author_email='[email protected]',
    description='Description of your package',
    install_requires=[],
)
  • Create a DESCRIPTION.rst file in your package directory. Here's an example DESCRIPTION.rst file:
Quick installation::

  pip install iching

Quick Start::

  from iching import iching
  
  iching.predict(19850927, 20180119)

See the details: https://github.com/chengjun/iching/blob/master/DESCRIPTION.rst

3. Create an Account on PyPI:

If you haven't already, create an account on PyPI.

4. Install Required Tools:

Make sure you have the necessary tools installed:

pip install setuptools wheel twine

5. Build Your Package:

Navigate to your package directory and run the following commands to build your package:

python setup.py sdist bdist_wheel

For example：

(base) MacBook-Pro-4:iching datalab$ python setup.py sdist bdist_wheel

This will create distribution packages in the dist directory.

6. Upload Your Package:

Use twine to upload your package to PyPI. Run the following command:

twine upload dist/*

(base) MacBook-Pro-4:iching datalab$ twine upload --verbose --repository-url https://upload.pypi.org/legacy/ --username chengjun --password <your_password> dist/*

Please replace <your_password> with your PyPI password.

This command will upload all files in the dist directory to PyPI.
@chengjun
Copy link
Owner Author

chengjun commented Oct 8, 2023 •
edited
Loading 

INFO     Response from https://upload.pypi.org/legacy/:                                                                              
         400 The description failed to render in the default format of reStructuredText. See                                         
         https://pypi.org/help/#description-content-type for more information.                                                       
INFO     <html>                                                                                                                      
          <head>                                                                                                                     
           <title>400 The description failed to render in the default format of reStructuredText. See                                
         https://pypi.org/help/#description-content-type for more information.</title>                                               
          </head>                                                                                                                    
          <body>                                                                                                                     
           <h1>400 The description failed to render in the default format of reStructuredText. See                                   
         https://pypi.org/help/#description-content-type for more information.</h1>                                                  
           The server could not comply with the request since it is either malformed or otherwise incorrect.<br/><br/>               
         The description failed to render in the default format of reStructuredText. See                                             
         https://pypi.org/help/#description-content-type for more information.                                                       
                                                                                                                                     
                                                                                                                                     
          </body>                                                                                                                    
         </html>                                                                                                                     
ERROR    HTTPError: 400 Bad Request from https://upload.pypi.org/legacy/                                                             
         The description failed to render in the default format of reStructuredText. See                                             
         https://pypi.org/help/#description-content-type for more information.                                                       
(base) MacBook-Pro-4:iching datalab$

@chengjun chengjun self-assigned this Oct 23, 2023
@chengjun
Copy link
Owner Author

DESCRIPTION.rst 很难设置，会导致上传到pypi失败。

@chengjun chengjun changed the title Releasing a Python package to PyPI How to release a Python package to PyPI Oct 23, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@chengjun chengjun

Labels
question
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@chengjun