Feat: Multiplayer sessions added using CRUD database.

business_objects/tcg/__init__.py

@@ -0,0 +1 @@
+

business_objects/tcg/mtg_deck.py

@@ -0,0 +1,172 @@
+"""
+Project:    PARTS Website
+Author:     Edward Middleton-Smith
+            Precision And Research Technology Systems Limited
+
+Technology: Business Objects
+Feature:    MTG Deck Business Object
+"""
+
+# internal
+from business_objects.base import Base
+from business_objects.db_base import SQLAlchemy_ABC, Get_Many_Parameters_Base
+import lib.argument_validation as av
+from extensions import db
+from helpers.helper_app import Helper_App
+# external
+from dataclasses import dataclass
+from typing import ClassVar
+from sqlalchemy.types import Text, Boolean
+
+
+class MTG_Deck(SQLAlchemy_ABC, Base):
+    ATTR_DECK_ID: ClassVar[str] = 'deck_id'
+    ATTR_COMMANDER_BRACKET_ID: ClassVar[str] = 'commander_bracket_id'
+    FLAG_DECK: ClassVar[str] = 'deck'
+    FLAG_IS_COMMANDER: ClassVar[str] = 'is_commander'
+    NAME_ATTR_OPTION_VALUE: ClassVar[str] = ATTR_DECK_ID
+    NAME_ATTR_OPTION_TEXT: ClassVar[str] = Base.FLAG_NAME
+
+    __tablename__ = 'tcg_mtg_deck'
+    __table_args__ = { 'extend_existing': True }
+
+    deck_id = db.Column(db.Integer, primary_key=True)
+    name = db.Column(db.Text)
+    is_commander = db.Column(db.Boolean)
+    commander_bracket_id = db.Column(db.Integer)
+    active = db.Column(db.Boolean)
+    created_on = db.Column(db.DateTime)
+    created_by_user_id = db.Column(db.Integer)
+    updated_last_on = db.Column(db.DateTime)
+    updated_last_by_user_id = db.Column(db.Integer)
+    change_set_id = db.Column(db.Integer)
+
+    def __init__(self):
+        self.deck_id = 0
+        self.is_new = False
+        super().__init__()
+
+    @classmethod
+    def from_db_mtg_deck(cls, query_row):
+        _m = f'{cls.__qualname__}.from_db_mtg_deck'
+        deck = cls()
+        deck.deck_id = query_row[0]
+        deck.name = query_row[1]
+        deck.is_commander = av.input_bool(query_row[2], cls.FLAG_IS_COMMANDER, _m)
+        deck.commander_bracket_id = query_row[3]
+        deck.active = av.input_bool(query_row[4], cls.FLAG_ACTIVE, _m)
+        deck.created_on = query_row[5]
+        deck.created_by_user_id = query_row[6]
+        return deck
+
+    @classmethod
+    def from_json(cls, json):
+        _m = f'{cls.__qualname__}.from_json'
+        deck = cls()
+        if json is None: return deck
+        deck.deck_id = json.get(cls.ATTR_DECK_ID, -1)
+        deck.name = json.get(cls.FLAG_NAME, None)
+        deck.is_commander = av.input_bool(json.get(cls.FLAG_IS_COMMANDER, True), cls.FLAG_IS_COMMANDER, _m)
+        deck.commander_bracket_id = json.get(cls.ATTR_COMMANDER_BRACKET_ID, None)
+        deck.active = av.input_bool(json.get(cls.FLAG_ACTIVE, True), cls.FLAG_ACTIVE, _m)
+        deck.created_on = json.get(cls.FLAG_CREATED_ON, None)
+        deck.created_by_user_id = json.get(Base.ATTR_USER_ID, None)
+        return deck
+
+    def to_json(self):
+        as_json = {
+            **self.get_shared_json_attributes(self)
+            , self.ATTR_DECK_ID: self.deck_id
+            , self.FLAG_NAME: self.name
+            , self.FLAG_IS_COMMANDER: self.is_commander
+            , self.ATTR_COMMANDER_BRACKET_ID: self.commander_bracket_id
+            , self.FLAG_ACTIVE: self.active
+            , self.FLAG_CREATED_ON: self.created_on
+            , Base.ATTR_USER_ID: self.created_by_user_id
+        }
+        return as_json
+
+    def __repr__(self):
+        return f'''
+{self.__class__.__name__}(
+    {self.ATTR_DECK_ID}: {self.deck_id}
+    {self.FLAG_NAME}: {self.name}
+    {self.FLAG_IS_COMMANDER}: {self.is_commander}
+    {self.ATTR_COMMANDER_BRACKET_ID}: {self.commander_bracket_id}
+    {self.FLAG_ACTIVE}: {self.active}
+    {self.FLAG_CREATED_ON}: {self.created_on}
+    {Base.ATTR_USER_ID}: {self.created_by_user_id}
+)
+            '''
+
+
+class Parameters_MTG_Deck(Get_Many_Parameters_Base):
+    get_all_deck: bool
+    get_inactive_deck: bool
+    deck_ids: str
+    deck_names: str
+    commander_bracket_ids: str
+    include_commander_option: bool
+    require_all_id_filters_met: bool
+    require_any_id_filters_met: bool
+    require_all_non_id_filters_met: bool
+    require_any_non_id_filters_met: bool
+
+    @classmethod
+    def get_default(cls):
+        return cls(
+              get_all_deck = True
+            , get_inactive_deck = False
+            , deck_ids = ''
+            , deck_names = ''
+            , commander_bracket_ids = ''
+            , include_commander_option = True
+            , require_all_id_filters_met = True
+            , require_any_id_filters_met = True
+            , require_all_non_id_filters_met = False
+            , require_any_non_id_filters_met = True
+        )
+
+    @classmethod
+    def from_json(cls, json):
+        return cls(
+              get_all_deck = json.get('a_get_all_deck', False)
+            , get_inactive_deck = json.get('a_get_inactive_deck', False)
+            , deck_ids = json.get('a_deck_ids', '')
+            , deck_names = json.get('a_deck_names', '')
+            , commander_bracket_ids = json.get('a_commander_bracket_ids', '')
+            , include_commander_option = json.get('a_include_commander_option', True)
+            , require_all_id_filters_met = json.get('a_require_all_id_filters_met', True)
+            , require_any_id_filters_met = json.get('a_require_any_id_filters_met', True)
+            , require_all_non_id_filters_met = json.get('a_require_all_non_id_filters_met', False)
+            , require_any_non_id_filters_met = json.get('a_require_any_non_id_filters_met', True)
+        )
+
+    def to_json(self):
+        return {
+              'a_get_all_deck': self.get_all_deck
+            , 'a_get_inactive_deck': self.get_inactive_deck
+            , 'a_deck_ids': self.deck_ids
+            , 'a_deck_names': self.deck_names
+            , 'a_commander_bracket_ids': self.commander_bracket_ids
+            , 'a_include_commander_option': self.include_commander_option
+            , 'a_require_all_id_filters_met': self.require_all_id_filters_met
+            , 'a_require_any_id_filters_met': self.require_any_id_filters_met
+            , 'a_require_all_non_id_filters_met': self.require_all_non_id_filters_met
+            , 'a_require_any_non_id_filters_met': self.require_any_non_id_filters_met
+        }
+
+    @staticmethod
+    def get_type_hints():
+        return {
+              'a_get_all_deck': Boolean
+            , 'a_get_inactive_deck': Boolean
+            , 'a_deck_ids': Text
+            , 'a_deck_names': Text
+            , 'a_commander_bracket_ids': Text
+            , 'a_include_commander_option': Boolean
+            , 'a_require_all_id_filters_met': Boolean
+            , 'a_require_any_id_filters_met': Boolean
+            , 'a_require_all_non_id_filters_met': Boolean
+            , 'a_require_any_non_id_filters_met': Boolean
+        }

business_objects/tcg/mtg_deck_commander_bracket.py

@@ -0,0 +1,152 @@
+"""
+Project:    PARTS Website
+Author:     Edward Middleton-Smith
+            Precision And Research Technology Systems Limited
+
+Technology: Business Objects
+Feature:    MTG Deck Commander Bracket Business Object
+"""
+
+# internal
+from business_objects.base import Base
+from business_objects.db_base import SQLAlchemy_ABC, Get_Many_Parameters_Base
+import lib.argument_validation as av
+from extensions import db
+from helpers.helper_app import Helper_App
+# external
+from dataclasses import dataclass
+from typing import ClassVar
+
+
+class MTG_Deck_Commander_Bracket(SQLAlchemy_ABC, Base):
+    ATTR_COMMANDER_BRACKET_ID: ClassVar[str] = 'commander_bracket_id'
+    FLAG_COMMANDER_BRACKET: ClassVar[str] = 'commander_bracket'
+    FLAG_DESCRIPTION: ClassVar[str] = 'description'
+    FLAG_DISPLAY_ORDER: ClassVar[str] = 'display_order'
+    NAME_ATTR_OPTION_VALUE: ClassVar[str] = ATTR_COMMANDER_BRACKET_ID
+    NAME_ATTR_OPTION_TEXT: ClassVar[str] = Base.FLAG_NAME
+
+    __tablename__ = 'tcg_mtg_deck_commander_bracket'
+    __table_args__ = { 'extend_existing': True }
+
+    commander_bracket_id = db.Column(db.Integer, primary_key=True)
+    name = db.Column(db.Text)
+    description = db.Column(db.Text)
+    display_order = db.Column(db.Integer)
+    active = db.Column(db.Boolean)
+    created_on = db.Column(db.DateTime)
+    created_by_user_id = db.Column(db.Integer)
+    updated_last_on = db.Column(db.DateTime)
+    updated_last_by_user_id = db.Column(db.Integer)
+    change_set_id = db.Column(db.Integer)
+
+    def __init__(self):
+        self.commander_bracket_id = 0
+        self.is_new = False
+        super().__init__()
+
+    @classmethod
+    def from_db_mtg_deck_commander_bracket(cls, query_row):
+        _m = f'{cls.__qualname__}.from_db_mtg_deck_commander_bracket'
+        bracket = cls()
+        bracket.commander_bracket_id = query_row[0]
+        bracket.name = query_row[1]
+        bracket.description = query_row[2]
+        bracket.display_order = query_row[3]
+        bracket.active = av.input_bool(query_row[4], cls.FLAG_ACTIVE, _m)
+        bracket.created_on = query_row[5]
+        bracket.created_by_user_id = query_row[6]
+        return bracket
+
+    @classmethod
+    def from_json(cls, json):
+        _m = f'{cls.__qualname__}.from_json'
+        bracket = cls()
+        if json is None: return bracket
+        bracket.commander_bracket_id = json.get(cls.ATTR_COMMANDER_BRACKET_ID, -1)
+        bracket.name = json.get(cls.FLAG_NAME, None)
+        bracket.description = json.get(cls.FLAG_DESCRIPTION, None)
+        bracket.display_order = json.get(cls.FLAG_DISPLAY_ORDER, 0)
+        bracket.active = av.input_bool(json.get(cls.FLAG_ACTIVE, True), cls.FLAG_ACTIVE, _m)
+        bracket.created_on = json.get(cls.FLAG_CREATED_ON, None)
+        bracket.created_by_user_id = json.get(Base.ATTR_USER_ID, None)
+        return bracket
+
+    def to_json(self):
+        as_json = {
+            **self.get_shared_json_attributes(self)
+            , self.ATTR_COMMANDER_BRACKET_ID: self.commander_bracket_id
+            , self.FLAG_NAME: self.name
+            , self.FLAG_DESCRIPTION: self.description
+            , self.FLAG_DISPLAY_ORDER: self.display_order
+            , self.FLAG_ACTIVE: self.active
+            , self.FLAG_CREATED_ON: self.created_on
+            , Base.ATTR_USER_ID: self.created_by_user_id
+        }
+        return as_json
+
+    def __repr__(self):
+        return f'''
+{self.__class__.__name__}(
+    {self.ATTR_COMMANDER_BRACKET_ID}: {self.commander_bracket_id}
+    {self.FLAG_NAME}: {self.name}
+    {self.FLAG_DESCRIPTION}: {self.description}
+    {self.FLAG_DISPLAY_ORDER}: {self.display_order}
+    {self.FLAG_ACTIVE}: {self.active}
+    {self.FLAG_CREATED_ON}: {self.created_on}
+    {Base.ATTR_USER_ID}: {self.created_by_user_id}
+)
+            '''
+
+
+class Parameters_MTG_Deck_Commander_Bracket(Get_Many_Parameters_Base):
+    get_all_commander_bracket: bool
+    get_inactive_commander_bracket: bool
+    commander_bracket_ids: str
+    commander_bracket_names: str
+    user_ids: str
+    require_all_id_filters_met: bool
+    require_any_id_filters_met: bool
+    require_all_non_id_filters_met: bool
+    require_any_non_id_filters_met: bool
+
+    @classmethod
+    def get_default(cls, user_id_session):
+        return cls(
+              get_all_commander_bracket = True
+            , get_inactive_commander_bracket = False
+            , commander_bracket_ids = ''
+            , commander_bracket_names = ''
+            , user_ids = str(user_id_session)
+            , require_all_id_filters_met = True
+            , require_any_id_filters_met = True
+            , require_all_non_id_filters_met = False
+            , require_any_non_id_filters_met = True
+        )
+
+    @classmethod
+    def from_json(cls, json):
+        return cls(
+              get_all_commander_bracket = json.get('a_get_all_commander_bracket', False)
+            , get_inactive_commander_bracket = json.get('a_get_inactive_commander_bracket', False)
+            , commander_bracket_ids = json.get('a_commander_bracket_ids', '')
+            , commander_bracket_names = json.get('a_commander_bracket_names', '')
+            , user_ids = json.get('a_user_ids', '')
+            , require_all_id_filters_met = json.get('a_require_all_id_filters_met', True)
+            , require_any_id_filters_met = json.get('a_require_any_id_filters_met', True)
+            , require_all_non_id_filters_met = json.get('a_require_all_non_id_filters_met', False)
+            , require_any_non_id_filters_met = json.get('a_require_any_non_id_filters_met', True)
+        )
+
+    def to_json(self):
+        return {
+              'a_get_all_commander_bracket': self.get_all_commander_bracket
+            , 'a_get_inactive_commander_bracket': self.get_inactive_commander_bracket
+            , 'a_commander_bracket_ids': self.commander_bracket_ids
+            , 'a_commander_bracket_names': self.commander_bracket_names
+            , 'a_user_ids': self.user_ids
+            , 'a_require_all_id_filters_met': self.require_all_id_filters_met
+            , 'a_require_any_id_filters_met': self.require_any_id_filters_met
+            , 'a_require_all_non_id_filters_met': self.require_all_non_id_filters_met
+            , 'a_require_any_non_id_filters_met': self.require_any_non_id_filters_met
+        }

business_objects/tcg/mtg_game.py

@@ -0,0 +1,192 @@
+"""
+Project:    PARTS Website
+Author:     Edward Middleton-Smith
+            Precision And Research Technology Systems Limited
+
+Technology: Business Objects
+Feature:    MTG Game Business Object
+"""
+
+# internal
+from business_objects.base import Base
+from business_objects.db_base import SQLAlchemy_ABC, Get_Many_Parameters_Base
+import lib.argument_validation as av
+from extensions import db
+from helpers.helper_app import Helper_App
+# external
+from dataclasses import dataclass
+from typing import ClassVar
+from sqlalchemy import bindparam
+from sqlalchemy.types import Text, Boolean
+
+
+class MTG_Game(SQLAlchemy_ABC, Base):
+    ATTR_GAME_ID: ClassVar[str] = 'game_id'
+    FLAG_END_ON: ClassVar[str] = 'end_on'
+    FLAG_GAME: ClassVar[str] = 'game'
+    FLAG_IS_COMMANDER: ClassVar[str] = 'is_commander'
+    FLAG_IS_DRAFT: ClassVar[str] = 'is_draft'
+    FLAG_IS_SEALED: ClassVar[str] = 'is_sealed'
+    FLAG_LOCATION_NAME: ClassVar[str] = 'location_name'
+    FLAG_NOTES: ClassVar[str] = 'notes'
+    FLAG_START_ON: ClassVar[str] = 'start_on'
+    FLAG_STARTING_LIFE: ClassVar[str] = 'starting_life'
+    NAME_ATTR_OPTION_VALUE: ClassVar[str] = ATTR_GAME_ID
+    NAME_ATTR_OPTION_TEXT: ClassVar[str] = FLAG_START_ON
+
+    __tablename__ = 'tcg_mtg_game'
+    __table_args__ = { 'extend_existing': True }
+
+    game_id = db.Column(db.Integer, primary_key=True)
+    notes = db.Column(db.Text)
+    is_commander = db.Column(db.Boolean)
+    is_draft = db.Column(db.Boolean)
+    is_sealed = db.Column(db.Boolean)
+    location_name = db.Column(db.Text)
+    start_on = db.Column(db.DateTime)
+    end_on = db.Column(db.DateTime)
+    starting_life = db.Column(db.Integer)
+    active = db.Column(db.Boolean)
+    created_on = db.Column(db.DateTime)
+    created_by_user_id = db.Column(db.Integer)
+    updated_last_on = db.Column(db.DateTime)
+    updated_last_by_user_id = db.Column(db.Integer)
+    change_set_id = db.Column(db.Integer)
+
+    def __init__(self):
+        self.game_id = 0
+        self.is_new = False
+        super().__init__()
+
+    @classmethod
+    def from_db_mtg_game(cls, query_row):
+        _m = f'{cls.__qualname__}.from_db_mtg_game'
+        game = cls()
+        game.game_id = query_row[0]
+        game.notes = query_row[1]
+        game.is_commander = av.input_bool(query_row[2], cls.FLAG_IS_COMMANDER, _m)
+        game.is_draft = av.input_bool(query_row[3], cls.FLAG_IS_DRAFT, _m)
+        game.is_sealed = av.input_bool(query_row[4], cls.FLAG_IS_SEALED, _m)
+        game.location_name = query_row[5]
+        game.start_on = query_row[6]
+        game.end_on = query_row[7]
+        game.starting_life = query_row[8]
+        game.active = av.input_bool(query_row[9], cls.FLAG_ACTIVE, _m)
+        game.created_on = query_row[10]
+        game.created_by_user_id = query_row[11]
+        return game
+
+    @classmethod
+    def from_json(cls, json):
+        _m = f'{cls.__qualname__}.from_json'
+        game = cls()
+        if json is None: return game
+        game.game_id = json.get(cls.ATTR_GAME_ID, -1)
+        game.notes = json.get(cls.FLAG_NOTES, None)
+        game.is_commander = av.input_bool(json.get(cls.FLAG_IS_COMMANDER, True), cls.FLAG_IS_COMMANDER, _m)
+        game.is_draft = av.input_bool(json.get(cls.FLAG_IS_DRAFT, False), cls.FLAG_IS_DRAFT, _m)
+        game.is_sealed = av.input_bool(json.get(cls.FLAG_IS_SEALED, False), cls.FLAG_IS_SEALED, _m)
+        game.location_name = json.get(cls.FLAG_LOCATION_NAME, None)
+        game.start_on = json.get(cls.FLAG_START_ON, None)
+        game.starting_life = json.get(cls.FLAG_STARTING_LIFE, 40)
+        game.end_on = json.get(cls.FLAG_END_ON, None)
+        game.active = av.input_bool(json.get(cls.FLAG_ACTIVE, True), cls.FLAG_ACTIVE, _m)
+        game.created_on = json.get(cls.FLAG_CREATED_ON, None)
+        game.created_by_user_id = json.get(Base.ATTR_USER_ID, None)
+        return game
+
+    def to_json(self):
+        as_json = {
+            **self.get_shared_json_attributes(self)
+            , self.ATTR_GAME_ID: self.game_id
+            , self.FLAG_NOTES: self.notes
+            , self.FLAG_IS_COMMANDER: self.is_commander
+            , self.FLAG_IS_DRAFT: self.is_draft
+            , self.FLAG_IS_SEALED: self.is_sealed
+            , self.FLAG_LOCATION_NAME: self.location_name
+            , self.FLAG_START_ON: self.start_on
+            , self.FLAG_STARTING_LIFE: self.starting_life
+            , self.FLAG_END_ON: self.end_on
+            , self.FLAG_ACTIVE: self.active
+            , self.FLAG_CREATED_ON: self.created_on
+            , Base.ATTR_USER_ID: self.created_by_user_id
+        }
+        return as_json
+
+    def __repr__(self):
+        return f'''
+{self.__class__.__name__}(
+    {self.ATTR_GAME_ID}: {self.game_id}
+    {self.FLAG_NOTES}: {self.notes}
+    {self.FLAG_IS_COMMANDER}: {self.is_commander}
+    {self.FLAG_IS_DRAFT}: {self.is_draft}
+    {self.FLAG_IS_SEALED}: {self.is_sealed}
+    {self.FLAG_LOCATION_NAME}: {self.location_name}
+    {self.FLAG_START_ON}: {self.start_on}
+    {self.FLAG_END_ON}: {self.end_on}
+    {self.FLAG_STARTING_LIFE}: {self.starting_life}
+    {self.FLAG_ACTIVE}: {self.active}
+    {self.FLAG_CREATED_ON}: {self.created_on}
+    {Base.ATTR_USER_ID}: {self.created_by_user_id}
+)
+            '''
+
+class Parameters_MTG_Game(Get_Many_Parameters_Base):
+    get_all_game: bool
+    get_inactive_game: bool
+    game_ids: str
+    get_all_user: bool
+    get_inactive_user: bool
+    user_ids: str
+    require_all_id_filters_met: bool
+    require_any_id_filters_met: bool
+
+    @classmethod
+    def get_default(cls, user_id_session):
+        return cls(
+              get_all_game = True
+            , get_inactive_game = False
+            , game_ids = ''
+            , get_all_user = False
+            , get_inactive_user = False
+            , user_ids = '' if user_id_session is None else f'{user_id_session}'
+            , require_all_id_filters_met = True
+            , require_any_id_filters_met = True
+        )
+
+    @classmethod
+    def from_json(cls, json):
+        return cls(
+              get_all_game = json.get('a_get_all_game', False)
+            , get_inactive_game = json.get('a_get_inactive_game', False)
+            , game_ids = json.get('a_game_ids', '')
+            , get_all_user = json.get('a_get_all_user', False)
+            , get_inactive_user = json.get('a_get_inactive_user', False)
+            , user_ids = json.get('a_user_ids', '')
+            , require_all_id_filters_met = json.get('a_require_all_id_filters_met', True)
+            , require_any_id_filters_met = json.get('a_require_any_id_filters_met', True)
+        )
+
+    def to_json(self):
+        return {
+              'a_get_all_game': self.get_all_game
+            , 'a_get_inactive_game': self.get_inactive_game
+            , 'a_game_ids': str(self.game_ids)
+            , 'a_get_all_user': self.get_all_user
+            , 'a_get_inactive_user': self.get_inactive_user
+            , 'a_user_ids': str(self.user_ids)
+            , 'a_require_all_id_filters_met': self.require_all_id_filters_met
+            , 'a_require_any_id_filters_met': self.require_any_id_filters_met
+        }
+    @staticmethod
+    def get_type_hints():
+        return {
+              'a_get_all_game': Boolean
+            , 'a_get_inactive_game': Boolean
+            , 'a_game_ids': Text
+            , 'a_get_all_user': Boolean
+            , 'a_get_inactive_user': Boolean
+            , 'a_user_ids': Text
+            , 'a_require_all_id_filters_met': Boolean
+            , 'a_require_any_id_filters_met': Boolean
+        }

business_objects/tcg/mtg_game_player.py

@@ -0,0 +1,197 @@
+"""
+Project:    PARTS Website
+Author:     Edward Middleton-Smith
+            Precision And Research Technology Systems Limited
+
+Technology: Business Objects
+Feature:    MTG Game Player Business Object
+"""
+
+# internal
+from business_objects.base import Base
+from business_objects.db_base import SQLAlchemy_ABC, Get_Many_Parameters_Base
+import lib.argument_validation as av
+from extensions import db
+from helpers.helper_app import Helper_App
+# external
+from dataclasses import dataclass
+from typing import ClassVar
+from sqlalchemy import Uuid
+from sqlalchemy.types import Text, Boolean
+# import uuid
+
+class MTG_Game_Player(SQLAlchemy_ABC, Base):
+    ATTR_PLAYER_ID: ClassVar[str] = 'player_id'
+    ATTR_GAME_ID: ClassVar[str] = 'game_id'
+    ATTR_DECK_ID: ClassVar[str] = 'deck_id'
+    FLAG_PLAYER: ClassVar[str] = 'player'
+    FLAG_NOTES: ClassVar[str] = 'notes'
+    FLAG_DISPLAY_ORDER: ClassVar[str] = 'display_order'
+    NAME_ATTR_OPTION_VALUE: ClassVar[str] = ATTR_PLAYER_ID
+    NAME_ATTR_OPTION_TEXT: ClassVar[str] = Base.FLAG_NAME
+
+    __tablename__ = 'tcg_mtg_game_player'
+    __table_args__ = { 'extend_existing': True }
+
+    player_id = db.Column(db.Integer, primary_key=True)
+    game_id = db.Column(db.Integer)
+    user_id = db.Column(db.Integer)
+    deck_id = db.Column(db.Integer)
+    name = db.Column(db.Text)
+    notes = db.Column(db.Text)
+    display_order = db.Column(db.Integer)
+    active = db.Column(db.Boolean)
+    created_on = db.Column(db.DateTime)
+    created_by_user_id = db.Column(db.Integer)
+    updated_last_on = db.Column(db.DateTime)
+    updated_last_by_user_id = db.Column(db.Integer)
+    change_set_id = db.Column(db.Integer)
+
+    def __init__(self):
+        self.player_id = 0
+        self.is_new = False
+        super().__init__()
+
+    @classmethod
+    def from_db_mtg_game_player(cls, query_row):
+        _m = f'{cls.__qualname__}.from_db_mtg_game_player'
+        player = cls()
+        player.player_id = query_row[0]
+        player.game_id = query_row[1]
+        player.user_id = query_row[2]
+        player.deck_id = query_row[3]
+        player.name = query_row[4]
+        player.notes = query_row[5]
+        player.display_order = query_row[6]
+        player.active = av.input_bool(query_row[7], cls.FLAG_ACTIVE, _m)
+        player.created_on = query_row[8]
+        player.created_by_user_id = query_row[9]
+        return player
+
+    @classmethod
+    def from_json(cls, json):
+        _m = f'{cls.__qualname__}.from_json'
+        player = cls()
+        if json is None: return player
+        player.player_id = json.get(cls.ATTR_PLAYER_ID, -1)
+        player.game_id = json.get(cls.ATTR_GAME_ID, None)
+        player.user_id = json.get(Base.ATTR_USER_ID, None)
+        player.deck_id = json.get(cls.ATTR_DECK_ID, None)
+        player.name = json.get(cls.FLAG_NAME, None)
+        player.notes = json.get(cls.FLAG_NOTES, None)
+        player.display_order = json.get(cls.FLAG_DISPLAY_ORDER, 0)
+        player.active = av.input_bool(json.get(cls.FLAG_ACTIVE, True), cls.FLAG_ACTIVE, _m)
+        player.created_on = json.get(cls.FLAG_CREATED_ON, None)
+        player.created_by_user_id = json.get(Base.ATTR_USER_ID, None)
+        return player
+
+    def to_json(self):
+        as_json = {
+            **self.get_shared_json_attributes(self)
+            , self.ATTR_PLAYER_ID: self.player_id
+            , self.ATTR_GAME_ID: self.game_id
+            , Base.ATTR_USER_ID: self.user_id
+            , self.ATTR_DECK_ID: self.deck_id
+            , self.FLAG_NAME: self.name
+            , self.FLAG_NOTES: self.notes
+            , self.FLAG_DISPLAY_ORDER: self.display_order
+            , self.FLAG_ACTIVE: self.active
+            , self.FLAG_CREATED_ON: self.created_on
+        }
+        return as_json
+
+    def __repr__(self):
+        return f'''
+{self.__class__.__name__}(
+    {self.ATTR_PLAYER_ID}: {self.player_id}
+    {self.ATTR_GAME_ID}: {self.game_id}
+    {Base.ATTR_USER_ID}: {self.user_id}
+    {self.ATTR_DECK_ID}: {self.deck_id}
+    {self.FLAG_NAME}: {self.name}
+    {self.FLAG_NOTES}: {self.notes}
+    {self.FLAG_DISPLAY_ORDER}: {self.display_order}
+    {self.FLAG_ACTIVE}: {self.active}
+    {self.FLAG_CREATED_ON}: {self.created_on}
+)
+            '''
+
+class MTG_Game_Player_Temp(db.Model, Base):
+    __tablename__ = 'tcg_mtg_game_player_temp'
+    __table_args__ = { 'extend_existing': True }
+    temp_id = db.Column(db.Integer, primary_key=True)
+    player_id = db.Column(db.Integer)
+    game_id = db.Column(db.Integer)
+    user_id = db.Column(db.Integer)
+    deck_id = db.Column(db.Integer)
+    name = db.Column(db.Text)
+    notes = db.Column(db.Text)
+    display_order = db.Column(db.Integer)
+    active = db.Column(db.Boolean)
+    created_on = db.Column(db.DateTime)
+    guid = db.Column(Uuid) #, default = uuid.uuid4)
+
+    def __init__(self):
+        super().__init__()
+
+    @classmethod
+    def from_player(cls, player, guid):
+        _m = 'MTG_Game_Player_Temp.from_player'
+        temp = cls()
+        temp.player_id = player.player_id
+        temp.game_id = player.game_id
+        temp.user_id = player.user_id
+        temp.deck_id = player.deck_id
+        temp.name = player.name
+        temp.notes = player.notes
+        temp.display_order = player.display_order
+        temp.active = player.active
+        temp.created_on = player.created_on
+        temp.guid = guid
+        return temp
+
+
+class Parameters_MTG_Game_Player(Get_Many_Parameters_Base):
+    get_all_game: bool
+    get_inactive_game: bool
+    game_ids: str
+    require_all_id_filters_met: bool
+    require_any_id_filters_met: bool
+
+    @classmethod
+    def get_default(cls, user_id_session):
+        return cls(
+              get_all_game = True
+            , get_inactive_game = False
+            , game_ids = ''
+            , require_all_id_filters_met = True
+            , require_any_id_filters_met = True
+        )
+
+    @classmethod
+    def from_json(cls, json):
+        return cls(
+              get_all_game = json.get('a_get_all_game', False)
+            , get_inactive_game = json.get('a_get_inactive_game', False)
+            , game_ids = json.get('a_game_ids', '')
+            , require_all_id_filters_met = json.get('a_require_all_id_filters_met', True)
+            , require_any_id_filters_met = json.get('a_require_any_id_filters_met', True)
+        )
+
+    def to_json(self):
+        return {
+              'a_get_all_game': self.get_all_game
+            , 'a_get_inactive_game': self.get_inactive_game
+            , 'a_game_ids': self.game_ids
+            , 'a_require_all_id_filters_met': self.require_all_id_filters_met
+            , 'a_require_any_id_filters_met': self.require_any_id_filters_met
+        }
+
+    @staticmethod
+    def get_type_hints():
+        return {
+              'a_get_all_game': Boolean
+            , 'a_get_inactive_game': Boolean
+            , 'a_game_ids': Text
+            , 'a_require_all_id_filters_met': Boolean
+            , 'a_require_any_id_filters_met': Boolean
+        }

business_objects/tcg/mtg_game_round.py

@@ -0,0 +1,176 @@
+"""
+Project:    PARTS Website
+Author:     Edward Middleton-Smith
+            Precision And Research Technology Systems Limited
+
+Technology: Business Objects
+Feature:    MTG Game Round Business Object
+"""
+
+# internal
+from business_objects.base import Base
+from business_objects.db_base import SQLAlchemy_ABC, Get_Many_Parameters_Base
+import lib.argument_validation as av
+from extensions import db
+from helpers.helper_app import Helper_App
+# external
+from dataclasses import dataclass
+from typing import ClassVar
+from sqlalchemy import Uuid
+from sqlalchemy.types import Text, Boolean
+
+
+class MTG_Game_Round(SQLAlchemy_ABC, Base):
+    ATTR_ROUND_ID: ClassVar[str] = 'round_id'
+    ATTR_GAME_ID: ClassVar[str] = 'game_id'
+    FLAG_ROUND: ClassVar[str] = 'round'
+    FLAG_NOTES: ClassVar[str] = 'notes'
+    NAME_ATTR_OPTION_VALUE: ClassVar[str] = ATTR_ROUND_ID
+    NAME_ATTR_OPTION_TEXT: ClassVar[str] = ATTR_ROUND_ID
+
+    __tablename__ = 'tcg_mtg_game_round'
+    __table_args__ = { 'extend_existing': True }
+
+    round_id = db.Column(db.Integer, primary_key=True)
+    game_id = db.Column(db.Integer)
+    notes = db.Column(db.Text)
+    display_order = db.Column(db.Integer)
+    active = db.Column(db.Boolean)
+    created_on = db.Column(db.DateTime)
+    created_by_user_id = db.Column(db.Integer)
+    updated_last_on = db.Column(db.DateTime)
+    updated_last_by_user_id = db.Column(db.Integer)
+    change_set_id = db.Column(db.Integer)
+
+    def __init__(self):
+        self.round_id = 0
+        self.is_new = False
+        super().__init__()
+
+    @classmethod
+    def from_db_mtg_game_round(cls, query_row):
+        _m = f'{cls.__qualname__}.from_db_mtg_game_round'
+        round = cls()
+        round.round_id = query_row[0]
+        round.game_id = query_row[1]
+        round.notes = query_row[2]
+        round.display_order = query_row[3]
+        round.active = av.input_bool(query_row[4], cls.FLAG_ACTIVE, _m)
+        round.created_on = query_row[5]
+        round.created_by_user_id = query_row[6]
+        return round
+
+    @classmethod
+    def from_json(cls, json):
+        _m = f'{cls.__qualname__}.from_json'
+        round = cls()
+        if json is None: return round
+        round.round_id = json.get(cls.ATTR_ROUND_ID, -1)
+        round.game_id = json.get(cls.ATTR_GAME_ID, None)
+        round.notes = json.get(cls.FLAG_NOTES, None)
+        round.display_order = json.get(cls.FLAG_DISPLAY_ORDER, -1)
+        round.active = av.input_bool(json.get(cls.FLAG_ACTIVE, True), cls.FLAG_ACTIVE, _m)
+        round.created_on = json.get(cls.FLAG_CREATED_ON, None)
+        round.created_by_user_id = json.get(Base.ATTR_USER_ID, None)
+        return round
+
+    def to_json(self):
+        as_json = {
+            **self.get_shared_json_attributes(self)
+            , self.ATTR_ROUND_ID: self.round_id
+            , self.ATTR_GAME_ID: self.game_id
+            , self.FLAG_NOTES: self.notes
+            , self.FLAG_DISPLAY_ORDER: self.display_order
+            , self.FLAG_ACTIVE: self.active
+            , self.FLAG_CREATED_ON: self.created_on
+            , Base.ATTR_USER_ID: self.created_by_user_id
+        }
+        return as_json
+
+    def __repr__(self):
+        return f'''
+{self.__class__.__name__}(
+    {self.ATTR_ROUND_ID}: {self.round_id}
+    {self.ATTR_GAME_ID}: {self.game_id}
+    {self.FLAG_NOTES}: {self.notes}
+    {self.FLAG_DISPLAY_ORDER}: {self.display_order}
+    {self.FLAG_ACTIVE}: {self.active}
+    {self.FLAG_CREATED_ON}: {self.created_on}
+    {Base.ATTR_USER_ID}: {self.created_by_user_id}
+)
+            '''
+
+class MTG_Game_Round_Temp(db.Model, Base):
+    __tablename__ = 'tcg_mtg_game_round_temp'
+    __table_args__ = { 'extend_existing': True }
+    temp_id = db.Column(db.Integer, primary_key=True)
+    round_id = db.Column(db.Integer)
+    game_id = db.Column(db.Integer)
+    notes = db.Column(db.Text)
+    display_order = db.Column(db.Integer)
+    active = db.Column(db.Boolean)
+    created_on = db.Column(db.DateTime)
+    guid = db.Column(Uuid)
+
+    def __init__(self):
+        super().__init__()
+
+    @classmethod
+    def from_round(cls, round, guid):
+        _m = 'MTG_Game_Round_Temp.from_round'
+        temp = cls()
+        temp.round_id = round.round_id
+        temp.game_id = round.game_id
+        temp.notes = round.notes
+        temp.display_order = round.display_order
+        temp.active = round.active
+        temp.created_on = round.created_on
+        temp.guid = guid
+        return temp
+
+
+class Parameters_MTG_Game_Round(Get_Many_Parameters_Base):
+    get_all_game: bool
+    get_inactive_game: bool
+    game_ids: str
+    require_all_id_filters_met: bool
+    require_any_id_filters_met: bool
+
+    @classmethod
+    def get_default(cls, user_id_session):
+        return cls(
+              get_all_game = True
+            , get_inactive_game = False
+            , game_ids = ''
+            , require_all_id_filters_met = True
+            , require_any_id_filters_met = True
+        )
+
+    @classmethod
+    def from_json(cls, json):
+        return cls(
+              get_all_game = json.get('a_get_all_game', False)
+            , get_inactive_game = json.get('a_get_inactive_game', False)
+            , game_ids = json.get('a_game_ids', '')
+            , require_all_id_filters_met = json.get('a_require_all_id_filters_met', True)
+            , require_any_id_filters_met = json.get('a_require_any_id_filters_met', True)
+        )
+
+    def to_json(self):
+        return {
+              'a_get_all_game': self.get_all_game
+            , 'a_get_inactive_game': self.get_inactive_game
+            , 'a_game_ids': self.game_ids
+            , 'a_require_all_id_filters_met': self.require_all_id_filters_met
+            , 'a_require_any_id_filters_met': self.require_any_id_filters_met
+        }
+
+    @staticmethod
+    def get_type_hints():
+        return {
+              'a_get_all_game': Boolean
+            , 'a_get_inactive_game': Boolean
+            , 'a_game_ids': Text
+            , 'a_require_all_id_filters_met': Boolean
+            , 'a_require_any_id_filters_met': Boolean
+        }

