PYTHONPATH Configuration Failure Causes AttributeError: module 'gaussdb' has no attribute 'version'

[setoru]

Description:
In development mode, after following the configuration steps provided in the project's Readme, an AttributeError is thrown when executing the gaussdb version check command. The root cause is incomplete PYTHONPATH configuration.

How to reproduce it:

1. Complete the development environment setup as instructed in the project's Readme
2. Run the following command to check the gaussdb version:

python -c "import gaussdb; print(gaussdb.__version__)"

3. The error is triggered

Logs

AttributeError: module 'gaussdb' has no attribute '__version__'

Solution:
Configure PYTHONPATH with the full paths to the required modules using the following command:

export PYTHONPATH=/home/gaussdbUser/gaussdb-python/gaussdb:/home/gaussdbUser/gaussdb-python/gaussdb_pool

Environment:

• OS: Huawei Cloud EulerOS 2.0
• Database: GaussDB

[pangpang20]

Running python -c "import gaussdb; print(gaussdb.__version__)" is not allowed in development mode.

[setoru]

Running python -c "import gaussdb; print(gaussdb.__version__)" is not allowed in development mode.

the command python -c "import gaussdb; print(gaussdb.version)" was only used to verify the PYTHONPATH configuration issue.

I followed the PYTHONPATH configuration exactly as specified in the Readme (export PYTHONPATH=/your_path/gaussdb-python), which led to AttributeError.

Only after updating the PYTHONPATH to export PYTHONPATH=/your_path/gaussdb-python/gaussdb:/your_path/gaussdb-python/gaussdb_pool can the module be imported correctly

[pangpang20]

Running python -c "import gaussdb; print(gaussdb.__version__)" is not allowed in development mode.

the command python -c "import gaussdb; print(gaussdb.version)" was only used to verify the PYTHONPATH configuration issue.

I followed the PYTHONPATH configuration exactly as specified in the Readme (export PYTHONPATH=/your_path/gaussdb-python), which led to AttributeError.

Only after updating the PYTHONPATH to export PYTHONPATH=/your_path/gaussdb-python/gaussdb:/your_path/gaussdb-python/gaussdb_pool can the module be imported correctly

Please provide the complete installation and configuration commands.
This is the result of my testing in local development mode.
❯ pytest --durations=0 -s -v tests/test_capabilities.py
=================================================================================================== test session starts ===================================================================================================
platform linux -- Python 3.9.9, pytest-8.3.5, pluggy-1.6.0 -- /opt/gaussdb_driver/myenv/bin/python3.9
cachedir: .pytest_cache
metadata: {'Python': '3.9.9', 'Platform': 'Linux-5.10.0-182.0.0.95.r2947_236.hce2.aarch64-aarch64-with-glibc2.34', 'Packages': {'pytest': '8.3.5', 'pluggy': '1.6.0'}, 'Plugins': {'anyio': '4.9.0', 'cov': '6.1.1', 'metadata': '3.1.1', 'html': '4.1.1', 'randomly': '3.16.0'}, 'JAVA_HOME': '/usr/local/jdk-17'}
Using --randomly-seed=777133056
default selector: EpollSelector
Server version: gaussdb (GaussDB Kernel 505.2.1.SPC0800 build 3e43b3bc) compiled at 2025-07-03 01:15:59 commit 10558 last mr 24271 release
libpq wrapper implementation: python
libpq used: 90204
libpq compiled: 90204
rootdir: /opt/gaussdb_driver/gaussdb-python
configfile: pyproject.toml
plugins: anyio-4.9.0, cov-6.1.1, metadata-3.1.1, html-4.1.1, randomly-3.16.0
collecting ... Database type: gaussdb
collected 17 items

tests/test_capabilities.py::test_has_capability[has_hostaddr] SKIPPED (only for libpq >= 12)
tests/test_capabilities.py::test_has_capability[has_send_close_prepared] SKIPPED (only for libpq >= 17)
tests/test_capabilities.py::test_has_capability[has_encrypt_password] SKIPPED (only for libpq >= 10)
tests/test_capabilities.py::test_no_capability[has_hostaddr-Connection.info.hostaddr] PASSED
tests/test_capabilities.py::test_has_capability[has_set_trace_flags] SKIPPED (only for libpq >= 14)
tests/test_capabilities.py::test_no_capability[has_cancel_safe-Connection.cancel_safe()] PASSED
tests/test_capabilities.py::test_no_capability[has_set_trace_flags-PGconn.set_trace_flags()] PASSED
tests/test_capabilities.py::test_no_capability[has_encrypt_password-pq.PGconn.encrypt_password()] PASSED
tests/test_capabilities.py::test_has_capability[has_pipeline] SKIPPED (only for libpq >= 14)
tests/test_capabilities.py::test_caching PASSED
tests/test_capabilities.py::test_no_capability[has_send_close_prepared-PGconn.send_close_prepared()] PASSED
tests/test_capabilities.py::test_impl_build_error PASSED
tests/test_capabilities.py::test_no_capability[has_pipeline-Connection.pipeline()] PASSED
tests/test_capabilities.py::test_build_or_import_msg PASSED
tests/test_capabilities.py::test_has_capability[has_cancel_safe] SKIPPED (only for libpq >= 17)
tests/test_capabilities.py::test_has_capability[has_stream_chunked] SKIPPED (only for libpq >= 17)
tests/test_capabilities.py::test_no_capability[has_stream_chunked-Cursor.stream() with 'size' parameter greater than 1] PASSED

==================================================================================================== slowest durations ====================================================================================================

(44 durations < 0.005s hidden. Use -vv to show these durations.)
================================================================================================= short test summary info =================================================================================================
SKIPPED [1] tests/fix_pq.py:47: only for libpq >= 12
SKIPPED [3] tests/fix_pq.py:47: only for libpq >= 17
SKIPPED [1] tests/fix_pq.py:47: only for libpq >= 10
SKIPPED [2] tests/fix_pq.py:47: only for libpq >= 14
============================================================================================== 10 passed, 7 skipped in 0.21s ==============================================================================================

[setoru]

I followed the PYTHONPATH configuration exactly as shown in the Readme.

It seems there might be an issue with the current PYTHONPATH setup in the documentation.

[pangpang20]

You are correct. Here the command export PYTHONPATH=/your_path/gaussdb-python should point to the subdirectories:
export PYTHONPATH="/your_path/gaussdb-python/gaussdb:/your_path/gaussdb-python/gaussdb_pool", We will optimize the README and submit a PR in the future.