Commitee602b3

committed

Proof of concept for adding kwdoc content to properties using a decorator

1 parentbcef5d6 commitee602b3Copy full SHA for ee602b3

File tree

+29

-0

lines changed

+29

-0

lines changed

Lines changed: 25 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -3,6 +3,31 @@`
`3`	`3`	`from .import_api`
`4`	`4`
`5`	`5`
	`6`	`+defkwarg_doc(text):`
	`7`	`+"""`
	`8`	`+ Decorator for defining the documentation used when artist properties are`
	`9`	`+ passed through as keyword arguments.`
	`10`	`+`
	`11`	+ See e.g. the `**kwargs` section in `.Axes.text`.
	`12`	`+`
	`13`	+ The given text is stored in a privat variable ``_kwarg_doc`` on the method.
	`14`	`+ It is used for generating the kwdoc list for artists, which we`
	`15`	`+ auto-generate through docstring interpolation, e.g. via`
	`16`	+ ``%(Line2D:kwdoc)s``.
	`17`	`+`
	`18`	`+ The text should contain the supported types as well as the default value`
	`19`	`+ if applicable, e.g.:`
	`20`	`+`
	`21`	+ @_docstring.kwarg_doc("bool, default: :rc:`text.usetex`")
	`22`	`+ def set_usetex(self, usetex):`
	`23`	`+`
	`24`	`+ """`
	`25`	`+defdecorator(func):`
	`26`	`+func._kwarg_doc=text`
	`27`	`+returnfunc`
	`28`	`+returndecorator`
	`29`	`+`
	`30`	`+`
`6`	`31`	`classSubstitution:`
`7`	`32`	`"""`
`8`	`33`	`A decorator that performs %-substitution on an object's docstring.`

Lines changed: 3 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -1433,6 +1433,9 @@ def get_valid_values(self, attr):`
`1433`	`1433`	`raiseAttributeError('%s has no function %s'% (self.o,name))`
`1434`	`1434`	`func=getattr(self.o,name)`
`1435`	`1435`
	`1436`	`+ifhasattr(func,'_kwarg_doc'):`
	`1437`	`+returnfunc._kwarg_doc`
	`1438`	`+`
`1436`	`1439`	`docstring=inspect.getdoc(func)`
`1437`	`1440`	`ifdocstringisNone:`
`1438`	`1441`	`return'unknown'`

Lines changed: 1 addition & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -1279,6 +1279,7 @@ def set_fontproperties(self, fp):`
`1279`	`1279`	`self._fontproperties=FontProperties._from_any(fp).copy()`
`1280`	`1280`	`self.stale=True`
`1281`	`1281`
	`1282`	+@_docstring.kwarg_doc("bool, default: :rc:`text.usetex`")
`1282`	`1283`	`defset_usetex(self,usetex):`
`1283`	`1284`	`"""`
`1284`	`1285`	`Parameters`

Comments

(0)