privacy: Substitute type aliases in private-in-public checker by petrochenkov · Pull Request #34193 · rust-lang/rust

petrochenkov · 2016-06-09T23:43:32Z

Everyone in the issue discussion seemed to be in favor, @huonw also spoke about this here, but the issue haven't got any movement.
I think it's reasonable to do this before turning private_in_public warnings into errors.

r? @nikomatsakis

jseyfried · 2016-06-12T21:23:10Z

I'm having trouble seeing why this is an error.

Priv2 is used in a public interface through an alias.
The error location here is suboptimal. On one hand Priv2 is the true source of the error and pointing to PrivAlias is misleading, on the other hand pointing to Priv2 is confusing too, because the public interface it's used in is not pointed to.
Ideally, there should be two diagnostic messages - one for the public interface location and the other for actual private type location. I'll implement this if positive decision about the whole PR is made.

Ahh, makes sense.

I'm confused a bit. This seems like it's causing a new error?

This seems like it's causing a new error?
No, the error from line 211 (alias location) migrated to this line (aliased type location).

Ideally, there should be two diagnostic messages - one for the public interface location and the other for actual private type location.
I implemented the extra note for the private type location for type aliases, but dropped it, the situation should be rare, likely happens in advanced code and doesn't worth the extra code.
Now the error is reported at the public interface location only.

nikomatsakis · 2016-06-27T16:17:12Z

can we add a test to show that no error results?

It's tested, the check is just moved from this file to private-in-public-warn.rs

nikomatsakis · 2016-06-27T16:19:22Z

Ideally, we would fix rustdoc to not use private type aliases as part of this PR.

petrochenkov · 2016-06-28T22:38:47Z

Ideally, we would fix rustdoc to not use private type aliases as part of this PR.

I'll try to fix this and the error locations tomorrow. If I won't be able to, it'll have to wait for another week or so. (I also don't think these are blockers for merging the PR)

petrochenkov · 2016-07-03T14:39:04Z

fix rustdoc to not use private type aliases

Curiously, rustdoc doesn't currently substitute private use aliases.

use std::result::Result as MyResult;
pub fn get_result() -> MyResult<u8, u16> { // Still displayed as MyResult by rustdoc
panic!();
}

nikomatsakis · 2016-07-07T17:46:54Z

@petrochenkov I guess it's debatable what's the right thing to do there. I mean, the link still goes to the right place, I guess, and it's not clear that showing the full path will help readability overall. (And the full path in that crate may not be the same as the full path from another crate.) In any case, it feels different, because MyResult is a name the user can use, even if their path to it is different.

petrochenkov · 2016-07-08T09:20:44Z

Updated with rustdoc changes and tweaked error locations.

bors · 2016-07-15T19:46:20Z

