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: