2024-02-20 06:37:21 +00:00
|
|
|
from datetime import datetime, timedelta, timezone
|
|
|
|
from os import path
|
|
|
|
from urllib.parse import urlparse
|
|
|
|
|
|
|
|
from requests import Session
|
|
|
|
|
|
|
|
from .. import __version__
|
|
|
|
from .base import ContentProvider
|
|
|
|
|
|
|
|
|
|
|
|
class CKAN(ContentProvider):
|
|
|
|
"""Provide contents of a remote CKAN dataset."""
|
|
|
|
|
|
|
|
def __init__(self):
|
|
|
|
super().__init__()
|
|
|
|
self.session = Session()
|
|
|
|
self.session.headers.update(
|
|
|
|
{
|
|
|
|
"user-agent": f"repo2docker {__version__}",
|
|
|
|
}
|
|
|
|
)
|
|
|
|
|
|
|
|
def _fetch_version(self, api_url):
|
|
|
|
"""Fetch dataset modified date and convert to epoch.
|
|
|
|
Borrowed from the Hydroshare provider.
|
|
|
|
"""
|
|
|
|
package_show_url = f"{api_url}package_show?id={self.dataset_id}"
|
|
|
|
resp = self.urlopen(package_show_url).json()
|
|
|
|
date = resp["result"]["metadata_modified"]
|
|
|
|
parsed_date = datetime.strptime(date, "%Y-%m-%dT%H:%M:%S.%f")
|
|
|
|
epoch = parsed_date.replace(tzinfo=timezone(timedelta(0))).timestamp()
|
|
|
|
# truncate the timestamp
|
|
|
|
return str(int(epoch))
|
|
|
|
|
|
|
|
def _request(self, url, **kwargs):
|
|
|
|
return self.session.get(url, **kwargs)
|
|
|
|
|
|
|
|
urlopen = _request
|
|
|
|
|
|
|
|
def detect(self, source, ref=None, extra_args=None):
|
|
|
|
"""Trigger this provider for things that resolve to a CKAN dataset."""
|
|
|
|
parsed_url = urlparse(source)
|
|
|
|
if not parsed_url.netloc:
|
|
|
|
return None
|
|
|
|
|
2024-03-25 02:37:31 +00:00
|
|
|
url_parts = parsed_url.path.split("/")
|
|
|
|
if url_parts[-2] == "dataset":
|
|
|
|
self.dataset_id = url_parts[-1]
|
|
|
|
else:
|
|
|
|
return None
|
|
|
|
|
|
|
|
api_url_path = "/api/3/action/"
|
|
|
|
api_url = parsed_url._replace(path=api_url_path).geturl()
|
2024-02-20 06:37:21 +00:00
|
|
|
|
|
|
|
status_show_url = f"{api_url}status_show"
|
|
|
|
resp = self.urlopen(status_show_url)
|
|
|
|
if resp.status_code == 200:
|
|
|
|
self.version = self._fetch_version(api_url)
|
|
|
|
return {
|
|
|
|
"dataset_id": self.dataset_id,
|
|
|
|
"api_url": api_url,
|
|
|
|
"version": self.version,
|
|
|
|
}
|
|
|
|
else:
|
|
|
|
return None
|
|
|
|
|
|
|
|
def fetch(self, spec, output_dir, yield_output=False):
|
|
|
|
"""Fetch a CKAN dataset."""
|
|
|
|
dataset_id = spec["dataset_id"]
|
|
|
|
|
|
|
|
yield f"Fetching CKAN dataset {dataset_id}.\n"
|
|
|
|
package_show_url = f"{spec['api_url']}package_show?id={dataset_id}"
|
|
|
|
resp = self.urlopen(
|
|
|
|
package_show_url,
|
|
|
|
headers={"accept": "application/json"},
|
|
|
|
)
|
|
|
|
|
|
|
|
dataset = resp.json()
|
|
|
|
|
|
|
|
yield "Fetching CKAN resources.\n"
|
|
|
|
|
|
|
|
resources = dataset["result"]["resources"]
|
|
|
|
|
|
|
|
for resource in resources:
|
|
|
|
file_url = resource["url"]
|
|
|
|
fname = file_url.rsplit("/", maxsplit=1)[-1]
|
|
|
|
if fname == "":
|
|
|
|
fname = resource["id"]
|
|
|
|
|
|
|
|
yield f"Requesting {file_url}\n"
|
|
|
|
resp = self._request(file_url, stream=True)
|
|
|
|
resp.raise_for_status()
|
|
|
|
|
|
|
|
dst_fname = path.join(output_dir, fname)
|
|
|
|
with open(dst_fname, "wb") as dst:
|
|
|
|
yield f"Fetching {fname}\n"
|
|
|
|
for chunk in resp.iter_content(chunk_size=None):
|
|
|
|
dst.write(chunk)
|
|
|
|
|
|
|
|
@property
|
|
|
|
def content_id(self):
|
|
|
|
"""A unique ID to represent the version of the content."""
|
|
|
|
return f"{self.dataset_id}.v{self.version}"
|