@cpp.js/package-gdal 1.0.0-beta.22 → 1.0.0

package/dist/prebuilt/Android-x86_64/include/cpl_http.h

@@ -0,0 +1,319 @@
+/******************************************************************************
+ * $Id$
+ *
+ * Project:  Common Portability Library
+ * Purpose:  Function wrapper for libcurl HTTP access.
+ * Author:   Frank Warmerdam, warmerdam@pobox.com
+ *
+ ******************************************************************************
+ * Copyright (c) 2006, Frank Warmerdam
+ * Copyright (c) 2009, Even Rouault <even dot rouault at spatialys.com>
+ *
+ * SPDX-License-Identifier: MIT
+ ****************************************************************************/
+
+#ifndef CPL_HTTP_H_INCLUDED
+#define CPL_HTTP_H_INCLUDED
+
+#include "cpl_conv.h"
+#include "cpl_string.h"
+#include "cpl_progress.h"
+#include "cpl_vsi.h"
+
+/**
+ * \file cpl_http.h
+ *
+ * Interface for downloading HTTP, FTP documents
+ */
+
+/*! @cond Doxygen_Suppress */
+#ifndef CPL_HTTP_MAX_RETRY
+#define CPL_HTTP_MAX_RETRY 0
+#endif
+
+#ifndef CPL_HTTP_RETRY_DELAY
+#define CPL_HTTP_RETRY_DELAY 30.0
+#endif
+/*! @endcond */
+
+CPL_C_START
+
+/*! Describe a part of a multipart message */
+typedef struct
+{
+    /*! NULL terminated array of headers */ char **papszHeaders;
+
+    /*! Buffer with data of the part     */ GByte *pabyData;
+    /*! Buffer length                    */ int nDataLen;
+} CPLMimePart;
+
+/*! Describe the result of a CPLHTTPFetch() call */
+typedef struct
+{
+    /*! cURL error code : 0=success, non-zero if request failed */
+    int nStatus;
+
+    /*! Content-Type of the response */
+    char *pszContentType;
+
+    /*! Error message from curl, or NULL */
+    char *pszErrBuf;
+
+    /*! Length of the pabyData buffer */
+    int nDataLen;
+    /*! Allocated size of the pabyData buffer */
+    int nDataAlloc;
+
+    /*! Buffer with downloaded data */
+    GByte *pabyData;
+
+    /*! Headers returned */
+    char **papszHeaders;
+
+    /*! Number of parts in a multipart message */
+    int nMimePartCount;
+
+    /*! Array of parts (resolved by CPLHTTPParseMultipartMime()) */
+    CPLMimePart *pasMimePart;
+
+} CPLHTTPResult;
+
+/*! @cond Doxygen_Suppress */
+typedef size_t (*CPLHTTPFetchWriteFunc)(void *pBuffer, size_t nSize,
+                                        size_t nMemb, void *pWriteArg);
+/*! @endcond */
+
+int CPL_DLL CPLHTTPEnabled(void);
+CPLHTTPResult CPL_DLL *CPLHTTPFetch(const char *pszURL,
+                                    CSLConstList papszOptions);
+CPLHTTPResult CPL_DLL *
+CPLHTTPFetchEx(const char *pszURL, CSLConstList papszOptions,
+               GDALProgressFunc pfnProgress, void *pProgressArg,
+               CPLHTTPFetchWriteFunc pfnWrite, void *pWriteArg);
+CPLHTTPResult CPL_DLL **CPLHTTPMultiFetch(const char *const *papszURL,
+                                          int nURLCount, int nMaxSimultaneous,
+                                          CSLConstList papszOptions);
+
+void CPL_DLL CPLHTTPCleanup(void);
+void CPL_DLL CPLHTTPDestroyResult(CPLHTTPResult *psResult);
+void CPL_DLL CPLHTTPDestroyMultiResult(CPLHTTPResult **papsResults, int nCount);
+int CPL_DLL CPLHTTPParseMultipartMime(CPLHTTPResult *psResult);
+
+void CPL_DLL CPLHTTPSetDefaultUserAgent(const char *pszUserAgent);
+
+/* -------------------------------------------------------------------- */
+/* To install an alternate network layer to the default Curl one        */
+/* -------------------------------------------------------------------- */
+/** Callback function to process network requests.
+ *
+ * If CLOSE_PERSISTENT is found in papszOptions, no network request should be
+ * issued, but a dummy non-null CPLHTTPResult* should be returned by the
+ * callback.
+ *
+ * Its first arguments are the same as CPLHTTPFetchEx()
+ * @param pszURL See CPLHTTPFetchEx()
+ * @param papszOptions See CPLHTTPFetchEx()
+ * @param pfnProgress See CPLHTTPFetchEx()
+ * @param pProgressArg See CPLHTTPFetchEx()
+ * @param pfnWrite See CPLHTTPFetchEx()
+ * @param pWriteArg See CPLHTTPFetchEx()
+ * @param pUserData user data value that was passed during
+ * CPLHTTPPushFetchCallback()
+ * @return nullptr if the request cannot be processed, in which case the
+ * previous handler will be used.
+ */
+typedef CPLHTTPResult *(*CPLHTTPFetchCallbackFunc)(
+    const char *pszURL, CSLConstList papszOptions, GDALProgressFunc pfnProgress,
+    void *pProgressArg, CPLHTTPFetchWriteFunc pfnWrite, void *pWriteArg,
+    void *pUserData);
+
+void CPL_DLL CPLHTTPSetFetchCallback(CPLHTTPFetchCallbackFunc pFunc,
+                                     void *pUserData);
+
+int CPL_DLL CPLHTTPPushFetchCallback(CPLHTTPFetchCallbackFunc pFunc,
+                                     void *pUserData);
+int CPL_DLL CPLHTTPPopFetchCallback(void);
+
+/* -------------------------------------------------------------------- */
+/*      The following is related to OAuth2 authorization around         */
+/*      google services like fusion tables, and potentially others      */
+/*      in the future.  Code in cpl_google_oauth2.cpp.                  */
+/*                                                                      */
+/*      These services are built on CPL HTTP services.                  */
+/* -------------------------------------------------------------------- */
+
+char CPL_DLL *GOA2GetAuthorizationURL(const char *pszScope);
+char CPL_DLL *GOA2GetRefreshToken(const char *pszAuthToken,
+                                  const char *pszScope);
+char CPL_DLL *GOA2GetAccessToken(const char *pszRefreshToken,
+                                 const char *pszScope);
+
+char CPL_DLL **GOA2GetAccessTokenFromServiceAccount(
+    const char *pszPrivateKey, const char *pszClientEmail, const char *pszScope,
+    CSLConstList papszAdditionalClaims, CSLConstList papszOptions);
+
+char CPL_DLL **GOA2GetAccessTokenFromCloudEngineVM(CSLConstList papszOptions);
+
+CPL_C_END
+
+#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
+/*! @cond Doxygen_Suppress */
+// Not sure if this belong here, used in cpl_http.cpp, cpl_vsil_curl.cpp and
+// frmts/wms/gdalhttp.cpp
+void CPL_DLL *CPLHTTPSetOptions(void *pcurl, const char *pszURL,
+                                const char *const *papszOptions);
+char **CPLHTTPGetOptionsFromEnv(const char *pszFilename);
+
+/** Stores HTTP retry parameters */
+struct CPLHTTPRetryParameters
+{
+    int nMaxRetry = CPL_HTTP_MAX_RETRY;
+    double dfInitialDelay = CPL_HTTP_RETRY_DELAY;
+    std::string osRetryCodes{};
+
+    CPLHTTPRetryParameters() = default;
+    explicit CPLHTTPRetryParameters(const CPLStringList &aosHTTPOptions);
+};
+
+/** HTTP retry context */
+class CPLHTTPRetryContext
+{
+  public:
+    explicit CPLHTTPRetryContext(const CPLHTTPRetryParameters &oParams);
+
+    bool CanRetry(int response_code, const char *pszErrBuf,
+                  const char *pszCurlError);
+    bool CanRetry();
+
+    /** Returns the delay to apply. Only valid after a successful call to CanRetry() */
+    double GetCurrentDelay() const;
+
+    /** Reset retry counter. */
+    void ResetCounter()
+    {
+        m_nRetryCount = 0;
+    }
+
+  private:
+    CPLHTTPRetryParameters m_oParameters{};
+    int m_nRetryCount = 0;
+    double m_dfCurDelay = 0.0;
+    double m_dfNextDelay = 0.0;
+};
+
+void CPL_DLL *CPLHTTPIgnoreSigPipe();
+void CPL_DLL CPLHTTPRestoreSigPipeHandler(void *old_handler);
+bool CPLMultiPerformWait(void *hCurlMultiHandle, int &repeats);
+/*! @endcond */
+
+bool CPL_DLL CPLIsMachinePotentiallyGCEInstance();
+bool CPLIsMachineForSureGCEInstance();
+
+/** Manager of Google OAuth2 authentication.
+ *
+ * This class handles different authentication methods and handles renewal
+ * of access token.
+ *
+ * @since GDAL 2.3
+ */
+class GOA2Manager
+{
+  public:
+    GOA2Manager();
+
+    /** Authentication method */
+    typedef enum
+    {
+        NONE,
+        GCE,
+        ACCESS_TOKEN_FROM_REFRESH,
+        SERVICE_ACCOUNT
+    } AuthMethod;
+
+    bool SetAuthFromGCE(CSLConstList papszOptions);
+    bool SetAuthFromRefreshToken(const char *pszRefreshToken,
+                                 const char *pszClientId,
+                                 const char *pszClientSecret,
+                                 CSLConstList papszOptions);
+    bool SetAuthFromServiceAccount(const char *pszPrivateKey,
+                                   const char *pszClientEmail,
+                                   const char *pszScope,
+                                   CSLConstList papszAdditionalClaims,
+                                   CSLConstList papszOptions);
+
+    /** Returns the authentication method. */
+    AuthMethod GetAuthMethod() const
+    {
+        return m_eMethod;
+    }
+
+    const char *GetBearer() const;
+
+    /** Returns private key for SERVICE_ACCOUNT method */
+    const CPLString &GetPrivateKey() const
+    {
+        return m_osPrivateKey;
+    }
+
+    /** Returns client email for SERVICE_ACCOUNT method */
+    const CPLString &GetClientEmail() const
+    {
+        return m_osClientEmail;
+    }
+
+    /** Returns a key that can be used to uniquely identify the instance
+     * parameters (excluding bearer)
+     */
+    std::string GetKey() const
+    {
+        std::string osKey(std::to_string(static_cast<int>(m_eMethod))
+                              .append(",client-id=")
+                              .append(m_osClientId)
+                              .append(",client-secret=")
+                              .append(m_osClientSecret)
+                              .append(",refresh-token=")
+                              .append(m_osRefreshToken)
+                              .append(",private-key=")
+                              .append(m_osPrivateKey)
+                              .append(",client-email=")
+                              .append(m_osClientEmail)
+                              .append(",scope=")
+                              .append(m_osScope));
+        osKey.append(",additional-claims=");
+        for (const auto *pszOption : m_aosAdditionalClaims)
+        {
+            osKey.append(pszOption);
+            osKey.append("+");
+        }
+        osKey.append(",options=");
+        for (const auto *pszOption : m_aosOptions)
+        {
+            osKey.append(pszOption);
+            osKey.append("+");
+        }
+        return osKey;
+    }
+
+  private:
+    mutable CPLString m_osCurrentBearer{};
+    mutable time_t m_nExpirationTime = 0;
+
+    AuthMethod m_eMethod = NONE;
+
+    // for ACCESS_TOKEN_FROM_REFRESH
+    CPLString m_osClientId{};
+    CPLString m_osClientSecret{};
+    CPLString m_osRefreshToken{};
+
+    // for SERVICE_ACCOUNT
+    CPLString m_osPrivateKey{};
+    CPLString m_osClientEmail{};
+    CPLString m_osScope{};
+    CPLStringList m_aosAdditionalClaims{};
+
+    CPLStringList m_aosOptions{};
+};
+
+#endif  // __cplusplus
+
+#endif /* ndef CPL_HTTP_H_INCLUDED */

