Skip to content

Update wrappers README to cover wrapper versioning#240

Merged
jorajeev merged 2 commits intomainfrom
versioning
Jan 27, 2026
Merged

Update wrappers README to cover wrapper versioning#240
jorajeev merged 2 commits intomainfrom
versioning

Conversation

@sarsko
Copy link
Contributor

@sarsko sarsko commented Dec 4, 2025

Covers wrapper versioning.

Could include the alternatives to doing it like this, but that might also just add confusion.


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

```
[dependencies]
tokio = { package = "shuttle-tokio", version = "0.1.0" }
tokio-version-importer-do-not-use-directly = { version = "=1.36.0" }
Copy link
Member

Choose a reason for hiding this comment

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

This looks ugly - how about just writing

tokio = { package = ... }
tokio-version-pin = { version = "=1.36.0" }

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It being ugly is the point ? It's to protect against accidentally using it

```toml
[features]
shuttle = [
"PACKAGE_NAME/shuttle",
Copy link
Member

Choose a reason for hiding this comment

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

I still find this hard to read - since PACKAGE_NAME is a placeholder (i.e., acts like a variable).

I think this would be a lot more readable if we just used specific examples - users are smart enough to generalize:

shuttle = [
    "shuttle-tokio/shuttle",
    "shuttle-parking_lot/shuttle",
]

etc.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fair

@jorajeev jorajeev merged commit 49faea2 into main Jan 27, 2026
7 checks passed
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.

2 participants