initial commit

Author: v-kolesov

Diff for: .gitignore

@@ -0,0 +1,125 @@
+# ignore all . files and . folders
+# Dont ignore .gitignore (this file)
+# This is just for verbosity, you can leave it out if
+# .gitignore is already tracked or if you use -f to
+# force-add it if you just created it
+!/.gitignore
+__pycache__/
+*.py[cod]
+
+# Distribution / packaging
+.Python
+env/
+build/
+.build/
+.dist/
+.idea/
+.marketsight/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+tests/.consistency.*
+tests/.timing.*
+tests/.api_benchmarks.*
+tests/pytest.ini
+.pytest_cache/*
+tests/.pytest_cache/*
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+.python27
+.py38
+.clean
+ENV/
+.activate.ps1
+.pyinstaller27/
+.pyinstaller36/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# docker
+.docker/
+
+# deployment scripts
+build-deploy*.ps1
+/.marketsight/

Diff for: CHANGES.rst

@@ -0,0 +1,4 @@
+Release 0.1.0 (released TBD)
+=========================================
+
+* First public release

Diff for: LICENSE

@@ -0,0 +1,18 @@
+Copyright 2021 Dynata, LLC.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Diff for: README.rst

@@ -0,0 +1,133 @@
+####################################################
+Dynata Reporting & Analytics API
+####################################################
+
+.. image:: https://marketsight.readthedocs.io/en/latest/_static/marketsight-logo.png
+  :alt: Dynata Reporting & Analytics
+  :align: right
+  :width: 120
+  :height: 120
+  :target: https://marketsight.readthedocs.io/en/latest.html
+
+**Python bindings for the Dynata Reporting & Analytics (MarketSight) API**
+
+
+The **MarketSight Client API** library provides Python bindings for the
+Dynata Reporting & Analytics API, providing a Pythonic interface for
+interacting with the underlying platform's RESTful APIs.
+
+.. contents::
+  :depth: 3
+  :backlinks: entry
+
+------------------------
+
+*****************
+Installation
+*****************
+
+To install **MarketSight API Client**, just execute:
+
+  .. code:: bash
+
+   $ pip install marketsight
+
+Dependencies
+=================
+
+* `Validator-Collection v.1.5.0 <https://github.com/insightindustry/validator-collection>`_ or higher
+* `simplejson v.3.0 <https://github.com/simplejson/simplejson>`_ or higher
+* `bravado v.10.6.0 <https://github.com/Yelp/bravado/>`_ or higher
+* `dpath v.2.0.1 <https://github.com/akesterson/dpath-python>`_ or higher
+
+-----------------------------------
+
+*********************************
+Key MarketSight API Features
+*********************************
+
+* Ability to manage your Account settings within the Dynata Reporting
+  & Analytics platform.
+* Ability to manage data within the Dynata Reporting & Analytics platform.
+* Ability to perform high-end statistical analyses on your data in the
+  Dynata Reporting & Analytics platform.
+* Ability to produce interactive visualizations of your data and insights.
+* Ability to produce and share interactive dashboards to deliver your insights
+  to downstream users.
+* Ability to embed or otherwise integrate the MarketSight platform into your
+  applications.
+
+-----------------------
+
+**********************************
+Hello, World and Basic Usage
+**********************************
+
+1. Initialize the Library
+==========================================
+
+
+.. code-block:: python
+   :linenos:
+
+
+   # Import the MarketSight API Client
+   import marketsight
+
+   # Call the "client" factory function.
+   api = marketsight.client("https://application.marketsight.com/api/v1/swagger/public.json")
+
+
+2. Authorize Against the API
+================================
+
+
+.. code-block:: python
+   :linenos:
+
+    # Initialize the MarketSight API Client.
+    api = marketsight.client("https://application.marketsight.com/api/v1/swagger/public.json")
+
+    # Connect your instance to the API and authorize as a partner.
+    api.connect(
+        client_id = "MY CLIENT ID GOES HERE",
+        client_secret = "MY CLIENT SECRET GOES HERE"
+    )
+
+3. Call the API
+=====================
+
+Execute API calls to perform operations, for example:
+
+
+.. code-block:: python
+  :linenos:
+
+
+  # Retrieve an Account
+  account = api.Accounts.retrieve(account_id = "MY ACCOUNT ID GOES HERE")
+
+  # Retrieve a User
+  user = api.Users.retrieve(user_id = "MY USER ID GOES HERE")
+
+  # Retrieve a Dataset's Meta-data
+  dataset = api.Datasets.retrieve(dataset_id = "MY DATASET ID GOES HERE")
+
+---------------
+
+*********************
+Questions and Issues
+*********************
+
+You can ask questions and report issues on the project's
+`Github Issues Page <https://github.com/dynata/msight-csl/issues>`_
+
+
+--------------------
+
+**********************
+License
+**********************
+
+**MarketSight Core** is made available under an
+`MIT License <https://marketsight.readthedocs.org/en/latest/license.html>`_.

Diff for: marketsight/__init__.py

@@ -0,0 +1 @@
+from marketsight.application_api import client, Helper, OPENAPI_URL

Diff for: marketsight/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

Diff for: marketsight/_compat.py

@@ -0,0 +1,103 @@
+"""
+######################
+marketsight._compat
+######################
+
+This module handles import compatibility issues between Python 2 and Python 3.
+"""
+# pylint: disable=invalid-name,redefined-builtin,no-member,missing-docstring,unused-import,undefined-variable,used-before-assignment
+
+import math
+import sys
+from decimal import Decimal
+
+import chardet
+
+_ver = sys.version_info
+
+#: Python 2.x?
+is_py2 = _ver[0] == 2
+
+#: Python 3.x?
+is_py3 = _ver[0] == 3
+
+try:
+    import simplejson as json
+except ImportError:
+    import json
+
+# ---------
+# Specifics
+# ---------
+
+if is_py2:
+    from StringIO import StringIO  # pylint: disable=import-error
+    from urllib3.packages.ordered_dict import (
+        OrderedDict,
+    )  # pylint: disable=import-error,E0611
+    import urllib as base_urllib
+
+    builtin_str = str
+    bytes = str
+    str = unicode
+    basestring = basestring
+    numeric_types = (int, long, float, Decimal)
+    integer_types = (int, long)
+    long = long
+    xrange = xrange
+    INFINITY = float("+inf")
+    NEGATIVE_INFINITY = float("-inf")
+
+
+elif is_py3:
+    from io import StringIO
+    from collections import OrderedDict
+    import urllib.parse as base_urllib
+
+    builtin_str = str
+    str = str
+    bytes = bytes
+    basestring = (str, bytes)
+    numeric_types = (int, float, Decimal)
+    integer_types = (int,)
+    long = int
+    xrange = range
+    INFINITY = math.inf
+    NEGATIVE_INFINITY = -math.inf
+
+
+def with_metaclass(meta, *bases):
+    """Create a base class with a metaclass."""
+    # This requires a bit of explanation: the basic idea is to make a dummy
+    # metaclass for one level of class instantiation that replaces itself with
+    # the actual metaclass.
+    class metaclass(type):
+        # pylint: disable=unused-argument
+
+        def __new__(cls, name, this_bases, d):
+            return meta(name, bases, d)
+
+        @classmethod
+        def __prepare__(cls, name, this_bases):
+            return meta.__prepare__(name, bases)
+
+    return type.__new__(metaclass, "temporary_class", (), {})
+
+
+def add_metaclass(metaclass):
+    """Class decorator for creating a class with a metaclass."""
+
+    def wrapper(cls):
+        orig_vars = cls.__dict__.copy()
+        slots = orig_vars.get("__slots__")
+        if slots is not None:
+            if isinstance(slots, str):
+                slots = [slots]
+            for slots_var in slots:
+                orig_vars.pop(slots_var)
+        orig_vars.pop("__dict__", None)
+        orig_vars.pop("__weakref__", None)
+
+        return metaclass(cls.__name__, cls.__bases__, orig_vars)
+
+    return wrapper