package/dist/prebuilt/Android-x86_64/include/cpl_json.h

@@ -0,0 +1,301 @@
+/******************************************************************************
+ * Project:  Common Portability Library
+ * Purpose:  Function wrapper for libjson-c access.
+ * Author:   Dmitry Baryshnikov, dmitry.baryshnikov@nextgis.com
+ *
+ ******************************************************************************
+ * Copyright (c) 2017-2018 NextGIS, <info@nextgis.com>
+ *
+ * SPDX-License-Identifier: MIT
+ ****************************************************************************/
+
+#ifndef CPL_JSON_H_INCLUDED
+#define CPL_JSON_H_INCLUDED
+
+#include "cpl_progress.h"
+#include "cpl_string.h"
+
+#include <cstdint>
+#include <string>
+#include <vector>
+
+/**
+ * \file cpl_json.h
+ *
+ * Interface for read and write JSON documents
+ */
+
+/*! @cond Doxygen_Suppress */
+typedef void *JSONObjectH;
+
+CPL_C_START
+
+class CPLJSONArray;
+
+/*! @endcond */
+
+/**
+ * @brief The CPLJSONArray class holds JSON object from CPLJSONDocument
+ */
+class CPL_DLL CPLJSONObject
+{
+    friend class CPLJSONArray;
+    friend class CPLJSONDocument;
+
+  public:
+    /**
+     * Json object types
+     */
+    enum class Type
+    {
+        Unknown,
+        Null,
+        Object,
+        Array,
+        Boolean,
+        String,
+        Integer,
+        Long,
+        Double
+    };
+
+    /**
+     * Json object format to string options
+     */
+    enum class PrettyFormat
+    {
+        Plain,   ///< No extra whitespace or formatting applied
+        Spaced,  ///< Minimal whitespace inserted
+        Pretty   ///< Formatted output
+    };
+
+  public:
+    /*! @cond Doxygen_Suppress */
+    CPLJSONObject();
+    explicit CPLJSONObject(const std::string &osName,
+                           const CPLJSONObject &oParent);
+    explicit CPLJSONObject(std::nullptr_t);
+    explicit CPLJSONObject(const std::string &osVal);
+    explicit CPLJSONObject(const char *pszValue);
+    explicit CPLJSONObject(bool bVal);
+    explicit CPLJSONObject(int nVal);
+    explicit CPLJSONObject(int64_t nVal);
+    explicit CPLJSONObject(uint64_t nVal);
+    explicit CPLJSONObject(double dfVal);
+    ~CPLJSONObject();
+    CPLJSONObject(const CPLJSONObject &other);
+    CPLJSONObject(CPLJSONObject &&other);
+    CPLJSONObject &operator=(const CPLJSONObject &other);
+    CPLJSONObject &operator=(CPLJSONObject &&other);
+
+    // This method is not thread-safe
+    CPLJSONObject Clone() const;
+
+  private:
+    explicit CPLJSONObject(const std::string &osName, JSONObjectH poJsonObject);
+    /*! @endcond */
+
+  public:
+    // setters
+    void Add(const std::string &osName, const std::string &osValue);
+    void Add(const std::string &osName, const char *pszValue);
+    void Add(const std::string &osName, double dfValue);
+    void Add(const std::string &osName, int nValue);
+    void Add(const std::string &osName, GInt64 nValue);
+    void Add(const std::string &osName, uint64_t nValue);
+    void Add(const std::string &osName, const CPLJSONArray &oValue);
+    void Add(const std::string &osName, const CPLJSONObject &oValue);
+    void AddNoSplitName(const std::string &osName, const CPLJSONObject &oValue);
+    void Add(const std::string &osName, bool bValue);
+    void AddNull(const std::string &osName);
+
+    void Set(const std::string &osName, const std::string &osValue);
+    void Set(const std::string &osName, const char *pszValue);
+    void Set(const std::string &osName, double dfValue);
+    void Set(const std::string &osName, int nValue);
+    void Set(const std::string &osName, GInt64 nValue);
+    void Set(const std::string &osName, uint64_t nValue);
+    void Set(const std::string &osName, bool bValue);
+    void SetNull(const std::string &osName);
+
+    /*! @cond Doxygen_Suppress */
+    JSONObjectH GetInternalHandle() const
+    {
+        return m_poJsonObject;
+    }
+
+    /*! @endcond */
+
+    // getters
+    std::string GetString(const std::string &osName,
+                          const std::string &osDefault = "") const;
+    double GetDouble(const std::string &osName, double dfDefault = 0.0) const;
+    int GetInteger(const std::string &osName, int nDefault = 0) const;
+    GInt64 GetLong(const std::string &osName, GInt64 nDefault = 0) const;
+    bool GetBool(const std::string &osName, bool bDefault = false) const;
+    std::string ToString(const std::string &osDefault = "") const;
+    double ToDouble(double dfDefault = 0.0) const;
+    int ToInteger(int nDefault = 0) const;
+    GInt64 ToLong(GInt64 nDefault = 0) const;
+    bool ToBool(bool bDefault = false) const;
+    CPLJSONArray ToArray() const;
+    std::string Format(PrettyFormat eFormat) const;
+
+    //
+    void Delete(const std::string &osName);
+    void DeleteNoSplitName(const std::string &osName);
+    CPLJSONArray GetArray(const std::string &osName) const;
+    CPLJSONObject GetObj(const std::string &osName) const;
+    CPLJSONObject operator[](const std::string &osName) const;
+    Type GetType() const;
+
+    /*! @cond Doxygen_Suppress */
+    std::string GetName() const
+    {
+        return m_osKey;
+    }
+
+    /*! @endcond */
+
+    std::vector<CPLJSONObject> GetChildren() const;
+    bool IsValid() const;
+    void Deinit();
+
+  protected:
+    /*! @cond Doxygen_Suppress */
+    CPLJSONObject GetObjectByPath(const std::string &osPath,
+                                  std::string &osName) const;
+    /*! @endcond */
+
+  private:
+    JSONObjectH m_poJsonObject = nullptr;
+    std::string m_osKey{};
+};
+
+/**
+ * @brief The JSONArray class JSON array from JSONDocument
+ */
+class CPL_DLL CPLJSONArray : public CPLJSONObject
+{
+    friend class CPLJSONObject;
+    friend class CPLJSONDocument;
+
+  public:
+    /*! @cond Doxygen_Suppress */
+    CPLJSONArray();
+    explicit CPLJSONArray(const std::string &osName);
+    explicit CPLJSONArray(const CPLJSONObject &other);
+
+  private:
+    explicit CPLJSONArray(const std::string &osName, JSONObjectH poJsonObject);
+
+    class CPL_DLL ConstIterator
+    {
+        const CPLJSONArray &m_oSelf;
+        int m_nIdx;
+        mutable CPLJSONObject m_oObj{};
+
+      public:
+        ConstIterator(const CPLJSONArray &oSelf, bool bStart)
+            : m_oSelf(oSelf), m_nIdx(bStart ? 0 : oSelf.Size())
+        {
+        }
+
+        ~ConstIterator() = default;
+
+        CPLJSONObject &operator*() const
+        {
+            m_oObj = m_oSelf[m_nIdx];
+            return m_oObj;
+        }
+
+        ConstIterator &operator++()
+        {
+            m_nIdx++;
+            return *this;
+        }
+
+        bool operator==(const ConstIterator &it) const
+        {
+            return m_nIdx == it.m_nIdx;
+        }
+
+        bool operator!=(const ConstIterator &it) const
+        {
+            return m_nIdx != it.m_nIdx;
+        }
+    };
+
+    /*! @endcond */
+  public:
+    int Size() const;
+    void AddNull();
+    void Add(const CPLJSONObject &oValue);
+    void Add(const std::string &osValue);
+    void Add(const char *pszValue);
+    void Add(double dfValue);
+    void Add(int nValue);
+    void Add(GInt64 nValue);
+    void Add(uint64_t nValue);
+    void Add(bool bValue);
+    CPLJSONObject operator[](int nIndex);
+    const CPLJSONObject operator[](int nIndex) const;
+
+    /** Iterator to first element */
+    ConstIterator begin() const
+    {
+        return ConstIterator(*this, true);
+    }
+
+    /** Iterator to after last element */
+    ConstIterator end() const
+    {
+        return ConstIterator(*this, false);
+    }
+};
+
+/**
+ * @brief The CPLJSONDocument class Wrapper class around json-c library
+ */
+class CPL_DLL CPLJSONDocument
+{
+  public:
+    /*! @cond Doxygen_Suppress */
+    CPLJSONDocument();
+    ~CPLJSONDocument();
+    CPLJSONDocument(const CPLJSONDocument &other);
+    CPLJSONDocument &operator=(const CPLJSONDocument &other);
+    CPLJSONDocument(CPLJSONDocument &&other);
+    CPLJSONDocument &operator=(CPLJSONDocument &&other);
+    /*! @endcond */
+
+    bool Save(const std::string &osPath) const;
+    std::string SaveAsString() const;
+
+    CPLJSONObject GetRoot();
+    const CPLJSONObject GetRoot() const;
+    void SetRoot(const CPLJSONObject &oRoot);
+    bool Load(const std::string &osPath);
+    bool LoadMemory(const std::string &osStr);
+    bool LoadMemory(const GByte *pabyData, int nLength = -1);
+    bool LoadChunks(const std::string &osPath, size_t nChunkSize = 16384,
+                    GDALProgressFunc pfnProgress = nullptr,
+                    void *pProgressArg = nullptr);
+    bool LoadUrl(const std::string &osUrl, const char *const *papszOptions,
+                 GDALProgressFunc pfnProgress = nullptr,
+                 void *pProgressArg = nullptr);
+
+  private:
+    mutable JSONObjectH m_poRootJsonObject;
+};
+
+CPL_C_END
+
+#if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
+extern "C++"
+{
+    CPLStringList CPLParseKeyValueJson(const char *pszJson);
+}
+#endif
+
+#endif  // CPL_JSON_H_INCLUDED

