neo4j / neo4j/neo4j-python-driver
Unix Socket support
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 1k
- Forks
- 213
- Avg merge
- 1d 3h
- Merged PRs (30d)
- 19
Description
Parsing a Neo4J URL goes through a number of specifically coded schemes
While servers recently received the capability to bind to unix sockets, the python client doesn't recognize the bolt+unix scheme.
Attempting to connect throws an error:
neo4j.exceptions.ConfigurationError: URI scheme 'bolt+unix' is not supported. Supported URI schemes are ['bolt', 'bolt+ssc', 'bolt+s', 'neo4j', 'neo4j+ssc', 'neo4j+s']. Examples: bolt://host[:port] or neo4j://host[:port][?routing_context]
Feature Request
Add proper bolt+unix scheme support to the Python library.
Pitch
Unix sockets were labeled as production ready in the 2025.09.0 release.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading the URI parsing sections linked in src/neo4j/_api.py and the supported-scheme definitions in src/neo4j/api.py. Trace how an unsupported scheme reaches ConfigurationError, then verify that bolt+unix is accepted and can be used for connections without breaking the existing schemes.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- neo4j, python
- Domain
- databases
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100