Skip to content

Commit

Permalink
Update doc
Browse files Browse the repository at this point in the history
  • Loading branch information
Rafiot committed Aug 26, 2016
1 parent 32bc878 commit a6ae9ae
Show file tree
Hide file tree
Showing 3 changed files with 22 additions and 14 deletions.
27 changes: 16 additions & 11 deletions README.md
@@ -1,3 +1,7 @@
README
======


[![Build Status](https://travis-ci.org/MISP/PyMISP.svg?branch=master)](https://travis-ci.org/MISP/PyMISP)
[![Coverage Status](https://coveralls.io/repos/github/MISP/PyMISP/badge.svg?branch=master)](https://coveralls.io/github/MISP/PyMISP?branch=master)

Expand All @@ -12,45 +16,46 @@ PyMISP allows you to fetch events, add or update events/attributes, add or updat
* [requests](http://docs.python-requests.org)

## Install from pip
~~~~

```
pip install pymisp
~~~~
```

## Install the lastest version from repo

~~~~
```
git clone https://github.com/CIRCL/PyMISP.git && cd PyMISP
python setup.py install
~~~~
```

## Samples and how to use PyMISP

Various examples and samples scripts are in the [examples/](examples/) directory.

In the examples directory, you will need to change the keys.py.sample to enter your MISP url and API key.

~~~~
```
cd examples
cp keys.py.sample keys.py
vim keys.py
~~~~
```

The API key of MISP is available in the Automation section of the MISP web interface.

To test if your URL and API keys are correct, you can test with examples/last.py to
fetch the last 10 events published.

~~~~
```
cd examples
python last.py -l 10
~~~~
```

## Documentation

[PyMISP API documentation is available](http://www.circl.lu/assets/files/PyMISP.pdf).

Documentation can be generated with epydoc:

~~~~
epydoc --url https://github.com/CIRCL/PyMISP --graph all --name PyMISP --pdf pymisp -o doc
~~~~
```
epydoc --url https://github.com/CIRCL/PyMISP --graph all --name PyMISP --pdf pymisp -o doc
```
6 changes: 3 additions & 3 deletions docs/source/conf.py
Expand Up @@ -17,9 +17,9 @@
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
#
# import os
# import sys
# sys.path.insert(0, os.path.abspath('.'))
import os
import sys
sys.path.insert(0, os.path.abspath('.'))

from recommonmark.parser import CommonMarkParser

Expand Down
3 changes: 3 additions & 0 deletions docs/source/index.rst
Expand Up @@ -11,6 +11,9 @@ Contents:
.. toctree::
:maxdepth: 2

readme
modules



Indices and tables
Expand Down

0 comments on commit a6ae9ae

Please sign in to comment.