[pslacerda]

It is parsed into a DocstringMeta.

[pslacerda]

In my actual usage I'm monkey patching to support a style similar to google:

import docstring_parser.parser.google, re
docstring_parser.parser.google._sections = {
    "ARGUMENTS": "param",
    "EXAMPLES": "examples",
}
docstring_parser.parser.google._titles_re = re.compile(
    "^(" + "|".join("(%s)" % t for t in docstring_parser.parser.google._sections) + ")", flags=re.M
)
docstring_parser.parser.google._valid = {t for t, a in docstring_parser.parser.google._sections.items() if a}

[rr-]

@pslacerda can you add tests for this?

[pslacerda]

Sure I can. I do need Notes, Note and Example also, beside Examples. Should I add these too?

[rr-]

Yes.

If you're feeling adventurous, you could refactor it so that extending the library for whatever sections you need is possible and doesn't require such hacks.

[pslacerda]

I was feeling adventurous, just finished the code. Even with it a bit ugly, it is working for my case. I expect it to be an usual case.

[pslacerda]

-- I'd rather preferred GoogleParser.
-- Me too!
[Closed]

[rr-]

Thank you. Excellent work, though I don't understand the last comment. I requested only some cosmetic changes.

[pslacerda]

I was trying to say that maybe it could be like:

class GoogleParser:
    """New API for custom sections"""
    _sections: ...
    _title_colon: ...
    _titles_re: ...
    _valid: ...

    def __init__(sections=None, title_colon=True): pass
    def parse(): pass
    def add_section(): pass
    def _build_meta(): pass

def parse(s):
    """Old & easy API keep as it was."""
    return GoogleParser().parse(s)

But now I like the way it turned.

[pslacerda]

Just tried with classes, see if you like. Also things that looks like titles but aren't titles are now description.

[rr-]

@pslacerda thanks, beautiful work. Merged. LMK if you need a new version on PyPI.

[pslacerda]

@rr- seems you merged local but didn't pushed to Github.
I want to show the usage briefly in the README. Then a new version would be more than welcome.

[rr-]

@pslacerda haha you're right :D I just pushed the changes. OK, LMK once you document the changes and we'll release a new version. Also, I apologize for the late reply.