{"id":43770195,"url":"https://github.com/cesbit/aiowmi","last_synced_at":"2026-04-01T20:27:35.605Z","repository":{"id":36962894,"uuid":"444865964","full_name":"cesbit/aiowmi","owner":"cesbit","description":"Python WMI Queries","archived":false,"fork":false,"pushed_at":"2026-03-27T13:20:49.000Z","size":161,"stargazers_count":28,"open_issues_count":6,"forks_count":10,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-03-27T23:55:29.660Z","etag":null,"topics":["python","wmi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cesbit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"cesbit"}},"created_at":"2022-01-05T16:05:13.000Z","updated_at":"2026-03-27T13:20:53.000Z","dependencies_parsed_at":"2024-07-17T09:37:44.587Z","dependency_job_id":null,"html_url":"https://github.com/cesbit/aiowmi","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"purl":"pkg:github/cesbit/aiowmi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cesbit%2Faiowmi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cesbit%2Faiowmi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cesbit%2Faiowmi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cesbit%2Faiowmi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cesbit","download_url":"https://codeload.github.com/cesbit/aiowmi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cesbit%2Faiowmi/sbom","scorecard":{"id":271507,"data":{"date":"2025-08-11","repo":{"name":"github.com/cesbit/aiowmi","commit":"2d2af4118b5d6a7fe9e9f2de3f090218c8e45705"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.8,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Code-Review","score":2,"reason":"Found 7/30 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/ci.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/cesbit/aiowmi/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/cesbit/aiowmi/ci.yml/main?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/ci.yml:21","Warn: pipCommand not pinned by hash: .github/workflows/ci.yml:22","Warn: pipCommand not pinned by hash: .github/workflows/ci.yml:23","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   3 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":8,"reason":"2 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2023-62 / GHSA-m2qf-hxjv-5gpq","Warn: Project is vulnerable to: GHSA-j225-cvw7-qrx7"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 10 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T13:30:20.692Z","repository_id":36962894,"created_at":"2025-08-17T13:30:20.692Z","updated_at":"2025-08-17T13:30:20.692Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291624,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","wmi"],"created_at":"2026-02-05T16:34:32.474Z","updated_at":"2026-04-01T20:27:35.597Z","avatar_url":"https://github.com/cesbit.png","language":"Python","funding_links":["https://github.com/sponsors/cesbit"],"categories":[],"sub_categories":[],"readme":"[![CI](https://github.com/cesbit/aiowmi/workflows/CI/badge.svg)](https://github.com/cesbit/aiowmi/actions)\n[![Release Version](https://img.shields.io/github/release/cesbit/aiowmi)](https://github.com/cesbit/aiowmi/releases)\n\n\n# Python WMI\n\nWindows Management Interface connector using asyncio for the Python language.\n\n**Supports:**\n- [x] NTLM Authentication\n- [x] Kerberos Authentication\n- [x] WMI Query (IWbemServices_ExecQuery)\n- [x] Parsing of basic WMI Objects (int/float/str/datetime/array/references)\n- [x] Optimized queries using the SmartEnum implementation\n\n**Todo:**\n- [ ] Async WMI Query (IWbemServices_ExecQueryAsync)\n- [ ] Other DCOM/RPC/WMI calls?\n- [ ] Support for WMI Methods?\n- [ ] Improve documentation\n\n## Usage\n\nThe example below covers most of what is suppored by this library:\n\n```python\n\nimport asyncio\nimport logging\nimport time\nfrom aiowmi.connection import Connection\nfrom aiowmi.query import Query\n\n\nasync def main():\n\n    host = '10.0.0.1'  # ip address or hostname or fqdn\n    username = 'username'\n    password = 'password'\n    domain = ''  # optional domain name\n\n    # Query has a default namespace 'root/cimv2'\n    queries = (\n        Query('SELECT * FROM Win32_OperatingSystem', namespace='root/cimv2'),\n        Query('SELECT * FROM Win32_NetworkAdapter'),\n        Query('SELECT * FROM Win32_LoggedOnUser'),\n        Query('SELECT * FROM Win32_PnpEntity'),\n        Query('SELECT Caption, Description, InstallDate, InstallDate2, '\n              'InstallLocation, InstallSource, InstallState, Language, '\n              'LocalPackage, Name, PackageCache, PackageCode, PackageName, '\n              'ProductID, RegCompany, RegOwner, SKUNumber, Transforms, '\n              'URLInfoAbout, URLUpdateInfo, Vendor, Version '\n              'FROM Win32_Product'),\n        Query('SELECT Name, DiskReadsPersec, DiskWritesPersec '\n              'FROM Win32_PerfFormattedData_PerfDisk_LogicalDisk'),\n    )\n\n    start = time.time()\n\n    conn = Connection(host, username, password, domain=domain)\n    service = None\n    await conn.connect()\n    try:\n        service = await conn.negotiate_ntlm()\n\n        for query in queries:\n            print(f\"\"\"\n###############################################################################\n# Start Query: {query.query}\n###############################################################################\n\"\"\")\n            async with query.context(conn, service) as qc:\n                async for props in qc.results():\n                    # Function `get_properties(..)` accepts a few keyword\n                    # arguments:\n                    #\n                    # ignore_defaults:\n                    #        Ignore default values. Set missing values to None\n                    #        if a value does not exist in the current class.\n                    #        ignore_defaults will always be True if\n                    #        ignore_missing is set to True.\n                    # ignore_missing:\n                    #       If set to True, values missing in the current class\n                    #       will not be part of the result.\n                    # load_qualifiers:\n                    #       Load the qualifiers of the properties. If False,\n                    #       the property qualifier_set will have the offset\n                    #       in the heap where the qualifiers are stored.\n                    #\n                    for name, prop in props.items():\n                        print(name, '\\n\\t', prop.value)\n\n                        if prop.is_reference():\n                            # References can easy be queried using the\n                            # get_reference(..) function. The function accepts\n                            # a keyword argument `filter_props=[..]` with an\n                            # optional list of properties to query. If omitted,\n                            #  the function returns all (*) properties.\n                            res = await prop.get_reference(conn, service)\n                            ref_props = res.get_properties(ignore_missing=True)\n                            for name, prop in ref_props.items():\n                                print('\\t\\t', name, '\\n\\t\\t\\t', prop.value)\n\n                    print(f\"\"\"\n----------------------------------- End Item ----------------------------------\n\"\"\")\n    finally:\n        if service:\n            service.close()\n        conn.close()\n        end = time.time()\n        print('done in ', end-start)\n\nif __name__ == '__main__':\n    formatter = logging.Formatter(\n            fmt='[%(levelname)1.1s %(asctime)s %(module)s:%(lineno)d] ' +\n                '%(message)s',\n            datefmt='%y%m%d %H:%M:%S',\n            style='%')\n\n    ch = logging.StreamHandler()\n    ch.setLevel(logging.DEBUG)\n    ch.setFormatter(formatter)\n\n    logger = logging.getLogger('aiowmi')\n    logger.addHandler(ch)\n    logger.setLevel(logging.DEBUG)\n\n    asyncio.run(main())\n\n\n```\n\n\n## Kerberos\n\nFor Kerberos Authentication, make sure to use a FQDN as hostname and domain\nis no longer optional.\n\nFor caching TGT and TGS, a kerberos cache per connection can be kept.\n\n```python\nfrom aiowmi.connection import Connection\nfrom aiowmi.kerberos.cache import KerberosCache\n\n# Example file cache (tgt, tgs are stored and loaded from file)\nkcache = KerberosCache('/tmp/kcache.bin')\n\n# Example mem-cache (tgt, tgs are stored in the cache which can be re-used)\nkcache = KerberosCache()\n\nconn = Connection(..., kerberos_cache=kcache)\n# If different from the host, the kdc_host address may be provided\n# for the Kerberos Key Distribution Center (KDC).\n#\n# Once connected (await conn.connect()), make the following negotiation call:\n#   service = await conn.negotiate_kerberos()\n\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcesbit%2Faiowmi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcesbit%2Faiowmi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcesbit%2Faiowmi/lists"}