add packaged code to handle podspec

Signed-off-by: rpotter12 <rohitpotter12@gmail.com>

Author: rpotter12

src/packagedcode/__init__.py

@@ -25,16 +25,17 @@
 from __future__ import absolute_import
 from __future__ import unicode_literals
 
-from packagedcode import build
-from packagedcode import chef
-from packagedcode import models
 from packagedcode import about
 from packagedcode import bower
-from packagedcode import conda
+from packagedcode import build
 from packagedcode import cargo
+from packagedcode import chef
+from packagedcode import conda
+from packagedcode import cocoapods
 from packagedcode import freebsd
 from packagedcode import haxe
 from packagedcode import maven
+from packagedcode import models
 from packagedcode import npm
 from packagedcode import nuget
 from packagedcode import phpcomposer
@@ -62,6 +63,7 @@
     phpcomposer.PHPComposerPackage,
     haxe.HaxePackage,
     cargo.RustCargoCrate,
+    cocoapods.CocoapodsPackage,
     models.MeteorPackage,
     bower.BowerPackage,
     freebsd.FreeBSDPackage,

src/packagedcode/cocoapods.py

@@ -0,0 +1,186 @@
+# All rights reserved.
+# http://nexb.com and https://github.com/nexB/scancode-toolkit/
+# The ScanCode software is licensed under the Apache License version 2.0.
+# Data generated with ScanCode require an acknowledgment.
+# ScanCode is a trademark of nexB Inc.
+#
+# You may not use this software except in compliance with the License.
+# You may obtain a copy of the License at: http://apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software distributed
+# under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+# CONDITIONS OF ANY KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations under the License.
+#
+# When you publish or redistribute any data created with ScanCode or any ScanCode
+# derivative work, you must accompany this data with the following acknowledgment:
+#
+#  Generated with ScanCode and provided on an "AS IS" BASIS, WITHOUT WARRANTIES
+#  OR CONDITIONS OF ANY KIND, either express or implied. No content created from
+#  ScanCode should be considered or used as legal advice. Consult an Attorney
+#  for any legal advice.
+#  ScanCode is a free software code scanning tool from nexB Inc. and others.
+#  Visit https://github.com/nexB/scancode-toolkit/ for support and download.
+
+from __future__ import absolute_import
+from __future__ import print_function
+from __future__ import unicode_literals
+
+import logging
+import re
+
+import attr
+from packageurl import PackageURL
+
+from commoncode.fileutils import py2
+from commoncode import filetype
+from commoncode import fileutils
+from packagedcode import models
+from packagedcode.spec import ParseSpec
+
+
+"""
+Handle cocoapods packages manifests for macOS and iOS
+including .podspec, Podfile and Podfile.lock files.
+See https://cocoapods.org
+"""
+
+# TODO: implementation to get dependency data using gemsfileparser
+# Check: https://gitlab.com/balasankarc/gemfileparser
+# TODO: override the license detection to detect declared_license correctly.
+
+
+TRACE = False
+
+logger = logging.getLogger(__name__)
+
+if TRACE:
+    import sys
+    logging.basicConfig(stream=sys.stdout)
+    logger.setLevel(logging.DEBUG)
+
+
+@attr.s()
+class CocoapodsPackage(models.Package):
+    metafiles = ('*.podspec',)
+    extensions = ('.podspec',)
+    default_type = 'pods'
+    default_primary_language = 'Objective-C'
+    default_web_baseurl = 'https://cocoapods.org'
+    default_download_baseurl = None
+    default_api_baseurl = None
+
+    @classmethod
+    def recognize(cls, location):
+        yield parse(location)
+
+    def repository_homepage_url(self, baseurl=default_web_baseurl):
+        return '{}/pods/{}'.format(baseurl, self.name)
+
+    def repository_download_url(self):
+        return '{}/archive/{}.zip'.format(self.homepage_url, self.version)
+
+
+def is_podspec(location):
+    """
+    Checks if the file is actually a podspec file
+    """
+    return (filetype.is_file(location) and location.endswith('.podspec'))
+
+
+def parse(location):
+    """
+    Return a Package object from a .podspec file or None.
+    """
+    if not is_podspec(location):
+        return
+
+    podspec_obj = ParseSpec()
+    podspec_data = podspec_obj.parse_spec(location)
+    return build_package(podspec_data)
+
+
+def build_package(podspec_data):
+    """
+    Return a Package object from a package data mapping or None.
+    """
+    name = podspec_data.get('name')
+    version = podspec_data.get('version')
+    declared_license = podspec_data.get('license')
+    summary = podspec_data.get('summary')
+    description = podspec_data.get('description')
+    homepage_url = podspec_data.get('homepage_url')
+    source = podspec_data.get('source')
+    authors = podspec_data.get('author') or None
+
+    author_names = []
+    author_email = []
+    if authors:
+        for split_author in authors:
+            split_author = split_author.strip()
+            author, email = parse_person(split_author)
+            author_names.append(author)
+            author_email.append(email)
+
+    parties = []
+    if authors:
+        parties.append(
+            models.Party(
+                type=models.party_person,
+                name=', '.join(author_names),
+                email=', '.join(author_email),
+                role='author'
+            )
+        )
+
+    if len(summary) > len(description):
+        description = summary
+
+    package = CocoapodsPackage(
+        name=name,
+        version=version,
+        vcs_url=source,
+        source_packages=list(source.split('\n')),
+        description=description,
+        declared_license=declared_license,
+        homepage_url=homepage_url,
+        parties=parties
+    )
+    return package
+
+
+person_parser = re.compile(
+    r'^(?P<name>[\w\s(),-_.,]+)'
+    r'=>'
+    r'(?P<email>[\S+]+$)'
+).match
+
+person_parser_only_name = re.compile(
+    r'^(?P<name>[\w\s(),-_.,]+)'
+).match
+
+
+def parse_person(person):
+    """
+    Return name and email from person string.
+    
+    https://guides.cocoapods.org/syntax/podspec.html#authors
+    Author can be in the form:
+        s.author = 'Rohit Potter'
+        or
+        s.author = 'Rohit Potter=>rohit@gmail.com'
+    Author check:
+    >>> p = parse_person('Rohit Potter=>rohit@gmail.com')
+    >>> assert p == ('Rohit Potter', 'rohit@gmail.com')
+    >>> p = parse_person('Rohit Potter')
+    >>> assert p == ('Rohit Potter', None)
+    """
+    parsed = person_parser(person)
+    if not parsed:
+        parsed = person_parser_only_name(person)
+        name = parsed.group('name')
+        email = None
+    else:
+        name = parsed.group('name')
+        email = parsed.group('email')
+
+    return name, email 

tests/packagedcode/data/plugin/help.txt

@@ -200,6 +200,13 @@ Package: nuget
   extensions: .nupkg
   filetypes: zip archive, microsoft ooxml
 
+
+--------------------------------------------
+Package: pods
+  class: packagedcode.cocoapods:CocoapodsPackage
+  metafiles: *.podspec
+  extensions: .podspec
+
 --------------------------------------------
 Package: pypi
   class: packagedcode.pypi:PythonPackage