2018-09-30 17:40:28 +00:00
|
|
|
|
import pathlib
|
2018-04-27 17:16:43 +00:00
|
|
|
|
from contextlib import suppress
|
2019-05-03 12:31:49 +00:00
|
|
|
|
from fractions import Fraction
|
2018-08-03 16:15:08 +00:00
|
|
|
|
from itertools import chain
|
2018-05-13 13:13:12 +00:00
|
|
|
|
from operator import attrgetter
|
2018-10-03 12:51:22 +00:00
|
|
|
|
from typing import Dict, List, Set
|
2018-04-27 17:16:43 +00:00
|
|
|
|
|
2018-10-05 15:13:23 +00:00
|
|
|
|
from boltons import urlutils
|
2018-09-30 17:40:28 +00:00
|
|
|
|
from citext import CIText
|
2019-02-07 12:47:42 +00:00
|
|
|
|
from ereuse_utils.naming import HID_CONVERSION_DOC, Naming
|
2020-08-17 14:45:18 +00:00
|
|
|
|
from flask import g
|
2018-11-09 10:22:13 +00:00
|
|
|
|
from more_itertools import unique_everseen
|
2018-08-03 16:15:08 +00:00
|
|
|
|
from sqlalchemy import BigInteger, Boolean, Column, Enum as DBEnum, Float, ForeignKey, Integer, \
|
2018-10-08 15:32:45 +00:00
|
|
|
|
Sequence, SmallInteger, Unicode, inspect, text
|
2020-08-17 14:45:18 +00:00
|
|
|
|
from sqlalchemy.dialects.postgresql import UUID
|
2018-04-10 15:06:39 +00:00
|
|
|
|
from sqlalchemy.ext.declarative import declared_attr
|
2019-05-03 12:31:49 +00:00
|
|
|
|
from sqlalchemy.ext.hybrid import hybrid_property
|
2018-06-26 13:36:21 +00:00
|
|
|
|
from sqlalchemy.orm import ColumnProperty, backref, relationship, validates
|
2018-05-30 10:49:40 +00:00
|
|
|
|
from sqlalchemy.util import OrderedSet
|
2018-06-10 16:47:49 +00:00
|
|
|
|
from sqlalchemy_utils import ColorType
|
2018-06-26 13:36:21 +00:00
|
|
|
|
from stdnum import imei, meid
|
2018-11-11 20:52:55 +00:00
|
|
|
|
from teal.db import CASCADE_DEL, POLYMORPHIC_ID, POLYMORPHIC_ON, ResourceNotFound, URL, \
|
2019-12-17 22:57:55 +00:00
|
|
|
|
check_lower, check_range, IntEnum
|
2018-10-23 13:37:37 +00:00
|
|
|
|
from teal.enums import Layouts
|
2018-09-07 10:38:02 +00:00
|
|
|
|
from teal.marshmallow import ValidationError
|
2018-10-05 15:13:23 +00:00
|
|
|
|
from teal.resource import url_for_resource
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
2018-09-30 17:40:28 +00:00
|
|
|
|
from ereuse_devicehub.db import db
|
2019-07-01 18:39:32 +00:00
|
|
|
|
from ereuse_devicehub.resources.enums import BatteryTechnology, CameraFacing, ComputerChassis, \
|
2019-12-17 22:57:55 +00:00
|
|
|
|
DataStorageInterface, DisplayTech, PrinterTechnology, RamFormat, RamInterface, Severity, TransferState
|
2020-10-27 20:29:38 +00:00
|
|
|
|
from ereuse_devicehub.resources.models import STR_SM_SIZE, Thing, listener_reset_field_updated_in_actual_time
|
2019-12-11 01:19:13 +00:00
|
|
|
|
from ereuse_devicehub.resources.user.models import User
|
2018-07-02 10:52:54 +00:00
|
|
|
|
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
2020-10-30 20:08:55 +00:00
|
|
|
|
|
2018-04-10 15:06:39 +00:00
|
|
|
|
class Device(Thing):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""Base class for any type of physical object that can be identified.
|
|
|
|
|
|
|
|
|
|
Device partly extends `Schema's IndividualProduct <https
|
|
|
|
|
://schema.org/IndividualProduct>`_, adapting it to our
|
|
|
|
|
use case.
|
|
|
|
|
|
|
|
|
|
A device requires an identification method, ideally a serial number,
|
|
|
|
|
although it can be identified only with tags too. More ideally
|
|
|
|
|
both methods are used.
|
|
|
|
|
|
|
|
|
|
Devices can contain ``Components``, which are just a type of device
|
|
|
|
|
(it is a recursive relationship).
|
2018-06-24 14:57:49 +00:00
|
|
|
|
"""
|
2018-06-10 16:47:49 +00:00
|
|
|
|
id = Column(BigInteger, Sequence('device_seq'), primary_key=True)
|
2019-06-19 11:35:26 +00:00
|
|
|
|
id.comment = """The identifier of the device for this database. Used only
|
|
|
|
|
internally for software; users should not use this.
|
2018-06-20 21:18:15 +00:00
|
|
|
|
"""
|
2019-02-07 12:47:42 +00:00
|
|
|
|
type = Column(Unicode(STR_SM_SIZE), nullable=False)
|
2020-03-25 15:47:57 +00:00
|
|
|
|
hid = Column(Unicode(), check_lower('hid'), unique=False)
|
2020-07-07 15:17:19 +00:00
|
|
|
|
hid.comment = """The Hardware ID (HID) is the ID traceability
|
2019-06-19 11:35:26 +00:00
|
|
|
|
systems use to ID a device globally. This field is auto-generated
|
|
|
|
|
from Devicehub using literal identifiers from the device,
|
2020-04-01 17:11:14 +00:00
|
|
|
|
so it can re-generated *offline*.
|
2019-02-05 16:59:15 +00:00
|
|
|
|
""" + HID_CONVERSION_DOC
|
2020-03-25 15:47:57 +00:00
|
|
|
|
model = Column(Unicode(), check_lower('model'))
|
2019-05-03 12:31:49 +00:00
|
|
|
|
model.comment = """The model of the device in lower case.
|
2020-04-01 17:11:14 +00:00
|
|
|
|
|
2019-05-03 12:31:49 +00:00
|
|
|
|
The model is the unambiguous, as technical as possible, denomination
|
2020-04-01 17:11:14 +00:00
|
|
|
|
for the product. This field, among others, is used to identify
|
2019-05-03 12:31:49 +00:00
|
|
|
|
the product.
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""
|
2018-09-30 10:29:33 +00:00
|
|
|
|
manufacturer = Column(Unicode(), check_lower('manufacturer'))
|
2019-05-03 12:31:49 +00:00
|
|
|
|
manufacturer.comment = """The normalized name of the manufacturer,
|
2019-02-03 16:12:53 +00:00
|
|
|
|
in lower case.
|
2020-04-01 17:11:14 +00:00
|
|
|
|
|
2019-02-03 16:12:53 +00:00
|
|
|
|
Although as of now Devicehub does not enforce normalization,
|
|
|
|
|
users can choose a list of normalized manufacturer names
|
|
|
|
|
from the own ``/manufacturers`` REST endpoint.
|
|
|
|
|
"""
|
2018-09-30 10:29:33 +00:00
|
|
|
|
serial_number = Column(Unicode(), check_lower('serial_number'))
|
2019-02-03 16:12:53 +00:00
|
|
|
|
serial_number.comment = """The serial number of the device in lower case."""
|
2019-05-03 12:31:49 +00:00
|
|
|
|
brand = db.Column(CIText())
|
|
|
|
|
brand.comment = """A naming for consumers. This field can represent
|
2020-04-01 17:11:14 +00:00
|
|
|
|
several models, so it can be ambiguous, and it is not used to
|
2019-05-03 12:31:49 +00:00
|
|
|
|
identify the product.
|
|
|
|
|
"""
|
|
|
|
|
generation = db.Column(db.SmallInteger, check_range('generation', 0))
|
|
|
|
|
generation.comment = """The generation of the device."""
|
2019-07-01 09:30:48 +00:00
|
|
|
|
version = db.Column(db.CIText())
|
2019-07-07 19:36:09 +00:00
|
|
|
|
version.comment = """The version code of this device, like v1 or A001."""
|
|
|
|
|
weight = Column(Float(decimal_return_scale=4), check_range('weight', 0.1, 5))
|
|
|
|
|
weight.comment = """The weight of the device in Kg."""
|
|
|
|
|
width = Column(Float(decimal_return_scale=4), check_range('width', 0.1, 5))
|
2019-06-19 11:35:26 +00:00
|
|
|
|
width.comment = """The width of the device in meters."""
|
2019-07-07 19:36:09 +00:00
|
|
|
|
height = Column(Float(decimal_return_scale=4), check_range('height', 0.1, 5))
|
2019-06-19 11:35:26 +00:00
|
|
|
|
height.comment = """The height of the device in meters."""
|
2019-07-07 19:36:09 +00:00
|
|
|
|
depth = Column(Float(decimal_return_scale=4), check_range('depth', 0.1, 5))
|
2019-06-19 11:35:26 +00:00
|
|
|
|
depth.comment = """The depth of the device in meters."""
|
2018-06-10 16:47:49 +00:00
|
|
|
|
color = Column(ColorType)
|
2018-10-05 15:13:23 +00:00
|
|
|
|
color.comment = """The predominant color of the device."""
|
2019-05-03 12:31:49 +00:00
|
|
|
|
production_date = Column(db.DateTime)
|
2020-04-01 17:11:14 +00:00
|
|
|
|
production_date.comment = """The date of production of the device.
|
2019-12-09 16:24:24 +00:00
|
|
|
|
This is timezone naive, as Workbench cannot report this data with timezone information.
|
2019-05-03 12:31:49 +00:00
|
|
|
|
"""
|
2019-07-01 09:30:48 +00:00
|
|
|
|
variant = Column(db.CIText())
|
2019-05-03 12:31:49 +00:00
|
|
|
|
variant.comment = """A variant or sub-model of the device."""
|
2019-07-01 09:30:48 +00:00
|
|
|
|
sku = db.Column(db.CIText())
|
2020-04-01 17:11:14 +00:00
|
|
|
|
sku.comment = """The Stock Keeping Unit (SKU), i.e. a
|
2019-06-29 14:26:14 +00:00
|
|
|
|
merchant-specific identifier for a product or service.
|
|
|
|
|
"""
|
2019-07-07 19:36:09 +00:00
|
|
|
|
image = db.Column(db.URL)
|
|
|
|
|
image.comment = "An image of the device."
|
2018-10-23 13:37:37 +00:00
|
|
|
|
|
2020-10-30 20:08:55 +00:00
|
|
|
|
owner_id = db.Column(UUID(as_uuid=True),
|
|
|
|
|
db.ForeignKey(User.id),
|
|
|
|
|
nullable=False,
|
|
|
|
|
default=lambda: g.user.id)
|
|
|
|
|
owner = db.relationship(User, primaryjoin=owner_id == User.id)
|
2020-11-22 17:47:58 +00:00
|
|
|
|
allocated = db.Column(Boolean, default=False)
|
2020-12-01 14:55:21 +00:00
|
|
|
|
allocated.comment = "device is allocated or not."
|
2020-10-30 20:08:55 +00:00
|
|
|
|
|
2018-10-23 13:37:37 +00:00
|
|
|
|
_NON_PHYSICAL_PROPS = {
|
|
|
|
|
'id',
|
|
|
|
|
'type',
|
|
|
|
|
'created',
|
|
|
|
|
'updated',
|
|
|
|
|
'parent_id',
|
2020-11-03 19:26:03 +00:00
|
|
|
|
'owner_id',
|
2018-10-23 13:37:37 +00:00
|
|
|
|
'hid',
|
|
|
|
|
'production_date',
|
2018-11-17 19:21:11 +00:00
|
|
|
|
'color', # these are only user-input thus volatile
|
|
|
|
|
'width',
|
|
|
|
|
'height',
|
|
|
|
|
'depth',
|
2019-05-03 12:31:49 +00:00
|
|
|
|
'weight',
|
|
|
|
|
'brand',
|
|
|
|
|
'generation',
|
|
|
|
|
'production_date',
|
2019-06-29 14:26:14 +00:00
|
|
|
|
'variant',
|
|
|
|
|
'version',
|
2019-07-07 19:36:09 +00:00
|
|
|
|
'sku',
|
2020-11-22 17:47:58 +00:00
|
|
|
|
'image',
|
|
|
|
|
'allocated'
|
2018-10-23 13:37:37 +00:00
|
|
|
|
}
|
2018-04-27 17:16:43 +00:00
|
|
|
|
|
2019-02-07 12:47:42 +00:00
|
|
|
|
__table_args__ = (
|
|
|
|
|
db.Index('device_id', id, postgresql_using='hash'),
|
|
|
|
|
db.Index('type_index', type, postgresql_using='hash')
|
|
|
|
|
)
|
|
|
|
|
|
2018-11-09 10:22:13 +00:00
|
|
|
|
def __init__(self, **kw) -> None:
|
|
|
|
|
super().__init__(**kw)
|
|
|
|
|
with suppress(TypeError):
|
2019-01-02 16:52:43 +00:00
|
|
|
|
self.hid = Naming.hid(self.type, self.manufacturer, self.model, self.serial_number)
|
2018-11-09 10:22:13 +00:00
|
|
|
|
|
2018-05-13 13:13:12 +00:00
|
|
|
|
@property
|
2019-05-11 14:27:22 +00:00
|
|
|
|
def actions(self) -> list:
|
2019-06-19 11:35:26 +00:00
|
|
|
|
"""All the actions where the device participated, including:
|
2019-02-03 16:12:53 +00:00
|
|
|
|
|
2019-05-11 14:27:22 +00:00
|
|
|
|
1. Actions performed directly to the device.
|
|
|
|
|
2. Actions performed to a component.
|
|
|
|
|
3. Actions performed to a parent device.
|
2018-06-24 14:57:49 +00:00
|
|
|
|
|
2019-05-11 14:27:22 +00:00
|
|
|
|
Actions are returned by descending ``created`` time.
|
2018-06-10 16:47:49 +00:00
|
|
|
|
"""
|
2020-11-27 17:10:51 +00:00
|
|
|
|
return sorted(chain(self.actions_multiple, self.actions_one), key=lambda x: x.created)
|
2018-05-13 13:13:12 +00:00
|
|
|
|
|
2018-11-09 10:22:13 +00:00
|
|
|
|
@property
|
|
|
|
|
def problems(self):
|
2019-05-11 14:27:22 +00:00
|
|
|
|
"""Current actions with severity.Warning or higher.
|
2018-11-09 10:22:13 +00:00
|
|
|
|
|
2019-05-11 14:27:22 +00:00
|
|
|
|
There can be up to 3 actions: current Snapshot,
|
|
|
|
|
current Physical action, current Trading action.
|
2018-11-09 10:22:13 +00:00
|
|
|
|
"""
|
|
|
|
|
from ereuse_devicehub.resources.device import states
|
2019-05-11 14:27:22 +00:00
|
|
|
|
from ereuse_devicehub.resources.action.models import Snapshot
|
|
|
|
|
actions = set()
|
2018-11-09 10:22:13 +00:00
|
|
|
|
with suppress(LookupError, ValueError):
|
2019-05-11 14:27:22 +00:00
|
|
|
|
actions.add(self.last_action_of(Snapshot))
|
2018-11-09 10:22:13 +00:00
|
|
|
|
with suppress(LookupError, ValueError):
|
2019-05-11 14:27:22 +00:00
|
|
|
|
actions.add(self.last_action_of(*states.Physical.actions()))
|
2018-11-09 10:22:13 +00:00
|
|
|
|
with suppress(LookupError, ValueError):
|
2019-05-11 14:27:22 +00:00
|
|
|
|
actions.add(self.last_action_of(*states.Trading.actions()))
|
|
|
|
|
return self._warning_actions(actions)
|
2018-04-30 17:58:19 +00:00
|
|
|
|
|
2018-04-27 17:16:43 +00:00
|
|
|
|
@property
|
2018-04-30 17:58:19 +00:00
|
|
|
|
def physical_properties(self) -> Dict[str, object or None]:
|
2019-06-19 11:35:26 +00:00
|
|
|
|
"""Fields that describe the physical properties of a device.
|
2018-04-27 17:16:43 +00:00
|
|
|
|
|
2019-07-07 19:36:09 +00:00
|
|
|
|
:return A dictionary:
|
2018-04-27 17:16:43 +00:00
|
|
|
|
- Column.
|
|
|
|
|
- Actual value of the column or None.
|
|
|
|
|
"""
|
|
|
|
|
# todo ensure to remove materialized values when start using them
|
|
|
|
|
# todo or self.__table__.columns if inspect fails
|
2018-04-30 17:58:19 +00:00
|
|
|
|
return {c.key: getattr(self, c.key, None)
|
2018-04-27 17:16:43 +00:00
|
|
|
|
for c in inspect(self.__class__).attrs
|
2018-04-30 17:58:19 +00:00
|
|
|
|
if isinstance(c, ColumnProperty)
|
|
|
|
|
and not getattr(c, 'foreign_keys', None)
|
2018-10-23 13:37:37 +00:00
|
|
|
|
and c.key not in self._NON_PHYSICAL_PROPS}
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
2018-10-05 15:13:23 +00:00
|
|
|
|
@property
|
|
|
|
|
def url(self) -> urlutils.URL:
|
|
|
|
|
"""The URL where to GET this device."""
|
|
|
|
|
return urlutils.URL(url_for_resource(Device, item_id=self.id))
|
|
|
|
|
|
2018-10-13 12:53:46 +00:00
|
|
|
|
@property
|
|
|
|
|
def rate(self):
|
2019-04-23 19:27:31 +00:00
|
|
|
|
"""The last Rate of the device."""
|
2018-10-13 12:53:46 +00:00
|
|
|
|
with suppress(LookupError, ValueError):
|
2019-05-11 14:27:22 +00:00
|
|
|
|
from ereuse_devicehub.resources.action.models import Rate
|
|
|
|
|
return self.last_action_of(Rate)
|
2018-10-13 12:53:46 +00:00
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def price(self):
|
2018-10-14 18:10:52 +00:00
|
|
|
|
"""The actual Price of the device, or None if no price has
|
|
|
|
|
ever been set."""
|
2018-10-13 12:53:46 +00:00
|
|
|
|
with suppress(LookupError, ValueError):
|
2019-05-11 14:27:22 +00:00
|
|
|
|
from ereuse_devicehub.resources.action.models import Price
|
|
|
|
|
return self.last_action_of(Price)
|
2018-10-13 12:53:46 +00:00
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def trading(self):
|
2019-05-11 14:27:22 +00:00
|
|
|
|
"""The actual trading state, or None if no Trade action has
|
2018-10-14 18:10:52 +00:00
|
|
|
|
ever been performed to this device."""
|
2018-10-13 12:53:46 +00:00
|
|
|
|
from ereuse_devicehub.resources.device import states
|
|
|
|
|
with suppress(LookupError, ValueError):
|
2019-05-11 14:27:22 +00:00
|
|
|
|
action = self.last_action_of(*states.Trading.actions())
|
|
|
|
|
return states.Trading(action.__class__)
|
2018-10-13 12:53:46 +00:00
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def physical(self):
|
2018-10-14 18:10:52 +00:00
|
|
|
|
"""The actual physical state, None otherwise."""
|
2018-10-13 12:53:46 +00:00
|
|
|
|
from ereuse_devicehub.resources.device import states
|
|
|
|
|
with suppress(LookupError, ValueError):
|
2019-05-11 14:27:22 +00:00
|
|
|
|
action = self.last_action_of(*states.Physical.actions())
|
|
|
|
|
return states.Physical(action.__class__)
|
2018-10-13 12:53:46 +00:00
|
|
|
|
|
2020-11-19 14:25:56 +00:00
|
|
|
|
@property
|
|
|
|
|
def traking(self):
|
|
|
|
|
"""The actual traking state, None otherwise."""
|
|
|
|
|
from ereuse_devicehub.resources.device import states
|
|
|
|
|
with suppress(LookupError, ValueError):
|
|
|
|
|
action = self.last_action_of(*states.Traking.actions())
|
|
|
|
|
return states.Traking(action.__class__)
|
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def usage(self):
|
|
|
|
|
"""The actual usage state, None otherwise."""
|
|
|
|
|
from ereuse_devicehub.resources.device import states
|
|
|
|
|
with suppress(LookupError, ValueError):
|
|
|
|
|
action = self.last_action_of(*states.Usage.actions())
|
|
|
|
|
return states.Usage(action.__class__)
|
|
|
|
|
|
2018-10-13 12:53:46 +00:00
|
|
|
|
@property
|
|
|
|
|
def physical_possessor(self):
|
|
|
|
|
"""The actual physical possessor or None.
|
|
|
|
|
|
|
|
|
|
The physical possessor is the Agent that has physically
|
|
|
|
|
the device. It differs from legal owners, usufructuarees
|
|
|
|
|
or reserves in that the physical possessor does not have
|
|
|
|
|
a legal relation per se with the device, but it is the one
|
|
|
|
|
that has it physically. As an example, a transporter could
|
|
|
|
|
be a physical possessor of a device although it does not
|
|
|
|
|
own it legally.
|
2018-11-12 17:15:24 +00:00
|
|
|
|
|
|
|
|
|
Note that there can only be one physical possessor per device,
|
2019-05-11 14:27:22 +00:00
|
|
|
|
and :class:`ereuse_devicehub.resources.action.models.Receive`
|
2018-11-12 17:15:24 +00:00
|
|
|
|
changes it.
|
2018-10-13 12:53:46 +00:00
|
|
|
|
"""
|
2020-11-23 10:43:30 +00:00
|
|
|
|
pass
|
|
|
|
|
# TODO @cayop uncomment this lines for link the possessor with the device
|
|
|
|
|
# from ereuse_devicehub.resources.action.models import Receive
|
|
|
|
|
# with suppress(LookupError):
|
|
|
|
|
# action = self.last_action_of(Receive)
|
|
|
|
|
# return action.agent_to
|
2018-10-13 12:53:46 +00:00
|
|
|
|
|
2018-11-09 10:22:13 +00:00
|
|
|
|
@property
|
|
|
|
|
def working(self):
|
|
|
|
|
"""A list of the current tests with warning or errors. A
|
|
|
|
|
device is working if the list is empty.
|
|
|
|
|
|
|
|
|
|
This property returns, for the last test performed of each type,
|
2019-02-03 16:12:53 +00:00
|
|
|
|
the one with the worst ``severity`` of them, or ``None`` if no
|
2018-11-09 10:22:13 +00:00
|
|
|
|
test has been executed.
|
|
|
|
|
"""
|
2019-05-11 14:27:22 +00:00
|
|
|
|
from ereuse_devicehub.resources.action.models import Test
|
|
|
|
|
current_tests = unique_everseen((e for e in reversed(self.actions) if isinstance(e, Test)),
|
2018-11-09 10:22:13 +00:00
|
|
|
|
key=attrgetter('type')) # last test of each type
|
2019-05-11 14:27:22 +00:00
|
|
|
|
return self._warning_actions(current_tests)
|
2018-11-09 10:22:13 +00:00
|
|
|
|
|
2018-04-10 15:06:39 +00:00
|
|
|
|
@declared_attr
|
|
|
|
|
def __mapper_args__(cls):
|
2019-06-19 11:35:26 +00:00
|
|
|
|
"""Defines inheritance.
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
|
|
|
|
From `the guide <http://docs.sqlalchemy.org/en/latest/orm/
|
|
|
|
|
extensions/declarative/api.html
|
|
|
|
|
#sqlalchemy.ext.declarative.declared_attr>`_
|
|
|
|
|
"""
|
2018-05-13 13:13:12 +00:00
|
|
|
|
args = {POLYMORPHIC_ID: cls.t}
|
|
|
|
|
if cls.t == 'Device':
|
2018-04-10 15:06:39 +00:00
|
|
|
|
args[POLYMORPHIC_ON] = cls.type
|
|
|
|
|
return args
|
|
|
|
|
|
2019-05-11 14:27:22 +00:00
|
|
|
|
def last_action_of(self, *types):
|
|
|
|
|
"""Gets the last action of the given types.
|
2018-10-13 12:53:46 +00:00
|
|
|
|
|
2019-05-11 14:27:22 +00:00
|
|
|
|
:raise LookupError: Device has not an action of the given type.
|
2018-10-13 12:53:46 +00:00
|
|
|
|
"""
|
|
|
|
|
try:
|
2019-05-03 12:31:49 +00:00
|
|
|
|
# noinspection PyTypeHints
|
2020-11-27 17:10:51 +00:00
|
|
|
|
actions = self.actions
|
|
|
|
|
actions.sort(key=lambda x: x.created)
|
|
|
|
|
return next(e for e in reversed(actions) if isinstance(e, types))
|
2018-10-13 12:53:46 +00:00
|
|
|
|
except StopIteration:
|
2019-05-11 14:27:22 +00:00
|
|
|
|
raise LookupError('{!r} does not contain actions of types {}.'.format(self, types))
|
2018-10-13 12:53:46 +00:00
|
|
|
|
|
2019-05-11 14:27:22 +00:00
|
|
|
|
def _warning_actions(self, actions):
|
|
|
|
|
return sorted(ev for ev in actions if ev.severity >= Severity.Warning)
|
2018-11-09 10:22:13 +00:00
|
|
|
|
|
2018-04-30 17:58:19 +00:00
|
|
|
|
def __lt__(self, other):
|
|
|
|
|
return self.id < other.id
|
2018-04-27 17:16:43 +00:00
|
|
|
|
|
2018-10-03 12:51:22 +00:00
|
|
|
|
def __str__(self) -> str:
|
|
|
|
|
return '{0.t} {0.id}: model {0.model}, S/N {0.serial_number}'.format(self)
|
|
|
|
|
|
|
|
|
|
def __format__(self, format_spec):
|
|
|
|
|
if not format_spec:
|
|
|
|
|
return super().__format__(format_spec)
|
|
|
|
|
v = ''
|
|
|
|
|
if 't' in format_spec:
|
|
|
|
|
v += '{0.t} {0.model}'.format(self)
|
|
|
|
|
if 's' in format_spec:
|
2019-07-07 19:36:09 +00:00
|
|
|
|
superclass = self.__class__.mro()[1]
|
|
|
|
|
if not isinstance(self, Device) and superclass != Device:
|
|
|
|
|
assert issubclass(superclass, Thing)
|
|
|
|
|
v += superclass.__name__ + ' '
|
|
|
|
|
v += '{0.manufacturer}'.format(self)
|
2018-10-16 14:30:10 +00:00
|
|
|
|
if self.serial_number:
|
2019-07-07 19:36:09 +00:00
|
|
|
|
v += ' ' + self.serial_number.upper()
|
2018-10-03 12:51:22 +00:00
|
|
|
|
return v
|
2018-05-13 13:13:12 +00:00
|
|
|
|
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
2018-06-26 13:36:21 +00:00
|
|
|
|
class DisplayMixin:
|
2019-05-03 12:31:49 +00:00
|
|
|
|
"""Base class for the Display Component and the Monitor Device."""
|
|
|
|
|
size = Column(Float(decimal_return_scale=1), check_range('size', 2, 150), nullable=False)
|
2019-06-19 11:35:26 +00:00
|
|
|
|
size.comment = """The size of the monitor in inches."""
|
2018-06-26 13:36:21 +00:00
|
|
|
|
technology = Column(DBEnum(DisplayTech))
|
2020-04-01 17:11:14 +00:00
|
|
|
|
technology.comment = """The technology the monitor uses to display
|
2019-06-19 11:35:26 +00:00
|
|
|
|
the image.
|
2018-06-26 13:36:21 +00:00
|
|
|
|
"""
|
2019-05-03 12:31:49 +00:00
|
|
|
|
resolution_width = Column(SmallInteger, check_range('resolution_width', 10, 20000),
|
|
|
|
|
nullable=False)
|
2020-04-01 17:11:14 +00:00
|
|
|
|
resolution_width.comment = """The maximum horizontal resolution the
|
2019-06-19 11:35:26 +00:00
|
|
|
|
monitor can natively support in pixels.
|
2018-06-26 13:36:21 +00:00
|
|
|
|
"""
|
2019-05-03 12:31:49 +00:00
|
|
|
|
resolution_height = Column(SmallInteger, check_range('resolution_height', 10, 20000),
|
|
|
|
|
nullable=False)
|
2020-04-01 17:11:14 +00:00
|
|
|
|
resolution_height.comment = """The maximum vertical resolution the
|
2019-06-19 11:35:26 +00:00
|
|
|
|
monitor can natively support in pixels.
|
2018-06-26 13:36:21 +00:00
|
|
|
|
"""
|
2018-10-23 13:37:37 +00:00
|
|
|
|
refresh_rate = Column(SmallInteger, check_range('refresh_rate', 10, 1000))
|
|
|
|
|
contrast_ratio = Column(SmallInteger, check_range('contrast_ratio', 100, 100000))
|
2019-05-03 12:31:49 +00:00
|
|
|
|
touchable = Column(Boolean)
|
2018-10-23 13:37:37 +00:00
|
|
|
|
touchable.comment = """Whether it is a touchscreen."""
|
2018-06-26 13:36:21 +00:00
|
|
|
|
|
2019-05-03 12:31:49 +00:00
|
|
|
|
@hybrid_property
|
|
|
|
|
def aspect_ratio(self):
|
|
|
|
|
"""The aspect ratio of the display, as a fraction: ``X/Y``.
|
|
|
|
|
|
|
|
|
|
Regular values are ``4/3``, ``5/4``, ``16/9``, ``21/9``,
|
|
|
|
|
``14/10``, ``19/10``, ``16/10``.
|
|
|
|
|
"""
|
|
|
|
|
return Fraction(self.resolution_width, self.resolution_height)
|
|
|
|
|
|
|
|
|
|
# noinspection PyUnresolvedReferences
|
|
|
|
|
@aspect_ratio.expression
|
|
|
|
|
def aspect_ratio(cls):
|
|
|
|
|
# The aspect ratio to use as SQL in the DB
|
|
|
|
|
# This allows comparing resolutions
|
|
|
|
|
return db.func.round(cls.resolution_width / cls.resolution_height, 2)
|
|
|
|
|
|
|
|
|
|
@hybrid_property
|
|
|
|
|
def widescreen(self):
|
|
|
|
|
"""Whether the monitor is considered to be widescreen.
|
|
|
|
|
|
|
|
|
|
Widescreen monitors are those having a higher aspect ratio
|
|
|
|
|
greater than 4/3.
|
|
|
|
|
"""
|
|
|
|
|
# We add a tiny extra to 4/3 to avoid precision errors
|
|
|
|
|
return self.aspect_ratio > 4.001 / 3
|
|
|
|
|
|
|
|
|
|
def __str__(self) -> str:
|
|
|
|
|
return '{0.t} {0.serial_number} {0.size}in ({0.aspect_ratio}) {0.technology}'.format(self)
|
|
|
|
|
|
2018-10-03 12:51:22 +00:00
|
|
|
|
def __format__(self, format_spec: str) -> str:
|
|
|
|
|
v = ''
|
|
|
|
|
if 't' in format_spec:
|
|
|
|
|
v += '{0.t} {0.model}'.format(self)
|
|
|
|
|
if 's' in format_spec:
|
2019-05-03 12:31:49 +00:00
|
|
|
|
v += '({0.manufacturer}) S/N {0.serial_number}'.format(self)
|
|
|
|
|
v += '– {0.size}in ({0.aspect_ratio}) {0.technology}'.format(self)
|
2018-10-03 12:51:22 +00:00
|
|
|
|
return v
|
|
|
|
|
|
2018-06-26 13:36:21 +00:00
|
|
|
|
|
2018-04-10 15:06:39 +00:00
|
|
|
|
class Computer(Device):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""A chassis with components inside that can be processed
|
|
|
|
|
automatically with Workbench Computer.
|
|
|
|
|
|
|
|
|
|
Computer is broadly extended by ``Desktop``, ``Laptop``, and
|
|
|
|
|
``Server``. The property ``chassis`` defines it more granularly.
|
|
|
|
|
"""
|
2018-06-10 16:47:49 +00:00
|
|
|
|
id = Column(BigInteger, ForeignKey(Device.id), primary_key=True)
|
2018-06-26 13:36:21 +00:00
|
|
|
|
chassis = Column(DBEnum(ComputerChassis), nullable=False)
|
2019-02-03 16:12:53 +00:00
|
|
|
|
chassis.comment = """The physical form of the computer.
|
2019-12-10 23:35:17 +00:00
|
|
|
|
|
2019-02-03 16:12:53 +00:00
|
|
|
|
It is a subset of the Linux definition of DMI / DMI decode.
|
|
|
|
|
"""
|
2020-03-19 00:55:26 +00:00
|
|
|
|
ethereum_address = Column(CIText(), unique=True, default=None)
|
2020-08-17 14:45:18 +00:00
|
|
|
|
deposit = Column(Integer, check_range('deposit', min=0, max=100), default=0)
|
2020-04-01 17:11:14 +00:00
|
|
|
|
owner_id = db.Column(UUID(as_uuid=True),
|
2020-08-17 14:45:18 +00:00
|
|
|
|
db.ForeignKey(User.id),
|
|
|
|
|
nullable=False,
|
|
|
|
|
default=lambda: g.user.id)
|
2020-04-01 17:11:14 +00:00
|
|
|
|
author = db.relationship(User, primaryjoin=owner_id == User.id)
|
2019-12-17 22:57:55 +00:00
|
|
|
|
transfer_state = db.Column(IntEnum(TransferState), default=TransferState.Initial, nullable=False)
|
|
|
|
|
transfer_state.comment = TransferState.__doc__
|
2020-04-01 17:11:14 +00:00
|
|
|
|
receiver_id = db.Column(UUID(as_uuid=True),
|
2020-08-17 14:45:18 +00:00
|
|
|
|
db.ForeignKey(User.id),
|
|
|
|
|
nullable=True)
|
2020-04-01 17:11:14 +00:00
|
|
|
|
receiver = db.relationship(User, primaryjoin=receiver_id == User.id)
|
2019-12-19 00:38:03 +00:00
|
|
|
|
deliverynote_address = db.Column(CIText(), nullable=True)
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
2018-10-18 08:09:10 +00:00
|
|
|
|
def __init__(self, chassis, **kwargs) -> None:
|
|
|
|
|
chassis = ComputerChassis(chassis)
|
|
|
|
|
super().__init__(chassis=chassis, **kwargs)
|
|
|
|
|
|
2018-06-16 10:41:12 +00:00
|
|
|
|
@property
|
2019-05-11 14:27:22 +00:00
|
|
|
|
def actions(self) -> list:
|
|
|
|
|
return sorted(chain(super().actions, self.actions_parent))
|
2018-06-16 10:41:12 +00:00
|
|
|
|
|
2018-10-03 12:51:22 +00:00
|
|
|
|
@property
|
|
|
|
|
def ram_size(self) -> int:
|
|
|
|
|
"""The total of RAM memory the computer has."""
|
2018-10-13 12:53:46 +00:00
|
|
|
|
return sum(ram.size or 0 for ram in self.components if isinstance(ram, RamModule))
|
2018-10-03 12:51:22 +00:00
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def data_storage_size(self) -> int:
|
|
|
|
|
"""The total of data storage the computer has."""
|
2018-10-13 12:53:46 +00:00
|
|
|
|
return sum(ds.size or 0 for ds in self.components if isinstance(ds, DataStorage))
|
2018-10-03 12:51:22 +00:00
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def processor_model(self) -> str:
|
|
|
|
|
"""The model of one of the processors of the computer."""
|
2018-10-13 12:53:46 +00:00
|
|
|
|
return next((p.model for p in self.components if isinstance(p, Processor)), None)
|
2018-10-03 12:51:22 +00:00
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def graphic_card_model(self) -> str:
|
|
|
|
|
"""The model of one of the graphic cards of the computer."""
|
2018-10-13 12:53:46 +00:00
|
|
|
|
return next((p.model for p in self.components if isinstance(p, GraphicCard)), None)
|
2018-10-03 12:51:22 +00:00
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def network_speeds(self) -> List[int]:
|
2018-10-13 12:53:46 +00:00
|
|
|
|
"""Returns two values representing the speeds of the network
|
|
|
|
|
adapters of the device.
|
|
|
|
|
|
|
|
|
|
1. The max Ethernet speed of the computer, 0 if ethernet
|
|
|
|
|
adaptor exists but its speed is unknown, None if no eth
|
2019-05-08 17:12:05 +00:00
|
|
|
|
adaptor exists.
|
2018-10-13 12:53:46 +00:00
|
|
|
|
2. The max WiFi speed of the computer, 0 if computer has
|
|
|
|
|
WiFi but its speed is unknown, None if no WiFi adaptor
|
|
|
|
|
exists.
|
2018-10-03 12:51:22 +00:00
|
|
|
|
"""
|
2018-10-13 12:53:46 +00:00
|
|
|
|
speeds = [None, None]
|
2018-10-03 12:51:22 +00:00
|
|
|
|
for net in (c for c in self.components if isinstance(c, NetworkAdapter)):
|
2018-10-13 12:53:46 +00:00
|
|
|
|
speeds[net.wireless] = max(net.speed or 0, speeds[net.wireless] or 0)
|
2018-10-03 12:51:22 +00:00
|
|
|
|
return speeds
|
|
|
|
|
|
2018-11-09 10:22:13 +00:00
|
|
|
|
@property
|
|
|
|
|
def privacy(self):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""Returns the privacy of all ``DataStorage`` components when
|
2018-11-21 13:26:56 +00:00
|
|
|
|
it is not None.
|
2018-11-09 10:22:13 +00:00
|
|
|
|
"""
|
|
|
|
|
return set(
|
|
|
|
|
privacy for privacy in
|
|
|
|
|
(hdd.privacy for hdd in self.components if isinstance(hdd, DataStorage))
|
|
|
|
|
if privacy
|
|
|
|
|
)
|
|
|
|
|
|
2018-10-03 12:51:22 +00:00
|
|
|
|
def __format__(self, format_spec):
|
|
|
|
|
if not format_spec:
|
|
|
|
|
return super().__format__(format_spec)
|
|
|
|
|
v = ''
|
|
|
|
|
if 't' in format_spec:
|
|
|
|
|
v += '{0.chassis} {0.model}'.format(self)
|
|
|
|
|
elif 's' in format_spec:
|
2018-10-16 14:30:10 +00:00
|
|
|
|
v += '({0.manufacturer})'.format(self)
|
|
|
|
|
if self.serial_number:
|
|
|
|
|
v += ' S/N ' + self.serial_number.upper()
|
2018-10-03 12:51:22 +00:00
|
|
|
|
return v
|
|
|
|
|
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
|
|
|
|
class Desktop(Computer):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Laptop(Computer):
|
2018-10-23 13:37:37 +00:00
|
|
|
|
layout = Column(DBEnum(Layouts))
|
|
|
|
|
layout.comment = """Layout of a built-in keyboard of the computer,
|
2019-06-19 11:35:26 +00:00
|
|
|
|
if any.
|
|
|
|
|
"""
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
|
|
|
|
|
2018-06-26 13:36:21 +00:00
|
|
|
|
class Server(Computer):
|
2018-04-10 15:06:39 +00:00
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
2018-06-26 13:36:21 +00:00
|
|
|
|
class Monitor(DisplayMixin, Device):
|
|
|
|
|
id = Column(BigInteger, ForeignKey(Device.id), primary_key=True)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class ComputerMonitor(Monitor):
|
2018-04-10 15:06:39 +00:00
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
2018-06-26 13:36:21 +00:00
|
|
|
|
class TelevisionSet(Monitor):
|
2018-04-10 15:06:39 +00:00
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
2018-10-23 13:37:37 +00:00
|
|
|
|
class Projector(Monitor):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
2018-06-26 13:36:21 +00:00
|
|
|
|
class Mobile(Device):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""A mobile device consisting of smartphones, tablets, and cellphones."""
|
|
|
|
|
|
2018-06-20 21:18:15 +00:00
|
|
|
|
id = Column(BigInteger, ForeignKey(Device.id), primary_key=True)
|
2018-06-26 13:36:21 +00:00
|
|
|
|
imei = Column(BigInteger)
|
2020-04-01 17:11:14 +00:00
|
|
|
|
imei.comment = """The International Mobile Equipment Identity of
|
2019-05-03 12:31:49 +00:00
|
|
|
|
the smartphone as an integer.
|
2018-06-20 21:18:15 +00:00
|
|
|
|
"""
|
2018-06-26 13:36:21 +00:00
|
|
|
|
meid = Column(Unicode)
|
2020-04-01 17:11:14 +00:00
|
|
|
|
meid.comment = """The Mobile Equipment Identifier as a hexadecimal
|
2019-05-03 12:31:49 +00:00
|
|
|
|
string.
|
2018-06-20 21:18:15 +00:00
|
|
|
|
"""
|
2020-02-18 12:50:48 +00:00
|
|
|
|
ram_size = db.Column(db.Integer, check_range('ram_size', min=128, max=36000))
|
2019-05-03 12:31:49 +00:00
|
|
|
|
ram_size.comment = """The total of RAM of the device in MB."""
|
2020-02-18 12:50:48 +00:00
|
|
|
|
data_storage_size = db.Column(db.Integer, check_range('data_storage_size', 0, 10 ** 8))
|
|
|
|
|
data_storage_size.comment = """The total of data storage of the device in MB"""
|
2020-03-03 11:03:09 +00:00
|
|
|
|
display_size = db.Column(db.Float(decimal_return_scale=1), check_range('display_size', min=0.1, max=30.0))
|
|
|
|
|
display_size.comment = """The total size of the device screen"""
|
2018-06-20 21:18:15 +00:00
|
|
|
|
|
2018-06-26 13:36:21 +00:00
|
|
|
|
@validates('imei')
|
|
|
|
|
def validate_imei(self, _, value: int):
|
2018-10-04 08:59:31 +00:00
|
|
|
|
if not imei.is_valid(str(value)):
|
2018-06-26 13:36:21 +00:00
|
|
|
|
raise ValidationError('{} is not a valid imei.'.format(value))
|
2018-11-17 18:22:41 +00:00
|
|
|
|
return value
|
2018-06-26 13:36:21 +00:00
|
|
|
|
|
|
|
|
|
@validates('meid')
|
|
|
|
|
def validate_meid(self, _, value: str):
|
|
|
|
|
if not meid.is_valid(value):
|
|
|
|
|
raise ValidationError('{} is not a valid meid.'.format(value))
|
2018-11-17 18:22:41 +00:00
|
|
|
|
return value
|
2018-06-26 13:36:21 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Smartphone(Mobile):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Tablet(Mobile):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Cellphone(Mobile):
|
|
|
|
|
pass
|
|
|
|
|
|
2018-06-20 21:18:15 +00:00
|
|
|
|
|
2018-04-10 15:06:39 +00:00
|
|
|
|
class Component(Device):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""A device that can be inside another device."""
|
2018-06-10 16:47:49 +00:00
|
|
|
|
id = Column(BigInteger, ForeignKey(Device.id), primary_key=True)
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
2019-02-07 12:47:42 +00:00
|
|
|
|
parent_id = Column(BigInteger, ForeignKey(Computer.id))
|
2018-04-10 15:06:39 +00:00
|
|
|
|
parent = relationship(Computer,
|
2018-05-13 13:13:12 +00:00
|
|
|
|
backref=backref('components',
|
|
|
|
|
lazy=True,
|
2018-11-11 20:52:55 +00:00
|
|
|
|
cascade=CASCADE_DEL,
|
2018-05-30 10:49:40 +00:00
|
|
|
|
order_by=lambda: Component.id,
|
|
|
|
|
collection_class=OrderedSet),
|
2018-06-15 13:31:03 +00:00
|
|
|
|
primaryjoin=parent_id == Computer.id)
|
2018-04-27 17:16:43 +00:00
|
|
|
|
|
2019-02-07 12:47:42 +00:00
|
|
|
|
__table_args__ = (
|
|
|
|
|
db.Index('parent_index', parent_id, postgresql_using='hash'),
|
|
|
|
|
)
|
|
|
|
|
|
2018-04-27 17:16:43 +00:00
|
|
|
|
def similar_one(self, parent: Computer, blacklist: Set[int]) -> 'Component':
|
2019-06-19 11:35:26 +00:00
|
|
|
|
"""Gets a component that:
|
|
|
|
|
|
|
|
|
|
* has the same parent.
|
|
|
|
|
* Doesn't generate HID.
|
|
|
|
|
* Has same physical properties.
|
2018-04-27 17:16:43 +00:00
|
|
|
|
:param parent:
|
|
|
|
|
:param blacklist: A set of components to not to consider
|
|
|
|
|
when looking for similar ones.
|
|
|
|
|
"""
|
|
|
|
|
assert self.hid is None, 'Don\'t use this method with a component that has HID'
|
|
|
|
|
component = self.__class__.query \
|
2020-11-06 16:09:39 +00:00
|
|
|
|
.filter_by(parent=parent, hid=None, owner_id=self.owner_id,
|
|
|
|
|
**self.physical_properties) \
|
2018-04-27 17:16:43 +00:00
|
|
|
|
.filter(~Component.id.in_(blacklist)) \
|
|
|
|
|
.first()
|
|
|
|
|
if not component:
|
|
|
|
|
raise ResourceNotFound(self.type)
|
|
|
|
|
return component
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
2018-05-13 13:13:12 +00:00
|
|
|
|
@property
|
2019-05-11 14:27:22 +00:00
|
|
|
|
def actions(self) -> list:
|
|
|
|
|
return sorted(chain(super().actions, self.actions_components))
|
2018-05-13 13:13:12 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class JoinedComponentTableMixin:
|
|
|
|
|
@declared_attr
|
|
|
|
|
def id(cls):
|
|
|
|
|
return Column(BigInteger, ForeignKey(Component.id), primary_key=True)
|
|
|
|
|
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
2018-05-13 13:13:12 +00:00
|
|
|
|
class GraphicCard(JoinedComponentTableMixin, Component):
|
2018-06-10 16:47:49 +00:00
|
|
|
|
memory = Column(SmallInteger, check_range('memory', min=1, max=10000))
|
2019-06-19 11:35:26 +00:00
|
|
|
|
memory.comment = """The amount of memory of the Graphic Card in MB."""
|
2018-06-10 16:47:49 +00:00
|
|
|
|
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
2018-06-10 16:47:49 +00:00
|
|
|
|
class DataStorage(JoinedComponentTableMixin, Component):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""A device that stores information."""
|
2018-06-10 16:47:49 +00:00
|
|
|
|
size = Column(Integer, check_range('size', min=1, max=10 ** 8))
|
2019-06-19 11:35:26 +00:00
|
|
|
|
size.comment = """The size of the data-storage in MB."""
|
2018-06-12 14:50:05 +00:00
|
|
|
|
interface = Column(DBEnum(DataStorageInterface))
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
2018-10-13 12:53:46 +00:00
|
|
|
|
@property
|
|
|
|
|
def privacy(self):
|
2018-12-30 11:43:29 +00:00
|
|
|
|
"""Returns the privacy compliance state of the data storage.
|
|
|
|
|
|
|
|
|
|
This is, the last erasure performed to the data storage.
|
|
|
|
|
"""
|
2019-05-11 14:27:22 +00:00
|
|
|
|
from ereuse_devicehub.resources.action.models import EraseBasic
|
2018-11-09 10:22:13 +00:00
|
|
|
|
try:
|
2019-05-11 14:27:22 +00:00
|
|
|
|
ev = self.last_action_of(EraseBasic)
|
2018-11-09 10:22:13 +00:00
|
|
|
|
except LookupError:
|
|
|
|
|
ev = None
|
|
|
|
|
return ev
|
2018-10-13 12:53:46 +00:00
|
|
|
|
|
2018-10-03 12:51:22 +00:00
|
|
|
|
def __format__(self, format_spec):
|
|
|
|
|
v = super().__format__(format_spec)
|
|
|
|
|
if 's' in format_spec:
|
2018-11-21 13:26:56 +00:00
|
|
|
|
v += ' – {} GB'.format(self.size // 1000 if self.size else '?')
|
2018-10-03 12:51:22 +00:00
|
|
|
|
return v
|
|
|
|
|
|
2018-06-10 16:47:49 +00:00
|
|
|
|
|
|
|
|
|
class HardDrive(DataStorage):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class SolidStateDrive(DataStorage):
|
|
|
|
|
pass
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
|
|
|
|
|
2018-05-13 13:13:12 +00:00
|
|
|
|
class Motherboard(JoinedComponentTableMixin, Component):
|
2018-07-02 10:52:54 +00:00
|
|
|
|
slots = Column(SmallInteger, check_range('slots', min=0))
|
2019-06-19 11:35:26 +00:00
|
|
|
|
slots.comment = """PCI slots the motherboard has."""
|
2018-07-02 10:52:54 +00:00
|
|
|
|
usb = Column(SmallInteger, check_range('usb', min=0))
|
|
|
|
|
firewire = Column(SmallInteger, check_range('firewire', min=0))
|
|
|
|
|
serial = Column(SmallInteger, check_range('serial', min=0))
|
|
|
|
|
pcmcia = Column(SmallInteger, check_range('pcmcia', min=0))
|
2019-05-03 12:31:49 +00:00
|
|
|
|
bios_date = Column(db.Date)
|
|
|
|
|
bios_date.comment = """The date of the BIOS version."""
|
2019-06-29 14:26:14 +00:00
|
|
|
|
ram_slots = Column(db.SmallInteger, check_range('ram_slots'))
|
|
|
|
|
ram_max_size = Column(db.Integer, check_range('ram_max_size'))
|
2018-04-10 15:06:39 +00:00
|
|
|
|
|
|
|
|
|
|
2018-06-26 13:35:13 +00:00
|
|
|
|
class NetworkMixin:
|
2018-06-10 16:47:49 +00:00
|
|
|
|
speed = Column(SmallInteger, check_range('speed', min=10, max=10000))
|
2020-04-01 17:11:14 +00:00
|
|
|
|
speed.comment = """The maximum speed this network adapter can handle,
|
2019-06-19 11:35:26 +00:00
|
|
|
|
in mbps.
|
2018-06-26 13:35:13 +00:00
|
|
|
|
"""
|
2018-10-13 12:53:46 +00:00
|
|
|
|
wireless = Column(Boolean, nullable=False, default=False)
|
2019-06-19 11:35:26 +00:00
|
|
|
|
wireless.comment = """Whether it is a wireless interface."""
|
2018-06-26 13:35:13 +00:00
|
|
|
|
|
2018-10-03 12:51:22 +00:00
|
|
|
|
def __format__(self, format_spec):
|
|
|
|
|
v = super().__format__(format_spec)
|
|
|
|
|
if 's' in format_spec:
|
|
|
|
|
v += ' – {} Mbps'.format(self.speed)
|
|
|
|
|
return v
|
|
|
|
|
|
2018-06-26 13:35:13 +00:00
|
|
|
|
|
|
|
|
|
class NetworkAdapter(JoinedComponentTableMixin, NetworkMixin, Component):
|
|
|
|
|
pass
|
2018-04-27 17:16:43 +00:00
|
|
|
|
|
|
|
|
|
|
2018-05-13 13:13:12 +00:00
|
|
|
|
class Processor(JoinedComponentTableMixin, Component):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""The CPU."""
|
2018-05-11 16:58:48 +00:00
|
|
|
|
speed = Column(Float, check_range('speed', 0.1, 15))
|
2019-02-03 16:12:53 +00:00
|
|
|
|
speed.comment = """The regular CPU speed."""
|
2018-05-11 16:58:48 +00:00
|
|
|
|
cores = Column(SmallInteger, check_range('cores', 1, 10))
|
2019-02-03 16:12:53 +00:00
|
|
|
|
cores.comment = """The number of regular cores."""
|
2018-07-19 19:25:06 +00:00
|
|
|
|
threads = Column(SmallInteger, check_range('threads', 1, 20))
|
2019-02-03 16:12:53 +00:00
|
|
|
|
threads.comment = """The number of threads per core."""
|
2018-05-11 16:58:48 +00:00
|
|
|
|
address = Column(SmallInteger, check_range('address', 8, 256))
|
2019-02-03 16:12:53 +00:00
|
|
|
|
address.comment = """The address of the CPU: 8, 16, 32, 64, 128 or 256 bits."""
|
2019-05-03 12:31:49 +00:00
|
|
|
|
abi = Column(Unicode, check_lower('abi'))
|
|
|
|
|
abi.comment = """The Application Binary Interface of the processor."""
|
2018-05-11 16:58:48 +00:00
|
|
|
|
|
|
|
|
|
|
2018-05-13 13:13:12 +00:00
|
|
|
|
class RamModule(JoinedComponentTableMixin, Component):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""A stick of RAM."""
|
2018-04-27 17:16:43 +00:00
|
|
|
|
size = Column(SmallInteger, check_range('size', min=128, max=17000))
|
2019-02-03 16:12:53 +00:00
|
|
|
|
size.comment = """The capacity of the RAM stick."""
|
2018-07-19 19:25:06 +00:00
|
|
|
|
speed = Column(SmallInteger, check_range('speed', min=100, max=10000))
|
2018-06-12 14:50:05 +00:00
|
|
|
|
interface = Column(DBEnum(RamInterface))
|
|
|
|
|
format = Column(DBEnum(RamFormat))
|
2018-06-26 13:36:21 +00:00
|
|
|
|
|
|
|
|
|
|
2018-07-02 10:52:54 +00:00
|
|
|
|
class SoundCard(JoinedComponentTableMixin, Component):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
2018-06-26 13:36:21 +00:00
|
|
|
|
class Display(JoinedComponentTableMixin, DisplayMixin, Component):
|
2019-06-19 11:35:26 +00:00
|
|
|
|
"""The display of a device. This is used in all devices that have
|
2019-02-03 16:12:53 +00:00
|
|
|
|
displays but that it is not their main part, like laptops,
|
|
|
|
|
mobiles, smart-watches, and so on; excluding ``ComputerMonitor``
|
|
|
|
|
and ``TelevisionSet``.
|
2018-06-26 13:36:21 +00:00
|
|
|
|
"""
|
|
|
|
|
pass
|
2018-09-30 17:40:28 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-03 12:31:49 +00:00
|
|
|
|
class Battery(JoinedComponentTableMixin, Component):
|
|
|
|
|
wireless = db.Column(db.Boolean)
|
|
|
|
|
wireless.comment = """If the battery can be charged wirelessly."""
|
|
|
|
|
technology = db.Column(db.Enum(BatteryTechnology))
|
|
|
|
|
size = db.Column(db.Integer, nullable=False)
|
|
|
|
|
size.comment = """Maximum battery capacity by design, in mAh.
|
2020-04-01 17:11:14 +00:00
|
|
|
|
|
2019-05-03 12:31:49 +00:00
|
|
|
|
Use BatteryTest's "size" to get the actual size of the battery.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
@property
|
|
|
|
|
def capacity(self) -> float:
|
|
|
|
|
"""The quantity of """
|
2019-05-11 14:27:22 +00:00
|
|
|
|
from ereuse_devicehub.resources.action.models import MeasureBattery
|
|
|
|
|
real_size = self.last_action_of(MeasureBattery).size
|
2019-05-03 12:31:49 +00:00
|
|
|
|
return real_size / self.size if real_size and self.size else None
|
|
|
|
|
|
|
|
|
|
|
2019-07-01 18:39:32 +00:00
|
|
|
|
class Camera(Component):
|
|
|
|
|
"""The camera of a device."""
|
|
|
|
|
focal_length = db.Column(db.SmallInteger)
|
|
|
|
|
video_height = db.Column(db.SmallInteger)
|
|
|
|
|
video_width = db.Column(db.Integer)
|
|
|
|
|
horizontal_view_angle = db.Column(db.Integer)
|
|
|
|
|
facing = db.Column(db.Enum(CameraFacing))
|
|
|
|
|
vertical_view_angle = db.Column(db.SmallInteger)
|
|
|
|
|
video_stabilization = db.Column(db.Boolean)
|
|
|
|
|
flash = db.Column(db.Boolean)
|
|
|
|
|
|
|
|
|
|
|
2018-10-23 13:37:37 +00:00
|
|
|
|
class ComputerAccessory(Device):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""Computer peripherals and similar accessories."""
|
2018-10-23 13:37:37 +00:00
|
|
|
|
id = Column(BigInteger, ForeignKey(Device.id), primary_key=True)
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class SAI(ComputerAccessory):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Keyboard(ComputerAccessory):
|
|
|
|
|
layout = Column(DBEnum(Layouts)) # If we want to do it not null
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Mouse(ComputerAccessory):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class MemoryCardReader(ComputerAccessory):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Networking(NetworkMixin, Device):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""Routers, switches, hubs..."""
|
2018-10-23 13:37:37 +00:00
|
|
|
|
id = Column(BigInteger, ForeignKey(Device.id), primary_key=True)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Router(Networking):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Switch(Networking):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Hub(Networking):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class WirelessAccessPoint(Networking):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Printer(Device):
|
|
|
|
|
id = Column(BigInteger, ForeignKey(Device.id), primary_key=True)
|
|
|
|
|
wireless = Column(Boolean, nullable=False, default=False)
|
|
|
|
|
wireless.comment = """Whether it is a wireless printer."""
|
|
|
|
|
scanning = Column(Boolean, nullable=False, default=False)
|
|
|
|
|
scanning.comment = """Whether the printer has scanning capabilities."""
|
|
|
|
|
technology = Column(DBEnum(PrinterTechnology))
|
|
|
|
|
technology.comment = """Technology used to print."""
|
|
|
|
|
monochrome = Column(Boolean, nullable=False, default=True)
|
|
|
|
|
monochrome.comment = """Whether the printer is only monochrome."""
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class LabelPrinter(Printer):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Sound(Device):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Microphone(Sound):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Video(Device):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""Devices related to video treatment."""
|
2018-10-23 13:37:37 +00:00
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class VideoScaler(Video):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Videoconference(Video):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
2018-11-12 10:59:49 +00:00
|
|
|
|
class Cooking(Device):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""Cooking devices."""
|
2018-11-12 10:59:49 +00:00
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Mixer(Cooking):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
2019-07-07 19:36:09 +00:00
|
|
|
|
class DIYAndGardening(Device):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Drill(DIYAndGardening):
|
2019-07-01 18:39:32 +00:00
|
|
|
|
max_drill_bit_size = db.Column(db.SmallInteger)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class PackOfScrewdrivers(Device):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
2019-07-07 19:36:09 +00:00
|
|
|
|
class Home(Device):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Dehumidifier(Home):
|
2019-07-01 18:39:32 +00:00
|
|
|
|
size = db.Column(db.SmallInteger)
|
|
|
|
|
size.comment = """The capacity in Liters."""
|
|
|
|
|
|
|
|
|
|
|
2019-07-07 19:36:09 +00:00
|
|
|
|
class Stairs(Home):
|
2019-07-01 18:39:32 +00:00
|
|
|
|
max_allowed_weight = db.Column(db.Integer)
|
|
|
|
|
|
|
|
|
|
|
2019-07-07 19:36:09 +00:00
|
|
|
|
class Recreation(Device):
|
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class Bike(Recreation):
|
2019-07-01 18:39:32 +00:00
|
|
|
|
wheel_size = db.Column(db.SmallInteger)
|
|
|
|
|
gears = db.Column(db.SmallInteger)
|
|
|
|
|
|
|
|
|
|
|
2019-07-07 19:36:09 +00:00
|
|
|
|
class Racket(Recreation):
|
2019-07-01 18:39:32 +00:00
|
|
|
|
pass
|
|
|
|
|
|
|
|
|
|
|
2018-09-30 17:40:28 +00:00
|
|
|
|
class Manufacturer(db.Model):
|
2019-02-03 16:12:53 +00:00
|
|
|
|
"""The normalized information about a manufacturer.
|
|
|
|
|
|
|
|
|
|
Ideally users should use the names from this list when submitting
|
|
|
|
|
devices.
|
|
|
|
|
"""
|
2019-02-07 12:47:42 +00:00
|
|
|
|
name = db.Column(CIText(), primary_key=True)
|
2019-02-03 16:12:53 +00:00
|
|
|
|
name.comment = """The normalized name of the manufacturer."""
|
2018-09-30 17:40:28 +00:00
|
|
|
|
url = db.Column(URL(), unique=True)
|
2019-02-03 16:12:53 +00:00
|
|
|
|
url.comment = """An URL to a page describing the manufacturer."""
|
2018-09-30 17:40:28 +00:00
|
|
|
|
logo = db.Column(URL())
|
2019-02-03 16:12:53 +00:00
|
|
|
|
logo.comment = """An URL pointing to the logo of the manufacturer."""
|
2018-09-30 17:40:28 +00:00
|
|
|
|
|
2019-02-07 12:47:42 +00:00
|
|
|
|
__table_args__ = (
|
|
|
|
|
# from https://niallburkley.com/blog/index-columns-for-like-in-postgres/
|
|
|
|
|
db.Index('name_index', text('name gin_trgm_ops'), postgresql_using='gin'),
|
|
|
|
|
{'schema': 'common'}
|
|
|
|
|
)
|
|
|
|
|
|
2018-09-30 17:40:28 +00:00
|
|
|
|
@classmethod
|
2018-10-05 12:35:51 +00:00
|
|
|
|
def add_all_to_session(cls, session: db.Session):
|
2018-09-30 17:40:28 +00:00
|
|
|
|
"""Adds all manufacturers to session."""
|
2018-10-05 12:35:51 +00:00
|
|
|
|
cursor = session.connection().connection.cursor()
|
|
|
|
|
#: Dialect used to write the CSV
|
|
|
|
|
|
|
|
|
|
with pathlib.Path(__file__).parent.joinpath('manufacturers.csv').open() as f:
|
|
|
|
|
cursor.copy_expert(
|
|
|
|
|
'COPY common.manufacturer FROM STDIN (FORMAT csv)',
|
|
|
|
|
f
|
|
|
|
|
)
|
2020-10-16 14:25:46 +00:00
|
|
|
|
|
|
|
|
|
|
2020-10-27 20:29:38 +00:00
|
|
|
|
listener_reset_field_updated_in_actual_time(Device)
|