API/Interface

[pgajek2]

How should the test library framework work from a developer’s perspective?

The API/interface should:

1. Be consistent with other Apex Fluently classes — a single class with interfaces defined at the top of the class.
2. Support a Factory, a Builder, or both.
3. Allow mocking of non-writable fields (e.g., formula fields, roll-up summary fields), possibly via a separate module.
4. Allow mocking relationships without using JSON.serialize and JSON.deserialize.
5. Allow creating more than one record.
6. Support default values.
7. Support variants for the same SObjectType.
8. Allow creating random data based on an index.
9. Test suite, so no need to query from TestSetup

[pgajek2]

public class TestData implements Builder {
   public interface Builder {
      Builder template(SObject prototype);
      Builder set(SObjectField field, Object value);
      Builder set(String field, Object value);

      SObject build();
      SObject buildAndInsert();
      List<SObject> buildMany(Integer amount);
      List<SObject> buildAndInsertMany(Integer amount);
   }
   
   public interface Variants {
   
   }
   
   public interface Randomizer {
   
   }
   
   public static of(SObjectType type) {
      return new TestData(type);
   }
   
   public TestData(SObjectType type) {
      // ...
   }
   
   // methods implementation
}

public class AccountTestBuilder extends TestData {
    public AccountTestBuilder() {
    
    }
}