{"id":23519,"library":"dbs3-pycurl","title":"dbs3-pycurl","description":"DBS3 Pycurl Client is a Python library providing a pycurl-based HTTP client for interacting with the CMS Data Bookkeeping Service (DBS). Version 3.18.3 is currently available, with last release in 2023-2024, and it follows the DBS3 release schedule.","status":"active","version":"3.18.3","language":"python","source_language":"en","source_url":"https://github.com/dmwm/PycurlClient/tree/3.17.8","tags":["cms","dbs","pycurl","http-client","data-management"],"install":[{"cmd":"pip install dbs3-pycurl","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"Required for HTTP client functionality","package":"pycurl","optional":false},{"reason":"Required for Oracle database access","package":"cx-Oracle","optional":true}],"imports":[{"wrong":"from dbs.apis.dbsClient import DBSClient","symbol":"RestClient","correct":"from RestClient import RestClient"}],"quickstart":{"code":"from dbs.apis.dbsClient import DBSReader\nimport os\n\n# Example: fetch dataset summary by dataset\nreader = DBSReader(url=\"https://cmsweb.cern.ch/dbs/prod/global/DBSReader\")\ndataset = \"/Sample/Sample-4342-0003/GEN-SIM\"\nsummary = reader.listDatasetSummary(dataset=dataset)\nprint(summary)","lang":"python","description":"Initialize DBSReader with production URL and fetch dataset summary."},"warnings":[{"fix":"Create a new client instance per thread or use threading locks.","message":"The DBSClient and DBSReader classes are not thread-safe. Do not share instances across threads without locks.","severity":"gotcha","affected_versions":"all"},{"fix":"Monitor release notes for deprecation timelines and migrate to REST.","message":"The 'dbs.apis.dbsClient' API is gradually being replaced by REST-based clients. Check for 'DBS3Client' or direct REST calls in newer releases.","severity":"deprecated","affected_versions":">=3.18.0"},{"fix":"Install pycurl with SSL support, e.g., 'PYCURL_SSL_LIBRARY=openssl pip install pycurl'.","message":"The library uses pycurl under the hood; ensure that the system has libcurl installed and pycurl is compiled with SSL support to avoid connection errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'-2024':37 '2023':36 '3.18.3':28 'avail':31 'base':15 'bookkeep':24 'client':6,17,50 'cms':22,45 'current':30 'data':23,52 'data-manag':51 'dbs':26,46 'dbs3':2,4,42 'dbs3-pycurl':1 'follow':40 'http':16,49 'http-client':48 'interact':19 'last':33 'librari':10 'manag':53 'provid':11 'pycurl':3,5,14,47 'pycurl-bas':13 'python':9 'releas':34,43 'schedul':44 'servic':25 'version':27","created_at":"2026-05-01T08:08:12.746248+00:00","updated_at":"2026-05-01T08:08:12.746248+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'RestClient' from 'RestClient' (/tmp/tmpvw7c6rs6/venv/lib/python3.12/site-packages/RestClient/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"3.18.3","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/dmwm/PycurlClient","docs":null,"changelog":null,"pypi":"https://pypi.org/project/dbs3-pycurl/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["http-networking","data"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}