#include <simgear/props/props.hxx>
#include <simgear/misc/strutils.hxx>
+#include <simgear/structure/function_list.hxx>
#include <simgear/structure/SGReferenced.hxx>
#include <simgear/structure/SGSharedPtr.hxx>
class Package : public SGReferenced
{
public:
+
+ typedef boost::function<void(Package*, Install*)> InstallCallback;
+
/**
* get or create an install for the package
*/
InstallRef install();
-
+
+ InstallRef
+ existingInstall(const InstallCallback& cb = InstallCallback()) const;
+
bool isInstalled() const;
std::string id() const;
+
+ /**
+ * Variant IDs. Note the primary ID will always be included as
+ * variants()[0], to simplify enumerating all variants
+ */
+ string_list variants() const;
+
+ /**
+ * Fully-qualified ID, including our catalog'd ID
+ */
+ std::string qualifiedId() const;
+
+ /**
+ * Fully-qualified ID, including our catalog'd ID
+ */
+ std::string qualifiedVariantId(const unsigned int variantIndex) const;
/**
* human-readable name - note this is probably not localised,
* although this is not ruled out for the future.
*/
std::string name() const;
-
+
+ /**
+ * Human readable name of a variant
+ */
+ std::string nameForVariant(const std::string& vid) const;
+
+ std::string nameForVariant(const unsigned int vIndex) const;
+
/**
* syntactic sugar to get the localised description
*/
std::string getLocalisedProp(const std::string& aName) const;
unsigned int revision() const;
-
+
+ size_t fileSizeBytes() const;
+
CatalogRef catalog() const
{ return m_catalog; }
bool matches(const SGPropertyNode* aFilter) const;
-
+
+ string_set tags() const;
+
/**
* download URLs for the package
*/
string_list thumbnailUrls() const;
+ /**
+ * thumbnail file paths within the package on disk
+ */
+ string_list thumbnails() const;
+
/**
* Packages we depend upon.
* If the dependency list cannot be satisifed for some reason,
* this will raise an sg_exception.
*/
PackageList dependencies() const;
+
+ /**
+ * Name of the package directory on disk. This may or may not be the
+ * same as the primary ID, depending on the aircraft author
+ */
+ std::string dirName() const;
private:
+ SGPath pathOnDisk() const;
+
friend class Catalog;
+ friend class Root;
Package(const SGPropertyNode* aProps, CatalogRef aCatalog);
void initWithProps(const SGPropertyNode* aProps);
-
+
+ void updateFromProps(const SGPropertyNode* aProps);
+
std::string getLocalisedString(const SGPropertyNode* aRoot, const char* aName) const;
SGPropertyNode_ptr m_props;
+ std::string m_id;
string_set m_tags;
CatalogRef m_catalog;
+
+ mutable function_list<InstallCallback> _install_cb;
};