forked from s_ranjbar/city_retrofit
Changing comments and signature to improve the documentation
This commit is contained in:
parent
688541b20c
commit
60f5d9aca1
|
@ -6,27 +6,27 @@ Copyright © 2022 Project Author Guille Gutierrez guillermo.gutierrezmorote@conc
|
|||
|
||||
class Catalog:
|
||||
"""
|
||||
Catalog name
|
||||
Catalogs base class not implemented instance of the Catalog base class, catalogs will inherit from this class.
|
||||
"""
|
||||
|
||||
@property
|
||||
def names(self):
|
||||
def names(self, category=None):
|
||||
"""
|
||||
Base property to return the catalog entries names
|
||||
:return: not implemented error
|
||||
:return: Catalog names filter by category if provided
|
||||
"""
|
||||
raise NotImplementedError
|
||||
|
||||
def entries(self, category=None):
|
||||
"""
|
||||
Base property to return the catalog entries
|
||||
:return: not implemented error
|
||||
:return: Catalog content filter by category if provided
|
||||
"""
|
||||
raise NotImplementedError
|
||||
|
||||
def get_entry(self, name):
|
||||
"""
|
||||
Base property to return the catalog entry matching the given name
|
||||
:return: not implemented error
|
||||
:return: Catalog entry with the matching name
|
||||
"""
|
||||
raise NotImplementedError
|
||||
|
|
|
@ -5,8 +5,9 @@ Copyright © 2022 Project Author Guille Gutierrez guillermo.gutierrezmorote@conc
|
|||
"""
|
||||
|
||||
from pathlib import Path
|
||||
from typing import TypeVar
|
||||
from catalogs.greenery.greenery_catalog import GreeneryCatalog
|
||||
|
||||
Catalog = TypeVar('Catalog')
|
||||
|
||||
class GreeneryCatalogFactory:
|
||||
"""
|
||||
|
@ -19,25 +20,17 @@ class GreeneryCatalogFactory:
|
|||
self._path = base_path
|
||||
|
||||
@property
|
||||
def _nrel(self) -> GreeneryCatalog:
|
||||
def _nrel(self):
|
||||
"""
|
||||
Return a greenery catalog using ecore as datasource
|
||||
Return a greenery catalog based in NREL using ecore as datasource
|
||||
:return: GreeneryCatalog
|
||||
"""
|
||||
return GreeneryCatalog((self._path / 'ecore_greenery_catalog.xml').resolve())
|
||||
|
||||
@property
|
||||
def catalog(self) -> GreeneryCatalog:
|
||||
def catalog(self) -> Catalog:
|
||||
"""
|
||||
Enrich the city given to the class using the class given handler
|
||||
:return: City
|
||||
:return: Catalog
|
||||
"""
|
||||
return getattr(self, self._file_type, lambda: None)
|
||||
|
||||
@property
|
||||
def catalog_debug(self) -> GreeneryCatalog:
|
||||
"""
|
||||
Enrich the city given to the class using the class given handler
|
||||
:return: City
|
||||
"""
|
||||
return GreeneryCatalog((self._path / 'ecore_greenery_catalog.xml').resolve())
|
||||
|
|
Loading…
Reference in New Issue
Block a user