Handle nested list for license data

[chinyeungli]

[
    {
      "path": "swagger/annotations/Api.java",
      "type": "file",
      "name": "Api.java",
      "base_name": "Api",
      "extension": ".java",
      "size": 5074,
      "date": "2017-07-15",
      "sha1": "c3a48ec7e684a35417241dd59507ec61702c508c",
      "md5": "326fb262bbb9c2ce32179f0450e24601",
      "mime_type": "text/plain",
      "file_type": "ASCII text",
      "programming_language": "Java",
      "is_binary": false,
      "is_text": true,
      "is_archive": false,
      "is_media": false,
      "is_source": true,
      "is_script": false,
      "licenses": [
        {
          "key": "apache-2.0",
          "score": 90.7,
          "short_name": "Apache 2.0",
          "category": "Permissive",
          "owner": "Apache Software Foundation",
          "homepage_url": "http://www.apache.org/licenses/",
          "text_url": "http://www.apache.org/licenses/LICENSE-2.0",
          "reference_url": "https://enterprise.dejacode.com/urn/urn:dje:license:apache-2.0",
          "spdx_license_key": "Apache-2.0",
          "spdx_url": "https://spdx.org/licenses/Apache-2.0",
          "start_line": 4,
          "end_line": 14,
          "matched_rule": {
            "identifier": "apache-2.0_7.RULE",
            "license_choice": false,
            "licenses": [
              "apache-2.0"
            ]
          }
        },
        {
          "key": "apache-2.0",
          "score": 40.0,
          "short_name": "Apache 2.0",
          "category": "Permissive",
          "owner": "Apache Software Foundation",
          "homepage_url": "http://www.apache.org/licenses/",
          "text_url": "http://www.apache.org/licenses/LICENSE-2.0",
          "reference_url": "https://enterprise.dejacode.com/urn/urn:dje:license:apache-2.0",
          "spdx_license_key": "Apache-2.0",
          "spdx_url": "https://spdx.org/licenses/Apache-2.0",
          "start_line": 8,
          "end_line": 8,
          "matched_rule": {
            "identifier": "apache-2.0_25.RULE",
            "license_choice": false,
            "licenses": [
              "apache-2.0"
            ]
          }
        }
      ],
      "files_count": 0,
      "dirs_count": 0,
      "size_count": 0,
      "scan_errors": []
    },
]

How do we want to handle a nested list in a JSON input?
OR do we want to support nested list at all?

[pombredanne]

@chinyeungli which nested list do you refer to specifically? Is this the list of licenses in particular?

[chinyeungli]

@pombredanne I am refering the licenses list
The question is what'll the ABOUT file look like from the above example?
The ABOUT file is like a key/value (dict) pair.

[pombredanne]

@chinyeungli can you paste an example of a .ABOUT file that you have difficulties with? This way we can work out some simple mapping between the two formats (or decide to update the .ABOUT format if needed). Note also that this is an area that may evolve significantly when we support license expressions throughout #275

[chinyeungli]

From the above example,
The ABOUT file will looks like (with proper mapping.config)

about_resource_path: swagger/annotations/Api.java
type: file
name: Api.java
...

My question is how do we represent the licenses in the ABOUT file since the licenses (1 key) have two values. If we want to take a multiple line approach, it'll look something like the following:
i.e.

license: |
   key: apache-2.0
   score: 90.7
   ...
   key: apache-2.0
   score: 40.0
   ...

[pombredanne]

We are now handling this alright as a list of License objects in an ABOUT file yml:

licenses:
    - key: apache-2.0
      name: Apache 2.0