package/dist/prebuilt/Android-x86_64/include/cpl_list.h

@@ -0,0 +1,59 @@
+/**********************************************************************
+ * $Id$
+ *
+ * Name:     cpl_list.h
+ * Project:  CPL - Common Portability Library
+ * Purpose:  List functions.
+ * Author:   Andrey Kiselev, dron@remotesensing.org
+ *
+ **********************************************************************
+ * Copyright (c) 2003, Andrey Kiselev <dron@remotesensing.org>
+ *
+ * SPDX-License-Identifier: MIT
+ ****************************************************************************/
+
+#ifndef CPL_LIST_H_INCLUDED
+#define CPL_LIST_H_INCLUDED
+
+#include "cpl_port.h"
+
+/**
+ * \file cpl_list.h
+ *
+ * Simplest list implementation.  List contains only pointers to stored
+ * objects, not objects itself. All operations regarding allocation and
+ * freeing memory for objects should be performed by the caller.
+ *
+ */
+
+CPL_C_START
+
+/** List element structure. */
+typedef struct _CPLList CPLList;
+
+/** List element structure. */
+struct _CPLList
+{
+    /*! Pointer to the data object. Should be allocated and freed by the
+     * caller.
+     * */
+    void *pData;
+    /*! Pointer to the next element in list. NULL, if current element is the
+     * last one.
+     */
+    struct _CPLList *psNext;
+};
+
+CPLList CPL_DLL *CPLListAppend(CPLList *psList, void *pData);
+CPLList CPL_DLL *CPLListInsert(CPLList *psList, void *pData, int nPosition);
+CPLList CPL_DLL *CPLListGetLast(CPLList *psList);
+CPLList CPL_DLL *CPLListGet(CPLList *const psList, int nPosition);
+int CPL_DLL CPLListCount(const CPLList *psList);
+CPLList CPL_DLL *CPLListRemove(CPLList *psList, int nPosition);
+void CPL_DLL CPLListDestroy(CPLList *psList);
+CPLList CPL_DLL *CPLListGetNext(const CPLList *psElement);
+void CPL_DLL *CPLListGetData(const CPLList *psElement);
+
+CPL_C_END
+
+#endif /* CPL_LIST_H_INCLUDED */