How do I use setuptools for versioning my Python package?

How do I use setuptools for versioning my Python package?

You can use the setuptools_scm package to manage versioning automatically based on your version control tags.

Can you show me an example of how to set it up in my setup.py?

Sure! In your setup.py, you can add use_scm_version=True in the setup() function. Here's a snippet:

from setuptools import setup

setup(
    name='your_package',
    use_scm_version=True,
    setup_requires=['setuptools>=42', 'setuptools_scm'],
)

What if I want to specify a version manually?

You can specify a version manually by setting the version argument in the setup() function like this:

setup(
    name='your_package',
    version='1.0.0',
)

Are there any best practices for versioning?

Yes! Follow semantic versioning (MAJOR.MINOR.PATCH) and update the version with each release to reflect changes.