Skip to content

enumerations ¤

This module contains all the enumerations of the package.

Classes:

  • BreakageKind

    Enumeration of the possible API breakages.

  • DocstringSectionKind

    Enumeration of the possible docstring section kinds.

  • ExplanationStyle

    Enumeration of the possible styles for explanations.

  • Kind

    Enumeration of the different object kinds.

  • ObjectKind

    Enumeration of the different runtime object kinds.

  • ParameterKind

    Enumeration of the different parameter kinds.

  • Parser

    Enumeration of the different docstring parsers.

  • When

    Enumeration of the different times at which an extension is used.

BreakageKind ¤


          flowchart TD
          griffe.enumerations.BreakageKind[BreakageKind]

          

          click griffe.enumerations.BreakageKind href "" "griffe.enumerations.BreakageKind"
          

Enumeration of the possible API breakages.

DocstringSectionKind ¤


          flowchart TD
          griffe.enumerations.DocstringSectionKind[DocstringSectionKind]

          

          click griffe.enumerations.DocstringSectionKind href "" "griffe.enumerations.DocstringSectionKind"
          

Enumeration of the possible docstring section kinds.

Attributes:

admonition class-attribute instance-attribute ¤

admonition = 'admonition'

Admonition block.

attributes class-attribute instance-attribute ¤

attributes = 'attributes'

Attributes section.

classes class-attribute instance-attribute ¤

classes = 'classes'

Classes section.

deprecated class-attribute instance-attribute ¤

deprecated = 'deprecated'

Deprecation section.

examples class-attribute instance-attribute ¤

examples = 'examples'

Examples section.

functions class-attribute instance-attribute ¤

functions = 'functions'

Functions section.

modules class-attribute instance-attribute ¤

modules = 'modules'

Modules section.

other_parameters class-attribute instance-attribute ¤

other_parameters = 'other parameters'

Other parameters (keyword arguments) section.

parameters class-attribute instance-attribute ¤

parameters = 'parameters'

Parameters section.

raises class-attribute instance-attribute ¤

raises = 'raises'

Raises (exceptions) section.

receives class-attribute instance-attribute ¤

receives = 'receives'

Received value(s) (generators) section.

returns class-attribute instance-attribute ¤

returns = 'returns'

Returned value(s) section.

text class-attribute instance-attribute ¤

text = 'text'

Text section.

warns class-attribute instance-attribute ¤

warns = 'warns'

Warnings section.

yields class-attribute instance-attribute ¤

yields = 'yields'

Yielded value(s) (generators) section.

ExplanationStyle ¤


          flowchart TD
          griffe.enumerations.ExplanationStyle[ExplanationStyle]

          

          click griffe.enumerations.ExplanationStyle href "" "griffe.enumerations.ExplanationStyle"
          

Enumeration of the possible styles for explanations.

Attributes:

  • GITHUB (str) –

    Explanation as GitHub workflow commands warnings, adapted to CI.

  • MARKDOWN (str) –

    Explanations in Markdown, adapted to changelogs.

  • ONE_LINE (str) –

    Explanations on one-line.

  • VERBOSE (str) –

    Explanations on multiple lines.

GITHUB class-attribute instance-attribute ¤

GITHUB: str = 'github'

Explanation as GitHub workflow commands warnings, adapted to CI.

MARKDOWN class-attribute instance-attribute ¤

MARKDOWN: str = 'markdown'

Explanations in Markdown, adapted to changelogs.

ONE_LINE class-attribute instance-attribute ¤

ONE_LINE: str = 'oneline'

Explanations on one-line.

VERBOSE class-attribute instance-attribute ¤

VERBOSE: str = 'verbose'

Explanations on multiple lines.

Kind ¤


          flowchart TD
          griffe.enumerations.Kind[Kind]

          

          click griffe.enumerations.Kind href "" "griffe.enumerations.Kind"
          

Enumeration of the different object kinds.

Attributes:

ALIAS class-attribute instance-attribute ¤

ALIAS: str = 'alias'

Aliases (imported objects).

ATTRIBUTE class-attribute instance-attribute ¤

ATTRIBUTE: str = 'attribute'

Attributes and properties.

CLASS class-attribute instance-attribute ¤

CLASS: str = 'class'

Classes.

FUNCTION class-attribute instance-attribute ¤

FUNCTION: str = 'function'

Functions and methods.

MODULE class-attribute instance-attribute ¤

MODULE: str = 'module'

