Adding a new configure script

Updated docs, tests and some cosmetics code mods.
Added 3pp libraries (with their own about file)

Author: pombredanne

.gitignore

@@ -1,22 +1,14 @@
 *.py[cod]
 
-# C extensions
-*.so
-
-# Packages
-*.egg
-*.egg-info
-dist
-build
-eggs
-parts
-bin
-var
-sdist
-develop-eggs
-.installed.cfg
-lib
+/build
+/bin
+/var
+/lib
 lib64
+/Include
+/Lib
+/Scripts
+/include
 
 # Installer logs
 pip-log.txt
@@ -36,4 +28,4 @@ nosetests.xml
 /.settings
 
 # PyCharm project
-.idea/
+.idea/

.travis.yml

@@ -1,12 +1,11 @@
 language: python
+
 python:
   - "2.6"
   - "2.7"
 install:
-    - "pip install -r requirements.txt --use-mirrors"
-    - "pip install coverage"
-    - "pip install coveralls"
+    - ./configure etc/conf/tests
 script:
     - "coverage run --source=about_code_tool setup.py test"
 after_success:
-    coveralls
+    - coveralls

NOTICE

@@ -0,0 +1,10 @@
+ Copyright (c) 2013-2014 nexB Inc. http://www.nexb.com/ - All rights reserved.
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+     http://www.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.

README.rst

@@ -52,18 +52,18 @@ Open and run the installer using all the default options.
 
 INSTALLATION
 ------------
-Download and save the about.py file from:
-https://raw.github.com/dejacode/about-code-tool/master/about.py
+Checkout or download and extract the AboutCode tool from:
+    https://github.com/dejacode/about-code-tool/
+
+To install all the needed dependencies in a virtualenv, run (on posix)::
+    source configure 
+or on windows::
+    configure
 
 
 TESTS
 -----
-Optionally, to verify that everything works fine you can run the test suite,
-download the whole repository at:
-https://github.com/dejacode/about-code-tool/archive/master.zip
-
-Then open a terminal or command prompt, extract the download if needed and run::
-
+To verify that everything works fine you can run the test suite with::
     python setup.py test
 
 
@@ -147,13 +147,15 @@ information will be saved to the CSV file named "thirdparty_about.csv".
                             Example syntax:
                             genabout.py --extract_license --api_url='api_url' --api_username='api_username' --api_key='api_key'
 
+
 Example::
 
     $ python genabout.py thirdparty_code.csv /tmp/thirdparty_about/
 
 In this example, the tool will look at the "thirdparty_code.csv" and generate
 the .ABOUT files in the directory /tmp/thirdparty_about/.
 
+
 **genattrib.py**
 
 ::
@@ -204,17 +206,17 @@ For issues, you can use:
 
 SOURCE CODE
 -----------
-The ABOUT tool is available through GitHub. For the latest version visit:
-
+AboutCode is available through GitHub. For the latest version visit:
     https://github.com/dejacode/about-code-tool
 
 
 HACKING
 -------
 We accept pull requests provided under the same license as this tool.
+You agree to the http://developercertificate.org/ 
 
 
 LICENSE
 -------
-The ABOUT tool is released under the Apache 2.0 license.
+AboutCode is released under the Apache 2.0 license.
 See (of course) the about.ABOUT file for details.

about.ABOUT

@@ -1,37 +1,25 @@
-about_resource: about-code-tool/about.py
+about_resource: .
 
-name: ABOUT tool
-version: 0.8.1
+name: AboutCode
+version: 0.9.0
 
 owner: nexB Inc.
 author: Jillian Daguil, Chin Yeung Li, Philippe Ombredanne, Thomas Druez
 
-
 home_url: http://dejacode.org
-readme_file: README.rst
-changelog_file: CHANGELOG.txt
 
 vcs_tool: git
 vcs_repository: https://github.com/dejacode/about-code-tool.git
 
-description: This is a tool to process ABOUT files. An ABOUT file provides a
- simple way to document the provenance (origin and license) 'about' a software
- component. An ABOUT file is a small text file stored in the codebase
- side-by-side with the software component that it documents.
+description: AboutCode is a tool to process ABOUT files. An ABOUT file
+ provides a simple way to document the provenance (origin and license)
+ 'about' a software component. This is a small text file stored in the
+ codebase side-by-side with the documented software component.
 
 
-license_text_file: apache2.LICENSE.txt
+dej_license: apache-2.0
+license_text_file: apache-2.0.LICENSE
 license_spdx: Apache-2.0
