Skip to content

feat(x509): add PkiPath type - #466

Merged
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath
Mar 7, 2022
Merged

feat(x509): add PkiPath type#466
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath

Conversation

@npmccallum

@npmccallumnpmccallum commented Mar 5, 2022

Copy link
Copy Markdown
Contributor

No description provided.

@npmccallum
npmccallumforce-pushed the pkipath branch 2 times, most recently from 952ba35 to 36449d1CompareMarch 5, 2022 20:52
Signed-off-by: Nathaniel McCallum <nathaniel@profian.com>
///
/// [RFC 6066]: https://datatracker.ietf.org/doc/html/rfc6066#section-10.1
#[derive(Clone, Debug, PartialEq, Eq, Default, Newtype)]
pub struct PkiPath<'a>(Vec<Certificate<'a>>);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like this could use some sort of accessor for the inner Certificates, such as AsRef<[Certificate<'a>]> and/or something that exposes an Iterator<Item=&Certificate<'a>>

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri Like #[derive(Newtype)]? :)

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh right, I forgot it was adding Deref/DerefMut impls.

Thinking about that again, doing that unilaterally somewhat defeats the point of having a newtype, since it effectively leaks the inner type and precludes adding your own inherent methods (at least if you want it to be an idiomatic use of Deref).

But that's something we can circle back on another day, I suppose.

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type, but allow the outer type to pick up implementations of traits relevant to specific contexts. Of note here is this new type: #479

This is particularly useful where an identical inner type is used in multiple contexts. A primary example of this is Vec<Extension> which has different OIDs in different contexts. The outer type determines which Identifiable instance to give to the inner type.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type

This description is antithetical to the typical notion of "newtype", which is to encapsulate the inner type

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri I don't think the invariants of "newtype" are that well defined. They are commonly used to allow the implementation of a trait from one crate on the type from a second crate within a third crate, which is roughly how we're using them here.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implicit deref coercion has somewhat magical and often surprising powers which allow you to transparently treat one type as another, which go well beyond what's typically meant by "newtype". It means you can't encapsulate the inner type, and it's a mandatory part of the public API.

A very common usage of the newtype pattern is to encapsulate another type to keep it out of the public API, so you can upgrade the dependency that provides the inner type without it resulting in a breaking change to the public API of the consumer providing the outer newtype.

@tarcieri
tarcieri merged commit 4ca4b07 into RustCrypto:masterMar 7, 2022
@npmccallum
npmccallum deleted the pkipath branch March 10, 2022 20:46
Sign up for freeto 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

@npmccallum@tarcieri
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
feat(x509): add PkiPath type by npmccallum · Pull Request #466 · RustCrypto/formats · GitHub
Skip to content

feat(x509): add PkiPath type - #466

Merged
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath
Mar 7, 2022
Merged

feat(x509): add PkiPath type#466
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath

Conversation

@npmccallum

@npmccallumnpmccallum commented Mar 5, 2022

Copy link
Copy Markdown
Contributor

No description provided.

@npmccallum
npmccallumforce-pushed the pkipath branch 2 times, most recently from 952ba35 to 36449d1CompareMarch 5, 2022 20:52
Signed-off-by: Nathaniel McCallum <nathaniel@profian.com>
///
/// [RFC 6066]: https://datatracker.ietf.org/doc/html/rfc6066#section-10.1
#[derive(Clone, Debug, PartialEq, Eq, Default, Newtype)]
pub struct PkiPath<'a>(Vec<Certificate<'a>>);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like this could use some sort of accessor for the inner Certificates, such as AsRef<[Certificate<'a>]> and/or something that exposes an Iterator<Item=&Certificate<'a>>

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri Like #[derive(Newtype)]? :)

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh right, I forgot it was adding Deref/DerefMut impls.

Thinking about that again, doing that unilaterally somewhat defeats the point of having a newtype, since it effectively leaks the inner type and precludes adding your own inherent methods (at least if you want it to be an idiomatic use of Deref).

But that's something we can circle back on another day, I suppose.

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type, but allow the outer type to pick up implementations of traits relevant to specific contexts. Of note here is this new type: #479

This is particularly useful where an identical inner type is used in multiple contexts. A primary example of this is Vec<Extension> which has different OIDs in different contexts. The outer type determines which Identifiable instance to give to the inner type.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type

This description is antithetical to the typical notion of "newtype", which is to encapsulate the inner type

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri I don't think the invariants of "newtype" are that well defined. They are commonly used to allow the implementation of a trait from one crate on the type from a second crate within a third crate, which is roughly how we're using them here.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implicit deref coercion has somewhat magical and often surprising powers which allow you to transparently treat one type as another, which go well beyond what's typically meant by "newtype". It means you can't encapsulate the inner type, and it's a mandatory part of the public API.

A very common usage of the newtype pattern is to encapsulate another type to keep it out of the public API, so you can upgrade the dependency that provides the inner type without it resulting in a breaking change to the public API of the consumer providing the outer newtype.

@tarcieri
tarcieri merged commit 4ca4b07 into RustCrypto:masterMar 7, 2022
@npmccallum
npmccallum deleted the pkipath branch March 10, 2022 20:46
Sign up for freeto 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

@npmccallum@tarcieri
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(x509): add PkiPath type by npmccallum · Pull Request #466 · RustCrypto/formats · GitHub
Skip to content

feat(x509): add PkiPath type - #466

Merged
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath
Mar 7, 2022
Merged

feat(x509): add PkiPath type#466
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath

Conversation

@npmccallum

@npmccallumnpmccallum commented Mar 5, 2022

Copy link
Copy Markdown
Contributor

No description provided.

@npmccallum
npmccallumforce-pushed the pkipath branch 2 times, most recently from 952ba35 to 36449d1CompareMarch 5, 2022 20:52
Signed-off-by: Nathaniel McCallum <nathaniel@profian.com>
///
/// [RFC 6066]: https://datatracker.ietf.org/doc/html/rfc6066#section-10.1
#[derive(Clone, Debug, PartialEq, Eq, Default, Newtype)]
pub struct PkiPath<'a>(Vec<Certificate<'a>>);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like this could use some sort of accessor for the inner Certificates, such as AsRef<[Certificate<'a>]> and/or something that exposes an Iterator<Item=&Certificate<'a>>

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri Like #[derive(Newtype)]? :)

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh right, I forgot it was adding Deref/DerefMut impls.

Thinking about that again, doing that unilaterally somewhat defeats the point of having a newtype, since it effectively leaks the inner type and precludes adding your own inherent methods (at least if you want it to be an idiomatic use of Deref).

But that's something we can circle back on another day, I suppose.

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type, but allow the outer type to pick up implementations of traits relevant to specific contexts. Of note here is this new type: #479

This is particularly useful where an identical inner type is used in multiple contexts. A primary example of this is Vec<Extension> which has different OIDs in different contexts. The outer type determines which Identifiable instance to give to the inner type.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type

This description is antithetical to the typical notion of "newtype", which is to encapsulate the inner type

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri I don't think the invariants of "newtype" are that well defined. They are commonly used to allow the implementation of a trait from one crate on the type from a second crate within a third crate, which is roughly how we're using them here.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implicit deref coercion has somewhat magical and often surprising powers which allow you to transparently treat one type as another, which go well beyond what's typically meant by "newtype". It means you can't encapsulate the inner type, and it's a mandatory part of the public API.

A very common usage of the newtype pattern is to encapsulate another type to keep it out of the public API, so you can upgrade the dependency that provides the inner type without it resulting in a breaking change to the public API of the consumer providing the outer newtype.

@tarcieri
tarcieri merged commit 4ca4b07 into RustCrypto:masterMar 7, 2022
@npmccallum
npmccallum deleted the pkipath branch March 10, 2022 20:46
Sign up for freeto 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

@npmccallum@tarcieri
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(x509): add PkiPath type by npmccallum · Pull Request #466 · RustCrypto/formats · GitHub
Skip to content

feat(x509): add PkiPath type - #466

Merged
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath
Mar 7, 2022
Merged

feat(x509): add PkiPath type#466
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath

Conversation

@npmccallum

@npmccallumnpmccallum commented Mar 5, 2022

Copy link
Copy Markdown
Contributor

No description provided.

@npmccallum
npmccallumforce-pushed the pkipath branch 2 times, most recently from 952ba35 to 36449d1CompareMarch 5, 2022 20:52
Signed-off-by: Nathaniel McCallum <nathaniel@profian.com>
///
/// [RFC 6066]: https://datatracker.ietf.org/doc/html/rfc6066#section-10.1
#[derive(Clone, Debug, PartialEq, Eq, Default, Newtype)]
pub struct PkiPath<'a>(Vec<Certificate<'a>>);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like this could use some sort of accessor for the inner Certificates, such as AsRef<[Certificate<'a>]> and/or something that exposes an Iterator<Item=&Certificate<'a>>

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri Like #[derive(Newtype)]? :)

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh right, I forgot it was adding Deref/DerefMut impls.

Thinking about that again, doing that unilaterally somewhat defeats the point of having a newtype, since it effectively leaks the inner type and precludes adding your own inherent methods (at least if you want it to be an idiomatic use of Deref).

But that's something we can circle back on another day, I suppose.

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type, but allow the outer type to pick up implementations of traits relevant to specific contexts. Of note here is this new type: #479

This is particularly useful where an identical inner type is used in multiple contexts. A primary example of this is Vec<Extension> which has different OIDs in different contexts. The outer type determines which Identifiable instance to give to the inner type.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type

This description is antithetical to the typical notion of "newtype", which is to encapsulate the inner type

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri I don't think the invariants of "newtype" are that well defined. They are commonly used to allow the implementation of a trait from one crate on the type from a second crate within a third crate, which is roughly how we're using them here.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implicit deref coercion has somewhat magical and often surprising powers which allow you to transparently treat one type as another, which go well beyond what's typically meant by "newtype". It means you can't encapsulate the inner type, and it's a mandatory part of the public API.

A very common usage of the newtype pattern is to encapsulate another type to keep it out of the public API, so you can upgrade the dependency that provides the inner type without it resulting in a breaking change to the public API of the consumer providing the outer newtype.

@tarcieri
tarcieri merged commit 4ca4b07 into RustCrypto:masterMar 7, 2022
@npmccallum
npmccallum deleted the pkipath branch March 10, 2022 20:46
Sign up for freeto 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

@npmccallum@tarcieri
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' feat(x509): add PkiPath type by npmccallum · Pull Request #466 · RustCrypto/formats · GitHub
Skip to content

feat(x509): add PkiPath type - #466

Merged
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath
Mar 7, 2022
Merged

feat(x509): add PkiPath type#466
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath

Conversation

@npmccallum

@npmccallumnpmccallum commented Mar 5, 2022

Copy link
Copy Markdown
Contributor

No description provided.

@npmccallum
npmccallumforce-pushed the pkipath branch 2 times, most recently from 952ba35 to 36449d1CompareMarch 5, 2022 20:52
Signed-off-by: Nathaniel McCallum <nathaniel@profian.com>
///
/// [RFC 6066]: https://datatracker.ietf.org/doc/html/rfc6066#section-10.1
#[derive(Clone, Debug, PartialEq, Eq, Default, Newtype)]
pub struct PkiPath<'a>(Vec<Certificate<'a>>);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like this could use some sort of accessor for the inner Certificates, such as AsRef<[Certificate<'a>]> and/or something that exposes an Iterator<Item=&Certificate<'a>>

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri Like #[derive(Newtype)]? :)

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh right, I forgot it was adding Deref/DerefMut impls.

Thinking about that again, doing that unilaterally somewhat defeats the point of having a newtype, since it effectively leaks the inner type and precludes adding your own inherent methods (at least if you want it to be an idiomatic use of Deref).

But that's something we can circle back on another day, I suppose.

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type, but allow the outer type to pick up implementations of traits relevant to specific contexts. Of note here is this new type: #479

This is particularly useful where an identical inner type is used in multiple contexts. A primary example of this is Vec<Extension> which has different OIDs in different contexts. The outer type determines which Identifiable instance to give to the inner type.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type

This description is antithetical to the typical notion of "newtype", which is to encapsulate the inner type

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri I don't think the invariants of "newtype" are that well defined. They are commonly used to allow the implementation of a trait from one crate on the type from a second crate within a third crate, which is roughly how we're using them here.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implicit deref coercion has somewhat magical and often surprising powers which allow you to transparently treat one type as another, which go well beyond what's typically meant by "newtype". It means you can't encapsulate the inner type, and it's a mandatory part of the public API.

A very common usage of the newtype pattern is to encapsulate another type to keep it out of the public API, so you can upgrade the dependency that provides the inner type without it resulting in a breaking change to the public API of the consumer providing the outer newtype.

@tarcieri
tarcieri merged commit 4ca4b07 into RustCrypto:masterMar 7, 2022
@npmccallum
npmccallum deleted the pkipath branch March 10, 2022 20:46
Sign up for freeto 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

@npmccallum@tarcieri
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(x509): add PkiPath type by npmccallum · Pull Request #466 · RustCrypto/formats · GitHub
Skip to content

feat(x509): add PkiPath type - #466

Merged
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath
Mar 7, 2022
Merged

feat(x509): add PkiPath type#466
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath

Conversation

@npmccallum

@npmccallumnpmccallum commented Mar 5, 2022

Copy link
Copy Markdown
Contributor

No description provided.

@npmccallum
npmccallumforce-pushed the pkipath branch 2 times, most recently from 952ba35 to 36449d1CompareMarch 5, 2022 20:52
Signed-off-by: Nathaniel McCallum <nathaniel@profian.com>
///
/// [RFC 6066]: https://datatracker.ietf.org/doc/html/rfc6066#section-10.1
#[derive(Clone, Debug, PartialEq, Eq, Default, Newtype)]
pub struct PkiPath<'a>(Vec<Certificate<'a>>);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like this could use some sort of accessor for the inner Certificates, such as AsRef<[Certificate<'a>]> and/or something that exposes an Iterator<Item=&Certificate<'a>>

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri Like #[derive(Newtype)]? :)

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh right, I forgot it was adding Deref/DerefMut impls.

Thinking about that again, doing that unilaterally somewhat defeats the point of having a newtype, since it effectively leaks the inner type and precludes adding your own inherent methods (at least if you want it to be an idiomatic use of Deref).

But that's something we can circle back on another day, I suppose.

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type, but allow the outer type to pick up implementations of traits relevant to specific contexts. Of note here is this new type: #479

This is particularly useful where an identical inner type is used in multiple contexts. A primary example of this is Vec<Extension> which has different OIDs in different contexts. The outer type determines which Identifiable instance to give to the inner type.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type

This description is antithetical to the typical notion of "newtype", which is to encapsulate the inner type

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri I don't think the invariants of "newtype" are that well defined. They are commonly used to allow the implementation of a trait from one crate on the type from a second crate within a third crate, which is roughly how we're using them here.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implicit deref coercion has somewhat magical and often surprising powers which allow you to transparently treat one type as another, which go well beyond what's typically meant by "newtype". It means you can't encapsulate the inner type, and it's a mandatory part of the public API.

A very common usage of the newtype pattern is to encapsulate another type to keep it out of the public API, so you can upgrade the dependency that provides the inner type without it resulting in a breaking change to the public API of the consumer providing the outer newtype.

@tarcieri
tarcieri merged commit 4ca4b07 into RustCrypto:masterMar 7, 2022
@npmccallum
npmccallum deleted the pkipath branch March 10, 2022 20:46
Sign up for freeto 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

@npmccallum@tarcieri
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat(x509): add PkiPath type by npmccallum · Pull Request #466 · RustCrypto/formats · GitHub
Skip to content

feat(x509): add PkiPath type - #466

Merged
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath
Mar 7, 2022
Merged

feat(x509): add PkiPath type#466
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath

Conversation

@npmccallum

@npmccallumnpmccallum commented Mar 5, 2022

Copy link
Copy Markdown
Contributor

No description provided.

@npmccallum
npmccallumforce-pushed the pkipath branch 2 times, most recently from 952ba35 to 36449d1CompareMarch 5, 2022 20:52
Signed-off-by: Nathaniel McCallum <nathaniel@profian.com>
///
/// [RFC 6066]: https://datatracker.ietf.org/doc/html/rfc6066#section-10.1
#[derive(Clone, Debug, PartialEq, Eq, Default, Newtype)]
pub struct PkiPath<'a>(Vec<Certificate<'a>>);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like this could use some sort of accessor for the inner Certificates, such as AsRef<[Certificate<'a>]> and/or something that exposes an Iterator<Item=&Certificate<'a>>

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri Like #[derive(Newtype)]? :)

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh right, I forgot it was adding Deref/DerefMut impls.

Thinking about that again, doing that unilaterally somewhat defeats the point of having a newtype, since it effectively leaks the inner type and precludes adding your own inherent methods (at least if you want it to be an idiomatic use of Deref).

But that's something we can circle back on another day, I suppose.

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type, but allow the outer type to pick up implementations of traits relevant to specific contexts. Of note here is this new type: #479

This is particularly useful where an identical inner type is used in multiple contexts. A primary example of this is Vec<Extension> which has different OIDs in different contexts. The outer type determines which Identifiable instance to give to the inner type.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type

This description is antithetical to the typical notion of "newtype", which is to encapsulate the inner type

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri I don't think the invariants of "newtype" are that well defined. They are commonly used to allow the implementation of a trait from one crate on the type from a second crate within a third crate, which is roughly how we're using them here.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implicit deref coercion has somewhat magical and often surprising powers which allow you to transparently treat one type as another, which go well beyond what's typically meant by "newtype". It means you can't encapsulate the inner type, and it's a mandatory part of the public API.

A very common usage of the newtype pattern is to encapsulate another type to keep it out of the public API, so you can upgrade the dependency that provides the inner type without it resulting in a breaking change to the public API of the consumer providing the outer newtype.

@tarcieri
tarcieri merged commit 4ca4b07 into RustCrypto:masterMar 7, 2022
@npmccallum
npmccallum deleted the pkipath branch March 10, 2022 20:46
Sign up for freeto 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

@npmccallum@tarcieri
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); feat(x509): add PkiPath type by npmccallum · Pull Request #466 · RustCrypto/formats · GitHub
Skip to content

