Restructure modules and add documentation

[patrick91]

See #3542

• strawberry.auto -> strawberry.types.auto
• strawberry.private -> strawberry.types.private
• strawberry.enum -> strawberry.types.enum
• strawberry.union -> strawberry.types.union
• strawberry.lazy_type -> strawberry.types.lazy
• strawberry.unset -> strawberry.types.unset
• strawberry.custom_scalar -> strawberry.types.scalar
• strawberry.object_type -> strawberry.types.object_type
• strawberry.type -> strawberry.types.type
• strawberry.field -> strawberry.types.fields.field
• strawberry.mutation -> strawberry.types.fields.mutation
• strawberry.arguments -> strawberry.types.arguments

@bellini666 I've only added the ones that will go into the types module for now, I wonder if we should also move things like directives to the types module?

[botberry]

Apollo Federation Subgraph Compatibility Results

Federation 1 Support	Federation 2 Support
_service 🟢 @key (single) 🟢 @key (multi) 🟢 @key (composite) 🟢 repeatable @key 🟢 @requires 🟢 @provides 🟢 federated tracing 🔲	@link 🟢 @shareable 🟢 @tag 🟢 @override 🟢 @inaccessible 🟢 @composeDirective 🟢 @interfaceObject 🟢

Learn more:

• Apollo Federation Subgraph Specification
• Compatibility Tests

[codecov]

Codecov Report

Attention: Patch coverage is 97.38134% with 16 lines in your changes missing coverage. Please review.

Project coverage is 96.57%. Comparing base (bea5cac) to head (846c0f8).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3546      +/-   ##
==========================================
- Coverage   96.58%   96.57%   -0.02%     
==========================================
  Files         524      525       +1     
  Lines       33632    33870     +238     
  Branches     5577     5587      +10     
==========================================
+ Hits        32485    32711     +226     
- Misses        912      922      +10     
- Partials      235      237       +2     

[codspeed-hq]

CodSpeed Performance Report

Merging #3546 will not alter performance

_{Comparing feature/docstring (846c0f8) with main (bea5cac)}

Summary

✅ 13 untouched benchmarks

[bellini666]

@bellini666 I've only added the ones that will go into the types module for now, I wonder if we should also move things like directives to the types module?

IMO yes. I mean, unless we think that the way it is now is totally ok and we are never going to have to refactor that, I'd say better to do now and have a single "huge breaking" release than having to have another one later.

[patrick91]

@bellini666 I meant to have types/directive.py (or similar) instead of
strawberry/directives/schema_directive.py as suggested in the issue

[bellini666]

@bellini666 I meant to have types/directive.py (or similar) instead of strawberry/directives/schema_directive.py as suggested in the issue

Oh, I misunderstood the question haha

Totally ok by me to move it to types instead. Maybe types/directives is just over engineering =P

[DoctorJohn]

Awesome work @patrick91, loving it. I left a bunch of nits and at least three non-nits. Have a look :) I'm halfway trough the files, but need to get lunch now, I'll finish the rest later.

[DoctorJohn]

Second half done 🎉 Still excellent changes. Most of these comments are nits again, some non-nits here and there. (Feel free to ignore all the adjustments made to test docsstrings. I couldn't resist though).

[DoctorJohn]

Awesome work @patrick91! Looks good to me now. (note the typo in TWEET.md)

[patrick91]

time to merge