business_objects/tcg/mtg_game_round_player_damage.py

@@ -0,0 +1,201 @@
+"""
+Project:    PARTS Website
+Author:     Edward Middleton-Smith
+            Precision And Research Technology Systems Limited
+
+Technology: Business Objects
+Feature:    MTG Game Round Player Damage Business Object
+"""
+
+# internal
+from business_objects.base import Base
+from business_objects.db_base import SQLAlchemy_ABC, Get_Many_Parameters_Base
+import lib.argument_validation as av
+from extensions import db
+from helpers.helper_app import Helper_App
+# external
+from dataclasses import dataclass
+from typing import ClassVar
+from sqlalchemy import Uuid
+from sqlalchemy.types import Text, Boolean
+
+
+class MTG_Game_Round_Player_Damage(SQLAlchemy_ABC, Base):
+    ATTR_DAMAGE_ID: ClassVar[str] = 'damage_id'
+    ATTR_PLAYER_ID: ClassVar[str] = 'player_id'
+    ATTR_ROUND_ID: ClassVar[str] = 'round_id'
+    ATTR_RECEIVED_FROM_COMMANDER_PLAYER_ID: ClassVar[str] = 'received_from_commander_player_id'
+    FLAG_COMMANDER_DEATHS: ClassVar[str] = 'commander_deaths'
+    FLAG_DAMAGE: ClassVar[str] = 'damage'
+    FLAG_HEALTH_CHANGE: ClassVar[str] = 'health_change'
+    FLAG_IS_ELIMINATED: ClassVar[str] = 'is_eliminated'
+    NAME_ATTR_OPTION_VALUE: ClassVar[str] = ATTR_DAMAGE_ID
+    NAME_ATTR_OPTION_TEXT: ClassVar[str] = ATTR_DAMAGE_ID
+
+    __tablename__ = 'tcg_mtg_game_round_player_damage'
+    __table_args__ = { 'extend_existing': True }
+
+    damage_id = db.Column(db.Integer, primary_key=True)
+    round_id = db.Column(db.Integer)
+    player_id = db.Column(db.Integer)
+    received_from_commander_player_id = db.Column(db.Integer)
+    health_change = db.Column(db.Integer)
+    commander_deaths = db.Column(db.Integer)
+    is_eliminated = db.Column(db.Boolean)
+    active = db.Column(db.Boolean)
+    created_on = db.Column(db.DateTime)
+    created_by_user_id = db.Column(db.Integer)
+    updated_last_on = db.Column(db.DateTime)
+    updated_last_by_user_id = db.Column(db.Integer)
+    change_set_id = db.Column(db.Integer)
+
+    def __init__(self):
+        self.damage_id = 0
+        self.is_new = False
+        super().__init__()
+
+    @classmethod
+    def from_db_mtg_game_round_player_damage(cls, query_row):
+        _m = f'{cls.__qualname__}.from_db_mtg_game_round_player_damage'
+        damage = cls()
+        damage.damage_id = query_row[0]
+        damage.round_id = query_row[1]
+        damage.player_id = query_row[2]
+        damage.received_from_commander_player_id = query_row[3]
+        damage.health_change = query_row[4]
+        damage.commander_deaths = query_row[5]
+        damage.is_eliminated = av.input_bool(query_row[6], cls.FLAG_IS_ELIMINATED, _m)
+        damage.active = av.input_bool(query_row[7], cls.FLAG_ACTIVE, _m)
+        damage.created_on = query_row[8]
+        damage.created_by_user_id = query_row[9]
+        return damage
+
+    @classmethod
+    def from_json(cls, json):
+        _m = f'{cls.__qualname__}.from_json'
+        damage = cls()
+        if json is None: return damage
+        damage.damage_id = json.get(cls.ATTR_DAMAGE_ID, -1)
+        damage.round_id = json.get(cls.ATTR_ROUND_ID, None)
+        damage.player_id = json.get(cls.ATTR_PLAYER_ID, None)
+        damage.received_from_commander_player_id = json.get(cls.ATTR_RECEIVED_FROM_COMMANDER_PLAYER_ID, None)
+        damage.health_change = json.get(cls.FLAG_HEALTH_CHANGE, 0)
+        damage.commander_deaths = json.get(cls.FLAG_COMMANDER_DEATHS, 0)
+        damage.is_eliminated = json.get(cls.FLAG_IS_ELIMINATED, False)
+        damage.active = av.input_bool(json.get(cls.FLAG_ACTIVE, True), cls.FLAG_ACTIVE, _m)
+        damage.created_on = json.get(cls.FLAG_CREATED_ON, None)
+        damage.created_by_user_id = json.get(Base.ATTR_USER_ID, None)
+        return damage
+
+    def to_json(self):
+        as_json = {
+            **self.get_shared_json_attributes(self)
+            , self.ATTR_DAMAGE_ID: self.damage_id
+            , self.ATTR_ROUND_ID: self.round_id
+            , self.ATTR_PLAYER_ID: self.player_id
+            , self.ATTR_RECEIVED_FROM_COMMANDER_PLAYER_ID: self.received_from_commander_player_id
+            , self.FLAG_HEALTH_CHANGE: self.health_change
+            , self.FLAG_COMMANDER_DEATHS: self.commander_deaths
+            , self.FLAG_IS_ELIMINATED: self.is_eliminated
+            , self.FLAG_ACTIVE: self.active
+            , self.FLAG_CREATED_ON: self.created_on
+            , Base.ATTR_USER_ID: self.created_by_user_id
+        }
+        return as_json
+
+    def __repr__(self):
+        return f'''
+{self.__class__.__name__}(
+    {self.ATTR_DAMAGE_ID}: {self.damage_id}
+    {self.ATTR_ROUND_ID}: {self.round_id}
+    {self.ATTR_PLAYER_ID}: {self.player_id}
+    {self.ATTR_RECEIVED_FROM_COMMANDER_PLAYER_ID}: {self.received_from_commander_player_id}
+    {self.FLAG_HEALTH_CHANGE}: {self.health_change}
+    {self.FLAG_COMMANDER_DEATHS}: {self.commander_deaths}
+    {self.FLAG_IS_ELIMINATED}: {self.is_eliminated}
+    {self.FLAG_ACTIVE}: {self.active}
+    {self.FLAG_CREATED_ON}: {self.created_on}
+    {Base.ATTR_USER_ID}: {self.created_by_user_id}
+)
+            '''
+
+class MTG_Game_Round_Player_Damage_Temp(db.Model, Base):
+    __tablename__ = 'tcg_mtg_game_round_player_damage_temp'
+    __table_args__ = { 'extend_existing': True }
+    temp_id = db.Column(db.Integer, primary_key=True)
+    damage_id = db.Column(db.Integer)
+    round_id = db.Column(db.Integer)
+    player_id = db.Column(db.Integer)
+    received_from_commander_player_id = db.Column(db.Integer)
+    health_change = db.Column(db.Integer)
+    commander_deaths = db.Column(db.Integer)
+    is_eliminated = db.Column(db.Boolean)
+    active = db.Column(db.Boolean)
+    created_on = db.Column(db.DateTime)
+    guid = db.Column(Uuid)
+
+    def __init__(self):
+        super().__init__()
+
+    @classmethod
+    def from_damage(cls, damage, guid):
+        _m = 'MTG_Game_Round_Player_Damage_Temp.from_damage'
+        temp = cls()
+        temp.damage_id = damage.damage_id
+        temp.round_id = damage.round_id
+        temp.player_id = damage.player_id
+        temp.received_from_commander_player_id = damage.received_from_commander_player_id
+        temp.health_change = damage.health_change
+        temp.commander_deaths = damage.commander_deaths
+        temp.is_eliminated = damage.is_eliminated
+        temp.active = damage.active
+        temp.created_on = damage.created_on
+        temp.guid = guid
+        return temp
+
+
+class Parameters_MTG_Game_Round_Player_Damage(Get_Many_Parameters_Base):
+    get_all_game: bool
+    get_inactive_game: bool
+    game_ids: str
+    require_all_id_filters_met: bool
+    require_any_id_filters_met: bool
+
+    @classmethod
+    def get_default(cls, user_id_session):
+        return cls(
+              get_all_game = True
+            , get_inactive_game = False
+            , game_ids = ''
+            , require_all_id_filters_met = True
+            , require_any_id_filters_met = True
+        )
+
+    @classmethod
+    def from_json(cls, json):
+        return cls(
+              get_all_game = json.get('a_get_all_game', False)
+            , get_inactive_game = json.get('a_get_inactive_game', False)
+            , game_ids = json.get('a_game_ids', '')
+            , require_all_id_filters_met = json.get('a_require_all_id_filters_met', True)
+            , require_any_id_filters_met = json.get('a_require_any_id_filters_met', True)
+        )
+
+    def to_json(self):
+        return {
+              'a_get_all_game': self.get_all_game
+            , 'a_get_inactive_game': self.get_inactive_game
+            , 'a_game_ids': self.game_ids
+            , 'a_require_all_id_filters_met': self.require_all_id_filters_met
+            , 'a_require_any_id_filters_met': self.require_any_id_filters_met
+        }
+
+    @staticmethod
+    def get_type_hints():
+        return {
+              'a_get_all_game': Boolean
+            , 'a_get_inactive_game': Boolean
+            , 'a_game_ids': Text
+            , 'a_require_all_id_filters_met': Boolean
+            , 'a_require_any_id_filters_met': Boolean
+        }

