feat: add vessel_tags filter to Vessels.search()

[alexspeddingvortexa]

RELATED TICKETS

• ad-hoc

CHANGELOG

• Added vessel_tags and vessel_tags_excluded parameters to Vessels.search() to support filtering vessels by tags (e.g. vessel_fso_tag, vessel_decommissioned_tag)
• Bumped version to 1.0.29

TESTS

• Added 4 unit tests verifying vessel_tags and vessel_tags_excluded are correctly passed through to the API (single tag, multiple tags, exclusion)

COMMENTS

• Follows the same pattern used by other endpoints (CargoMovements, VoyagesTimeseries, etc.) for vessel tag filtering

USAGE EXAMPLE

Install from this branch:

pip install git+https://github.com/VorTECHsa/python-sdk.git@feat/vessel-tags-filter

Then use:

from vortexasdk import Vessels
from vortexasdk.api.shared_types import Tag

# Fetch all FSO vessels
vessels = Vessels().search(
    vessel_tags=[Tag(tag="vessel_fso_tag")],
).to_df(columns=["name", "imo", "mmsi", "vessel_class", "tags"])

print(f"Found {len(vessels)} FSO vessels")
print(vessels.to_string())

Or run the included script from a local clone of this branch:

./venv/bin/python scripts/fetch_fso_vessels.py

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds vessel tag filtering support to the Vessels.search() reference endpoint, aligning it with tag-filter patterns used across other endpoints and releasing the change as version 1.0.29.

Changes:

• Added vessel_tags and vessel_tags_excluded parameters to Vessels.search().
• Passed these parameters through in the request payload.
• Added unit tests covering single/multiple tag inclusion and exclusion; bumped SDK version to 1.0.29.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File	Description
vortexasdk/version.py	Bumps SDK version to 1.0.29.
vortexasdk/endpoints/vessels.py	Adds vessel_tags/vessel_tags_excluded parameters and includes them in api_params.
tests/endpoints/test_vessels.py	Adds unit tests asserting the new params are passed through to the client call.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[kdalkas]

lgtm