music21.documentation.library.documenters¶
AttributeDocumenter¶
-
class
music21.documentation.library.documenters.
AttributeDocumenter
(referent, memberName, definingClass)¶ A documenter for class attributes, both read/write and read-only:
>>> from music21 import documentation, key >>> attribute = key.KeySignature.mode >>> documenter = documentation.AttributeDocumenter( ... attribute, 'mode', key.KeySignature) >>> documenter <music21.documentation.library.documenters.AttributeDocumenter: music21.key.KeySignature.mode>
>>> documenter.rstCrossReferenceString ':attr:`~music21.key.KeySignature.mode`'
>>> for line in documenter.rstAutodocDirectiveFormat: ... line ... '.. autoattribute:: music21.key.KeySignature.mode' ''
AttributeDocumenter
bases
AttributeDocumenter
read-only properties
-
AttributeDocumenter.
rstAutodocDirectiveFormat
¶
-
AttributeDocumenter.
sphinxCrossReferenceRole
¶
Read-only properties inherited from MemberDocumenter
:
Read-only properties inherited from ObjectDocumenter
:
Read-only properties inherited from Documenter
:
AttributeDocumenter
methods
Methods inherited from MemberDocumenter
:
Methods inherited from Documenter
:
ClassDocumenter¶
-
class
music21.documentation.library.documenters.
ClassDocumenter
(referent)¶ A documenter for one class:
>>> from music21 import documentation >>> klass = documentation.ClassDocumenter >>> documenter = documentation.ClassDocumenter(klass) >>> documenter <music21.documentation.library.documenters.ClassDocumenter: music21.documentation.library.documenters.ClassDocumenter>
>>> documenter.rstCrossReferenceString ':class:`~music21.documentation.library.documenters.ClassDocumenter`'
>>> for line in documenter.rstAutodocDirectiveFormat: ... line ... '.. autoclass:: music21.documentation.library.documenters.ClassDocumenter' ''
Generate the ReST lines by calling run on the documenter:
>>> restructedText = documenter.run()
ClassDocumenter
bases
ClassDocumenter
read-only properties
-
ClassDocumenter.
baseClassDocumenters
¶
-
ClassDocumenter.
baseClasses
¶
-
ClassDocumenter.
docAttr
¶ The music21 _DOC_ATTR definition for a documented class:
>>> from music21 import documentation, stream >>> klass = stream.Stream >>> documenter = documentation.ClassDocumenter(klass) >>> for key in sorted(list(documenter.docAttr.keys())): ... key ... 'autoSort' 'definesExplicitPageBreaks' 'definesExplicitSystemBreaks' 'isFlat' 'isSorted' 'recursionType'
-
ClassDocumenter.
docOrder
¶ The music21 _DOC_ORDER definition for a documented class:
>>> from music21 import documentation, stream >>> klass = stream.Stream >>> documenter = documentation.ClassDocumenter(klass) >>> for name in documenter.docOrder: ... name ... 'append' 'insert' 'insertAndShift' 'notes' 'pitches' 'transpose' 'augmentOrDiminish' 'scaleOffsets' 'scaleDurations'
-
ClassDocumenter.
inheritedDocAttrMapping
¶ A mapping of parent class documenters and doc-attr attribute dicts for a documented class:
>>> from music21 import documentation, stream >>> klass = stream.Measure >>> documenter = documentation.ClassDocumenter(klass) >>> mapping = documenter.inheritedDocAttrMapping >>> sortBy = lambda x: x.referentPackagesystemPath >>> for classDocumenter in sorted(mapping, key=sortBy): ... classDocumenter ... <music21.documentation.library.documenters.ClassDocumenter: music21.base.Music21Object> <music21.documentation.library.documenters.ClassDocumenter: music21.stream.Stream>
-
ClassDocumenter.
inheritedMethodsMapping
¶ A mapping of parent class documenters and inherited attributes for a documented class:
>>> from music21 import documentation, stream >>> klass = stream.Measure >>> documenter = documentation.ClassDocumenter(klass) >>> mapping = documenter.inheritedMethodsMapping >>> sortBy = lambda x: x.referentPackagesystemPath >>> for classDocumenter in sorted(mapping, key=sortBy): ... print('{0}:'.format( ... classDocumenter.referentPackagesystemPath)) ... for attributeDocumenter in mapping[classDocumenter][:10]: ... print('- {0}'.format( ... attributeDocumenter.referentPackagesystemPath)) ... music21.base.Music21Object: - music21.base.Music21Object.contextSites - music21.base.Music21Object.findAttributeInHierarchy - music21.base.Music21Object.getAllContextsByClass - music21.base.Music21Object.getContextAttr - music21.base.Music21Object.getContextByClass - music21.base.Music21Object.getOffsetBySite - music21.base.Music21Object.getSpannerSites - music21.base.Music21Object.hasSite - music21.base.Music21Object.isClassOrSubclass - music21.base.Music21Object.next music21.stream.Stream: - music21.stream.Stream.activateVariants - music21.stream.Stream.addGroupForElements - music21.stream.Stream.allPlayingWhileSounding - music21.stream.Stream.analyze - music21.stream.Stream.append - music21.stream.Stream.asTimespans - music21.stream.Stream.attachIntervalsBetweenStreams - music21.stream.Stream.attachMelodicIntervals - music21.stream.Stream.attributeCount - music21.stream.Stream.augmentOrDiminish
-
ClassDocumenter.
inheritedReadonlyPropertiesMapping
¶ A mapping of parent class documenters and inherited read-only properties for a documented class:
>>> from music21 import documentation, stream >>> klass = stream.Measure >>> documenter = documentation.ClassDocumenter(klass) >>> mapping = documenter.inheritedReadonlyPropertiesMapping >>> sortBy = lambda x: x.referentPackagesystemPath >>> for classDocumenter in sorted(mapping, key=sortBy): ... print('{0}:'.format( ... classDocumenter.referentPackagesystemPath)) ... for attributeDocumenter in mapping[classDocumenter][:10]: ... print('- {0}'.format( ... attributeDocumenter.referentPackagesystemPath)) ... music21.base.Music21Object: - music21.base.Music21Object.classes - music21.base.Music21Object.containerHierarchy - music21.base.Music21Object.derivation - music21.base.Music21Object.fullyQualifiedClasses - music21.base.Music21Object.isGrace - music21.base.Music21Object.measureNumber music21.stream.Stream: - music21.stream.Stream.beat - music21.stream.Stream.beatDuration - music21.stream.Stream.beatStr - music21.stream.Stream.beatStrength - music21.stream.Stream.flat - music21.stream.Stream.highestOffset - music21.stream.Stream.highestTime - music21.stream.Stream.isGapless - music21.stream.Stream.lowestOffset - music21.stream.Stream.notes
-
ClassDocumenter.
inheritedReadwritePropertiesMapping
¶ A mapping of parent class documenters and inherited read/write properties for a documented class:
>>> from music21 import documentation, stream >>> klass = stream.Measure >>> documenter = documentation.ClassDocumenter(klass) >>> mapping = documenter.inheritedReadwritePropertiesMapping >>> sortBy = lambda x: x.referentPackagesystemPath >>> for classDocumenter in sorted(mapping, key=sortBy): ... print('{0}:'.format(classDocumenter.referentPackagesystemPath)) ... for attributeDocumenter in mapping[classDocumenter][:10]: ... print('- {0}'.format(attributeDocumenter.referentPackagesystemPath)) ... music21.base.Music21Object: - music21.base.Music21Object.activeSite - music21.base.Music21Object.offset - music21.base.Music21Object.offsetFloat - music21.base.Music21Object.offsetRational - music21.base.Music21Object.priority - music21.base.Music21Object.quarterLength - music21.base.Music21Object.quarterLengthFloat music21.stream.Stream: - music21.stream.Stream.atSoundingPitch - music21.stream.Stream.duration - music21.stream.Stream.elements - music21.stream.Stream.finalBarline - music21.stream.Stream.metadata - music21.stream.Stream.seconds
-
ClassDocumenter.
methods
¶ The method documenters for a documented class:
>>> from music21 import documentation, stream >>> klass = stream.Stream >>> documenter = documentation.ClassDocumenter(klass) >>> for method in documenter.methods[:10]: ... method ... <music21.documentation.library.documenters.MethodDocumenter: music21.stream.Stream.activateVariants> <music21.documentation.library.documenters.MethodDocumenter: music21.stream.Stream.addGroupForElements> <music21.documentation.library.documenters.MethodDocumenter: music21.stream.Stream.allPlayingWhileSounding> <music21.documentation.library.documenters.MethodDocumenter: music21.stream.Stream.analyze> <music21.documentation.library.documenters.MethodDocumenter: music21.stream.Stream.append> <music21.documentation.library.documenters.MethodDocumenter: music21.stream.Stream.asTimespans> <music21.documentation.library.documenters.MethodDocumenter: music21.stream.Stream.attachIntervalsBetweenStreams> <music21.documentation.library.documenters.MethodDocumenter: music21.stream.Stream.attachMelodicIntervals> <music21.documentation.library.documenters.MethodDocumenter: music21.stream.Stream.attributeCount> <music21.documentation.library.documenters.MethodDocumenter: music21.stream.Stream.augmentOrDiminish>
-
ClassDocumenter.
readonlyProperties
¶ The read-only property documenters for a documented class:
>>> from music21 import documentation, stream >>> klass = stream.Stream >>> documenter = documentation.ClassDocumenter(klass) >>> for attr in documenter.readonlyProperties: ... attr ... <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.beat> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.beatDuration> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.beatStr> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.beatStrength> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.flat> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.highestOffset> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.highestTime> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.isGapless> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.lowestOffset> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.notes> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.notesAndRests> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.offsetMap> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.pitches> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.secondsMap> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.semiFlat> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.sorted> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.spannerBundle> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.spanners> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.variants> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.voices>
-
ClassDocumenter.
readwriteProperties
¶ The read/write property documenters for a documented class:
>>> from music21 import documentation, stream >>> klass = stream.Stream >>> documenter = documentation.ClassDocumenter(klass) >>> for prop in documenter.readwriteProperties: ... prop ... <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.atSoundingPitch> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.duration> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.elements> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.finalBarline> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.metadata> <music21.documentation.library.documenters.AttributeDocumenter: music21.stream.Stream.seconds>
-
ClassDocumenter.
referentPackagesystemPath
¶
-
ClassDocumenter.
rstAutodocDirectiveFormat
¶
-
ClassDocumenter.
rstBasesFormat
¶ The ReST format for the bases from which the documented class inherits:
>>> from music21 import documentation >>> klass = documentation.ClassDocumenter >>> documenter = documentation.ClassDocumenter(klass) >>> for line in documenter.rstBasesFormat: ... line ... '.. rubric:: :class:`~music21.documentation.library.documenters.ClassDocumenter` bases' '' '- :class:`~music21.documentation.library.documenters.ObjectDocumenter`' '- :class:`~music21.documentation.library.documenters.Documenter`' ''
-
ClassDocumenter.
rstDocAttrFormat
¶
-
ClassDocumenter.
rstInheritedDocAttrFormat
¶
-
ClassDocumenter.
rstInheritedMethodsFormat
¶ The ReST format for inherited methods:
>>> from music21 import documentation >>> klass = documentation.MethodDocumenter >>> documenter = documentation.ClassDocumenter(klass) >>> for line in documenter.rstInheritedMethodsFormat: ... line ... 'Methods inherited from :class:`~music21.documentation.library.documenters.MemberDocumenter`:' '' '.. hlist::' ' :columns: 3' '' ' - :meth:`~music21.documentation.library.documenters.MemberDocumenter.run`' '' 'Methods inherited from :class:`~music21.documentation.library.documenters.Documenter`:' '' '.. hlist::' ' :columns: 3' '' ' - :meth:`~music21.documentation.library.documenters.Documenter.makeHeading`' ' - :meth:`~music21.documentation.library.documenters.Documenter.makeRubric`' ''
-
ClassDocumenter.
rstInheritedReadonlyPropertiesFormat
¶ The ReST format for inherited methods:
>>> from music21 import documentation >>> klass = documentation.MethodDocumenter >>> documenter = documentation.ClassDocumenter(klass) >>> for line in documenter.rstInheritedReadonlyPropertiesFormat: ... line ... 'Read-only properties inherited from :class:`~music21.documentation.library.documenters.MemberDocumenter`:' '' '.. hlist::' ' :columns: 3' '' ' - :attr:`~music21.documentation.library.documenters.MemberDocumenter.definingClass`' ' - :attr:`~music21.documentation.library.documenters.MemberDocumenter.memberName`' ' - :attr:`~music21.documentation.library.documenters.MemberDocumenter.referentPackagesystemPath`' '' 'Read-only properties inherited from :class:`~music21.documentation.library.documenters.ObjectDocumenter`:' '' '.. hlist::' ' :columns: 3' '' ' - :attr:`~music21.documentation.library.documenters.ObjectDocumenter.referent`' ' - :attr:`~music21.documentation.library.documenters.ObjectDocumenter.rstCrossReferenceString`' '' 'Read-only properties inherited from :class:`~music21.documentation.library.documenters.Documenter`:' '' '.. hlist::' ' :columns: 3' '' ' - :attr:`~music21.documentation.library.documenters.Documenter.rstEditingWarningFormat`' ''
-
ClassDocumenter.
rstInheritedReadwritePropertiesFormat
¶ The ReST format for inherited methods:
>>> from music21 import documentation >>> klass = documentation.MethodDocumenter >>> documenter = documentation.ClassDocumenter(klass) >>> for line in documenter.rstInheritedReadwritePropertiesFormat: ... line ...
-
ClassDocumenter.
rstMethodsFormat
¶ The ReST format for the documented class’s methods:
>>> from music21 import documentation >>> klass = documentation.ClassDocumenter >>> documenter = documentation.ClassDocumenter(klass) >>> for line in documenter.rstMethodsFormat: ... line ... '.. rubric:: :class:`~music21.documentation.library.documenters.ClassDocumenter` methods' '' '.. automethod:: music21.documentation.library.documenters.ClassDocumenter.fromIdentityMap' '' '.. automethod:: music21.documentation.library.documenters.ClassDocumenter.run' '' 'Methods inherited from :class:`~music21.documentation.library.documenters.Documenter`:' '' '.. hlist::' ' :columns: 3' '' ' - :meth:`~music21.documentation.library.documenters.Documenter.makeHeading`' ' - :meth:`~music21.documentation.library.documenters.Documenter.makeRubric`' ''
-
ClassDocumenter.
rstReadonlyPropertiesFormat
¶ The ReST format for the documented class’s read-only properties:
>>> from music21 import documentation >>> klass = documentation.ClassDocumenter >>> documenter = documentation.ClassDocumenter(klass) >>> for line in documenter.rstReadonlyPropertiesFormat: ... line ... '.. rubric:: :class:`~music21.documentation.library.documenters.ClassDocumenter` read-only properties' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.baseClassDocumenters' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.baseClasses' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.docAttr' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.docOrder' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.inheritedDocAttrMapping' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.inheritedMethodsMapping' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.inheritedReadonlyPropertiesMapping' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.inheritedReadwritePropertiesMapping' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.methods' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.readonlyProperties' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.readwriteProperties' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.referentPackagesystemPath' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.rstAutodocDirectiveFormat' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.rstBasesFormat' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.rstDocAttrFormat' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.rstInheritedDocAttrFormat' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.rstInheritedMethodsFormat' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.rstInheritedReadonlyPropertiesFormat' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.rstInheritedReadwritePropertiesFormat' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.rstMethodsFormat' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.rstReadonlyPropertiesFormat' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.rstReadwritePropertiesFormat' '' '.. autoattribute:: music21.documentation.library.documenters.ClassDocumenter.sphinxCrossReferenceRole' '' 'Read-only properties inherited from :class:`~music21.documentation.library.documenters.ObjectDocumenter`:' '' '.. hlist::' ' :columns: 3' '' ' - :attr:`~music21.documentation.library.documenters.ObjectDocumenter.referent`' ' - :attr:`~music21.documentation.library.documenters.ObjectDocumenter.rstCrossReferenceString`' '' 'Read-only properties inherited from :class:`~music21.documentation.library.documenters.Documenter`:' '' '.. hlist::' ' :columns: 3' '' ' - :attr:`~music21.documentation.library.documenters.Documenter.rstEditingWarningFormat`' ''
-
ClassDocumenter.
rstReadwritePropertiesFormat
¶ The ReST format for the documented class’s read-only properties:
>>> from music21 import documentation >>> klass = documentation.ClassDocumenter >>> documenter = documentation.ClassDocumenter(klass) >>> for line in documenter.rstReadwritePropertiesFormat: ... line ...
-
ClassDocumenter.
sphinxCrossReferenceRole
¶
Read-only properties inherited from ObjectDocumenter
:
Read-only properties inherited from Documenter
:
ClassDocumenter
methods
-
classmethod
ClassDocumenter.
fromIdentityMap
(referent)¶
-
ClassDocumenter.
run
()¶
Methods inherited from Documenter
:
CorpusDocumenter¶
-
class
music21.documentation.library.documenters.
CorpusDocumenter
¶ A documenter for music21’s corpus:
>>> from music21 import documentation >>> documenter = documentation.CorpusDocumenter() >>> restructuredText = documenter.run()
CorpusDocumenter
bases
CorpusDocumenter
read-only properties
-
CorpusDocumenter.
headingText
¶
-
CorpusDocumenter.
rstCorpusIntroductionFormat
¶
-
CorpusDocumenter.
rstPageReferenceFormat
¶
Read-only properties inherited from Documenter
:
CorpusDocumenter
methods
-
CorpusDocumenter.
getRstComposerDictFormat
(composerDict)¶
-
CorpusDocumenter.
getRstComposerIntroductionFormat
(composerName, composerDirectory)¶
-
CorpusDocumenter.
getRstComposerWorksFormat
(workDict)¶
-
CorpusDocumenter.
getRstVirtualWorkFileDictFormat
(fileDict)¶
-
CorpusDocumenter.
getRstWorkFileDictFormat
(fileDict)¶
-
CorpusDocumenter.
run
()¶
Methods inherited from Documenter
:
Documenter¶
-
class
music21.documentation.library.documenters.
Documenter
¶ Abstract base class for documenting classes.
Documenter
read-only properties
-
Documenter.
rstEditingWarningFormat
¶
Documenter
methods
-
static
Documenter.
makeHeading
(text, heading_level)¶
-
static
Documenter.
makeRubric
(text)¶
-
Documenter.
run
()¶
FunctionDocumenter¶
-
class
music21.documentation.library.documenters.
FunctionDocumenter
(referent)¶ A documenter for one function:
>>> from music21 import common, documentation >>> function = common.opFrac >>> documenter = documentation.FunctionDocumenter(function) >>> documenter <music21.documentation.library.documenters.FunctionDocumenter: music21.common.opFrac>
>>> documenter.rstCrossReferenceString ':func:`~music21.common.opFrac`'
>>> for line in documenter.rstAutodocDirectiveFormat: ... line ... '.. autofunction:: music21.common.opFrac' ''
Call the documenter to generate its ReStructuredText format:
>>> restructuredText = documenter.run()
FunctionDocumenter
bases
FunctionDocumenter
read-only properties
-
FunctionDocumenter.
referentPackagesystemPath
¶
-
FunctionDocumenter.
rstAutodocDirectiveFormat
¶
-
FunctionDocumenter.
sphinxCrossReferenceRole
¶
Read-only properties inherited from ObjectDocumenter
:
Read-only properties inherited from Documenter
:
FunctionDocumenter
methods
-
FunctionDocumenter.
run
()¶
Methods inherited from Documenter
:
MemberDocumenter¶
-
class
music21.documentation.library.documenters.
MemberDocumenter
(referent, memberName, definingClass)¶ Abstract base class for documenting class members.
MemberDocumenter
bases
MemberDocumenter
read-only properties
-
MemberDocumenter.
definingClass
¶
-
MemberDocumenter.
memberName
¶
-
MemberDocumenter.
referentPackagesystemPath
¶
Read-only properties inherited from ObjectDocumenter
:
Read-only properties inherited from Documenter
:
MemberDocumenter
methods
-
MemberDocumenter.
run
()¶
Methods inherited from ObjectDocumenter
:
Methods inherited from Documenter
:
MethodDocumenter¶
-
class
music21.documentation.library.documenters.
MethodDocumenter
(referent, memberName, definingClass)¶ A documenter for class methods:
>>> from music21 import documentation, key >>> method = key.KeySignature.transpose >>> documenter = documentation.MethodDocumenter( ... method, 'transpose', key.KeySignature) >>> documenter <music21.documentation.library.documenters.MethodDocumenter: music21.key.KeySignature.transpose>
>>> documenter.rstCrossReferenceString ':meth:`~music21.key.KeySignature.transpose`'
>>> for line in documenter.rstAutodocDirectiveFormat: ... line ... '.. automethod:: music21.key.KeySignature.transpose' ''
MethodDocumenter
bases
MethodDocumenter
read-only properties
-
MethodDocumenter.
rstAutodocDirectiveFormat
¶
-
MethodDocumenter.
sphinxCrossReferenceRole
¶
Read-only properties inherited from MemberDocumenter
:
Read-only properties inherited from ObjectDocumenter
:
Read-only properties inherited from Documenter
:
MethodDocumenter
methods
Methods inherited from MemberDocumenter
:
Methods inherited from Documenter
:
ModuleDocumenter¶
-
class
music21.documentation.library.documenters.
ModuleDocumenter
(referent)¶ A documenter for one module:
>>> from music21 import documentation, serial >>> documenter = documentation.ModuleDocumenter(serial) >>> documenter <music21.documentation.library.documenters.ModuleDocumenter: music21.serial>
>>> for reference, referent in sorted(list( ... documenter.namesMapping.items())): ... print("%s %s" % (reference, referent)) ... ContiguousSegmentOfNotes <music21.documentation.library.documenters.ClassDocumenter: music21.serial.ContiguousSegmentOfNotes> HistoricalTwelveToneRow <music21.documentation.library.documenters.ClassDocumenter: music21.serial.HistoricalTwelveToneRow> ToneRow <music21.documentation.library.documenters.ClassDocumenter: music21.serial.ToneRow> TwelveToneMatrix <music21.documentation.library.documenters.ClassDocumenter: music21.serial.TwelveToneMatrix> TwelveToneRow <music21.documentation.library.documenters.ClassDocumenter: music21.serial.TwelveToneRow> findMultisets <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.findMultisets> findSegments <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.findSegments> findTransformedSegments <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.findTransformedSegments> findTransposedAndInvertedMultisets <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.findTransposedAndInvertedMultisets> findTransposedMultisets <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.findTransposedMultisets> findTransposedSegments <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.findTransposedSegments> getContiguousSegmentsOfLength <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.getContiguousSegmentsOfLength> getHistoricalRowByName <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.getHistoricalRowByName> labelMultisets <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.labelMultisets> labelSegments <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.labelSegments> labelTransformedSegments <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.labelTransformedSegments> labelTransposedAndInvertedMultisets <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.labelTransposedAndInvertedMultisets> labelTransposedMultisets <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.labelTransposedMultisets> labelTransposedSegments <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.labelTransposedSegments> pcToToneRow <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.pcToToneRow> rowToMatrix <music21.documentation.library.documenters.FunctionDocumenter: music21.serial.rowToMatrix>
>>> documenter.rstCrossReferenceString ':mod:`~music21.serial`'
>>> for line in documenter.rstAutodocDirectiveFormat: ... line ... '.. automodule:: music21.serial' ''
Call the documenter to generate the ReStructuredText format:
>>> restructuredText = documenter.run()
ModuleDocumenter
bases
ModuleDocumenter
read-only properties
-
ModuleDocumenter.
classDocumenters
¶ Return a list of class documenters for classes housed in the module documenter’s module object, taking into account any ordering via the _DOC_ORDER module-level variable:
>>> from music21 import documentation, serial >>> module = serial >>> documenter = documentation.ModuleDocumenter(module) >>> for classDocumenter in documenter.classDocumenters: ... print(classDocumenter.referentPackagesystemPath) ... music21.serial.ContiguousSegmentOfNotes music21.serial.HistoricalTwelveToneRow music21.serial.ToneRow music21.serial.TwelveToneMatrix music21.serial.TwelveToneRow
-
ModuleDocumenter.
functionDocumenters
¶ Return a list of class documenters for classes housed in the module documenter’s module object, taking into account any ordering via the _DOC_ORDER module-level variable:
>>> from music21 import documentation, serial >>> module = serial >>> documenter = documentation.ModuleDocumenter(module) >>> for functionDocumenter in documenter.functionDocumenters: ... print(functionDocumenter.referentPackagesystemPath) ... music21.serial.findMultisets music21.serial.findSegments music21.serial.findTransformedSegments music21.serial.findTransposedAndInvertedMultisets music21.serial.findTransposedMultisets music21.serial.findTransposedSegments music21.serial.getContiguousSegmentsOfLength music21.serial.getHistoricalRowByName music21.serial.labelMultisets music21.serial.labelSegments music21.serial.labelTransformedSegments music21.serial.labelTransposedAndInvertedMultisets music21.serial.labelTransposedMultisets music21.serial.labelTransposedSegments music21.serial.pcToToneRow music21.serial.rowToMatrix
-
ModuleDocumenter.
memberOrder
¶
-
ModuleDocumenter.
namesMapping
¶
-
ModuleDocumenter.
referenceName
¶ The short name of the module:
>>> from music21 import documentation, serial >>> module = serial >>> documenter = documentation.ModuleDocumenter(module) >>> documenter.referenceName 'moduleSerial'
>>> from music21.stream import makeNotation >>> module = makeNotation >>> documenter = documentation.ModuleDocumenter(module) >>> documenter.referenceName 'moduleStreamMakeNotation'
-
ModuleDocumenter.
referentPackagesystemPath
¶
-
ModuleDocumenter.
rstAutodocDirectiveFormat
¶
-
ModuleDocumenter.
rstPageReferenceFormat
¶
-
ModuleDocumenter.
sphinxCrossReferenceRole
¶
Read-only properties inherited from ObjectDocumenter
:
Read-only properties inherited from Documenter
:
ModuleDocumenter
methods
-
ModuleDocumenter.
run
()¶
Methods inherited from Documenter
:
ObjectDocumenter¶
-
class
music21.documentation.library.documenters.
ObjectDocumenter
(referent)¶ Base class for object documenting classes.
ObjectDocumenter
bases
ObjectDocumenter
read-only properties
-
ObjectDocumenter.
referent
¶
-
ObjectDocumenter.
rstCrossReferenceString
¶
Read-only properties inherited from Documenter
:
ObjectDocumenter
methods
-
ObjectDocumenter.
referentPackagesystemPath
()¶
-
ObjectDocumenter.
rstAutodocDirectiveFormat
()¶
-
ObjectDocumenter.
sphinxCrossReferenceRole
()¶
Methods inherited from Documenter
: