| Kat | a8ee6bb | 2013-04-05 17:06:30 +0200 | [diff] [blame] | 1 | Building/installation: |
| 2 | sudo python setup.py install |
| 3 | If you prefer to have it cleanly removable, install checkinstall and run |
| 4 | sudo checkinstall python setup.py install |
| Max | 32d0fd8 | 2016-03-30 14:58:15 +0200 | [diff] [blame] | 5 | Alternatively, just run 'pip install --user -e ./' |
| Kat | a8ee6bb | 2013-04-05 17:06:30 +0200 | [diff] [blame] | 6 | |
| 7 | Use |
| 8 | There are currently 3 scripts in this package: |
| 9 | osmodumpdoc.py - dump documentation (the VTY's "show online-help"). |
| 10 | osmotestconfig.py - test that apps start/write with example configs |
| 11 | osmotestvty.py - test vty operations (currently, tests very few) |
| 12 | |
| 13 | Each of these scripts imports a project-specific osmoappdesc.py, |
| 14 | which provides information about the available apps, configs, vty ports, etc. |
| 15 | |
| 16 | Run the scripts with osmoappdesc.py in the current directory (preferred) |
| 17 | or with -p <the directory containing osmoappdesc.py>. |
| 18 | Remember that osmoappdesc.py may contain relative paths. |
| 19 | |
| 20 | Example: |
| 21 | After install osmodumpdoc for openbsc's apps can be run by: |
| 22 | cd <your_source_dir>/openbsc/openbsc && osmodumpdoc.py |
| 23 | |
| 24 | Libraries: |
| 25 | osmopy/obscvty.py - connect to a vty, run commands on it, see the result |
| 26 | osmopy/osmoutil.py - code that's shared between the scripts |
| 27 | |
| 28 | obscvty.py may be of general use. osmoutil.py probably isn't. |