labfreed 1.0.0a13__py3-none-any.whl → 1.0.0a15__py3-none-any.whl

labfreed/pac_attributes/pythonic/py_attributes.py

@@ -1,12 +1,12 @@
 
-from datetime import date, datetime, time
+from datetime import UTC, date, datetime, time
 import json
 from typing import  Literal
 import warnings
 from pydantic import RootModel, field_validator
 
 from labfreed.labfreed_infrastructure import LabFREED_BaseModel
-from labfreed.pac_attributes.api_data_models.response import AttributeBase, AttributeGroup, BoolAttribute, DateTimeAttribute,  NumericAttribute, NumericValue, ObjectAttribute, ReferenceAttribute, ResourceAttribute, TextAttribute
+from labfreed.pac_attributes.api_data_models.response import AttributeBase, AttributeGroup, BoolAttribute, BoolListAttribute, DateTimeAttribute, DateTimeListAttribute,  NumericAttribute, NumericListAttribute, NumericValue, ObjectAttribute, ReferenceAttribute, ReferenceListAttribute, ResourceAttribute, ResourceListAttribute, TextAttribute, TextListAttribute
 from labfreed.pac_attributes.client.attribute_cache import CacheableAttributeGroup
 from labfreed.pac_id.pac_id import PAC_ID
 from labfreed.trex.pythonic.quantity import Quantity
@@ -66,13 +66,21 @@ class pyAttributes(RootModel[list[pyAttribute]]):
         value_list = attribute.value_list
         first_value = value_list[0]
         if isinstance(first_value, bool):
-            return BoolAttribute(value=value_list, **common_args)
+            if len(value_list) == 1:
+                return BoolAttribute(value=value_list[0], **common_args)
+            else:
+                return BoolListAttribute(value=value_list, **common_args)
+         
             
         elif isinstance(first_value, datetime | date | time):
             for v in value_list:
                 if not v.tzinfo:
                     warnings.warn(f'No timezone given for {v}. Assuming it is in UTC.')
-            return DateTimeAttribute(value=value_list, **common_args)
+                    v.replace(tzinfo=UTC)
+            if len(value_list) == 1:
+                return DateTimeAttribute(value=value_list[0], **common_args)
+            else:
+                return DateTimeListAttribute(value=value_list, **common_args)
             # return DateTimeAttribute(value =_date_value_from_python_type(value).value, **common_args)
             
         
@@ -83,9 +91,13 @@ class pyAttributes(RootModel[list[pyAttribute]]):
                     v = Quantity(value=v, unit='dimensionless')
                 values.append(NumericValue(numerical_value=v.value_as_str(), 
                                             unit = v.unit))
-            num_attribute = NumericAttribute(value = values, **common_args)
-            num_attribute.print_validation_messages()
-            return num_attribute
+            if len(values) == 1:
+                num_attr = NumericAttribute(value=values[0], **common_args)
+            else:
+                num_attr = NumericListAttribute(value=values, **common_args)
+            num_attr.print_validation_messages()
+            
+            return num_attr
         
         elif isinstance(first_value, str):
             # capture quantities in the form of "100.0e5 g/L"
@@ -94,20 +106,37 @@ class pyAttributes(RootModel[list[pyAttribute]]):
                 for v in value_list:
                     q = Quantity.from_str_with_unit(v)
                     values.append( NumericValue(numerical_value=q.value_as_str(), unit = q.unit) )
-                return NumericAttribute(value = values,
-                                            **common_args)
-                
+                if len(values) == 1:
+                    return NumericAttribute(value=values[0], **common_args)
+                else:
+                    return NumericListAttribute(value=values, **common_args)
+
             else:
-                return TextAttribute(value = value_list, **common_args)
+                if len(value_list) == 1:
+                    return TextAttribute(value=value_list[0], **common_args)
+                else:
+                    return TextListAttribute(value=value_list, **common_args)
             
         elif isinstance(first_value, pyReference):
-            return ReferenceAttribute(value = [v.root for v in value_list], **common_args)
+            values = [v.root for v in value_list]
+            if len(values) == 1:
+                return ReferenceAttribute(value=values[0], **common_args)
+            else:
+                return ReferenceListAttribute(value=values, **common_args)
         
         elif isinstance(first_value, pyResource):
