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

ref: Change module structure and visibility and require docs #1176

Merged
merged 3 commits into from
Jul 7, 2023

Conversation

flub
Copy link
Contributor

@flub flub commented Jul 6, 2023

This modifies the modules inside the crate structure and visibility.
Specifically it moves the config and command modules from the iroh
crate into the iroh binary. This could be a little confusing.
This means they are no longer part of the public API of the iroh
crate (and do not need to be documented).

It also fills in a few odd bits of missing doc comments and makes doc
comments required for public APIs on the crate.

When reviewing: the crux are the changes to main.rs and lib.rs.

This modifies the modules inside the crate structure and visibility.
Specifically it moves the `config` and `command` modules from the iroh
*crate* into the iroh *binary*.  This could be a little confusing.
This means they are no longer part of the public API of the iroh
crate (and do not need to be documented).

It also fills in a few odd bits of missing doc comments and makes doc
comments required for public APIs on the crate.
Copy link
Contributor

@divagant-martian divagant-martian left a comment

Choose a reason for hiding this comment

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

Don't think I'm in position to approve, but it makes sense to me to not expose cli stuff inside the library under a feature. If it's required by the lib and main ,it can be moved to the shared code (lib) later

Comment on lines -8 to -12

#[cfg(feature = "cli")]
pub mod commands;
#[cfg(feature = "cli")]
pub mod config;
Copy link
Contributor

Choose a reason for hiding this comment

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

looks cleaner to me

@flub flub enabled auto-merge (squash) July 7, 2023 10:10
@flub flub merged commit 81a0b1e into main Jul 7, 2023
@flub flub deleted the flub/iroh-doc-visibility branch July 7, 2023 10:44
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.

3 participants