Modules.

ObjectKind ¤


          flowchart TD
          griffe.enumerations.ObjectKind[ObjectKind]

          

          click griffe.enumerations.ObjectKind href "" "griffe.enumerations.ObjectKind"
          

Enumeration of the different runtime object kinds.

Attributes:

ATTRIBUTE class-attribute instance-attribute ¤

ATTRIBUTE: str = 'attribute'

Attributes.

BUILTIN_FUNCTION class-attribute instance-attribute ¤

BUILTIN_FUNCTION: str = 'builtin_function'

Built-in functions.

BUILTIN_METHOD class-attribute instance-attribute ¤

BUILTIN_METHOD: str = 'builtin_method'

Built-in ethods.

CACHED_PROPERTY class-attribute instance-attribute ¤

CACHED_PROPERTY: str = 'cached_property'

Cached properties.

CLASS class-attribute instance-attribute ¤

CLASS: str = 'class'

Classes.

CLASSMETHOD class-attribute instance-attribute ¤

CLASSMETHOD: str = 'classmethod'

Class methods.

COROUTINE class-attribute instance-attribute ¤

COROUTINE: str = 'coroutine'

Coroutines

FUNCTION class-attribute instance-attribute ¤

FUNCTION: str = 'function'

Functions.

METHOD class-attribute instance-attribute ¤

METHOD: str = 'method'

Methods.

METHOD_DESCRIPTOR class-attribute instance-attribute ¤

METHOD_DESCRIPTOR: str = 'method_descriptor'

Method descriptors.

MODULE class-attribute instance-attribute ¤

MODULE: str = 'module'

Modules.

PROPERTY class-attribute instance-attribute ¤

PROPERTY: str = 'property'

Properties.

STATICMETHOD class-attribute instance-attribute ¤

STATICMETHOD: str = 'staticmethod'

Static methods.

ParameterKind ¤


          flowchart TD
          griffe.enumerations.ParameterKind[ParameterKind]

          

          click griffe.enumerations.ParameterKind href "" "griffe.enumerations.ParameterKind"
          

Enumeration of the different parameter kinds.

Attributes:

keyword_only class-attribute instance-attribute ¤

keyword_only: str = 'keyword-only'

Keyword-only parameter.

positional_only class-attribute instance-attribute ¤

positional_only: str = 'positional-only'

Positional-only parameter.

positional_or_keyword class-attribute instance-attribute ¤

positional_or_keyword: str = 'positional or keyword'

Positional or keyword parameter.

var_keyword class-attribute instance-attribute ¤

var_keyword: str = 'variadic keyword'

Variadic keyword parameter.

var_positional class-attribute instance-attribute ¤

var_positional: str = 'variadic positional'

Variadic positional parameter.

Parser ¤


          flowchart TD
          griffe.enumerations.Parser[Parser]

          

          click griffe.enumerations.Parser href "" "griffe.enumerations.Parser"
          

Enumeration of the different docstring parsers.

Attributes:

  • google

    Google-style docstrings parser.

  • numpy

    Numpydoc-style docstrings parser.

  • sphinx

    Sphinx-style docstrings parser.

google class-attribute instance-attribute ¤

google = 'google'

Google-style docstrings parser.

numpy class-attribute instance-attribute ¤

numpy = 'numpy'

Numpydoc-style docstrings parser.

sphinx class-attribute instance-attribute ¤

sphinx = 'sphinx'

Sphinx-style docstrings parser.

When ¤


          flowchart TD
          griffe.enumerations.When[When]

          

          click griffe.enumerations.When href "" "griffe.enumerations.When"
          

Enumeration of the different times at which an extension is used.

Attributes:

  • after_all (int) –

    For each node, after the visit/inspection.

  • after_children (int) –

    For each node, after the children have been visited/inspected, and before finishing the visit/inspection.

  • before_all (int) –

    For each node, before the visit/inspection.

  • before_children (int) –

    For each node, after the visit has started, and before the children visit/inspection.

after_all class-attribute instance-attribute ¤

after_all: int = 4

For each node, after the visit/inspection.

after_children class-attribute instance-attribute ¤

after_children: int = 3

For each node, after the children have been visited/inspected, and before finishing the visit/inspection.

before_all class-attribute instance-attribute ¤

before_all: int = 1

For each node, before the visit/inspection.

before_children class-attribute instance-attribute ¤

before_children: int = 2

For each node, after the visit has started, and before the children visit/inspection.