-            return ResourceAttribute(value = [v.root for v in value_list], **common_args)
+            values = [v.root for v in value_list]
+            if len(values) == 1:
+                return ResourceAttribute(value=values[0], **common_args)
+            else:
+                return ResourceListAttribute(value=values, **common_args)
             
         elif isinstance(first_value, PAC_ID):
-            return ReferenceAttribute(value = [v.to_url(include_extensions=False) for v in value_list], **common_args)
+            values = [v.to_url(include_extensions=False) for v in value_list]
+            if len(values) == 1:
+                return ReferenceAttribute(value=values[0], **common_args)
+            else:
+                return ReferenceListAttribute(value=values, **common_args)
         
         else: #this covers the last resort case of arbitrary objects. Must be json serializable.
             try :
@@ -124,25 +153,25 @@ class pyAttributes(RootModel[list[pyAttribute]]):
         for a in attributes:
             value_list = a.value if isinstance(a.value, list) else [a.value]
             match a:
-                case ReferenceAttribute():
+                case ReferenceAttribute() | ReferenceListAttribute():
                     values =  [pyReference(v) for v in value_list]
                     
-                case ResourceAttribute():
+                case ResourceAttribute() | ResourceListAttribute():
                     values =  [pyResource(v) for v in value_list]
                     
-                case NumericAttribute():                                       
+                case NumericAttribute() | NumericListAttribute():                                       
                     values = [ Quantity.from_str_value(value=v.numerical_value, unit=v.unit) for v in value_list]
 
-                case BoolAttribute():
+                case BoolAttribute() | BoolAttribute():
                     values = value_list
                     
-                case TextAttribute():
+                case TextAttribute() | TextListAttribute():
                     values = value_list
                     
-                case DateTimeAttribute():                    
+                case DateTimeAttribute() | DateTimeAttribute():                    
                     values = value_list
                 
-                case ObjectAttribute():
+                case ObjectAttribute() | ObjectAttribute():
                     values = value_list
 
                        

labfreed/pac_cat/category_base.py

@@ -55,7 +55,7 @@ class Category(LabFREED_BaseModel):
                     k = f"{field_name} ({ field_info.alias})"
                 else:
                     k = f"{field_name}"
-            out.update({k : v } ) 
+                out.update({k : v } ) 
             
         for s in getattr(self, 'additional_segments', []):
             out.update( {s.key or '' : s.value })

labfreed/pac_cat/predefined_categories.py

@@ -1,5 +1,5 @@
 ## Materials
-from abc import ABC
+from abc import ABC, abstractproperty
 from pydantic import Field, computed_field, model_validator
 
 from labfreed.labfreed_infrastructure import ValidationMsgLevel
@@ -18,6 +18,10 @@ class PredefinedCategory(Category, ABC):
     def segments(self) -> list[IDSegment]:
         return self._get_segments(use_short_notation=False)
     
+    @abstractproperty
+    def is_serialized(self) -> bool:
+        pass
+    
     def _get_segments(self, use_short_notation=False) -> list[IDSegment]:
         segments = []
         can_omit_keys = use_short_notation # keeps track of whether keys can still be omitted. That is the case when the segment recommendation is followed
@@ -65,12 +69,17 @@ class Material_Device(PredefinedCategory):
         if not self.serial_number:
             self._add_validation_message(
                     source=f"Category {self.key}",
-                    level = ValidationMsgLevel.ERROR,
-                    msg=f'Category key {self.key} is missing mandatory field Serial Number',
+                    level = ValidationMsgLevel.WARNING,
+                    msg=f'Category key {self.key} is missing field Serial Number. Check that you are indeed to a product and not a specific device.',
                     highlight_pattern = f"{self.key}"
             )
         return self
     
+    @property
+    def is_serialized(self) -> bool:
+        return bool(self.serial_number)
+    
+    
 class Material_Substance(PredefinedCategory):
     '''Represents the -MS category'''
     key: str =         Field(default='-MS', frozen=True)
@@ -93,6 +102,11 @@ class Material_Substance(PredefinedCategory):
             )
         return self
     
+    @property
+    def is_serialized(self) -> bool:
+        return bool(self.batch_number or self.container_number or self.aliquot)
+    
+    
 class Material_Consumable(PredefinedCategory):
     '''Represents the -MC category'''
     key: str = Field(default='-MC', frozen=True)
