[Python.NET] DocStringAttribute Example
Jonno
jonnojohnson at gmail.com
Wed Mar 12 17:59:56 CET 2014
My mistake Tony,
I was using the 2.0 CLR version of pythondotnet which doesn't have the
DocStringAttribute class.
On Wed, Mar 12, 2014 at 9:46 AM, Tony Roberts <tony at pyxll.com> wrote:
> Hi,
>
> have you added the Python.Runtime to your project references? Take a look
> at the Python.Test project that's used by the unit tests if you're not sure
> how to set up your project.
>
> cheers,
> Tony
>
>
> On Wed, Mar 12, 2014 at 2:33 PM, Jonno <jonnojohnson at gmail.com> wrote:
>
>> Thanks Tony,
>>
>> This is probably my ignorance of C# but I get the following error using
>> the same syntax as the example:
>>
>> The type or namespace name 'DocStringAttribute' could not be found (are
>> you missing a using directive or an assembly reference?)
>>
>> I have the:
>> using Python.Runtime
>> statement.
>>
>>
>> On Fri, Mar 7, 2014 at 12:19 PM, Tony Roberts <tony at pyxll.com> wrote:
>>
>>> Hi,
>>>
>>> if your class has a constructor then the class docstring will get
>>> replaced with a description of the constructor, even if you explicitly gave
>>> the class a docstring using DocStringAttribute.
>>>
>>> I've created an issue for github for this and fixed it:
>>> https://github.com/pythonnet/pythonnet/issues/14
>>>
>>> In the same commit I added some unit tests which should do as an example
>>> for you to see how it should work (see the newly added file
>>> pythonnet/src/testing/doctest.cs and pythonnet/src/tests/test_docstring.py).
>>>
>>> cheers,
>>> Tony
>>>
>>>
>>>
>>> On Wed, Mar 5, 2014 at 3:59 PM, Jonno <jonnojohnson at gmail.com> wrote:
>>>
>>>> Hi,
>>>>
>>>> Is there an example how to format documentation in classes & methods so
>>>> that a python docstring will be produced?
>>>>
>>>> I found the following in a thread a while back but it's not working for
>>>> me:
>>>>
>>>> ### test.cs ##
>>>> using System;
>>>> using System.Runtime.InteropServices;
>>>> using Python.Runtime;
>>>>
>>>> namespace PinvokeTest
>>>> {
>>>> [DocStringAttribute("Interface class to external functions.")]
>>>> public class Invoke {
>>>>
>>>> [DocStringAttribute("External funtion simulation: WriteToFile(char)
>>>> will write a char to the terminal.")]
>>>> public static void WriteToFile(char arg) {
>>>> Console.WriteLine("Writing {0}", arg);
>>>> return;
>>>> }
>>>> }
>>>> }
>>>>
>>>>
>>>> _________________________________________________
>>>> Python.NET mailing list - PythonDotNet at python.org
>>>> https://mail.python.org/mailman/listinfo/pythondotnet
>>>>
>>>
>>>
>>> _________________________________________________
>>> Python.NET mailing list - PythonDotNet at python.org
>>> https://mail.python.org/mailman/listinfo/pythondotnet
>>>
>>
>>
>> _________________________________________________
>> Python.NET mailing list - PythonDotNet at python.org
>> https://mail.python.org/mailman/listinfo/pythondotnet
>>
>
>
> _________________________________________________
> Python.NET mailing list - PythonDotNet at python.org
> https://mail.python.org/mailman/listinfo/pythondotnet
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/pythondotnet/attachments/20140312/ce22d038/attachment-0001.html>
More information about the PythonDotNet
mailing list