Skip to content

remove RSN4c, add RTS4b (channels#release)#1057

Merged
tbedford merged 4 commits intomainfrom
fix/channels#release
Jul 31, 2021
Merged

remove RSN4c, add RTS4b (channels#release)#1057
tbedford merged 4 commits intomainfrom
fix/channels#release

Conversation

@tiholic
Copy link
Copy Markdown
Contributor

@tiholic tiholic commented Mar 22, 2021

channels#release in should raise error in realtime for specific states and should return without error in rest

RSN4c should be put under RTS4

Discussion: https://ably-real-time.slack.com/archives/C030C5YLY/p1615715227000800

`channels#release` in should raise error in realtime for specific states and should return without error in rest
@mattheworiordan mattheworiordan temporarily deployed to ably-docs-pr-1057 March 22, 2021 07:19 Inactive
@tiholic tiholic requested review from QuintinWillison and SimonWoolf and removed request for QuintinWillison March 22, 2021 07:19
@tiholic tiholic changed the title remove RSN4c, add RTS4b remove RSN4c, add RTS4b (channels#release) Mar 22, 2021
*** @(RTS3c1)@ If a new set of @ChannelOptions@ is supplied to @Channels#get@ that would trigger a reattachment of the channel if supplied to @Channel#setOptions@ per "@RTL16a@":#RTL16a, it must raise an error, informing the user that they must use @Channel#setOptions@ instead
* @(RTS4)@ @Channels#release@ function:
** @(RTS4a)@ Detaches the channel and then releases the channel resource i.e. it's deleted and can then be garbage collected
** @(RTS4b)@ Calling @release()@ with a channel name that corresponds to a channel that is in any state other than @INITIALIZED@, @DETACHED@, or @FAILED@ must, instead of releasing the channel, raise an error with code @90001@
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.

So now these two spec items contradict each other - if you call release on an attached channel, should it detach then release, or raise an error?

My suggestion in the slack thread was just get rid of RSN4c entirely

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@SimonWoolf I lost context after a long gap. Removing RTS4b is what we are looking for, is it?

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.

yes

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@SimonWoolf removed

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Resolving this conversation on @SimonWoolf's behalf.

@tbedford
Copy link
Copy Markdown
Contributor

@tiholic @SimonWoolf @QuintinWillison - is there any follow up on this? Are we able to resolve? If not should I close this PR? Thanks!

@tiholic
Copy link
Copy Markdown
Contributor Author

tiholic commented May 20, 2021

@tbedford we can land this PR after make necessary changes. Thanks for your patience :)

@QuintinWillison
Copy link
Copy Markdown
Contributor

This pull request will need more work. See this internal discussion in relation to the safe removal of spec points, where those spec points are at the end of a list.

@tiholic
Copy link
Copy Markdown
Contributor Author

tiholic commented Jun 25, 2021

@QuintinWillison @tbedford @SimonWoolf necessary changes have been made.

@QuintinWillison
Copy link
Copy Markdown
Contributor

@tbedford This is ready to land but I'll leave that to your team, when you're ready.

@tbedford
Copy link
Copy Markdown
Contributor

@QuintinWillison - Looks good to me, however I can't merge until the feedback from @SimonWoolf is attended to. Thanks.

@tbedford tbedford requested a review from SimonWoolf July 30, 2021 16:51
@tbedford tbedford merged commit bb3b6af into main Jul 31, 2021
@tbedford tbedford deleted the fix/channels#release branch July 31, 2021 07:32
m-hulbert pushed a commit that referenced this pull request Aug 19, 2021
QuintinWillison pushed a commit to ably/specification that referenced this pull request Sep 20, 2022
ttypic pushed a commit to ably/specification that referenced this pull request Mar 6, 2026
ttypic pushed a commit to ably/specification that referenced this pull request Mar 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

6 participants