v4.5.0

New features:

• recent_* and search_* methods accept chunk_size argument that allows to set size of requested entries while iterating over results (default is 10). Requires MWDB Core v2.9.0 (#94)
• Classes representing MWDB objects have meaningful __repr__ that prints basic object attributes (#95)
• CLI: mwdb login accepts --use-keyring/--no-keyring flag that allows you to choose whether you want to use keyring for storing credentials or not. It's useful especially on platforms that doesn't support keyring at all (#85)
• MWDB constructor accepts autologin argument (default: True). You can set it to False if you don't want to automatically fetch stored credentials and login during object construction (#85)

Bugfixes:

• mwdb login/mwdb logout no longer try to login using previously stored credentials (#85)

v4.4.0

New features:

• Added remove_comment function in MWDBObject (#87, thanks @msm-code!)

Bugfixes:

• Fixed mwdb login --api-key that was failing silently to store API key (thanks @v-rzh for bug report #90 and @Repumba for fix #92)

v4.3.1

Bugfixes:

• Fixed methods implementing fallback for older server versions (e.g. MWDBFile.download() / mwdb fetch) (#83)

v4.3.0

New features:

• HTTP 413 handling (ObjectTooLargeError, #81)

Bugfixes:

• CLI: Confirmation messages are printed to stderr instead of stdout (#76)
• Fixed blob overwrite in config_dhash (#80)
• Fixed wrapping of methods with server version-dependent fallback (#79)

v4.2.1

Bugfixes:

• CLI: Fixed broken fetch command (#74)

v4.2.0

New features:

• Removing attributes by attribute id (#68)

Bugfixes:

• Fixed compatibility with 8.x versions of Click (#71)

v4.1.0

New features and improvements:

• add_attribute method and attributes attribute in MWDBObject are backwards compatible and automatically fallback to older API if server version is < 2.6.0. Use them instead of add_metakey and metakeys (#65)
• Exposed and documented APIClientOptions (#67).
• Added APIClient.support_version for semver-aware server version check (#67).
• Support for karton_id and karton_arguments parameters in upload methods to assign Karton analysis to uploaded objects.
• Basic support for new attribute API in CLI (#62)

v4.0.0

Breaking changes:

• Dropped compatibility with Python 2. Recommended minimal Python version is 3.7
• Dropped legacy Malwarecage-named object aliases (use MWDB instead of Malwarecage)
• MWDB uses ~/.mwdb configuration as a defaults. Use config_path argument if you want to use another file or don't load configuration at all (None)
• ~/.mwdb configuration is scoped and allows to specify different options for each MWDB Core instance

[mwdb]
api_url = https://mwdb.cert.pl/api/

[mwdb:https://mwdb.cert.pl/api/]
...

[mwdb:http://127.0.0.1/api/]
...

mwdb login --api-url <API_URL> sets the default API endpoint used by further CLI invocations and api_url default in MWDB() constructor.

New features and improvements:

• CLI: -o json option to use JSON output for commands (#43)
• Support for Karton API (#52)
• Support for tagging an object along with upload (supported by MWDB Core >=2.6.0, #58)
• Support for new Attribute API introduced in MWDB Core 2.6.0 (#59)
• MWDBObject.remove() to remove current object from MWDB (#55)

v3.4.1

Bugfixes in CLI component:

• Remember api_url provided to mwdb login in further commands (#29)
• Fixed incorrect API key validation by mwdb login (#40)
• Fixed deprecated uses of beautifultable (#37)

v3.4.0

New features:

• listen_for_*: Added query argument (#21)
• Added typing stubs (#19)

Improvements and bugfixes:

• listen_for_*: Prevented iterating over whole database when pivot object has been deleted (#21)
• listen_for_*: RuntimeError("generator raised StopIteration") was raised when list of objects was initially empty and no pivot was provided (#24)
• Missing --output short option in CLI help message (#20)