architect-py 3.2.1__py3-none-any.whl → 5.0.0__py3-none-any.whl

architect_py/grpc/models/Cpty/CptysRequest.py

@@ -0,0 +1,37 @@
+# generated by datamodel-codegen:
+#   filename:  Cpty/CptysRequest.json
+
+from __future__ import annotations
+from architect_py.grpc.models.Cpty.CptysResponse import CptysResponse
+
+from msgspec import Struct
+
+
+class CptysRequest(Struct, omit_defaults=True):
+    pass
+
+    # Constructor that takes all field titles as arguments for convenience
+    @classmethod
+    def new(
+        cls,
+    ):
+        return cls()
+
+    def __str__(self) -> str:
+        return f"CptysRequest()"
+
+    @staticmethod
+    def get_response_type():
+        return CptysResponse
+
+    @staticmethod
+    def get_unannotated_response_type():
+        return CptysResponse
+
+    @staticmethod
+    def get_route() -> str:
+        return "/json.architect.Cpty/Cptys"
+
+    @staticmethod
+    def get_rpc_method():
+        return "unary"

architect_py/grpc/models/Cpty/CptysResponse.py

@@ -0,0 +1,27 @@
+# generated by datamodel-codegen:
+#   filename:  Cpty/CptysResponse.json
+
+from __future__ import annotations
+
+from typing import List
+
+from msgspec import Struct
+
+from .CptyStatus import CptyStatus
+
+
+class CptysResponse(Struct, omit_defaults=True):
+    cptys: List[CptyStatus]
+
+    # Constructor that takes all field titles as arguments for convenience
+    @classmethod
+    def new(
+        cls,
+        cptys: List[CptyStatus],
+    ):
+        return cls(
+            cptys,
+        )
+
+    def __str__(self) -> str:
+        return f"CptysResponse(cptys={self.cptys})"

architect_py/grpc/models/Cpty/__init__.py

@@ -0,0 +1,2 @@
+# generated by datamodel-codegen:
+#   filename:  schemas

architect_py/{grpc_client → grpc/models}/Folio/AccountHistoryRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Folio/AccountHistoryRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Folio.AccountHistoryResponse import AccountHistoryResponse
+from architect_py.grpc.models.Folio.AccountHistoryResponse import AccountHistoryResponse
 
 from datetime import datetime
 from typing import Optional
@@ -17,7 +17,7 @@ class AccountHistoryRequest(Struct, omit_defaults=True):
     from_inclusive: Optional[datetime] = None
     to_exclusive: Optional[datetime] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/AccountHistoryResponse.py

@@ -13,7 +13,7 @@ from .AccountSummary import AccountSummary
 class AccountHistoryResponse(Struct, omit_defaults=True):
     history: List[AccountSummary]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/AccountSummariesRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Folio/AccountSummariesRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Folio.AccountSummariesResponse import (
+from architect_py.grpc.models.Folio.AccountSummariesResponse import (
     AccountSummariesResponse,
 )
 
@@ -27,7 +27,7 @@ class AccountSummariesRequest(Struct, omit_defaults=True):
     """
     trader: Optional[definitions.TraderIdOrEmail] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/AccountSummariesResponse.py

@@ -13,7 +13,7 @@ from .AccountSummary import AccountSummary
 class AccountSummariesResponse(Struct, omit_defaults=True):
     account_summaries: List[AccountSummary]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/AccountSummary.py

@@ -74,7 +74,7 @@ class AccountSummary(Struct, omit_defaults=True):
     Yesterday total account equity.
     """
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/AccountSummaryRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Folio/AccountSummaryRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Folio.AccountSummary import AccountSummary
+from architect_py.grpc.models.Folio.AccountSummary import AccountSummary
 
 from msgspec import Struct
 
@@ -12,7 +12,7 @@ from .. import definitions
 class AccountSummaryRequest(Struct, omit_defaults=True):
     account: definitions.AccountIdOrName
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/HistoricalFillsRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Folio/HistoricalFillsRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Folio.HistoricalFillsResponse import (
+from architect_py.grpc.models.Folio.HistoricalFillsResponse import (
     HistoricalFillsResponse,
 )
 
@@ -18,17 +18,18 @@ class HistoricalFillsRequest(Struct, omit_defaults=True):
     account: Optional[definitions.AccountIdOrName] = None
     from_inclusive: Optional[datetime] = None
     limit: Optional[
-        Annotated[Optional[int], Meta(description="Default maximum is 1000.", ge=0)]
+        Annotated[Optional[int], Meta(description="Default maximum is 1000.")]
     ] = None
     """
     Default maximum is 1000.
     """
     order_id: Optional[definitions.OrderId] = None
+    symbol: Optional[str] = None
     to_exclusive: Optional[datetime] = None
     trader: Optional[definitions.TraderIdOrEmail] = None
     venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,
@@ -36,6 +37,7 @@ class HistoricalFillsRequest(Struct, omit_defaults=True):
         from_inclusive: Optional[datetime] = None,
         limit: Optional[int] = None,
         order_id: Optional[definitions.OrderId] = None,
+        symbol: Optional[str] = None,
         to_exclusive: Optional[datetime] = None,
         trader: Optional[definitions.TraderIdOrEmail] = None,
         venue: Optional[str] = None,
@@ -45,13 +47,14 @@ class HistoricalFillsRequest(Struct, omit_defaults=True):
             from_inclusive,
             limit,
             order_id,
+            symbol,
             to_exclusive,
             trader,
             venue,
         )
 
     def __str__(self) -> str:
-        return f"HistoricalFillsRequest(account={self.account},from_inclusive={self.from_inclusive},limit={self.limit},order_id={self.order_id},to_exclusive={self.to_exclusive},trader={self.trader},venue={self.venue})"
+        return f"HistoricalFillsRequest(account={self.account},from_inclusive={self.from_inclusive},limit={self.limit},order_id={self.order_id},symbol={self.symbol},to_exclusive={self.to_exclusive},trader={self.trader},venue={self.venue})"
 
     @staticmethod
     def get_response_type():

architect_py/{grpc_client → grpc/models}/Folio/HistoricalFillsResponse.py

@@ -14,7 +14,7 @@ class HistoricalFillsResponse(Struct, omit_defaults=True):
     aberrant_fills: List[definitions.AberrantFill]
     fills: List[definitions.Fill]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/HistoricalOrdersRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Folio/HistoricalOrdersRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Folio.HistoricalOrdersResponse import (
+from architect_py.grpc.models.Folio.HistoricalOrdersResponse import (
     HistoricalOrdersResponse,
 )
 
@@ -18,7 +18,7 @@ class HistoricalOrdersRequest(Struct, omit_defaults=True):
     account: Optional[definitions.AccountIdOrName] = None
     from_inclusive: Optional[datetime] = None
     limit: Optional[
-        Annotated[Optional[int], Meta(description="Default maximum is 1000.", ge=0)]
+        Annotated[Optional[int], Meta(description="Default maximum is 1000.")]
     ] = None
     """
     Default maximum is 1000.
@@ -37,7 +37,7 @@ class HistoricalOrdersRequest(Struct, omit_defaults=True):
     trader: Optional[definitions.TraderIdOrEmail] = None
     venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/HistoricalOrdersResponse.py

@@ -13,7 +13,7 @@ from ..Oms.Order import Order
 class HistoricalOrdersResponse(Struct, omit_defaults=True):
     orders: List[Order]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/grpc/models/Folio/__init__.py

@@ -0,0 +1,2 @@
+# generated by datamodel-codegen:
+#   filename:  schemas

architect_py/{grpc_client → grpc/models}/Health/HealthCheckRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Health/HealthCheckRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Health.HealthCheckResponse import HealthCheckResponse
+from architect_py.grpc.models.Health.HealthCheckResponse import HealthCheckResponse
 
 from typing import Annotated, Optional
 
@@ -25,7 +25,7 @@ class HealthCheckRequest(Struct, omit_defaults=True):
     Generally, this will only be set when querying the API gateway.  It's not recommended to rely on internal subservice names being stable.
     """
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Health/HealthCheckResponse.py

@@ -14,7 +14,7 @@ class HealthCheckResponse(Struct, omit_defaults=True):
     status: definitions.HealthStatus
     metrics: Optional[Dict[str, Any]] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/grpc/models/Health/__init__.py

@@ -0,0 +1,2 @@
+# generated by datamodel-codegen:
+#   filename:  schemas

architect_py/{grpc_client → grpc/models}/Marketdata/Candle.py

@@ -37,7 +37,7 @@ class Candle(Struct, omit_defaults=True):
     mo: Optional[Annotated[Optional[Decimal], Meta(title="mid_open")]] = None
     o: Optional[Annotated[Optional[Decimal], Meta(title="open")]] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Marketdata/HistoricalCandlesRequest.py

@@ -2,11 +2,11 @@
 #   filename:  Marketdata/HistoricalCandlesRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Marketdata.HistoricalCandlesResponse import (
+from architect_py.grpc.models.Marketdata.HistoricalCandlesResponse import (
     HistoricalCandlesResponse,
 )
 
-from datetime import datetime
+from typing import Optional
 
 from msgspec import Struct
 
@@ -15,28 +15,31 @@ from .. import definitions
 
 class HistoricalCandlesRequest(Struct, omit_defaults=True):
     candle_width: definitions.CandleWidth
-    end_date: datetime
-    start_date: datetime
+    end_date: definitions.DateTimeOrUtc
+    start_date: definitions.DateTimeOrUtc
     symbol: str
+    venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,
         candle_width: definitions.CandleWidth,
-        end_date: datetime,
-        start_date: datetime,
+        end_date: definitions.DateTimeOrUtc,
+        start_date: definitions.DateTimeOrUtc,
         symbol: str,
+        venue: Optional[str] = None,
     ):
         return cls(
             candle_width,
             end_date,
             start_date,
             symbol,
+            venue,
         )
 
     def __str__(self) -> str:
-        return f"HistoricalCandlesRequest(candle_width={self.candle_width},end_date={self.end_date},start_date={self.start_date},symbol={self.symbol})"
+        return f"HistoricalCandlesRequest(candle_width={self.candle_width},end_date={self.end_date},start_date={self.start_date},symbol={self.symbol},venue={self.venue})"
 
     @staticmethod
     def get_response_type():

architect_py/{grpc_client → grpc/models}/Marketdata/HistoricalCandlesResponse.py

@@ -13,7 +13,7 @@ from .Candle import Candle
 class HistoricalCandlesResponse(Struct, omit_defaults=True):
     candles: List[Candle]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Marketdata/L1BookSnapshot.py

@@ -14,10 +14,37 @@ class L1BookSnapshot(Struct, omit_defaults=True):
     s: Annotated[str, Meta(title="symbol")]
     tn: Annotated[int, Meta(ge=0, title="timestamp_ns")]
     ts: Annotated[int, Meta(title="timestamp")]
-    a: Optional[Annotated[List[Decimal], Meta(title="best_ask")]] = None
-    b: Optional[Annotated[List[Decimal], Meta(title="best_bid")]] = None
-
-    # below is a constructor that takes all field titles as arguments for convenience
+    a: Optional[
+        Annotated[
+            List[Decimal], Meta(description="(price, quantity)", title="best_ask")
+        ]
+    ] = None
+    """
+    (price, quantity)
+    """
+    b: Optional[
+        Annotated[
+            List[Decimal], Meta(description="(price, quantity)", title="best_bid")
+        ]
+    ] = None
+    """
+    (price, quantity)
+    """
+    rt: Optional[
+        Annotated[
+            Optional[int],
+            Meta(
+                description="Time that Architect feed received the message; only set if streaming from direct L1 feeds",
+                title="recv_time",
+            ),
+        ]
+    ] = None
+    """
+    Time that Architect feed received the message; only set if streaming from direct L1 feeds
+    """
+    rtn: Optional[Annotated[Optional[int], Meta(title="recv_time_ns")]] = None
+
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,
@@ -26,6 +53,8 @@ class L1BookSnapshot(Struct, omit_defaults=True):
         timestamp: int,
         best_ask: Optional[List[Decimal]] = None,
         best_bid: Optional[List[Decimal]] = None,
+        recv_time: Optional[int] = None,
+        recv_time_ns: Optional[int] = None,
     ):
         return cls(
             symbol,
@@ -33,10 +62,12 @@ class L1BookSnapshot(Struct, omit_defaults=True):
             timestamp,
             best_ask,
             best_bid,
+            recv_time,
+            recv_time_ns,
         )
 
     def __str__(self) -> str:
-        return f"L1BookSnapshot(symbol={self.s},timestamp_ns={self.tn},timestamp={self.ts},best_ask={self.a},best_bid={self.b})"
+        return f"L1BookSnapshot(symbol={self.s},timestamp_ns={self.tn},timestamp={self.ts},best_ask={self.a},best_bid={self.b},recv_time={self.rt},recv_time_ns={self.rtn})"
 
     @property
     def symbol(self) -> str:
@@ -85,3 +116,19 @@ class L1BookSnapshot(Struct, omit_defaults=True):
     @best_bid.setter
     def best_bid(self, value: Optional[List[Decimal]]) -> None:
         self.b = value
+
+    @property
+    def recv_time(self) -> Optional[int]:
+        return self.rt
+
+    @recv_time.setter
+    def recv_time(self, value: Optional[int]) -> None:
+        self.rt = value
+
+    @property
+    def recv_time_ns(self) -> Optional[int]:
+        return self.rtn
+
+    @recv_time_ns.setter
+    def recv_time_ns(self, value: Optional[int]) -> None:
+        self.rtn = value

architect_py/{grpc_client → grpc/models}/Marketdata/L1BookSnapshotRequest.py

@@ -2,26 +2,31 @@
 #   filename:  Marketdata/L1BookSnapshotRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Marketdata.L1BookSnapshot import L1BookSnapshot
