Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove dependency on Swift-NIO SSL #254

Merged

Conversation

ethan-kusters
Copy link
Contributor

Bug/issue #, if applicable: rdar://93197483

Summary

This removes Swift-DocC's dependency on Swift-NIO SSL.

The removal is motivated by Swift-NIO SSL deprecating support for CentOS 7 due to BoringSSL removing support for CentOS 7.

Details

The Swift-NIO SSL dependency is currently used to support running a documentation preview server over HTTPS which allows users to preview content on a secondary device while authoring it on a primary device since many OS's won't allow accessing non-local content over HTTP.

With the introduction of --transform-for-static-hosting and the subsequent enabling of that feature by default, there's less need for Swift-DocC to ship a solution for this niche feature out-of-the-box since standard command-line based preview servers now support serving DocC archives with minimal additional configuration.

Testing

Run docc preview and confirm it continues to function as expected for the basic HTTP use case.

Checklist

Make sure you check off the following items. If they cannot be completed, provide a reason.

  • Added tests Code removal.
  • Ran the ./bin/test script and it succeeded
  • Updated documentation if necessary

@ethan-kusters
Copy link
Contributor Author

@swift-ci please test

@ethan-kusters ethan-kusters force-pushed the remove-swift-nio-ssl-dependency branch from c16e9e3 to fae61d1 Compare May 12, 2022 22:45
@ethan-kusters
Copy link
Contributor Author

@swift-ci please test

@ethan-kusters
Copy link
Contributor Author

@swift-ci please test macOS

@ethan-kusters
Copy link
Contributor Author

@swift-ci please test

1 similar comment
@ethan-kusters
Copy link
Contributor Author

@swift-ci please test

@franklinsch
Copy link
Member

@ethan-kusters Do we still need this PR?

@ethan-kusters
Copy link
Contributor Author

@ethan-kusters Do we still need this PR?

We do! Still something we should land on main. I just haven't time to do the end-to-end testing I'd like to do to be confident this won't break anything.

@ethan-kusters ethan-kusters force-pushed the remove-swift-nio-ssl-dependency branch from 56ff6f6 to fe1df6a Compare June 22, 2022 16:51
This removes Swift-DocC's dependency on Swift-NIO SSL.

The removal is motivated by Swift-NIO SSL deprecating support for CentOS 7 due
to BoringSSL removing support for CentOS 7.

The Swift-NIO SSL dependency is currently used to support running a
documentation preview server over HTTPS which allows users to preview content
on a secondary device while authoring it on a primary device since
many OS's won't allow accessing non-local content over HTTP.

With the introduction of `--transform-for-static-hosting` and the subsequent
enabling of that feature by default, there's less need for Swift-DocC to ship
a solution for this niche feature out-of-the-box since standard command-line
based preview servers now support serving DocC archives with minimal additional
configuration.

Resolves rdar://93197483.
@ethan-kusters
Copy link
Contributor Author

@swift-ci please test

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.

None yet

4 participants