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

docs: Update the docstring of getDefaultSocket function #76

Merged
merged 1 commit into from Sep 15, 2020

Conversation

mykola-mokhnach
Copy link
Contributor

Related to #75

cc @qmfrederik

@qmfrederik
Copy link
Contributor

Thanks!

@@ -41,12 +41,21 @@ function swap16 (val) {
return ((val & 0xFF) << 8) | ((val >> 8) & 0xFF);
}

/**
* @typedef {Object} SocketOptions
* @property {?string} socketPath [/var/run/usbmuxd] The full path to the usbmuxd Unix socket
Copy link
Contributor

Choose a reason for hiding this comment

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

Just as a fyi, it may make sense to allow the caller to force TCP mode, even when on Linux/macOS. This can be useful, for example, when connecting to muxer on a remote host (for example, if usbmuxd and Appium are running in a different pod on a Kubernetes cluster, or, in more general terms, if the device is connected to a remote server).

For example, we could fall back to TCP mode if socketPath is null, or respect the USBMUXD_SOCKET_ADDRESS environment variable like libusbmuxd does.

I don't have an immediate use case for this now, but it came to mind, and thought it might be useful to share.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks for the info. To be honest, currently we don't really develop this module further, so we'd be happy to accept any improvements/fixes to it.

@mykola-mokhnach mykola-mokhnach merged commit a739ac3 into appium:master Sep 15, 2020
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

3 participants