Cursor rule

1---
2description: XCTest patterns, unit vs integration-style tests, fixtures, stability
3globs:
4  - "ContentstackTest/**/*.{h,m}"
5---
6 
7# Testing Rules – Contentstack iOS CDA SDK
8 
9Apply when writing or editing tests in the **ContentstackTest** target.
10 
11## Test naming and layout
12 
13- **XCTest** case classes: suffix **`Test`** (e.g. `ContentstackMainTest`, `QueryResultTest`, `SyncTest`) matching existing files under **`ContentstackTest/`**.
14- **Test methods:** `- (void)test...` with descriptive names; group related tests with `#pragma mark` sections where the file already uses that style.
15 
16## Unit vs integration-style
17 
18- **Unit-style:** Mock or avoid network where possible; assert parsing, model behavior, and edge cases quickly.
19- **Integration-style:** Tests that call the live CDA require valid credentials—typically via **`config.json`** in the test bundle (see `ContentstackMainTest` and similar). Do not commit real tokens; document required keys for local/CI runs.
20 
21## XCTest usage
22 
23- Use **`XCTAssert*`** macros; use **`XCTestExpectation`** / **`waitForExpectationsWithTimeout:`** for async flows.
24- Use **`setUp`** / **`tearDown`** for fixtures; load JSON or plist resources from **`[NSBundle bundleForClass:[self class]]`** when the project uses bundle resources.
25 
26## Stability
27 
28- Avoid time-dependent assertions unless necessary; prefer reasonable timeouts for network tests.
29- Do not introduce flaky ordering assumptions or shared mutable global state across tests without synchronization.
30 
31## Coverage
32 
33- The **Contentstack** scheme enables code coverage for the **Contentstack** framework target. Add or extend tests when changing production behavior; do not drop coverage for critical paths without replacement tests.
34