Add filtering sandboxes by state in the SDKs

[mishushakov]

Adds a new optional param to filter sandboxes by state

[changeset-bot]

🦋 Changeset detected

Latest commit: bb86d48

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@e2b/python-sdk	Minor
e2b	Minor
@e2b/cli	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[mlejva]

@mishushakov please add a section to docs here mentioning how to list and delete paused sandboxes

[mlejva]

@mishushakov will deleting paused sandboxes be included in a separate PR? I'm asking because the new docs addition doesn't mention anything about deleting paused sandboxes.

Other than that, this looks good to me on the docs level

[mishushakov]

Yes, this will be a separate PR.

[mishushakov]

Nevermind, I have decided to add it here as well to avoid merge conflicts

[mlejva]

One more thing, I noticed that in Python, we support importing the state type:

from e2b.api.client.models.get_sandboxes_state import GetSandboxesState

sandboxes = Sandbox.list(state=GetSandboxesState.PAUSED)

but in JS we expect users to just pass a string:

const sandboxes = await Sandbox.list({ state: 'paused' })

Why not passing just a string for Python as well?

[mishushakov]

Has to do with the way we generate enum types for Python SDK, I will look, maybe there's a flag for string-style enums in the generator

[ValentaTomas]

Can we merge #532 first as support for that is already in API? Will the mentioned PR break if we later deploy the API pagination changes?

[mishushakov]

Merging #532. The PR should still work even with pagination changes.

[mishushakov]

superseded by #667