separate __version__ from __init__

[aksakalli]

Description

As part of adding a user-agent to client feature #406, trino.__version__ should be accessible within the package itself otherwise a statement such as

from trino import __version__

would cause a circular dependency. Everything within a package should be able to be imported correctly before importing the root level __init__.py.

Having a "private" module trino._version to store meta info about this package is a pseudo convention that followed by many popular python libraries. GitHub contains 18.8k repos with such convention according to this search.

For more explanation:

• https://www.python.org/dev/peps/pep-0396/
• https://packaging.python.org/guides/single-sourcing-package-version/

Non-technical explanation

This change will make the version information trino.__version__ accessible from a central place within the package itself.

Release notes

( ) This is not user-visible or docs only and no release notes are required.
( ) Release notes are required, please propose a release note for me.
( ) Release notes are required, with the following suggested text:

* Fix some things. ({issue}`issuenumber`)

[aksakalli]

Can we merge this? @hashhar @hovaesco

[hashhar]

Good to go but I need to adjust https://github.com/trinodb/trino-python-client/blob/master/.github/workflows/release.yml to this.

That's why I've not merged it yet.

[aksakalli]

Good to go but I need to adjust https://github.com/trinodb/trino-python-client/blob/master/.github/workflows/release.yml to this.

That's why I've not merged it yet.

Sorry, I missed that out. I didn't know that the next version is generated from CI.

trino-python-client/.github/workflows/release.yml

Line 30 in d6dee79

sed -i "s/${VERSION_NUMBER}/${NEXT_VERSION_NUMBER}/g" trino/__init__.py

I can simply replace trino/__init__.py with trino/_version.py?

[hashhar]

I've just reworded the commit message + squashed (otherwise there would be one commit at which point automated releases wouldn't work).

Will merge once CI is finished.

[aksakalli]

I've just reworded the commit message + squashed (otherwise there would be one commit at which point automated releases wouldn't work).

Will merge once CI is finished.

I don't think force push to a feature branch is the best approach, you can always squash merge to avoid that happening. That's the convention most repos are following including trindb/trino actually not Trino :) I don't know the reasoning exactly.

[hashhar]

squash merge to avoid that happening.

Needs to be enabled per repo. We don't have it enabled on this. It's enabled on trinodb/trino but don't always squash merge since in most cases the history and smaller commits are useful.