@@ -115,6 +129,11 @@ class Material_Consumable(PredefinedCategory):
             )
         return self
     
+    @property
+    def is_serialized(self) -> bool:
+        return bool(self.batch_number or self.serial_number or self.aliquot)
+    
+    
 class Material_Misc(Material_Consumable):
     '''Represents the -MX category'''
     # same fields as Consumable
@@ -128,6 +147,8 @@ class Material_Misc(Material_Consumable):
     ''' Category segments, which are not defined in the specification'''
     
 
+    
+
 
 ## Data
 class Data_Abstract(PredefinedCategory, ABC):
@@ -147,6 +168,11 @@ class Data_Abstract(PredefinedCategory, ABC):
                     highlight_pattern = f"{self.key}"
             )
         return self
+    
+    @property
+    def is_serialized(self) -> bool:
+        return True
+    
 
 class Data_Result(Data_Abstract):
     '''Represents the -DR category'''
@@ -215,6 +241,11 @@ class Processor_Abstract(PredefinedCategory, ABC):
                     highlight_pattern = f"{self.key}"
             )
         return self
+    
+    @property
+    def is_serialized(self) -> bool:
+        return bool(self.processor_instance)
+    
 
 class Processor_Software(Processor_Abstract):
     '''Represents the -PS category'''
@@ -252,6 +283,11 @@ class Misc(Category, ABC):
             )
         return self
     
