pgconnstr

一个用于解析和操作PostgreSQL libpq风格连接字符串和URI的Python模块。

许可证

LGPLv3。有关详细信息，请参阅文件LICENSE。

class ConnectionString

pgconnstr.ConnectionString表示一个libpq连接字符串。

>>> from pgconnstr import ConnectionString
>>> c = ConnectionString(host='1.2.3.4', dbname='mydb', port=5432, user='anon',
...                      password="sec'ret", application_name='myapp')
...
>>> print(str(c))
application_name=myapp dbname=mydb host=1.2.3.4 password=sec\'ret port=5432 user=anon
>>> print(str(ConnectionString(str(c), dbname='otherdb')))
application_name=myapp dbname=otherdb host=1.2.3.4 password=sec\'ret port=5432 user=anon

组件可以通过属性访问。

>>> c.dbname
'mydb'
>>> c.host
'1.2.3.4'
>>> c.port
'5432'

如果未明确设置，标准组件将默认为None。有关标准关键词列表，请参阅https://postgresql.ac.cn/docs/12/libpq-connect.html#LIBPQ-PARAMKEYWORDS。

>>> c.connect_timeout is None
True

标准URI格式也可访问

>>> print(c.uri)
postgresql://anon:sec%27ret@1.2.3.4:5432/mydb?application_name=myapp

>>> print(ConnectionString(c, host='2001:db8::1234').uri)
postgresql://anon:sec%27ret@[2001:db8::1234]:5432/mydb?application_name=myapp