feat(x509): add PkiPath type - #466

Merged
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath
Mar 7, 2022
Merged

feat(x509): add PkiPath type#466
tarcieri merged 1 commit into
RustCrypto:masterfrom
npmccallum:pkipath

Conversation

@npmccallum

@npmccallumnpmccallum commented Mar 5, 2022

Copy link
Copy Markdown
Contributor

No description provided.

@npmccallum
npmccallumforce-pushed the pkipath branch 2 times, most recently from 952ba35 to 36449d1CompareMarch 5, 2022 20:52
Signed-off-by: Nathaniel McCallum <nathaniel@profian.com>
///
/// [RFC 6066]: https://datatracker.ietf.org/doc/html/rfc6066#section-10.1
#[derive(Clone, Debug, PartialEq, Eq, Default, Newtype)]
pub struct PkiPath<'a>(Vec<Certificate<'a>>);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like this could use some sort of accessor for the inner Certificates, such as AsRef<[Certificate<'a>]> and/or something that exposes an Iterator<Item=&Certificate<'a>>

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri Like #[derive(Newtype)]? :)

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh right, I forgot it was adding Deref/DerefMut impls.

Thinking about that again, doing that unilaterally somewhat defeats the point of having a newtype, since it effectively leaks the inner type and precludes adding your own inherent methods (at least if you want it to be an idiomatic use of Deref).

But that's something we can circle back on another day, I suppose.

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type, but allow the outer type to pick up implementations of traits relevant to specific contexts. Of note here is this new type: #479

This is particularly useful where an identical inner type is used in multiple contexts. A primary example of this is Vec<Extension> which has different OIDs in different contexts. The outer type determines which Identifiable instance to give to the inner type.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The intent of newtype is to expose the inner type

This description is antithetical to the typical notion of "newtype", which is to encapsulate the inner type

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tarcieri I don't think the invariants of "newtype" are that well defined. They are commonly used to allow the implementation of a trait from one crate on the type from a second crate within a third crate, which is roughly how we're using them here.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implicit deref coercion has somewhat magical and often surprising powers which allow you to transparently treat one type as another, which go well beyond what's typically meant by "newtype". It means you can't encapsulate the inner type, and it's a mandatory part of the public API.

A very common usage of the newtype pattern is to encapsulate another type to keep it out of the public API, so you can upgrade the dependency that provides the inner type without it resulting in a breaking change to the public API of the consumer providing the outer newtype.

@tarcieri
tarcieri merged commit 4ca4b07 into RustCrypto:masterMar 7, 2022
@npmccallum
npmccallum deleted the pkipath branch March 10, 2022 20:46
Sign up for freeto 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

@npmccallum@tarcieri