// Logic for getting information about and installing packages

#pragma once

#include <stdbool.h>

#include "ast.h"
#include "stdlib/datatypes.h"

Text_t get_package_name(Path_t lib_dir);
OptionalPath_t find_installed_package(Table_t *build_info, ast_t *use);
// The store entry (a .tomo/store/<digest>/ directory) containing the given path, if any:
OptionalPath_t package_store_entry(Path_t path);
// The --package-sources entry (<package sources dir>/<digest>/) containing the given path, if any:
OptionalPath_t package_sources_entry(Path_t path);
// The store directory a digest installs to (strips the "sha256:" prefix, since a colon isn't a valid Windows filename
// character):
Path_t package_store_path(Path_t store_root, const char *digest);
// The hex part of a "sha256:<hex>" digest, i.e. what package_store_path() uses as the directory name:
const char *package_digest_hex(const char *digest);
// Vendor the named package into the current project's vendor/ directory:
void vendor_package(const char *name, bool editable);
// The inverse: restore a vendored package to a non-vendored source and delete the vendored copy:
void unvendor_package(const char *name);
// The pinned digest for `name` per the ini chain a use in `using_file` consults (parse-only), or NULL:
const char *find_pinned_digest(Path_t using_file, const char *name);
// The --package-sources directory (a directory of package sources by digest), if one is active:
OptionalPath_t package_sources_dir(void);
// Activate a --package-sources directory for this process and nested tomo invocations:
void set_package_sources_dir(Path_t dir);
// Sync packages.ini's `unused=true` markers with the binding names actually in use:
void mark_unused_packages(Path_t ini_file, Table_t used_names);