+    @property
+    def is_serialized(self) -> bool:
+        return bool(self.id)
+    
+    
     
 category_key_to_class_map  = {
         '-MD': Material_Device,

labfreed/pac_id/extension.py

@@ -1,7 +1,7 @@
 
 from abc import ABC, abstractproperty
 
-from pydantic import model_validator
+from pydantic import computed_field, model_validator
 
 from labfreed.labfreed_infrastructure import LabFREED_BaseModel, ValidationMsgLevel
 
@@ -29,6 +29,7 @@ class Extension(LabFREED_BaseModel,ExtensionBase):
     type:str|None
     data_:str
     
+    @computed_field
     @property
     def data(self) -> str:
         return self.data_

labfreed/pac_id_resolver/cit_v1.py

@@ -1,25 +1,27 @@
 
 import re
 
+from deprecated import deprecated
+
 from pydantic import Field, model_validator
 from labfreed.labfreed_infrastructure import LabFREED_BaseModel, ValidationMessage, ValidationMsgLevel
 from labfreed.pac_id.pac_id import PAC_ID
 from labfreed.pac_id_resolver.services import Service, ServiceGroup
-from labfreed.pac_id_resolver.cit_common import ( _add_msg_to_cit_entry_model, 
+from labfreed.pac_id_resolver.resolver_config_common import ( _add_msg_to_cit_entry_model, 
                                                  _validate_service_name, 
                                                  _validate_application_intent, 
                                                  _validate_service_type,
                                                  ServiceType)
 
 
-
+@deprecated("Use ResolverConfig")
 class CITEntry_v1(LabFREED_BaseModel):
     applicable_if: str = Field(..., min_length=1)
     service_name: str = Field(..., min_length=1)
     application_intent:str = Field(..., min_length=1)
     service_type:ServiceType|str
     template_url:str = Field(..., min_length=1)
-    
+        
     
     @model_validator(mode='after')
     def _validate_model(self):
@@ -67,7 +69,7 @@ class CITEntry_v1(LabFREED_BaseModel):
     
     
 
-
+@deprecated("Use ResolverConfig")
 class CIT_v1(LabFREED_BaseModel):
     origin:str = ''
     entries:list[CITEntry_v1]

labfreed/pac_id_resolver/resolver.py

@@ -2,14 +2,13 @@ from functools import lru_cache
 import logging
 from typing import Self
 from requests import get
-
-
+from deprecated import deprecated
 
 from labfreed.pac_cat.pac_cat import PAC_CAT
 from labfreed.pac_id.pac_id import PAC_ID
 from labfreed.pac_id_resolver.services import ServiceGroup
 from labfreed.pac_id_resolver.cit_v1 import CIT_v1
-from labfreed.pac_id_resolver.cit_v2 import CIT_v2
+from labfreed.pac_id_resolver.resolver_config import ResolverConfig
 
 
 
@@ -22,49 +21,67 @@ def load_cit(path):
         return cit_from_str(s)
 
     
-def cit_from_str(s:str, origin:str='') -> CIT_v1|CIT_v2:
+@deprecated("cit version 1 is deprecated. use resolvber config and load with ResolverConfig.from_yaml(s)")
+def cit_from_str(s:str, origin:str='') -> CIT_v1|ResolverConfig:
     try:
-        cit2 = CIT_v2.from_yaml(s)
+        cit2 = ResolverConfig.from_yaml(s)
         cit_version = 'v2'
-    except Exception:
+    except Exception as e1:
         cit2 = None
     try:
         cit1 = CIT_v1.from_csv(s, origin)
         cit_version = 'v1'  # noqa: F841
-    except Exception:
+    except Exception as e2:
         cit1 = None
     
     cit = cit2 or cit1 or None
     return cit
 
 @lru_cache
-def _get_issuer_cit(issuer:str):
+def _get_issuer_resolver_config(issuer:str):
     '''Gets the issuer's cit.'''
+    # V2
+    url = 'HTTPS://PAC.' + issuer + '/resolver_config.yaml'
+    try:
+        r = get(url, timeout=2)
+        if r.status_code < 400:
+            config_str = r.text
+            resolver_config = ResolverConfig.from_yaml(config_str)
+            return resolver_config
+        else: 
+            logging.error(f"Could not get CIT V2 form {issuer}")
+    except Exception:
+        logging.error(f"Could not get CIT V2 form {issuer}")
+        
+        
+    # V1 (as fallback)
     url = 'HTTPS://PAC.' + issuer + '/coupling-information-table'
     try:
         r = get(url, timeout=2)
         if r.status_code < 400:
-            cit_str = r.text
+            config_str = r.text
+            cit = CIT_v1.from_csv(config_str, '')
+            return cit
         else: 
             logging.error(f"Could not get CIT form {issuer}")
-            cit_str  = None
     except Exception:
         logging.error(f"Could not get CIT form {issuer}")
-        cit_str  = None
-    cit = cit_from_str(cit_str, origin=issuer)
-    return cit
+        
+    # no cit found
+    return None 
+
     
 
 
 class PAC_ID_Resolver():
-    def __init__(self, cits:list[CIT_v2|CIT_v1]=None) -> Self:
+    def __init__(self, resolver_configs:list[ResolverConfig|CIT_v1]=None) -> Self:
         '''Initialize the resolver with coupling information tables'''
-        if not cits:
-            cits = []
-        self._cits = set(cits)
+        if not resolver_configs:
+            resolver_configs = []
+        self._resolver_configs = set(resolver_configs)
             
         
-    def resolve(self, pac_id:PAC_ID|str, check_service_status=True, use_issuer_cit=True) -> list[ServiceGroup]:
+    def resolve(self, pac_id:PAC_ID|str, check_service_status=True, use_issuer_resolver_config=True) -> list[ServiceGroup]:
         '''Resolve a PAC-ID'''
         if isinstance(pac_id, str):
             pac_id_catless = PAC_ID.from_url(pac_id, try_pac_cat=False)
@@ -77,18 +94,21 @@ class PAC_ID_Resolver():
             raise ValueError('pac_id is invalid. Should be a PAC-ID in url form or a PAC-ID object')
     
                 
-        cits = self._cits.copy()
-        if use_issuer_cit:
-            if issuer_cit := _get_issuer_cit(pac_id.issuer):
-                cits.add(issuer_cit)
+        resolver_configs = self._resolver_configs.copy()
+        if use_issuer_resolver_config:
+            if issuer_resolver_config := _get_issuer_resolver_config(pac_id.issuer):
+                resolver_configs.add(issuer_resolver_config)
          
         matches = []
-        for cit in cits:
-            if isinstance(cit, CIT_v1):
-                # cit v1 has no concept of categories and implied keys. It would treat these segments as value segment
-                matches.append(cit.evaluate_pac_id(pac_id_catless))
-            else:
-                matches.append(cit.evaluate_pac_id(pac_id))
+        for cit in resolver_configs:
+            try:
+                if isinstance(cit, CIT_v1):
+                    # cit v1 has no concept of categories and implied keys. It would treat these segments as value segment
+                    matches.append(cit.evaluate_pac_id(pac_id_catless))
+                else:
+                    matches.append(cit.evaluate_pac_id(pac_id))
+            except Exception as e:
+                logging.error(f'Failed to resolve pac {pac_id.to_url()} with cit {cit.origin}')
         
         if check_service_status:
             for m in matches:

labfreed/pac_id_resolver/{cit_v2.py → resolver_config.py}

@@ -8,18 +8,18 @@ import jsonpath_ng.ext as jsonpath
 
 from labfreed.pac_id_resolver.services import Service, ServiceGroup
 from labfreed.labfreed_infrastructure import LabFREED_BaseModel, ValidationMsgLevel, _quote_texts
-from labfreed.pac_id_resolver.cit_common import ( ServiceType)
+from labfreed.pac_id_resolver.resolver_config_common import ( ServiceType)
 
 
 __all__ = [
-    "CIT_v2",
-    "CITBlock_v2",
-    "CITEntry_v2"
+    "ResolverConfig",
+    "ResolverConfigBlock",
+    "ResolverConfigEntry"
 ]
 
 
 
-class CITEntry_v2(LabFREED_BaseModel):
+class ResolverConfigEntry(LabFREED_BaseModel):
     service_name: str
     application_intents:list[str]
     service_type:ServiceType |str
@@ -92,9 +92,9 @@ class CITEntry_v2(LabFREED_BaseModel):
     
     
 
-class CITBlock_v2(LabFREED_BaseModel):
+class ResolverConfigBlock(LabFREED_BaseModel):
     applicable_if: str  = Field(default='True', alias='if')
-    entries: list[CITEntry_v2]
+    entries: list[ResolverConfigEntry]
     
     @field_validator('applicable_if', mode='before')
     @classmethod
@@ -104,21 +104,21 @@ class CITBlock_v2(LabFREED_BaseModel):
     
 
 
-class CIT_v2(LabFREED_BaseModel):
+class ResolverConfig(LabFREED_BaseModel):
     schema_version: str = Field(default='2.0')
-    '''Coupling Information Table (CIT)'''
+    '''Resolver Configuration'''
     origin: str = ''
     model_config = {
         "extra": "allow"
     }
     '''@private'''
-    cit: list[CITBlock_v2] = Field(default_factory=list)
+    config: list[ResolverConfigBlock] = Field(default_factory=list)
     
     @model_validator(mode='after')
     def _validate_origin(self):
         if len(self.origin) == 0:
             self._add_validation_message(level=ValidationMsgLevel.WARNING,
-                                        source='CIT origin',
+                                        source='ResolverConfig origin',
                                         msg='Origin should not be empty'
                                         )
         return self
@@ -137,37 +137,37 @@ class CIT_v2(LabFREED_BaseModel):
         yml = yaml.dump(self.model_dump()                        )
         return yml
      
-    # hash and equal are only used to avoid adding the same cit multiple times. 
+    # hash and equal are only used to avoid adding the same resolver config multiple times. 
     # we can live with some instances, where it does not work 
     def __hash__(self):
         return self.model_dump_json().__hash__()
     
     def __eq__(self, other):
-        if not isinstance(other, CIT_v2):
+        if not isinstance(other, ResolverConfig):
             return False
         return self.model_dump() == other.model_dump()
     
     
     def evaluate_pac_id(self, pac):
         pac_id_json = pac.to_dict()
-        cit_evaluated = ServiceGroup(origin=self.origin)   
-        for block in self.cit:
+        resolver_config_evaluated = ServiceGroup(origin=self.origin)   
+        for block in self.config:
             _, is_applicable = self._evaluate_applicable_if(pac_id_json, block.applicable_if)
             if not is_applicable:
                 continue
 
             for e in block.entries:
                 if e.errors():
-                    continue #make this stable against errors in the cit
+                    continue #make this stable against errors in the resolver config
                 url = self._eval_url_template(pac_id_json, e.template_url)
-                cit_evaluated.services.append(Service(  
+                resolver_config_evaluated.services.append(Service(  
                                                         service_name=e.service_name,
                                                         application_intents=e.application_intents,
                                                         service_type=e.service_type,
                                                         url = url
                                     )
                               )            
-        return cit_evaluated
+        return resolver_config_evaluated
     
     
     def _evaluate_applicable_if(self, pac_id_json:str, expression) -> tuple[str, bool]:

labfreed/well_known_extensions/default_extension_interpreters.py

@@ -1,7 +1,7 @@
-from .display_name_extension import DisplayNameExtension
+from .text_base36_extension import TextBase36Extension
 from .trex_extension import TREX_Extension
 
 default_extension_interpreters = {
     'TREX': TREX_Extension,
-    'N': DisplayNameExtension
+    'TEXT': TextBase36Extension
 }

labfreed/well_known_extensions/display_name_extension.py

@@ -1,27 +1,35 @@
 import logging
 from typing import Literal, Self
-from pydantic import computed_field
+from pydantic import  model_validator
 from labfreed.labfreed_infrastructure import LabFREED_BaseModel
 from labfreed.pac_id.extension import ExtensionBase
-from labfreed.utilities.base36 import from_base36, to_base36
+from labfreed.well_known_extensions.text_base36_extension import TextBase36Extension
 
+from labfreed.utilities.base36 import from_base36
 
-class DisplayNameExtension(ExtensionBase, LabFREED_BaseModel):
+
+class DisplayNameExtension(TextBase36Extension, LabFREED_BaseModel):
     name:Literal['N'] = 'N'
     type:Literal['TEXT'] = 'TEXT'
-    display_name: str       
+    display_name: str      
     
-    @computed_field
-    @property
-    def data(self)->str:
-        # return '/'.join([to_base36(dn) for dn in self.display_name])
-        return to_base36(self.display_name).root
+    @model_validator(mode='before')
+    def move_display_name_to_text(cls, data):
+        # if display_name provided, move it to text
+        if isinstance(data, dict) and 'display_name' in data:
+            data['text'] = data.pop('display_name')
+        return data
     
     @staticmethod
     def from_extension(ext:ExtensionBase) -> Self:
         return DisplayNameExtension.create(name=ext.name,
                                   type=ext.type,
                                   data=ext.data)
+
+    @property
+    def display_name(self) -> str:
+        return self.text 
+    
     
     @staticmethod
     def create(*, name, type, data):

labfreed/well_known_extensions/text_base36_extension.py

@@ -0,0 +1,38 @@
+import logging
+from typing import Literal, Self
+from pydantic import computed_field
+from labfreed.labfreed_infrastructure import LabFREED_BaseModel
+from labfreed.pac_id.extension import ExtensionBase
+from labfreed.utilities.base36 import from_base36, to_base36
+
+
+class TextBase36Extension(ExtensionBase, LabFREED_BaseModel):
+    name:str 
+    type:Literal['TEXT'] = 'TEXT'
+    text: str       
+    
+    @computed_field
+    @property
+    def data(self)->str:
+        # return '/'.join([to_base36(dn) for dn in self.display_name])
+        return to_base36(self.text).root
+    
+    @staticmethod
+    def from_extension(ext:ExtensionBase) -> Self:
+        return TextBase36Extension.create(name=ext.name,
+                                  type=ext.type,
+                                  data=ext.data)
+    
+    @staticmethod
+    def create(*, name, type, data):
+            
+        if type != 'TEXT':
+            logging.warning(f'Type {name} was given, but this extension should only be used with type "TEXT". Will try to parse data as display names')
+        
+        text = from_base36(data)
+         
+        return TextBase36Extension(name=name, text=text)
+    
+    def __str__(self):
+        return 'Text: '+ self.text
+

{labfreed-1.0.0a13.dist-info → labfreed-1.0.0a15.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: labfreed
-Version: 1.0.0a13
+Version: 1.0.0a15
 Summary: Python implementation of LabFREED building blocks
 Author-email: Reto Thürer <thuerer.r@buchi.com>
 Requires-Python: >=3.11
@@ -25,6 +25,7 @@ Requires-Dist: jsonpath-ng>=1.7.0
 Requires-Dist: requests>=2.32.3
 Requires-Dist: requests_cache>=1.2.1
 Requires-Dist: cachetools>=6.1.0
+Requires-Dist: deprecated>=1.2.18
 Requires-Dist: pytest>=8.3.5 ; extra == "dev"
 Requires-Dist: pdoc>=15.0.1 ; extra == "dev"
 Requires-Dist: flit>=3.12.0 ; extra == "dev"