Free text search (q) for items

[ariaradick]

Hi,

I see that free text search (via the q parameter) is implemented for collections, I was wondering if it was planned to also support free text search for items?

Thank you

[vincentsarago]

It was added in #263 but it's not enabled by the default application because pgstac is not optimized for free-text search over items

we have an example app in the tests you can check

stac-fastapi-pgstac/tests/conftest.py

Lines 130 to 198 in f1b4215

	application_extensions = [
	TransactionExtension(client=TransactionsClient(), settings=api_settings),
	BulkTransactionExtension(client=BulkTransactionsClient()),
	]
	search_extensions = [
	QueryExtension(),
	SortExtension(),
	FieldsExtension(),
	SearchFilterExtension(client=FiltersClient()),
	TokenPaginationExtension(),
	FreeTextExtension(), # not recommended by PgSTAC
	]
	application_extensions.extend(search_extensions)
	collection_extensions = [
	QueryExtension(conformance_classes=[QueryConformanceClasses.COLLECTIONS]),
	SortExtension(conformance_classes=[SortConformanceClasses.COLLECTIONS]),
	FieldsExtension(conformance_classes=[FieldsConformanceClasses.COLLECTIONS]),
	CollectionSearchFilterExtension(client=FiltersClient()),
	FreeTextExtension(
	conformance_classes=[FreeTextConformanceClasses.COLLECTIONS],
	),
	OffsetPaginationExtension(),
	]
	collection_search_extension = CollectionSearchExtension.from_extensions(
	collection_extensions
	)
	application_extensions.append(collection_search_extension)
	item_collection_extensions = [
	QueryExtension(
	conformance_classes=[QueryConformanceClasses.ITEMS],
	),
	SortExtension(
	conformance_classes=[SortConformanceClasses.ITEMS],
	),
	FieldsExtension(conformance_classes=[FieldsConformanceClasses.ITEMS]),
	ItemCollectionFilterExtension(client=FiltersClient()),
	TokenPaginationExtension(),
	FreeTextExtension(), # not recommended by PgSTAC
	]
	application_extensions.extend(item_collection_extensions)
	items_get_request_model = create_request_model(
	model_name="ItemCollectionUri",
	base_model=ItemCollectionUri,
	extensions=item_collection_extensions,
	request_type="GET",
	)
	search_get_request_model = create_get_request_model(search_extensions)
	search_post_request_model = create_post_request_model(
	search_extensions, base_model=PgstacSearch
	)
	api = StacApi(
	settings=api_settings,
	extensions=application_extensions,
	client=CoreCrudClient(pgstac_search_model=search_post_request_model),
	items_get_request_model=items_get_request_model,
	search_get_request_model=search_get_request_model,
	search_post_request_model=search_post_request_model,
	collections_get_request_model=collection_search_extension.GET,
	response_class=JSONResponse,
	router=APIRouter(prefix=prefix),
	health_check=health_check,
	)
	return api