{"id":24398,"library":"pysmbclient","title":"PySMBClient","description":"PySMBClient is a convenient wrapper around smbclient for accessing SMB/CIFS shares. Version 0.1.5 is the latest release, but the library appears to be in maintenance mode with infrequent updates.","status":"maintenance","version":"0.1.5","language":"python","source_language":"en","source_url":"https://github.com/ktbartholomew/pysmbclient","tags":["smb","smbclient","wrapper","fileshare"],"install":[{"cmd":"pip install pysmbclient","lang":"bash","label":"PyPI install"}],"dependencies":[],"imports":[{"wrong":"from smbclient import PySMBClient","symbol":"SambaClient","correct":"from smbclient import SambaClient"}],"quickstart":{"code":"from smbclient import PySMBClient, register\nimport os\n\nregister(username='user', password='pass')\nwith PySMBClient() as client:\n    with client.open('smb://server/share/file.txt', mode='r') as f:\n        print(f.read())","lang":"python","description":"Basic file read from an SMB share. Note: register() must be called before operations."},"warnings":[{"fix":"Use 'from smbclient import PySMBClient' instead of 'from pysmbclient import PySMBClient'.","message":"The library uses the module name 'smbclient', not 'pysmbclient'. Importing 'pysmbclient' directly will raise ModuleNotFoundError.","severity":"gotcha","affected_versions":"all"},{"fix":"Ensure your SMB server supports SMB2+; consider using pysmb or smbprotocol for legacy SMB1.","message":"SMB protocol versions older than SMB2 may not be supported. The library relies on system smbclient which may have version restrictions.","severity":"deprecated","affected_versions":">=0.1.4"},{"fix":"Always call register() before instantiating PySMBClient.","message":"Authentication must be registered before any connection. Calling register() after opening a client can cause 'Operation not permitted' errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'0.1.5':14 'access':10 'appear':22 'around':7 'conveni':5 'fileshar':34 'infrequ':29 'latest':17 'librari':21 'mainten':26 'mode':27 'pysmbclient':1,2 'releas':18 'share':12 'smb':31 'smb/cifs':11 'smbclient':8,32 'updat':30 'version':13 'wrapper':6,33","created_at":"2026-05-01T08:12:51.932450+00:00","updated_at":"2026-05-01T08:12:51.932450+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.1.5","cli_name":"","cli_version":null,"type":"library","homepage":"http://bitbucket.org/nosklo/pysmbclient","github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/pysmbclient/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["http-networking"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}