Skip to content

Conversation

beccadax
Copy link
Contributor

@beccadax beccadax commented Nov 3, 2020

This pull request begins to implement "module selectors", which allow references to declarations to be unambiguously prefixed with a module they can be found through:

class MyClass: ObjectiveC::NSObject {}  // OK, ObjectiveC defines NSObject
class MyClass: Foundation::NSObject {}  // OK, Foundation re-exports NSObject
class MyClass: Swift::NSObject {}       // error, Swift does not re-export or define NSObject
class MyClass: MyModule::NSObject {}    // error, MyModule does not re-export or define NSObject

This PR parses module selectors and partially implements lookup and diagnostics for them. The new functionality is hidden behind an -enable-experimental-module-selector frontend flag. There is one diagnostic regression with that flag enabled, but I've made sure that it keeps working when the diagnostic is disabled.

This work was previously in PR #28834, which was closed during the master-to-main transition. I've updated it to work on modern compilers, including removing some FIXMEs for bad diagnostics that have improved since December 2019.

Makes progress on rdar://problem/19481048.

@beccadax beccadax changed the title Module selectors Implement experimental module selectors (MyMod::someName) feature Nov 3, 2020
@beccadax beccadax force-pushed the mod-squad-2 branch 3 times, most recently from eb8ecdf to b6d41f6 Compare July 21, 2021 20:18
@nkcsgexi
Copy link
Contributor

Woohoo! Thank you for reviving this, Becca!

A PatternBindingEntry formed from a MissingPatternSyntax has no valid SourceLocs in it, and a PatternBindingDecl containing only PatternBindingEntries with no valid SourceLocs trips an assertion during availability checking. (Generating dummy SourceLocs can cause invalid overlaps between AvailabilityScopes, so that’s not a workable solution.) The fix is to:

• Refuse to generate a PatternBindingEntry from a PatternBindingSyntax with a MissingPatternSyntax (MissingPatternSyntaxes at nested positions don’t have this problem)
• Refuse to generate a PatternBindingDecl with no PatternBindingEntries

This ensures that the invalid AST nodes are never formed.

No current test cases hit this problem, but certain invalid module selector tests can run into this situation when run with ASTGen.
@beccadax
Copy link
Contributor Author

@swift-ci build toolchain macOS platform

@beccadax beccadax changed the title Implement experimental module selectors (MyMod::someName) feature [SE-0491] Implement experimental module selectors (MyMod::someName) Sep 17, 2025
The `_Concurrency` and `_StringProcessing` modules are implementation details of the standard library; to developers, their contents should behave as though they are declared directly within module `Swift`. This is the exact same behavior we expect of cross-import overlays, so treat these modules as though they are cross-import overlays with no bystanding module.

Because these modules don’t re-export the standard library, it’s also necessary to treat `Swift` as a separately imported overlay of itself; do so and make that actually work.
The diagnostics in this test will evolve as we implement pieces of the feature.
In this commit, this change affects certain diagnostics but doesn’t actually alter name lookup behavior yet.
Adds comments explaining why these conversions aren’t lossy.
Lookups like Builtin::Int64 were failing because BuiltinUnit rejected all unqualified lookups. Make it allow unqualified lookups with a module selector.
This support is currently opt-in and has several modes.
• A module selector which specifies module `Foo` will also select declarations in cross-import overlays declared by `Foo`.
• Module selector-related diagnostics for a declaration in a cross-import overlay will recommend naming the declaring module in the module selector (taking advantage of the above).

The overall effect is to preserve the illusion that declarations in cross-import overlays belong to the declaring module.

This also applies to the standard library’s separately-imported overlays.
In code like the following:

```
protocol P { associatedtype A: Hashable }
protocol Q { associatedtype A: Comparable }

func fn<T: P & Q>(_: T) where T.A == Int { … }
```

`T.A` is actually the union of `P.A` and `Q.A`—it satisfies both associated types and has both of their constraints. This means it doesn’t actually make sense to apply a module selector to `A`—even if `P` and `Q` are in different modules, `T.A` always represents both of the declarations, not one or the other. We therefore now ban module selectors in this position, since they don’t actually jibe with the nature of a generic signature.

This justification technically doesn’t hold for *every* member type of a generic parameter—a member type can refer to a concrete typealias in a protocol extension, for instance—but in those situations, you can disambiguate (and add module selectors) by writing `P.A` or `Q.A` instead of `T.A`, so we’re not really worried about this limitation.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants