Update doc

pull/30/head
Raphaël Vinot 2016-08-26 12:13:58 +02:00
parent 32bc8782f0
commit a6ae9ae5f4
3 changed files with 22 additions and 14 deletions

View File

@ -1,3 +1,7 @@
README
======
[![Build Status](https://travis-ci.org/MISP/PyMISP.svg?branch=master)](https://travis-ci.org/MISP/PyMISP) [![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) [![Coverage Status](https://coveralls.io/repos/github/MISP/PyMISP/badge.svg?branch=master)](https://coveralls.io/github/MISP/PyMISP?branch=master)
@ -12,16 +16,17 @@ PyMISP allows you to fetch events, add or update events/attributes, add or updat
* [requests](http://docs.python-requests.org) * [requests](http://docs.python-requests.org)
## Install from pip ## Install from pip
~~~~
```
pip install pymisp pip install pymisp
~~~~ ```
## Install the lastest version from repo ## Install the lastest version from repo
~~~~ ```
git clone https://github.com/CIRCL/PyMISP.git && cd PyMISP git clone https://github.com/CIRCL/PyMISP.git && cd PyMISP
python setup.py install python setup.py install
~~~~ ```
## Samples and how to use PyMISP ## Samples and how to use PyMISP
@ -29,21 +34,21 @@ 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. In the examples directory, you will need to change the keys.py.sample to enter your MISP url and API key.
~~~~ ```
cd examples cd examples
cp keys.py.sample keys.py cp keys.py.sample keys.py
vim keys.py vim keys.py
~~~~ ```
The API key of MISP is available in the Automation section of the MISP web interface. 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 To test if your URL and API keys are correct, you can test with examples/last.py to
fetch the last 10 events published. fetch the last 10 events published.
~~~~ ```
cd examples cd examples
python last.py -l 10 python last.py -l 10
~~~~ ```
## Documentation ## Documentation
@ -51,6 +56,6 @@ python last.py -l 10
Documentation can be generated with epydoc: 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
~~~~ ```

View File

@ -17,9 +17,9 @@
# add these directories to sys.path here. If the directory is relative to the # 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. # documentation root, use os.path.abspath to make it absolute, like shown here.
# #
# import os import os
# import sys import sys
# sys.path.insert(0, os.path.abspath('.')) sys.path.insert(0, os.path.abspath('.'))
from recommonmark.parser import CommonMarkParser from recommonmark.parser import CommonMarkParser

View File

@ -11,6 +11,9 @@ Contents:
.. toctree:: .. toctree::
:maxdepth: 2 :maxdepth: 2
readme
modules
Indices and tables Indices and tables