PyVirusShare

A Python 3 library to interact with VirusShare API v2. The project is inspired from the latest update from VirusShare and the existed tool, vt-py; a client library for VirusTotal.

Installation

pip3 install PyVirusShare

Usage

Library Usage Demo

from virusshare import VirusShare

# Create an instance of PyVirusShare
v = VirusShare('<api_key>')

# Search for the information about the specific hash
result = v.info('a1ac533baaf7de1dae53cf5b465aeca28a7f20bdfc79e5a0a39437dd728c231f')

print(result['data'])
"""
{
    "filetype": "PE32 executable (DLL) (console) Intel 80386 Mono/.Net assembly, for MS Windows",
    "md5": "985d5ff3a3ede247c561c0ea4cedd342",
    "exif": {
        "CharacterSet": "Unicode",
        "CodeSize": 291328,
        "Comments": "Mono.Security.dll",
        "CompanyName": "MONO development team",
        "EntryPoint": "0x2000",
        "FileDescription": "Mono.Security.dll",
        "FileFlags": "(none)",
        "FileFlagsMask": "0x003f",
        "FileOS": "Win32",
        "FileSize": "286 kB",
...
..
.
"""

|Method|Example| |--|--| |Virustotal.info|v.info('<hash_str>')| |Virustotal.download|v.download('<hash_str>', '/tmp')| |Virustotal.quick|v.quick('<hash_str>')| |Virustotal.source|v.source('<hash_str>')|

Command Line Usage

<!-- ``` $ PyVirusShare download -k <api_key> -hs <hash_string> -o <output_dir> ``` -->

TODO

TODO

• [ ] Test on Linux
• [ ] Test on Windows
• [ ] Implement the functionalities with the list of hashes and its rate limit system.

License

This project is licensed under the terms of the MIT license.