-copyright: Copyright (c) 2013 nexB, Inc.
-
-notice:
- Copyright (c) 2013 nexB, Inc. http://www.nexb.com/ - All rights reserved.
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-     http://www.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.
+copyright: Copyright (c) 2013-2014 nexB Inc.
+
+notice_file: NOTICE

about_code_tool/about.py

@@ -2,17 +2,17 @@
 # -*- coding: utf8 -*-
 
 """
-This is a tool to process ABOUT files as specified at http://dejacode.org.
+AboutCode is a tool to process ABOUT files. ABOUT files are small text files
+that document the provenance (aka. the origin and license) of software
+components as well as the essential obligation such as attribution/credits and
+source code redistribution. See the ABOUT spec at http://dejacode.org.
 
-ABOUT files are small text files that document the origin and license of
-software components.
-
-This tool read and validates ABOUT files to collect your software components
-inventory.
+AbouCode reads and validates ABOUT files and collect software components
+inventories.
 """
 
 # We require Python 2.6 or later
-from __future__ import print_function, with_statement
+from __future__ import print_function
 
 from StringIO import StringIO
 import codecs
@@ -31,6 +31,7 @@
 import string
 import sys
 import urlparse
+import ntpath
 
 
 __version__ = '0.9.0'
@@ -55,15 +56,13 @@
 limitations under the License.
 """
 
-
 logger = logging.getLogger(__name__)
 handler = logging.StreamHandler()
 handler.setLevel(logging.CRITICAL)
 handler.setFormatter(logging.Formatter('%(levelname)s: %(message)s'))
 logger.addHandler(handler)
 
 
-
 def repr_problem(obj):
     """
     Return a formatted representation of a given Warn or Error object
@@ -451,6 +450,24 @@ def repr_problem(obj):
     'zlib.LICENSE',
 )
 
+def posix_path(path):
+    """
+    Return a path using the posixpath separator given a path that may
+    contain posix or windows separators, converting \ to /.
+    """
+    return path.replace(ntpath.sep, posixpath.sep)
+
+
+def native_path(path):
+    """
+    Return a path using the current OS path separator given a path that may
+    contain posix or windows separators, converting / to \ on windows and \ to
+    / on posix OSes.
+    """
+    path = path.replace(ntpath.sep, os.path.sep)
+    path = path.replace(posixpath.sep, os.path.sep)
+    return path
+
 
 def is_about_file(path):
     """
@@ -1057,18 +1074,24 @@ def __iter__(self):
         return iter(self.abouts)
 
     @staticmethod
-    def _collect_about_files(input_path):
+    def _collect_about_files(location):
         """
-        Return a list containing file-paths of valid .ABOUT file given a path.
-        When the input is a file rather than a directory. The returned list
-        may contain only one item if the file name is valid.
+        Given the location of a file or directory, return a list of 
+        locations of valid .ABOUT files.
         """
-        if os.path.isfile(input_path):
-            return filter(is_about_file, [input_path])
+        paths = []
+        if location:
+            if os.path.isfile(location) and is_about_file(location):
+                paths = [location]
+            else:
+                for root, _, files in os.walk(location):
+                    for name in files:
+                        if is_about_file(name):
+                            paths.append(os.path.join(root, name))
+        # normalize the paths to use os path seps
+        paths = [posix_path(p)for p in paths]
+        return paths
 
-        return [os.path.join(root, name)
-                for root, _, files in os.walk(input_path)
-                for name in files if is_about_file(name)]
 
     @property
     def errors(self):
@@ -1193,7 +1216,7 @@ def generate_attribution(self, template_path=None, limit_to=None):
                                       errors='replace')
                 about_content_dict['notice_text'] = about_object.notice_text()
 
-                # FIXME: The following is a tmp code to handle multiple 
+                # FIXME: The following is a tmp code to handle multiple
                 # 'license_text_file' in the input
                 for k in about_content_dict:
                     if '\n' in about_content_dict[k] and k == 'license_text_file':