[Ns-developers] upcoming ns-3 merge plan

[Gustavo Carneiro]

2008/7/12 Tom Henderson <tomh at tomh.org>:

> Gustavo Carneiro wrote:
>
>> 2008/7/12 Tom Henderson <tomh at tomh.org <mailto:tomh at tomh.org>>:
>>
>>    Hi all,
>>
>>    We have a lot of parallel development efforts ongoing, and I would
>>    like to suggest that we start to move several things to ns-3-dev.
>>
>>    1) Python:  Gustavo has been progressing the Python bindings based
>>    on feedback from Mathieu, and they now seem to be ready to merge and
>>    to start to get some user experience with them, so we'd like to
>>    suggest merging them ASAP
>>
>>
>> Python has been merged now.  Bring on the problem reports.. :P
>>
>> I hope Python bindings does not interfere too much with NS-3 development.
>>  If, by any chance, something breaks when compiling Python, just report the
>> problem and carry on with "./waf configure --python-disable" ("./waf
>> --python-disable" also works to disable Python for a single build run).
>>
>> Keep in mind that API coverage is not yet complete, and will be gradually
>> improved.  But testing of the Python bindings will be most appreciated.
>>
>> Happy testing! :-)
>>
>
> Gustavo, thanks for all of this work.  Can you point users to any examples
> or documentation at this time on how to get started with ns-3 Python?


There used to be some examples ported over to Python, but due to constant
API changes I stopped caring about examples at some point.  Sorry.

For now there is only one example, samples/simple-simulator.py (to run, try:
./waf --pyrun samples/simple-simulator.py), and some (very few) unit tests
in utils/python-unit-tests.py.

There is not much to say about Python API, as it tries to mimic the C++ one
as closely as possible, with very few exceptions where justified.  Of course
it is expected users know how to program in Python.

Help to port more examples would be most welcome.  Porting examples, as well
as adding unit tests, will also help figure out where the bindings need more
work.

-- 
Gustavo J. A. M. Carneiro
INESC Porto, Telecommunications and Multimedia Unit
"The universe is always one step beyond logic." -- Frank Herbert