Merge pull request #18 from maxmind/oalders/device-and-session-inputs

Add /device/session_age, /device/session_id and /email/first_seen

Author: oschwald

HISTORY.rst

@@ -5,6 +5,9 @@ History
 
 * Added the following new values to the ``/payment/processor`` validation:
   ``ebs``, ``hipay``, and ``lemon_way``.
+* Added the following new input values:
+  ``/device/session_age`` and ``/device/session_id``.
+* Added support for the ``/email/first_seen`` output.
 
 1.3.2 (2016-12-08)
 ++++++++++++++++++

README.rst

@@ -107,6 +107,8 @@ Example
     >>>     'device': {
     >>>         'ip_address': '81.2.69.160',
     >>>         'accept_language': 'en-US,en;q=0.8',
+    >>>         'session_age': 3600,
+    >>>         'session_id': 'a333a4e127f880d8820e56a66f40717c',
     >>>         'user_agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.89 Safari/537.36'
     >>>     },
     >>>     'event': {

docs/conf.py

@@ -25,8 +25,10 @@
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest',
-              'sphinx.ext.intersphinx', 'sphinx.ext.coverage']
+extensions = [
+    'sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.intersphinx',
+    'sphinx.ext.coverage'
+]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -87,7 +89,6 @@
 # A list of ignored prefixes for module index sorting.
 #modindex_common_prefix = []
 
-
 # -- Options for HTML output ---------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
@@ -167,7 +168,6 @@
 # Output file base name for HTML help builder.
 htmlhelp_basename = 'minfrauddoc'
 
-
 # -- Options for LaTeX output --------------------------------------------
 
 latex_elements = {
@@ -184,8 +184,8 @@
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).
 latex_documents = [
-    ('index', 'minfraud.tex', 'minfraud Documentation',
-     'Gregory Oschwald', 'manual'),
+    ('index', 'minfraud.tex', 'minfraud Documentation', 'Gregory Oschwald',
+     'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
@@ -208,29 +208,24 @@
 # If false, no module index is generated.
 #latex_domain_indices = True
 
-
 # -- Options for manual page output --------------------------------------
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [
-    ('index', 'minfraud', 'minfraud Documentation',
-     ['Gregory Oschwald'], 1)
-]
+man_pages = [('index', 'minfraud', 'minfraud Documentation',
+              ['Gregory Oschwald'], 1)]
 
 # If true, show URL addresses after external links.
 #man_show_urls = False
 
-
 # -- Options for Texinfo output ------------------------------------------
 
 # Grouping the document tree into Texinfo files. List of tuples
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-    ('index', 'minfraud', 'minfraud Documentation',
-     'Gregory Oschwald', 'minfraud',
-     'minFraud Score and Insights web service client.',
+    ('index', 'minfraud', 'minfraud Documentation', 'Gregory Oschwald',
+     'minfraud', 'minFraud Score and Insights web service client.',
      'Miscellaneous'),
 ]
 
@@ -243,12 +238,10 @@
 # How to display URL addresses: 'footnote', 'no', or 'inline'.
 #texinfo_show_urls = 'footnote'
 
-
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
     'python': ('http://python.readthedocs.org/en/latest/', None),
     'geoip2': ('http://geoip2.readthedocs.org/en/latest/', None)
 }
 
-
 autoclass_content = 'both'

minfraud/models.py

@@ -212,7 +212,9 @@ class ScoreIPAddress(object):
     """
 
     __slots__ = ()
-    _fields = {'risk': None, }
+    _fields = {
+        'risk': None,
+    }
 
 
 @_inflate_to_namedtuple
@@ -296,6 +298,7 @@ class Device(object):
       RFC 3339 date-time.
 
       :type: str | None
+
     """
 
     __slots__ = ()
@@ -341,6 +344,14 @@ class Disposition(object):
 class Email(object):
     """Information about the email address passed in the request.
 
+    .. attribute:: first_seen
+
+      A date string (e.g. 2017-04-24) to identify the date an email address
+      was first seen by MaxMind. This is expressed using the ISO 8601 date
+      format.
+
+      :type: str
+
     .. attribute:: is_free
 
       This field is true if MaxMind believes that this email is hosted by a
@@ -360,6 +371,7 @@ class Email(object):
 
     __slots__ = ()
     _fields = {
+        'first_seen': None,
         'is_free': None,
         'is_high_risk': None,
     }