#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>
+
typedef std::set<std::string> string_set;
namespace simgear
class Install;
class Catalog;
class Package;
+
+typedef SGSharedPtr<Package> PackageRef;
+typedef SGSharedPtr<Catalog> CatalogRef;
+typedef SGSharedPtr<Install> InstallRef;
-typedef std::vector<Package*> PackageList;
+typedef std::vector<PackageRef> PackageList;
-class Package
+ class Package : public SGReferenced
{
public:
+
+ typedef boost::function<void(Package*, Install*)> InstallCallback;
+
/**
* get or create an install for the package
*/
- Install* install();
-
+ 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 description() const;
/**
* access the raw property data in the package
std::string getLocalisedProp(const std::string& aName) const;
unsigned int revision() const;
-
- Catalog* catalog() 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, Catalog* aCatalog);
+ 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;
- Catalog* m_catalog;
+ CatalogRef m_catalog;
+
+ mutable function_list<InstallCallback> _install_cb;
};