Progress

Author: desiena

.coveragerc

@@ -0,0 +1,7 @@
+[run]
+omit =
+    tests/*
+
+[report]
+omit =
+    tests/*

.gitignore

@@ -123,6 +123,8 @@ celerybeat.pid
 
 # Environments
 tests/.env
+tests/.env_fms17
+tests/.env_fms22
 .venv
 env/
 venv/

README.md

@@ -87,13 +87,15 @@ students = Student.objects.order_by("pk").find(full_name__raw="*")
 
 # Find students with exact match (equivalent to __exact)
 student_john = Student.objects.find(full_name="John Doe")  # Searches for exact match
-students_of_2024_but_not_john = Student.objects.find(graduation_year=2024).omit(full_name="John Doe") # Searches for students graduating in 2024 but not named John Doe
+students_of_2024_but_not_john = Student.objects.find(graduation_year=2024).omit(
+    full_name="John Doe")  # Searches for students graduating in 2024 but not named John Doe
 
 # Query with chunking and portal prefetching
 result_set = (Student.objects
               .order_by("pk")
-              .find(full_name__raw="*") # __raw means filemaker raw query, so it will search for all students with a non-empty full_name
-              .chunk_size(1000) # Call the API in chunks of 1000 records (in this example, it will return all students)
+              .find(
+    full_name__raw="*")  # __raw means filemaker raw query, so it will search for all students with a non-empty full_name
+              .chunking(1000)  # Call the API in chunks of 1000 records (in this example, it will return all students)
               .prefetch_portal("classes", limit=100)
               )[:1000]  # Limit to first 1000 records
 
@@ -196,7 +198,7 @@ first_10 = Student.objects.find()[0:10]
 next_10 = Student.objects.find()[10:20]
 
 # Chunked processing for large datasets
-for student in Student.objects.find().chunk_size(1000):
+for student in Student.objects.find().chunking(1000):
     process_student(student)
 ```
 
@@ -217,7 +219,7 @@ for student in students:
     classes = student.classes.only_prefetched() 
 
     # Or force to fetch fresh portal data
-    classes = student.classes.avoid_prefetch_cache() 
+    classes = student.classes.ignore_prefetched() 
 
     # Create new portal records
     student.classes.create(name="New Class", description="Description")

data_types.txt

@@ -0,0 +1,6 @@
+Pay attention:
+if you use Float you can lose precision during reading both with Number and Text. (use Decimal or String if you need full precision)
+if you use DateTime, if you have timezone information, you will lose timezone information while writing to FMFieldType.DateTime. If you write to FMFieldType.Text it will write the full ISO rappresentation of the datetime, so no timezone information will be lost.
+if you use String -> FMFieldType.DateTime, the string has to be an ISO rappresentation. If it have timezone information, it will be lost.
+if you use Container -> To update the container value, use model.update_container(container_name, file) the model.refresh_from_db()
+if you use Bool -> set true_value=X, false_value=Y, to choose what to write in the field. Set truthy=[list of values considered true] and falsy=[list of values considered false] to choose what to consider true/false when reading from FM

fmdata/__init__.py

@@ -1,3 +1,14 @@
 from .const import FMErrorEnum
-from .fmclient import FMClient
-from .orm import Model, PortalField, PortalModel, PortalManager
+from .fmclient import FMClient, FMVersion
+from .orm import Model, PortalField, PortalModel, PortalManager
+from .fmd_fields import (
+    FMFieldType,
+    String,
+    Integer,
+    Float,
+    Decimal,
+    Bool,
+    Date,
+    DateTime,
+    Time,
+)