☔ The latest upstream changes (presumably #34570) made this pull request unmergeable. Please resolve the merge conflicts.

petrochenkov · 2016-07-15T20:41:40Z

Rebased.

nikomatsakis · 2016-08-10T20:21:43Z

will this logic work if you have a private type alias that refers to another private type alias?
e.g., type A = u32; type B = A; fn foo(x: B) { }?
(Can you also add some tests for that scenario? I could imagine that even if your patch gets it right, it's something future patches might easily break.)

nikomatsakis · 2016-08-10T20:22:01Z

r=me once new tests are added for recursive scenario

…ublic interface location

petrochenkov · 2016-08-10T22:17:15Z

Updated with a test for recursive substitution.

nikomatsakis · 2016-08-11T14:44:23Z

@bors r+

bors · 2016-08-11T14:44:24Z

📌 Commit 5d4ae4b has been approved by nikomatsakis

bors · 2016-08-11T17:09:11Z

⌛ Testing commit 5d4ae4b with merge 11f8805...

@huonw

privacy: Substitute type aliases in private-in-public checker Closes#30503Closes#34293 Everyone in the issue discussion seemed to be in favor, @huonw also spoke about this [here](https://www.reddit.com/r/rust/comments/3xldr9/surfaces_and_signatures_component_privacy_versus/cy615wq), but the issue haven't got any movement. I think it's reasonable to do this before turning `private_in_public` warnings into errors. r? @nikomatsakis

bors · 2016-08-11T20:14:26Z

☀️ Test successful - auto-linux-32-nopt-t, auto-linux-32-opt, auto-linux-64-cargotest, auto-linux-64-cross-freebsd, auto-linux-64-debug-opt, auto-linux-64-nopt-t, auto-linux-64-opt, auto-linux-64-opt-no-mir, auto-linux-64-opt-rustbuild, auto-linux-64-x-android-t, auto-linux-cross-opt, auto-linux-musl-64-opt, auto-mac-32-opt, auto-mac-64-opt, auto-mac-64-opt-rustbuild, auto-mac-cross-ios-opt, auto-win-gnu-32-opt, auto-win-gnu-32-opt-rustbuild, auto-win-gnu-64-opt, auto-win-msvc-32-opt, auto-win-msvc-64-cargotest, auto-win-msvc-64-opt, auto-win-msvc-64-opt-no-mir, auto-win-msvc-64-opt-rustbuild
Approved by: nikomatsakis
Pushing 11f8805 to master...

rust-highfive assigned nikomatsakis Jun 9, 2016

jseyfried reviewed Jun 12, 2016
View reviewed changes

petrochenkov mentioned this pull request Jun 16, 2016
Rust complains about "private type in public interface" even though the type and interface are both aliases. #34293
Closed

nikomatsakis reviewed Jun 27, 2016
View reviewed changes

petrochenkov force-pushed the privalias branch from 3657e37 to af0df95Compare June 28, 2016 22:47

nikomatsakis mentioned this pull request Jul 1, 2016
Make private_in_public compatibility lint deny-by-default #34206
Merged

petrochenkov force-pushed the privalias branch from af0df95 to 5679896Compare July 8, 2016 09:19

petrochenkov force-pushed the privalias branch from 5679896 to 91063fcCompare July 15, 2016 20:41

nikomatsakis reviewed Aug 10, 2016
View reviewed changes

petrochenkov added 4 commits August 11, 2016 00:32

privacy: Substitute type aliases in private-in-public checker
b7db9e8

Substitute private type aliases in rustdoc
08f0f7c

privacy: Move private-in-public diagnostics for type aliases to the p…
d43b9cb
…ublic interface location

Add test for recursive private alias substitution in rustdoc
5d4ae4b

petrochenkov force-pushed the privalias branch from 91063fc to 5d4ae4bCompare August 10, 2016 21:52

bors merged commit 5d4ae4b into rust-lang:masterAug 11, 2016

petrochenkov deleted the privalias branch September 21, 2016 20:01

Uh oh!

Uh oh!

Conversation

petrochenkov commented Jun 9, 2016• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

petrochenkovJun 12, 2016• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

nikomatsakis commented Jun 27, 2016

Uh oh!

petrochenkov commented Jun 28, 2016• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

petrochenkov commented Jul 3, 2016

Uh oh!

nikomatsakis commented Jul 7, 2016

Uh oh!

petrochenkov commented Jul 8, 2016

Uh oh!

bors commented Jul 15, 2016

Uh oh!

petrochenkov commented Jul 15, 2016

Uh oh!

Choose a reason for hiding this comment

Uh oh!

nikomatsakis commented Aug 10, 2016

Uh oh!

petrochenkov commented Aug 10, 2016

Uh oh!

nikomatsakis commented Aug 11, 2016

Uh oh!

bors commented Aug 11, 2016

Uh oh!

bors commented Aug 11, 2016

Uh oh!

bors commented Aug 11, 2016

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

petrochenkov commented Jun 9, 2016•
edited
Loading

petrochenkovJun 12, 2016•
edited
Loading

petrochenkov commented Jun 28, 2016•
edited
Loading