arelle-release 2.37.19__py3-none-any.whl → 2.37.21__py3-none-any.whl

arelle/CntlrCmdLine.py

@@ -537,6 +537,14 @@ def parseArgs(args):
         runtimeOptions = RuntimeOptions(pluginOptions=pluginOptions, **baseOptions)
     except RuntimeOptionsException as e:
         parser.error(f"{e}, please try\n python CntlrCmdLine.py --help")
+    if (
+        runtimeOptions.entrypointFile is None and
+        not runtimeOptions.proxy and
+        not runtimeOptions.plugins and
+        not pluginOptions and
+        not runtimeOptions.webserver
+    ):
+        parser.error("No entrypoint specified, please try\n python CntlrCmdLine.py --help")
     return runtimeOptions, arellePluginModules
 
 

arelle/FileSource.py

@@ -13,7 +13,7 @@ import struct
 import tarfile
 import zipfile
 import zlib
-from typing import IO, TYPE_CHECKING, Any, TextIO, cast
+from typing import IO, TYPE_CHECKING, Any, Optional, TextIO, cast
 
 import regex as re
 from lxml import etree
@@ -452,7 +452,7 @@ class FileSource:
     def reportPackage(self) -> ReportPackage | None:
         try:
             self._reportPackage: ReportPackage | None
-            return self._reportPackage
+            return cast(Optional[ReportPackage], self._reportPackage)
         except AttributeError:
             self._reportPackage = ReportPackage.fromFileSource(self)
             return self._reportPackage

arelle/ModelInstanceObject.py

@@ -1133,7 +1133,7 @@ class ModelContext(ModelObject):
             dimValue = self.modelXbrl.qnameDimensionDefaults.get(dimQname)
         return dimValue
 
-    def dimMemberQname(self, dimQname, includeDefaults=False):
+    def dimMemberQname(self, dimQname: ModelValue.QName, includeDefaults: bool = False) -> ModelValue.QName | None:
         """(QName) -- QName of explicit dimension if reported (or defaulted if includeDefaults is True), else None"""
         dimValue = self.dimValue(dimQname)
         if isinstance(dimValue, (ModelDimensionValue,DimValuePrototype)) and dimValue.isExplicit:

arelle/ModelXbrl.py

@@ -878,7 +878,7 @@ class ModelXbrl:
     def dimensionsInUse(self) -> set[Any]:
         self._dimensionsInUse: set[Any]
         try:
-            return self._dimensionsInUse
+            return cast(set[Any], self._dimensionsInUse)
         except AttributeError:
             self._dimensionsInUse = set(dim.dimension
                                         for cntx in self.contexts.values()  # use contextsInUse?  slower?

arelle/RuntimeOptions.py

@@ -183,12 +183,6 @@ class RuntimeOptions:
                 raise RuntimeOptionsException('Provided plugin options already exist as base options {}'.format(existingBaseOptions))
             for optionName, optionValue in pluginOptions.items():
                 setattr(self, optionName, optionValue)
-        if (self.entrypointFile is None and
-                not self.proxy and
-                not self.plugins and
-                not pluginOptions and
-                not self.webserver):
-            raise RuntimeOptionsException('Incorrect arguments')
         if self.webserver and not hasWebServer():
             raise RuntimeOptionsException("Webserver option requires webserver module")
         if self.webserver and any((

arelle/XbrlConst.py

@@ -101,6 +101,7 @@ elementLabel = "http://xbrl.org/arcrole/2008/element-label"
 genLabel = "http://xbrl.org/2008/label"
 qnGenLabel = qname("{http://xbrl.org/2008/label}label")
 xbrldt = "http://xbrl.org/2005/xbrldt"
+qnXbrldtClosed = qname("{http://xbrl.org/2005/xbrldt}xbrldt:closed")
 qnXbrldtHypercubeItem = qname("{http://xbrl.org/2005/xbrldt}xbrldt:hypercubeItem")
 qnXbrldtDimensionItem = qname("{http://xbrl.org/2005/xbrldt}xbrldt:dimensionItem")
 qnXbrldtContextElement = qname("{http://xbrl.org/2005/xbrldt}xbrldt:contextElement")
@@ -108,6 +109,7 @@ xbrldi = "http://xbrl.org/2006/xbrldi"
 qnXbrldiExplicitMember = qname("{http://xbrl.org/2006/xbrldi}xbrldi:explicitMember")
 qnXbrldiTypedMember = qname("{http://xbrl.org/2006/xbrldi}xbrldi:typedMember")
 xlink = "http://www.w3.org/1999/xlink"
+qnXlinkArcRole = qname("{http://www.w3.org/1999/xlink}xlink:arcrole")
 xl = "http://www.xbrl.org/2003/XLink"
 qnXlExtended = qname("{http://www.xbrl.org/2003/XLink}xl:extended")
 qnXlLocator = qname("{http://www.xbrl.org/2003/XLink}xl:locator")

arelle/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '2.37.19'
-__version_tuple__ = version_tuple = (2, 37, 19)
+__version__ = version = '2.37.21'
+__version_tuple__ = version_tuple = (2, 37, 21)

arelle/api/Session.py

@@ -1,10 +1,7 @@
 """
 See COPYRIGHT.md for copyright information.
 
-The Arelle Python Beta API (located in `arelle.api` module) is an in-progress API module.
-A roadmap for this API is in development.
-
-Users of this API should expect changes in future releases.
+The `arelle.api` module is the supported method for integrating Arelle into other Python applications.
 """
 from __future__ import annotations
 
@@ -12,7 +9,7 @@ import logging
 from types import TracebackType
 from typing import Any, BinaryIO
 
-from arelle import PluginManager, PackageManager
+from arelle import PackageManager, PluginManager
 from arelle.CntlrCmdLine import CntlrCmdLine, createCntlrAndPreloadPlugins
 from arelle.ModelXbrl import ModelXbrl
 from arelle.RuntimeOptions import RuntimeOptions
@@ -81,6 +78,7 @@ class Session:
         responseZipStream: BinaryIO | None = None,
         logHandler: logging.Handler | None = None,
         logFilters: list[logging.Filter] | None = None,
+        sourceZipStreamFileName: str | None = None,
     ) -> bool:
         """
         Perform a run using the given options.
@@ -88,8 +86,11 @@ class Session:
         :param sourceZipStream: Optional stream to read source data from.
         :param responseZipStream: Options stream to write response data to.
         :param logHandler: Optional log handler to use for logging.
+        :param sourceZipStreamFileName: Optional file name to use for the passed zip stream.
         :return: True if the run was successful, False otherwise.
         """
+        if sourceZipStreamFileName is not None and sourceZipStream is None:
+            raise ValueError("sourceZipStreamFileName may only be provided if sourceZipStream is not None.")
         PackageManager.reset()
         PluginManager.reset()
         if self._cntlr is None:
@@ -143,4 +144,5 @@ class Session:
                 options,
                 sourceZipStream=sourceZipStream,
                 responseZipStream=responseZipStream,
+                sourceZipStreamFileName=sourceZipStreamFileName,
             )

arelle/formula/XPathContext.py

@@ -351,8 +351,8 @@ class XPathContext:
                         raise XPathException(p, 'err:XPST0017', _('Function named {0} does not have a custom or built-in implementation.').format(op))
                 elif op in VALUE_OPS:
                     # binary arithmetic operations and value comparisons
-                    s1 = self.atomize(p, resultStack.pop()) if len(resultStack) > 0 else []
-                    s2 = self.atomize(p, self.evaluate(p.args, contextItem=contextItem))
+                    s1: Sequence[ContextItem] = self.atomize(p, resultStack.pop()) if len(resultStack) > 0 else []
+                    s2: Sequence[ContextItem] = self.atomize(p, self.evaluate(p.args, contextItem=contextItem))
                     # value comparisons
                     if len(s1) > 1 or len(s2) > 1:
                         raise XPathException(p, 'err:XPTY0004', _("Value operation '{0}' sequence length error").format(op))
@@ -383,35 +383,35 @@ class XPathContext:
                             elif isinstance(op2, Decimal) and isinstance(op1, float):
                                 op2 = float(op2)
                         if op == '+':
-                            result = op1 + op2
+                            result = op1 + op2  # type: ignore[assignment,operator]
                         elif op == '-':
-                            result = op1 - op2
+                            result = op1 - op2  # type: ignore[assignment,operator]
                         elif op == '*':
-                            result = op1 * op2
+                            result = op1 * op2  # type: ignore[assignment,operator]
                         elif op in ('div', 'idiv', "mod"):
                             try:
                                 if op == 'div':
-                                    result = op1 / op2
+                                    result = op1 / op2  # type: ignore[assignment,operator]
                                 elif op == 'idiv':
-                                    result = op1 // op2
+                                    result = op1 // op2  # type: ignore[assignment,operator]
                                 elif op == 'mod':
-                                    result = op1 % op2
+                                    result = op1 % op2  # type: ignore[assignment,operator]
                             except ZeroDivisionError:
                                 raise XPathException(p, 'err:FOAR0001', _('Attempt to divide by zero: {0} {1} {2}.').format(op1, op, op2))
                         elif op == 'ge':
-                            result = op1 >= op2
+                            result = op1 >= op2 # type: ignore[operator]
                         elif op == 'gt':
-                            result = op1 > op2
+                            result = op1 > op2 # type: ignore[operator]
                         elif op == 'le':
-                            result = op1 <= op2
+                            result = op1 <= op2 # type: ignore[operator]
                         elif op == 'lt':
-                            result = op1 < op2
+                            result = op1 < op2 # type: ignore[operator]
                         elif op == 'eq':
                             result = op1 == op2
                         elif op == 'ne':
                             result = op1 != op2
                         elif op == 'to':
-                            result = range(int(op1), int(op2) + 1)
+                            result = range(int(op1), int(op2) + 1)  # type: ignore[arg-type]
                 elif op in GENERALCOMPARISON_OPS:
                     # general comparisons
                     s1 = self.atomize(p, resultStack.pop()) if len(resultStack) > 0 else []
@@ -440,23 +440,23 @@ class XPathContext:
                 elif op in NODECOMPARISON_OPS:
                     # node comparisons
                     s1 = resultStack.pop() if len(resultStack) > 0 else []
-                    s2 = self.evaluate(p.args, contextItem=contextItem)
-                    if len(s1) > 1 or len(s2) > 1 or not self.isNodeSequence(s1) or not self.isNodeSequence(s2[0]):
+                    _s2 = self.evaluate(p.args, contextItem=contextItem)
+                    if len(s1) > 1 or len(_s2) > 1 or not self.isNodeSequence(s1) or not self.isNodeSequence(_s2[0]):
                         raise XPathException(p, 'err:XPTY0004', _('Node comparison sequence error'))
-                    if len(s1) == 0 or len(s2[0]) == 0:
+                    if len(s1) == 0 or len(_s2[0]) == 0:
                         result = []
                     else:
                         n1 = s1[0]
-                        n2 = s2[0][0]
+                        n2 = _s2[0][0]
                         result = False
                         for op1 in s1:
-                            for op2 in s2:
+                            for _op2 in _s2:
                                 if op == 'is':
                                     result = n1 == n2
                                 elif op == '>>':
-                                    result = op1 > op2
+                                    result = op1 > _op2  # type: ignore[operator]
                                 elif op == '<<':
-                                    result = op1 <= op2
+                                    result = op1 <= _op2  # type: ignore[operator]
                             if result:
                                 break
                 elif op in COMBINING_OPS:
@@ -503,7 +503,7 @@ class XPathContext:
                         if op == 'u+':
                             result = op1
                         elif op == 'u-':
-                            result = -op1
+                            result = -op1 # type: ignore[assignment,operator]
                 elif op == 'instance':
                     result = False
                     s1 = self.flattenSequence(resultStack.pop()) if len(resultStack) > 0 else []
@@ -671,7 +671,7 @@ class XPathContext:
                     if hasPrevValue:
                         prevValue = self.inScopeVars[rvQname]
                     for rv in r:
-                        self.inScopeVars[rvQname] = rv  # type: ignore[assignment]
+                        self.inScopeVars[rvQname] = rv
                         self.evaluateRangeVars(op, args[0], args[1:], contextItem, result)
                         if op != 'for' and len(result) > 0:
                             break  # short circuit evaluation

arelle/formula/XPathParser.py

@@ -9,7 +9,7 @@ import time
 import traceback
 from collections.abc import Iterable, Sequence
 from decimal import Decimal
-from typing import Any, TYPE_CHECKING, Union
+from typing import Any, TYPE_CHECKING, Union, cast
 from xml.dom import minidom
 
 from pyparsing import (
@@ -954,7 +954,7 @@ def staticExpressionFunctionContext() -> minidom.Element:
             ' xmlns:fn="http://www.w3.org/2005/xpath-functions"'
             '/>'
         ).documentElement
-    return _staticExpressionFunctionContext
+    return cast(minidom.Element, _staticExpressionFunctionContext)
 
 
 def parse(

arelle/plugin/OimTaxonomy/ModelValueMore.py

@@ -2,12 +2,12 @@
 See COPYRIGHT.md for copyright information.
 """
 
-from typing import TYPE_CHECKING, Set, Any
+from typing import TYPE_CHECKING, Optional, Set, Any
 
 from arelle.ModelValue import QName
 
 class QNameAt(QName):
-    def __init__(self, prefix: str | None, namespaceURI: str | None, localName: str, atSuffix:str = "end") -> None:
+    def __init__(self, prefix: Optional[str], namespaceURI: Optional[str], localName: str, atSuffix:str = "end") -> None:
         super(QNameAt, self).__init__(prefix, namespaceURI, localName)
         self.atSuffix: str = atSuffix # The context suffix must be either @end or @start. If an @ value is not provided then the suffix defaults to @end.
 

arelle/plugin/OimTaxonomy/ViewXbrlTxmyObj.py

@@ -1,8 +1,7 @@
 '''
 See COPYRIGHT.md for copyright information.
 '''
-from typing import Union
-from types import UnionType
+from typing import Union, get_origin
 from collections import defaultdict
 from decimal import Decimal
 from typing import GenericAlias
@@ -28,7 +27,7 @@ def viewXbrlTxmyObj(xbrlDts, objClass, tabWin, header, additionalViews=None):
             initialParentProp = False
             if isinstance(propType, str):
                 continue
-            elif isinstance(propType, UnionType):
+            elif get_origin(propType) is Union:
                 if any(arg.__name__.startswith("Xbrl") for arg in propType.__args__):
                     continue
             elif propType.__name__.startswith("Xbrl"): # skip taxonomy alias type

arelle/plugin/OimTaxonomy/XbrlConcept.py

@@ -2,7 +2,8 @@
 See COPYRIGHT.md for copyright information.
 """
 
-from typing import TYPE_CHECKING, TypeAlias, Optional, Any
+from typing import TYPE_CHECKING, Optional, Any
+from typing_extensions import TypeAlias
 from decimal import Decimal
 
 from arelle.ModelValue import QName

arelle/plugin/OimTaxonomy/XbrlCube.py

@@ -2,7 +2,7 @@
 See COPYRIGHT.md for copyright information.
 """
 
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING, Optional, Union
 
 from arelle.ModelValue import qname, QName, DateTime, YearMonthDayTimeDuration
 from arelle.PythonUtil import OrderedSet
@@ -32,7 +32,7 @@ class XbrlCubeDimension(XbrlTaxonomyObject):
     dimensionName: QName # (required) The QName of the dimension object that is used to identify the dimension. For the core dimensions of concept, period, entity and unit, the core dimension QNames of xbrl:concept, xbrl:period, xbrl:entity, xbrl:unit and xbrl:language are used. The dimension object indicates if the dimension is typed or explicit.
     domainName: Optional[QName] # (required if explicit dimension) The QName of the domain object that is used to identify the domain associated with the dimension. Only one domain can be associated with a dimension. The domain name cannot be provided for a typed dimension or the period core dimension.
     domainSort: Optional[str] # (optional if typed dimension) A string value that indicates the sort order of the typed dimension. The values can be either asc or desc. The values are case insensitive. This indicates if the cube is viewed the order of the values shown on the typed dimension. This cannot be used on an explicit dimension.
-    allowDomainFacts: bool | DefaultFalse # (optional    ) A boolean value that indicates if facts not identified with the dimension are included in the cube. For typed and explicit dimensions the value defaults to false. A value of true for a typed or explicit dimension will include facts that don't use the dimension in the cube. For the period core dimension, forever facts or facts with no period dimension are included when this value is set to true. For units, this is a unit with no units such as a string or date. For the entity core dimension, it is fact values with no entity. This property cannot be used on the concept core dimension.
+    allowDomainFacts: Union[bool, DefaultFalse] # (optional    ) A boolean value that indicates if facts not identified with the dimension are included in the cube. For typed and explicit dimensions the value defaults to false. A value of true for a typed or explicit dimension will include facts that don't use the dimension in the cube. For the period core dimension, forever facts or facts with no period dimension are included when this value is set to true. For units, this is a unit with no units such as a string or date. For the entity core dimension, it is fact values with no entity. This property cannot be used on the concept core dimension.
     periodConstraints: set[XbrlPeriodConstraint] # (optional only for period core dimension) Defines an ordered set of periodConstraint objects to restrict fact values in a cube to fact values with a specified period.
 
 class XbrlCube(XbrlReferencableTaxonomyObject):
@@ -49,7 +49,7 @@ class XbrlAllowedCubeDimension(XbrlTaxonomyObject):
     dimensionName: Optional[QName] # (optional) The dimension QName that identifies the taxonomy defined dimension.
     dimensionType: Optional[str] # (optional) The dimension QName that identifies the taxonomy defined dimension.
     dimensionDataType: Optional[QName] # (optional) The dimension QName that identifies the taxonomy defined dimension.
-    required: bool | DefaultFalse # (optional) The dimension QName that identifies the taxonomy defined dimension.
+    required: Union[bool, DefaultFalse] # (optional) The dimension QName that identifies the taxonomy defined dimension.
 
 class XbrlRequiredCubeRelationship(XbrlTaxonomyObject):
     relationshipTypeName: QName # (required) The relationship type QName of a relationship. This requires that at lease one of these relationship types exist on the cube.
@@ -59,11 +59,11 @@ class XbrlRequiredCubeRelationship(XbrlTaxonomyObject):
 class XbrlCubeType(XbrlReferencableTaxonomyObject):
     taxonomy: XbrlTaxonomyType
     name: QNameKeyType # (required) The name is a QName that uniquely identifies the cube type object.
-    baseCubeType: bool | DefaultTrue # (optional) Base cube type that the cube object is based on. Uses the QName of a cubeType object. The property only allows restriction rather than expansion of the baseCubeTape.
-    periodDimension: bool | DefaultTrue # (optional) boolean to indicate if the period core dimension is included in the cube. Defaults to true.
-    entityDimension: bool | DefaultTrue # (optional) boolean to indicate if the entity core dimension is included in the cube. Defaults to true.
-    unitDimension: bool | DefaultTrue # (optional) boolean to indicate if the unit core dimension is included in the cube. Defaults to true.
-    taxonomyDefinedDimension: bool | DefaultTrue # (optional) boolean to indicate if taxonomy defined dimensions are included in the cube. Defaults to true.
+    baseCubeType: Union[bool, DefaultTrue] # (optional) Base cube type that the cube object is based on. Uses the QName of a cubeType object. The property only allows restriction rather than expansion of the baseCubeTape.
+    periodDimension: Union[bool, DefaultTrue] # (optional) boolean to indicate if the period core dimension is included in the cube. Defaults to true.
+    entityDimension: Union[bool, DefaultTrue] # (optional) boolean to indicate if the entity core dimension is included in the cube. Defaults to true.
+    unitDimension: Union[bool, DefaultTrue] # (optional) boolean to indicate if the unit core dimension is included in the cube. Defaults to true.
+    taxonomyDefinedDimension: Union[bool, DefaultTrue] # (optional) boolean to indicate if taxonomy defined dimensions are included in the cube. Defaults to true.
     allowedCubeDimensions: OrderedSet[XbrlAllowedCubeDimension] # (optional) An ordered set of allowedCubeDimension objects that are permitted to be used on the cube. If the property is not defined then any dimensions can be associated with the cube.
     requiredCubeRelationships: OrderedSet[XbrlRequiredCubeRelationship] # (optional) An ordered set of requiredCubeRelationship objects that at a minimum must be associated with the cube.
 

arelle/plugin/OimTaxonomy/XbrlDts.py

@@ -2,7 +2,7 @@
 See COPYRIGHT.md for copyright information.
 """
 
-from typing import TYPE_CHECKING, cast, Any, ClassVar
+from typing import TYPE_CHECKING, Optional, Union, cast, Any, ClassVar
 from collections import OrderedDict, defaultdict # OrderedDict is not same as dict, has additional key order features
 import sys, traceback
 from arelle.ModelValue import QName, AnyURI
@@ -58,7 +58,7 @@ class XbrlDts(ModelXbrl): # complete wrapper for ModelXbrl
     def referenceTypes(self):
         return set(obj.referenceType for l in self.tagObjects.values() for obj in l if hasattr(obj, "referenceType"))
 
-    def labelValue(self, name: QName, labelType: QName, lang: str | None = None, fallbackToName: bool = True) -> str | None:
+    def labelValue(self, name: QName, labelType: QName, lang: Optional[str] = None, fallbackToName: bool = True) -> Optional[str]:
         if labelType == XbrlConst.conceptNameLabelRole:
             return str(name)
         if lang is None:
@@ -76,7 +76,7 @@ class XbrlDts(ModelXbrl): # complete wrapper for ModelXbrl
             return str(name)
         return None
 
-    def referenceProperties(self, name: QName, referenceType: QName | None, lang: str | None = None) -> list[XbrlPropertyType]:
+    def referenceProperties(self, name: QName, referenceType: Optional[QName], lang: Optional[str] = None) -> list[XbrlPropertyType]:
         refProperties = defaultdict(list)
         if lang is None:
             lang = self.modelXbrl.modelManager.defaultLang
@@ -90,11 +90,11 @@ class XbrlDts(ModelXbrl): # complete wrapper for ModelXbrl
 
 
     # UI thread viewTaxonomyObject
-    def viewTaxonomyObject(self, objectId: str | int) -> None:
+    def viewTaxonomyObject(self, objectId: Union[str, int]) -> None:
         """Finds taxonomy object, if any, and synchronizes any views displaying it to bring the model object into scrollable view region and highlight it
         :param objectId: string which includes _ordinalNumber, produced by ModelObject.objectId(), or integer object index
         """
-        xbrlObj: XbrlObject | str | int = ""
+        xbrlObj: Union[XbrlObject, str, int] = ""
         try:
             if isinstance(objectId, XbrlObject):
                 xbrlObj = objectId

arelle/plugin/OimTaxonomy/XbrlImportedTaxonomy.py

@@ -2,7 +2,7 @@
 See COPYRIGHT.md for copyright information.
 """
 
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Union
 
 from arelle.ModelValue import QName, AnyURI
 from arelle.PythonUtil import OrderedSet
@@ -18,5 +18,5 @@ class XbrlImportedTaxonomy(XbrlTaxonomyObject):
     taxonomyName: QNameKeyType # (required) The QName of the taxonomy to import. The location of the taxonomy QName is resolved by referencing the namespace map which includes the url of the namespace. When importing XBRL 2.1 taxonomies a QName comprising the namespace of the taxonomy to import and a local name of taxonomy is defined. i.e. ifrs:Taxonomy.
     includeObjects: set[QName] # (optional) A set of object QNames that should be imported from the taxonomyName location property. Only the objects defined in the include and any dependent objects are added to the dts. This property can only be used for taxonomy files using the OIM specification. The dependents of each object are defined in this specification.
     includeObjectTypes: set[QName] # (optional) A set of object type QNames that should be imported from the taxonomyName location property. Examples include xbrl:conceptObject and xbrl:memberObject. All objects of the specified object types from the taxonomyName and any dependent objects will be imported. This property can only be used for taxonomy files using the OIM specification. The includeObjectTypes cannot include the label object.
-    excludeLabels: bool | DefaultTrue # (optional) If set to true any labels attached to the objects comprising the dts deriving from the taxonomyName property will be excluded from the dts. The default value is false.
-    followImport: bool | DefaultFalse # (optional) If set to false the dts resolution will not import taxonomies defined in descendant ImportedTaxonomyObjects. These imports will be excluded from the dts. The default value is true. This means if a taxonomy QName is provided all imprtedTaxonomy objects will be brought into the dts.
+    excludeLabels: Union[bool, DefaultTrue] # (optional) If set to true any labels attached to the objects comprising the dts deriving from the taxonomyName property will be excluded from the dts. The default value is false.
+    followImport: Union[bool, DefaultFalse] # (optional) If set to false the dts resolution will not import taxonomies defined in descendant ImportedTaxonomyObjects. These imports will be excluded from the dts. The default value is true. This means if a taxonomy QName is provided all imprtedTaxonomy objects will be brought into the dts.

arelle/plugin/OimTaxonomy/XbrlNetwork.py

@@ -37,9 +37,9 @@ class XbrlRelationship(XbrlTaxonomyObject):
         return ("relationship", f"{str(self.source)}\u2192{self.target}", tuple(nestedProperties))
 
 class XbrlRelationshipSet:
-    _relationshipsFrom: dict[QName, list[XbrlRelationship]] | None
-    _relationshipsTo: dict[QName, list[XbrlRelationship]] | None
-    _roots: OrderedSet[QName] | None
+    _relationshipsFrom: Optional[dict[QName, list[XbrlRelationship]]]
+    _relationshipsTo: Optional[dict[QName, list[XbrlRelationship]]]
+    _roots: Optional[OrderedSet[QName]]
 
     def __init__(self):
         self._relationshipsFrom = self._relationshipsTo = self._roots = None

arelle/plugin/OimTaxonomy/XbrlProperty.py

@@ -2,7 +2,7 @@
 See COPYRIGHT.md for copyright information.
 """
 
-from typing import TYPE_CHECKING, Any, Optional
+from typing import TYPE_CHECKING, Any, Optional, Union
 
 from arelle.ModelValue import QName
 from arelle.PythonUtil import OrderedSet
@@ -23,6 +23,6 @@ class XbrlPropertyType(XbrlReferencableTaxonomyObject):
     name: QNameKeyType # (required) The name is a QName that uniquely identifies the property type object.
     dataType: QName # (required) Indicates the dataType of the property value. These are provided as a QName based on the datatypes specified in the XBRL 2.1 specification and any custom datatype defined in the taxonomy.
     enumerationDomain: Optional[QName] # (optional) Used to specify the QName of a domain object that is used to derive enumerated domain members QNames that can be used for the property.
-    definitional: bool | DefaultFalse # (optional) Indicates if the property is definitional. If changes to the property change the meaning of the object it is definitional, if the property provides extra information about the object it is not definitional. If no value is provided the attribute defaults to false.
+    definitional: Union[bool, DefaultFalse] # (optional) Indicates if the property is definitional. If changes to the property change the meaning of the object it is definitional, if the property provides extra information about the object it is not definitional. If no value is provided the attribute defaults to false.
     allowedObjects: set[QName] # (optional) List of allowable objects that the property can be used with. For example the balance property can only be used with concept objects.
-    allowedAsLinkProperty: bool | DefaultFalse # (optional) Indicates if the property can be used a a properton the link between two objects in a relationship. If no value is provided the attribute defaults to false.
+    allowedAsLinkProperty: Union[bool, DefaultFalse] # (optional) Indicates if the property can be used a a properton the link between two objects in a relationship. If no value is provided the attribute defaults to false.

arelle/plugin/OimTaxonomy/XbrlReport.py

@@ -2,7 +2,7 @@
 See COPYRIGHT.md for copyright information.
 """
 
-from typing import TYPE_CHECKING, Optional, Any
+from typing import TYPE_CHECKING, Optional, Any, Union
 from collections import OrderedDict
 from arelle.ModelValue import QName, AnyURI
 from arelle.PythonUtil import OrderedSet
@@ -12,9 +12,9 @@ from .XbrlTaxonomyObject import XbrlReportObject
 class XbrlFact(XbrlReportObject):
     report: XbrlDtsType
     id: Optional[str] # synthesized id (from fact key in JSON), marked Optional because it's a key, not value, in json source.
-    value: str | None # (required) The value of the {value} property of the fact. The value MUST be represented as (xbrlje:invalidFactValue):
+    value: Optional[str] # (required) The value of the {value} property of the fact. The value MUST be represented as (xbrlje:invalidFactValue):
     decimals: Optional[int] # An integer providing the value of the {decimals} property, or absent if the value is infinitely precise or not applicable (for nil or non-numeric facts).
-    dimensions: dict[QName | str, str] # (required) A dimensions object with properties corresponding to the members of the {dimensions} property.
+    dimensions: dict[Union[QName, str], str] # (required) A dimensions object with properties corresponding to the members of the {dimensions} property.
     links: dict[str, dict[str, list[str]]] # A links object, cormesponding to the link groups associated with the fact. This member MAY be absent if there are no link groups associated with the fact.
 
 

arelle/plugin/OimTaxonomy/XbrlTableTemplate.py

@@ -2,7 +2,7 @@
 See COPYRIGHT.md for copyright information.
 """
 
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING, Optional, Union
 from decimal import Decimal
 
 from arelle.ModelValue import QName
@@ -20,8 +20,8 @@ class XbrlTableTemplate(XbrlReferencableTaxonomyObject):
 
 class XbrlAxisDimensions(XbrlTaxonomyObject):
     dimensionName: QName # (required) The QName of a dimension defined by the cubeName property.
-    showTotal: bool | DefaultFalse # (optional) Indicates if the total of the dimension is shown in the axis. This is the value associated with the dimension absent. If no value is provided the default is false. The concept dimension defaults to false and cannot be set to true.
-    showAncestorColumns: bool | DefaultFalse # (optional) Define members on an explicit dimension that are not leaf values that are included on the axis. If not provided only leaf members on the axis will show.
+    showTotal: Union[bool, DefaultFalse] # (optional) Indicates if the total of the dimension is shown in the axis. This is the value associated with the dimension absent. If no value is provided the default is false. The concept dimension defaults to false and cannot be set to true.
+    showAncestorColumns: Union[bool, DefaultFalse] # (optional) Define members on an explicit dimension that are not leaf values that are included on the axis. If not provided only leaf members on the axis will show.
     totalLocation: Optional[str] # (optional) Indicates if the total is at the start or at the end when shown on the axis. The default value is end. The totalLocation attribute can only have a value of start or end.
     periodAlign: OrderedSet[str] # (optional) the period align attribute can only be used with the period dimension. This attribute is used to align time values of facts in a dimension rather than being created as seperate columns or rows. The values @start and @end are used to indicate if instant values are aligned with duration values. These values are used to support roll-forwards in a datatgrid and will align duration values and instant values with the same start and end dates.
 

arelle/plugin/OimTaxonomy/XbrlTypes.py

@@ -2,7 +2,7 @@
 See COPYRIGHT.md for copyright information.
 """
 
-from typing import TypeAlias
+from typing_extensions import TypeAlias
 from arelle.ModelValue import QName
 
 XbrlDtsType: TypeAlias = "XbrlDts"

arelle/plugin/OimTaxonomy/__init__.py

@@ -16,8 +16,7 @@ For debugging, saves the xsd objects loaded from the OIM taxonomy if
 
 """
 
-from typing import TYPE_CHECKING, cast, GenericAlias, Union, _UnionGenericAlias
-from types import UnionType
+from typing import TYPE_CHECKING, cast, GenericAlias, Union, _UnionGenericAlias, get_origin
 
 import os, io, json, sys, time, traceback
 import jsonschema
@@ -377,7 +376,7 @@ def loadOIMTaxonomy(cntlr, error, warning, modelXbrl, oimFile, mappedUri, **kwar
                             eltClass = propType.__args__[0]
                         if isinstance(jsonValue, list):
                             for iObj, listObj in enumerate(jsonValue):
-                                if isinstance(eltClass, str) or eltClass.__name__.startswith("Xbrl"): # nested Xbrl objects
+                                if isinstance(eltClass, str) or getattr(eltClass, "__name__", "").startswith("Xbrl"): # nested Xbrl objects
                                     if isinstance(listObj, dict):
                                         # this handles lists of dict objects.  For dicts of key-value dict objects see above.
                                         createTaxonomyObjects(propName, listObj, newObj, pathParts + [f'{propName}[{iObj}]'])
@@ -401,7 +400,7 @@ def loadOIMTaxonomy(cntlr, error, warning, modelXbrl, oimFile, mappedUri, **kwar
                                         collectionProp.append(listObj)
                         elif isinstance(jsonValue, dict) and keyClass:
                             for iObj, (valKey, valVal) in enumerate(jsonValue.items()):
-                                if isinstance(_keyClass, UnionType):
+                                if get_origin(_keyClass) is Union:
                                     if QName in _keyClass.__args__ and ":" in valKey:
                                         _valKey = qname(listObj, prefixNamespaces)
                                         if _valKey is None:
@@ -447,7 +446,7 @@ def loadOIMTaxonomy(cntlr, error, warning, modelXbrl, oimFile, mappedUri, **kwar
                             keyValue = jsonValue # e.g. the QNAme of the new object for parent object collection
                 elif propType in (type(oimParentObj), type(oimParentObj).__name__): # propType may be a TypeAlias which is a string name of class
                     setattr(newObj, propName, oimParentObj)
-                elif ((isinstance(propType, (UnionType,_UnionGenericAlias)) or isinstance(getattr(propType, "__origin__", None), type(Union))) and # Optional[ ] type
+                elif (((get_origin(propType) is Union) or isinstance(get_origin(propType), type(Union))) and # Optional[ ] type
                        propType.__args__[-1] in (type(None), DefaultTrue, DefaultFalse, DefaultZero)):
                           setattr(newObj, propName, {type(None): None, DefaultTrue: True, DefaultFalse: False, DefaultZero:0}[propType.__args__[-1]]) # use first of union for prop value creation
                 else: # absent json element

arelle/plugin/validate/NL/LinkbaseType.py

@@ -0,0 +1,77 @@
+'''
+See COPYRIGHT.md for copyright information.
+'''
+from __future__ import annotations
+
+from enum import Enum
+
+from arelle import XbrlConst
+from arelle.ModelValue import QName
+
+
+class LinkbaseType(Enum):
+    CALCULATION = "calculation"
+    DEFINITION = "definition"
+    LABEL = "label"
+    PRESENTATION = "presentation"
+    REFERENCE = "reference"
+
+    @staticmethod
+    def fromRefUri(refUri: str | None) -> LinkbaseType | None:
+        """
+        Returns the LinkbaseType corresponding to the given ref URI.
+        If the URI does not match any known linkbase reference type, returns None.
+        """
+        if refUri is None:
+            return None
+        return LINKBASE_TYPE_BY_REF_URI.get(refUri, None)
+
+    def getArcQn(self) -> QName:
+        """
+        Returns the qname of the arc associated with this LinkbaseType.
+        """
+        return LINKBASE_ARC_QN[self]
+
+    def getLinkQn(self) -> QName:
+        """
+        Returns the qname of the link associated with this LinkbaseType.
+        """
+        return LINKBASE_LINK_QN[self]
+
+    def getLowerName(self) -> str:
+        """
+        Returns the lower-case name of this LinkbaseType.
+        """
+        return self.value.lower()
+
+    def getRefUri(self) -> str:
+        """
+        Returns the ref URI associated with this LinkbaseType.
+        """
+        return LINKBASE_REF_URIS[self]
+
+
+LINKBASE_ARC_QN = {
+    LinkbaseType.CALCULATION: XbrlConst.qnLinkCalculationArc,
+    LinkbaseType.DEFINITION: XbrlConst.qnLinkDefinitionArc,
+    LinkbaseType.LABEL: XbrlConst.qnLinkLabelArc,
+    LinkbaseType.PRESENTATION: XbrlConst.qnLinkPresentationArc,
+    LinkbaseType.REFERENCE: XbrlConst.qnLinkReferenceArc,
+}
+
+LINKBASE_LINK_QN = {
+    LinkbaseType.CALCULATION: XbrlConst.qnLinkCalculationLink,
+    LinkbaseType.DEFINITION: XbrlConst.qnLinkDefinitionLink,
+    LinkbaseType.LABEL: XbrlConst.qnLinkLabelLink,
+    LinkbaseType.PRESENTATION: XbrlConst.qnLinkPresentationLink,
+    LinkbaseType.REFERENCE: XbrlConst.qnLinkReferenceLink,
+}
+
+LINKBASE_REF_URIS = {
+    LinkbaseType.CALCULATION: "http://www.xbrl.org/2003/role/calculationLinkbaseRef",
+    LinkbaseType.DEFINITION: "http://www.xbrl.org/2003/role/definitionLinkbaseRef",
+    LinkbaseType.LABEL: "http://www.xbrl.org/2003/role/labelLinkbaseRef",
+    LinkbaseType.PRESENTATION: "http://www.xbrl.org/2003/role/presentationLinkbaseRef",
+    LinkbaseType.REFERENCE: "http://www.xbrl.org/2003/role/referenceLinkbaseRef",
+}
+LINKBASE_TYPE_BY_REF_URI = {v: k for k, v in LINKBASE_REF_URIS.items()}