Skip to main content

FOSSLight Source

Project description

[Kor]

FOSSLight Source

FOSSLight Source is released under the Apache-2.0 License. Current python package version.

Detect the license for the source code.
Use Source Code Scanner and process the scanner results.

FOSSLight Source uses ScanCode, a source code scanner, to detect the copyright and license phrases contained in the file. Some files (ex- build script), binary files, directory and files in specific directories (ex-test) are excluded from the result. And removes words such as "-only" and "-old-style" from the license name to be printed. The output result is generated in Excel format.

Contents

📋 Prerequisite

FOSSLight Source needs a Python 3.6+.
For windows, you need to install Microsoft Visual C++ Build Tools.

🎉 How to install

It can be installed using pip3. It is recommended to install it in the python 3.6 + virtualenv environment.

$ pip3 install fosslight_source

🚀 How to run

There are two commands for FOSSLight Scanner.

1. fosslight_source

After executing ScanCode, the source code scanner, print the OSS Report.

Parameter Argument Description
h None Print help message.
p String Path to detect source.
j None As an output, the result of executing ScanCode in json format other than OSS Report is additionally generated.
o String Output file name without file extension.

Ex. Print result to OSS Report and json file

$ fosslight_source -p /home/source_path -j

2. fosslight_convert

Converts the result of executing ScanCode in json format into OSS Report format.

Parameter Argument Description
h None Print help message.
p String Path of ScanCode json files.
o String Output file name without file extension.

Ex. Converting scancode json result to OSS report

$ fosslight_convert -p /home/jsonfile_dir

📁 Result

$ tree
.
├── OSS-Report_2021-05-03_00-39-49.csv
├── OSS-Report_2021-05-03_00-39-49.xlsx
├── scancode_2021-05-03_00-39-49.json
└── fosslight_src_log_2021-05-03_00-39-49.txt

  • OSS-Report_[datetime].xlsx : FOSSLight Source result in OSS Report format.
  • OSS-Report_[datetime].csv : FOSSLight Source result in csv format. (Except Windows)
  • fosslight_src_log_[datetime].txt : The execution log.
  • scancode_[datetime].json : The ScanCode result in case of -j option.

👏 How to report issue

Please report any ideas or bugs to improve by creating an issue in Git Repository. Then there will be quick bug fixes and upgrades. Ideas to improve are always welcome.

📄 License

FOSSLight Source is Apache-2.0, as found in the LICENSE file.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fosslight_source-1.4.4.tar.gz (13.1 kB view hashes)

Uploaded Source

Built Distribution

fosslight_source-1.4.4-py3-none-any.whl (12.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page