business_objects/tcg/user.py

@@ -0,0 +1,229 @@
+"""
+Project:    PARTS Website
+Author:     Edward Middleton-Smith
+            Precision And Research Technology Systems Limited
+
+Technology: Business Objects
+Feature:    User Business Object
+"""
+
+# internal
+from business_objects.base import Base
+from business_objects.db_base import SQLAlchemy_ABC, Get_Many_Parameters_Base
+import lib.argument_validation as av
+from extensions import db
+from mtg_commander_life_tracker.forms.tcg.user import Filters_User
+from helpers.helper_app import Helper_App
+# external
+from dataclasses import dataclass
+from typing import ClassVar, Optional
+from sqlalchemy.types import Text, Boolean
+
+
+class User(SQLAlchemy_ABC, Base):
+    ATTR_USER_AUTH0_ID: ClassVar[str] = 'user_auth0_id'
+    FLAG_IS_EMAIL_VERIFIED: ClassVar[str] = 'is_email_verified'
+    FLAG_IS_SUPER_USER: ClassVar[str] = 'is_super_user'
+    FLAG_PRIORITY_ACCESS_LEVEL: ClassVar[str] = 'priority_access_level'
+    NAME_ATTR_OPTION_TEXT: ClassVar[str] = Base.FLAG_NAME
+    NAME_ATTR_OPTION_VALUE: ClassVar[str] = Base.ATTR_USER_ID
+
+    __tablename__ = 'tcg_user'
+    __table_args__ = { 'extend_existing': True }
+
+    user_id = db.Column(db.Integer, primary_key=True)
+    user_auth0_id = db.Column(db.String(250))
+    firstname = db.Column(db.Text)
+    surname = db.Column(db.Text)
+    email = db.Column(db.String(256))
+    is_email_verified = db.Column(db.Boolean)
+    is_super_user = db.Column(db.Boolean)
+    priority_access_level = db.Column(db.Integer)
+    is_new = db.Column(db.Boolean)
+    active = db.Column(db.Boolean)
+    
+    def __init__(self):
+        self.user_id = 0
+        self.is_new = False
+        super().__init__()
+    
+    @classmethod
+    def from_db_user(cls, query_row):
+        """Map from PostgreSQL FN_TCG_User_Get_Many result columns:
+        user_id, user_auth0_id, firstname, surname, email, is_email_verified,
+        is_super_user, active, created_on, created_by_user_id, updated_last_on,
+        updated_last_by_user_id, change_set_id
+        """
+        _m = f'{cls.__qualname__}.from_db_user'
+        Helper_App.console_log(f'user record: {query_row}')
+        user = cls()
+        user.user_id = query_row[0]
+        user.user_auth0_id = query_row[1]
+        user.firstname = query_row[2]
+        user.surname = query_row[3]
+        user.email = query_row[4]
+        user.is_email_verified = av.input_bool(query_row[5], cls.FLAG_IS_EMAIL_VERIFIED, _m)
+        user.is_super_user = av.input_bool(query_row[6], cls.FLAG_IS_SUPER_USER, _m)
+        user.active = av.input_bool(query_row[7], 'active', _m)
+        return user
+        
+    @classmethod
+    def from_json(cls, json):
+        _m = f'{cls.__qualname__}.from_json'
+        user = cls()
+        if json is None: return user
+        Helper_App.console_log(f'{_m}/n{json}')
+        user.user_id = json[cls.ATTR_USER_ID]
+        user.user_auth0_id = json[cls.ATTR_USER_AUTH0_ID]
+        user.firstname = json[cls.FLAG_FIRSTNAME]
+        user.surname = json[cls.FLAG_SURNAME]
+        user.email = json[cls.FLAG_EMAIL]
+        user.is_email_verified = av.input_bool(json[cls.FLAG_IS_EMAIL_VERIFIED], cls.FLAG_IS_EMAIL_VERIFIED, _m)
+        user.is_super_user = av.input_bool(json[cls.FLAG_IS_SUPER_USER], cls.FLAG_IS_SUPER_USER, _m)
+        return user
+    
+    @classmethod
+    def from_json_auth0(cls, json):
+        _m = f'{cls.__qualname__}.from_json_auth0'
+        Helper_App.console_log(_m)
+        Helper_App.console_log(f'JSON: {json}')
+        user = cls()
+        if json is None: return user
+        user_info = json['userinfo']
+        Helper_App.console_log(f'user_info: {user_info}')
+        user.user_id = None
+        user.user_auth0_id = user_info['sub']
+        user.firstname = None
+        user.surname = None
+        user.email = user_info[cls.FLAG_EMAIL]
+        user.is_email_verified = av.input_bool(user_info['email_verified'], cls.FLAG_IS_EMAIL_VERIFIED, _m)
+        user.is_super_user = None
+        return user
+    
+    def to_json(self):
+        as_json = {
+            **self.get_shared_json_attributes(self)
+            , self.ATTR_USER_ID: self.user_id
+            , self.ATTR_USER_AUTH0_ID: self.user_auth0_id
+            , self.FLAG_FIRSTNAME: self.firstname
+            , self.FLAG_SURNAME: self.surname
+            , self.FLAG_NAME: self.get_name()
+            , self.FLAG_EMAIL: self.email
+            , self.FLAG_IS_EMAIL_VERIFIED: self.is_email_verified
+            , self.FLAG_IS_SUPER_USER: self.is_super_user
+            , self.FLAG_PRIORITY_ACCESS_LEVEL: self.priority_access_level
+        }
+        return as_json
+        
+    def __repr__(self):
+        return f'''
+User (
+      {self.ATTR_USER_ID}: {self.user_id}
+    , {self.ATTR_USER_AUTH0_ID}: {self.user_auth0_id}
+    , {self.FLAG_FIRSTNAME}: {self.firstname}
+    , {self.FLAG_SURNAME}: {self.surname}
+    , {self.FLAG_NAME}: {self.get_name()}
+    , {self.FLAG_EMAIL}: {self.email}
+    , {self.FLAG_IS_EMAIL_VERIFIED}: {self.is_email_verified}
+    , {self.FLAG_IS_SUPER_USER}: {self.is_super_user}
+    , {self.FLAG_PRIORITY_ACCESS_LEVEL}: {self.priority_access_level}
+)           '''
+    
+    def get_is_logged_in(self):
+        return (self.user_id is not None and self.user_id > 0 and self.user_id != Base.USER_ID_GUEST)
+    
+    def get_name(self):
+        return f'{"" if self.firstname is None else self.firstname} {"" if self.surname is None else self.surname}'
+
+
+
+class Parameters_User(Get_Many_Parameters_Base):
+    # user_id: Optional[int]
+    # auth0_user_id: str
+    get_all_user: bool
+    get_inactive_user: bool
+    user_ids: str
+    """
+    user_auth0_ids: str
+    names_user: str
+    emails_user: str
+    """
+    require_all_id_filters_met: bool
+    require_any_id_filters_met: bool
+    # require_all_non_id_filters_met: bool
+    # require_any_non_id_filters_met: bool
+
+
+    @classmethod
+    def from_form_filters_user(cls, form):
+        _m = f'{cls.__qualname__}.from_form_filters_user'
+        av.val_instance(form, 'form', _m, Filters_User)
+        get_inactive = not av.input_bool(form.active_only.data, "active", _m)
+        # user_id = '' if form.user_id.data is None else form.user_id.data
+        filters = cls.get_default()
+        filters.get_all_user = True # (user_id == '')
+        filters.get_inactive_user = get_inactive
+        filters.user_ids = '' # user_id
+        # filters.user_auth0_ids = ''
+        filters.require_all_id_filters_met = True
+        filters.require_any_id_filters_met = True
+        # filters.require_all_non_id_filters_met = False
+        # filters.require_any_non_id_filters_met = True
+        return filters
+    
+    @classmethod
+    def from_user(cls, user):
+        av.val_instance(user, 'user', 'Parameters_User.from_user', User)
+        filters = cls.get_default()
+        filters.get_all_user = ((user.user_id is None or user.user_id == 0) and user.user_auth0_id is None)
+        filters.get_inactive_user = False
+        filters.user_ids = '' if user.user_id is None else str(user.user_id)
+        # filters.user_auth0_ids = user.user_auth0_id
+        # filters.names_user = user.get_name()
+        # filters.emails_user = user.email
+        return filters
+    
+    @classmethod
+    def get_default(cls):
+        return cls(
+              # user_id = None
+            # , auth0_user_id = ''
+              get_all_user = False
+            , get_inactive_user = False
+            , user_ids = ''
+            # , user_auth0_ids = ''
+            # , names_user = ''
+            # , emails_user = ''
+            , require_all_id_filters_met = True
+            , require_any_id_filters_met = True
+            # , require_all_non_id_filters_met = False
+            # , require_any_non_id_filters_met = True
+        )
+    
+    @classmethod
+    def from_json(self):
+        pass
+    def to_json(self):
+        return {
+            # 'a_user_id': self.user_id
+            # , 'a_auth0_user_id': self.auth0_user_id
+              'a_get_all_user': self.get_all_user
+            , 'a_get_inactive_user': self.get_inactive_user
+            , 'a_user_ids': self.user_ids
+            # , 'a_user_auth0_ids': self.user_auth0_ids
+            # , 'a_names_user': self.names_user
+            # , 'a_emails_user': self.emails_user
+            , 'a_require_all_id_filters_met': self.require_all_id_filters_met
+            , 'a_require_any_id_filters_met': self.require_any_id_filters_met
+            # , 'a_require_all_non_id_filters_met': self.require_all_non_id_filters_met
+            # , 'a_require_any_non_id_filters_met': self.require_any_non_id_filters_met
+        }
+    @staticmethod
+    def get_type_hints():
+        return {
+              'a_get_all_user': Boolean
+            , 'a_get_inactive_user': Boolean
+            , 'a_user_ids': Text
+            , 'a_require_all_id_filters_met': Boolean
+            , 'a_require_any_id_filters_met': Boolean
+        }