lib: add xbps_pkg_{path,url,path_or_url} functions

Author: Duncaen

include/xbps.h.in

@@ -2037,7 +2037,7 @@ bool xbps_remote_binpkg_exists(struct xbps_handle *xhp, xbps_dictionary_t pkgd);
  */
 bool xbps_repository_is_remote(const char *uri);
 
-/*
+/**
  * Returns an allocated string with the full path to the binary package
  * matching \a pkgd.
  *
@@ -2054,6 +2054,59 @@ bool xbps_repository_is_remote(const char *uri);
  */
 char *xbps_repository_pkg_path(struct xbps_handle *xhp, xbps_dictionary_t pkgd);
 
+/**
+ * Put the path to the binary package \a pkgd into \a dst.
+ *
+ * The \a pkgd dictionary must contain the following objects:
+ *  - architecture (string)
+ *  - pkgver (string)
+ *  - repository (string)
+ *
+ * @param[in] xhp Pointer to an xbps_handle struct.
+ * @param[in] dst Destination buffer.
+ * @param[in] dstsz Destination buffer size.
+ * @param[in] pkgd Package dictionary.
+ *
+ * @return The length of the path or a negative errno on error.
+ * @retval -EINVAL Missing required dictionary entry.
+ * @retval -ENOBUFS The path would exceed the supplied \a dst buffer.
+ */
+ssize_t xbps_pkg_path(struct xbps_handle *xhp, char *dst, size_t dstsz, xbps_dictionary_t pkgd);
+
+/**
+ * Put the url to the binary package \a pkgd into \a dst.
+ *
+ * The \a pkgd dictionary must contain the following objects:
+ *  - architecture (string)
+ *  - pkgver (string)
+ *  - repository (string)
+ *
+ * @param[in] xhp The pointer to an xbps_handle struct.
+ * @param[in] pkgd The package dictionary to match.
+ *
+ * @return The length of the path or a negative errno on error.
+ * @retval -EINVAL Missing required dictionary entry.
+ * @retval -ENOBUFS The path would exceed the supplied \a dst buffer.
+ */
+ssize_t xbps_pkg_url(struct xbps_handle *xhp, char *dst, size_t dstsz, xbps_dictionary_t pkgd);
+
+/**
+ * Put the url or path (if cached) to the binary package \a pkgd into \a dst.
+ *
+ * The \a pkgd dictionary must contain the following objects:
+ *  - architecture (string)
+ *  - pkgver (string)
+ *  - repository (string)
+ *
+ * @param[in] xhp The pointer to an xbps_handle struct.
+ * @param[in] pkgd The package dictionary to match.
+ *
+ * @return The length of the path or a negative errno on error.
+ * @retval -EINVAL Missing required dictionary entry.
+ * @retval -ENOBUFS The path would exceed the supplied \a dst buffer.
+ */
+ssize_t xbps_pkg_path_or_url(struct xbps_handle *xhp, char *dst, size_t dstsz, xbps_dictionary_t pkgd);
+
 /**
  * Gets the name of a package string. Package strings are composed
  * by a @<pkgname@>/@<version@> pair and separated by the *minus*

lib/util.c

@@ -327,6 +327,74 @@ xbps_pkgpattern_version(const char *pkg)
 	return strpbrk(pkg, "><*?[]");
 }
 
+ssize_t
+xbps_pkg_path(struct xbps_handle *xhp, char *dst, size_t dstsz, xbps_dictionary_t pkgd)
+{
+	const char *pkgver = NULL, *arch = NULL, *repoloc = NULL;
+	int l;
+
+	if (!xbps_dictionary_get_cstring_nocopy(pkgd, "pkgver", &pkgver) ||
+	    !xbps_dictionary_get_cstring_nocopy(pkgd, "architecture", &arch) ||
+	    !xbps_dictionary_get_cstring_nocopy(pkgd, "repository", &repoloc))
+		return -EINVAL;
+
+	if (xbps_repository_is_remote(repoloc))
+		repoloc = xhp->cachedir;
+
+	l = snprintf(dst, dstsz, "%s/%s.%s.xbps", repoloc, pkgver, arch);
+	if (l < 0 || (size_t)l >= dstsz)
+		return -ENOBUFS;
+
+	return l;
+}
+
+ssize_t
+xbps_pkg_url(struct xbps_handle *xhp UNUSED, char *dst, size_t dstsz, xbps_dictionary_t pkgd)
+{
+	const char *pkgver = NULL, *arch = NULL, *repoloc = NULL;
+	int l;
+
+	if (!xbps_dictionary_get_cstring_nocopy(pkgd, "pkgver", &pkgver) ||
+	    !xbps_dictionary_get_cstring_nocopy(pkgd, "architecture", &arch) ||
+	    !xbps_dictionary_get_cstring_nocopy(pkgd, "repository", &repoloc))
+		return -EINVAL;
+
+	l = snprintf(dst, dstsz, "%s/%s.%s.xbps", repoloc, pkgver, arch);
+	if (l < 0 || (size_t)l >= dstsz)
+		return -ENOBUFS;
+
+	return l;
+}
+
+ssize_t
+xbps_pkg_path_or_url(struct xbps_handle *xhp UNUSED, char *dst, size_t dstsz, xbps_dictionary_t pkgd)
+{
+	const char *pkgver = NULL, *arch = NULL, *repoloc = NULL;
+	int l;
+
+	if (!xbps_dictionary_get_cstring_nocopy(pkgd, "pkgver", &pkgver) ||
+	    !xbps_dictionary_get_cstring_nocopy(pkgd, "architecture", &arch) ||
+	    !xbps_dictionary_get_cstring_nocopy(pkgd, "repository", &repoloc))
+		return -EINVAL;
+
+	if (xbps_repository_is_remote(repoloc)) {
+		l = snprintf(dst, dstsz, "%s/%s.%s.xbps", xhp->cachedir,
+		    pkgver, arch);
+		if (l < 0 || (size_t)l >= dstsz)
+			return -ENOBUFS;
+		if (access(dst, R_OK) == 0)
+			return l;
+		if (errno != ENOENT)
+			return -errno;
+	}
+
+	l = snprintf(dst, dstsz, "%s/%s.%s.xbps", repoloc, pkgver, arch);
+	if (l < 0 || (size_t)l >= dstsz)
+		return -ENOBUFS;
+
+	return l;
+}
+
 char *
 xbps_repository_pkg_path(struct xbps_handle *xhp, xbps_dictionary_t pkg_repod)
 {