Merge pull request #55 from cul-it/develop

Pre-release merge for base-0.7

arxiv/license.py

@@ -0,0 +1,93 @@
+"""arXiv license definitions."""
+
+
+LICENSE_ICON_BASE_URI = '/icons/licenses'
+LICENSES = {
+    # key is the license URI
+    'http://arxiv.org/licenses/nonexclusive-distrib/1.0/': {
+        'label': 'arXiv.org perpetual, non-exclusive license to '
+                 'distribute this article',
+        'note': '(Minimal rights required by arXiv.org. Select this '
+                'unless you understand the implications of other '
+                'licenses)',
+        'order': 1,
+        'is_current': True,
+    },
+    'http://creativecommons.org/licenses/by/4.0/': {
+        'label': 'Creative Commons Attribution license',
+        'order': 5,
+        'is_current': True,
+        'icon_uri': f'{LICENSE_ICON_BASE_URI}/by-4.0.png'},
+
+    'http://creativecommons.org/licenses/by-sa/4.0/': {
+        'order': 6,
+        'label': 'Creative Commons Attribution-ShareAlike license',
+        'is_current': True,
+        'icon_uri': f'{LICENSE_ICON_BASE_URI}/by-sa-4.0.png'},
+
+    'http://creativecommons.org/licenses/by-nc-sa/4.0/': {
+        'order': 7,
+        'label': 'Creative Commons Attribution-Noncommercial-ShareAlike '
+                 'license',
+        'is_current': True,
+        'icon_uri': f'{LICENSE_ICON_BASE_URI}/by-nc-sa-4.0.png'},
+
+    'http://creativecommons.org/publicdomain/zero/1.0/': {
+        'label': 'Creative Commons Public Domain Declaration',
+        'order': 8,
+        'is_current': True,
+        'icon_uri': f'{LICENSE_ICON_BASE_URI}/zero-1.0.png'
+    },
+
+    'http://arxiv.org/licenses/assumed-1991-2003/': {
+        'label': 'Assumed arXiv.org perpetual, non-exclusive license to '
+                 'distribute this article for submissions made before '
+                 'January 2004',
+        'order': 9,
+        'is_current': False,
+    },
+
+    'http://creativecommons.org/licenses/by/3.0/': {
+        'label': 'Creative Commons Attribution license',
+        'order': 2,
+        'is_current': False,
+        'icon_uri': f'{LICENSE_ICON_BASE_URI}/by-3.0.png'
+    },
+
+    'http://creativecommons.org/licenses/by-nc-sa/3.0/': {
+        'label': 'Creative Commons Attribution-Noncommercial-ShareAlike '
+                 'license',
+        'order': 3,
+        'is_current': False,
+        'icon_uri': f'{LICENSE_ICON_BASE_URI}/by-nc-sa-3.0.png'
+    },
+    'http://creativecommons.org/licenses/publicdomain/': {
+        'label': 'Creative Commons Public Domain Declaration',
+        'note': '(Suitable for US government employees, for example)',
+        'order': 4,
+        'is_current': False,
+        'icon_uri': f'{LICENSE_ICON_BASE_URI}/publicdomain.png'
+    }
+}
+NO_LICENSE_TEXT = 'I do not certify that any of the above licenses apply'
+
+ASSUMED_LICENSE = LICENSES['http://arxiv.org/licenses/assumed-1991-2003/']
+
+# Historical license to updated/current license (old URI: new URI)
+TRANSLATED_LICENSES = {
+    'http://creativecommons.org/licenses/by/3.0/':
+    'http://creativecommons.org/licenses/by/4.0/',
+    'http://creativecommons.org/licenses/by-nc-sa/3.0/':
+    'http://creativecommons.org/licenses/by-nc-sa/4.0/',
+    'http://creativecommons.org/licenses/publicdomain/':
+    'http://creativecommons.org/publicdomain/zero/1.0/'
+}
+
+CURRENT_LICENSES = {
+    k: v for k, v in LICENSES.items()
+    if 'order' in v and 'is_current' in v and v['is_current']
+}
+
+# Current license URIs by display order
+CURRENT_LICENSE_URIS = \
+    sorted(CURRENT_LICENSES, key=lambda x: CURRENT_LICENSES[x]['order'])

arxiv/tests/test_license.py

@@ -0,0 +1,35 @@
+"""Tests for arXiv taxonomy module."""
+from unittest import TestCase
+from arxiv.license import LICENSES, CURRENT_LICENSE_URIS
+
+
+class TestLicense(TestCase):
+    """Tests for the arXiv license definitions."""
+
+    def test_current_license_uris(self):
+        """Regression test for the current active licenses."""
+        self.assertListEqual(
+            CURRENT_LICENSE_URIS,
+            [
+                'http://arxiv.org/licenses/nonexclusive-distrib/1.0/',
+                'http://creativecommons.org/licenses/by/4.0/',
+                'http://creativecommons.org/licenses/by-sa/4.0/',
+                'http://creativecommons.org/licenses/by-nc-sa/4.0/',
+                'http://creativecommons.org/publicdomain/zero/1.0/'
+            ],
+            'current license URIs match'
+        )
+
+    def test_licenses_are_valid(self):
+        """Test licenses contain required key/values."""
+        for uri, license in LICENSES.items():
+            self.assertIn('label', license)
+            self.assertTrue(license['label'])
+            self.assertIn('is_current', license)
+            self.assertIsInstance(license['is_current'], bool)
+            self.assertIn('order', license)
+            self.assertIsInstance(license['order'], int)
+            if 'icon_uri' in license:
+                self.assertTrue(license['icon_uri'])
+            if 'note' in license:
+                self.assertTrue(license['note'])