enh: sort search results by creation date instead of score and modified date

Author: paulmueller

CHANGELOG

@@ -1,6 +1,7 @@
 0.17.5
  - fix: error handling when connection to server fails on download (#75)
  - enh: add `CKANAPI.hostname`
+ - enh: sort search results by creation date instead of score and modified date
  - ref: replace `user_list` with `user_autocomplete`
  - ref: replace `search_dataset` with `search_dataset_via_api`
    in `APIInterrogator`; `search_dataset` is now only free text search.

dcoraid/dbmodel/db_api.py

@@ -137,6 +137,7 @@ def search_dataset_via_api(self,
                                circles: list[str] = None,
                                collections: list[str] = None,
                                circle_collection_union: bool = False,
+                               sort_solr: str = "metadata_created desc",
                                limit: int = 100):
         """Search datasets via the CKAN API
 
@@ -155,6 +156,11 @@ def search_dataset_via_api(self,
             sets. Otherwise (default), search only for datasets that
             are at least member of one of the circles and one of the
             collections.
+        sort_solr: str
+            SOLR search ordering. By default, sort according to dataset
+            creation date `'metadata_created desc'`. The CKAN default is
+            `'score desc, metadata_modified desc'`.
+            https://docs.ckan.org/en/latest/api/index.html#ckan.logic.action.get.package_search
         limit: int
             limit number of search results; Set to 0 to get all results
         """
@@ -216,6 +222,7 @@ def search_dataset_via_api(self,
                                 fq=final_fq,
                                 include_private=(self.mode == "user"),
                                 rows=rows,
+                                sort=sort_solr,
                                 start=num_retrieved,
                                 )
             if np.isinf(num_total):