+from architect_py.grpc.models.Marketdata.L1BookSnapshot import L1BookSnapshot
+
+from typing import Optional
 
 from msgspec import Struct
 
 
 class L1BookSnapshotRequest(Struct, omit_defaults=True):
     symbol: str
+    venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,
         symbol: str,
+        venue: Optional[str] = None,
     ):
         return cls(
             symbol,
+            venue,
         )
 
     def __str__(self) -> str:
-        return f"L1BookSnapshotRequest(symbol={self.symbol})"
+        return f"L1BookSnapshotRequest(symbol={self.symbol},venue={self.venue})"
 
     @staticmethod
     def get_response_type():

architect_py/{grpc_client → grpc/models}/Marketdata/L1BookSnapshotsRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Marketdata/L1BookSnapshotsRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Marketdata.ArrayOfL1BookSnapshot import (
+from architect_py.grpc.models.Marketdata.ArrayOfL1BookSnapshot import (
     ArrayOfL1BookSnapshot,
     L1BookSnapshot,
 )
@@ -14,19 +14,22 @@ from msgspec import Struct
 
 class L1BookSnapshotsRequest(Struct, omit_defaults=True):
     symbols: Optional[List[str]] = None
+    venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,
         symbols: Optional[List[str]] = None,
+        venue: Optional[str] = None,
     ):
         return cls(
             symbols,
+            venue,
         )
 
     def __str__(self) -> str:
-        return f"L1BookSnapshotsRequest(symbols={self.symbols})"
+        return f"L1BookSnapshotsRequest(symbols={self.symbols},venue={self.venue})"
 
     @staticmethod
     def get_response_type():

architect_py/{grpc_client → grpc/models}/Marketdata/L2BookSnapshot.py

@@ -27,7 +27,7 @@ class L2BookSnapshot(Struct, omit_defaults=True):
     tn: Annotated[int, Meta(ge=0, title="timestamp_ns")]
     ts: Annotated[int, Meta(title="timestamp")]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Marketdata/L2BookSnapshotRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Marketdata/L2BookSnapshotRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Marketdata.L2BookSnapshot import L2BookSnapshot
+from architect_py.grpc.models.Marketdata.L2BookSnapshot import L2BookSnapshot
 
 from typing import Optional
 
@@ -13,7 +13,7 @@ class L2BookSnapshotRequest(Struct, omit_defaults=True):
     symbol: str
     venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Marketdata/Liquidation.py

@@ -2,7 +2,7 @@
 #   filename:  Marketdata/Liquidation.json
 
 from __future__ import annotations
-from architect_py.scalars import OrderDir
+from architect_py.common_types import OrderDir
 from datetime import datetime, timezone
 
 from decimal import Decimal
@@ -21,7 +21,7 @@ class Liquidation(Struct, omit_defaults=True):
     tn: Annotated[int, Meta(ge=0, title="timestamp_ns")]
     ts: Annotated[int, Meta(title="timestamp")]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Marketdata/MarketStatus.py

@@ -13,7 +13,7 @@ class MarketStatus(Struct, omit_defaults=True):
     is_quoting: Optional[bool] = None
     is_trading: Optional[bool] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Marketdata/MarketStatusRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Marketdata/MarketStatusRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Marketdata.MarketStatus import MarketStatus
+from architect_py.grpc.models.Marketdata.MarketStatus import MarketStatus
 
 from typing import Optional
 
@@ -13,7 +13,7 @@ class MarketStatusRequest(Struct, omit_defaults=True):
     symbol: str
     venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Marketdata/SubscribeCandlesRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Marketdata/SubscribeCandlesRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Marketdata.Candle import Candle
+from architect_py.grpc.models.Marketdata.Candle import Candle
 
 from typing import Annotated, List, Optional
 
@@ -24,7 +24,7 @@ class SubscribeCandlesRequest(Struct, omit_defaults=True):
     """
     venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Marketdata/SubscribeCurrentCandlesRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Marketdata/SubscribeCurrentCandlesRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Marketdata.Candle import Candle
+from architect_py.grpc.models.Marketdata.Candle import Candle
 
 from typing import Annotated, Optional
 
@@ -22,8 +22,7 @@ class SubscribeCurrentCandlesRequest(Struct, omit_defaults=True):
         Annotated[
             Optional[int],
             Meta(
-                description="If None, send the current candle on every trade or candle tick. Otherwise, send a candle every `tick_period_ms`.",
-                ge=0,
+                description="If None, send the current candle on every trade or candle tick. Otherwise, send a candle every `tick_period_ms`."
             ),
         ]
     ] = None
@@ -32,7 +31,7 @@ class SubscribeCurrentCandlesRequest(Struct, omit_defaults=True):
     """
     venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,