Metadata-Version: 2.1
Name: anyrun
Version: 0.1
Summary: app.any.run malware submissions client
Home-page: https://github.com/mwalkowski/anyrun
Author: Michal Walkowski
Author-email: mi.walkowski@gmail.com
License: pache Software License 2.0
Keywords: malware submissions app.any.run
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
Requires-Dist: websocket-client (==0.56.0)
Requires-Dist: pytest-runner (==5.1)

## APP.ANY.RUN CLIENT [![Build Status](https://travis-ci.com/mwalkowski/anyrun.svg?branch=master)](https://travis-ci.com/mwalkowski/anyrun) [![codecov](https://codecov.io/gh/mwalkowski/anyrun/branch/master/graph/badge.svg)](https://codecov.io/gh/mwalkowski/anyrun) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![PyPI version](https://badge.fury.io/py/AnyRunClient.svg)](https://badge.fury.io/py/AnyRunClient)

This is a package that allows downloading and searching malware analysis from public submissions from [app.any.run](https://app.any.run).
It is built as a websocket client application 

### Features


- Register to all public submissions
- Requirements

   - websocket_client==0.56.0
   - Python 3.5, 3.6, 3.7

### Installation


You can install django-celery-results either via the Python Package Index (PyPI)
or from source.

To install using `pip`,::

    $ pip install -U anyrun

### QuickStart

```
from anyrun import AnyRunClient


def callback(msg: dict) -> None:
    print(msg)


if __name__ == "__main__":
    client = AnyRunClient(
        on_message_cb=callback,
        enable_trace=False
    )
    client.connect()
    client.run_forever()

````
And as a response you should get
```
...
...
{'msg': 'added', 'collection': 'tasks', 'id': '5cf6d8005ed7525c25fe5660', 'fields': ... }
...
...
```
### Settings

|param|description|
|---|---|
|enable_trace| enables debug trace logs, default: False|


Testing
-------
You can run the tests by creating a Python virtual environment, installing
the requirements from `test_requirements.txt` 
```
pip install -r requirements.txt -r test_requirements.txt
```
Then:   
```
python pytest -v
```

TODO
----

- Add support for search.
- More examples.

