Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Orange-OpenSource/floss-toolbox
A toolbox to help developers and open source referents to not waste their time with manual and boring tasks. Provides simple and light tools to make investigations in source code to look for hot data. Provides also primitives to manage GitHub and GitLab organizations.
https://github.com/Orange-OpenSource/floss-toolbox
admin bash commits dco dependabot github gitlab gitleaks hotwords logs octokit osint ruby shell signed-off toolbox vulnerabilities
Last synced: 3 months ago
JSON representation
A toolbox to help developers and open source referents to not waste their time with manual and boring tasks. Provides simple and light tools to make investigations in source code to look for hot data. Provides also primitives to manage GitHub and GitLab organizations.
- Host: GitHub
- URL: https://github.com/Orange-OpenSource/floss-toolbox
- Owner: Orange-OpenSource
- License: apache-2.0
- Created: 2021-01-20T11:38:11.000Z (almost 4 years ago)
- Default Branch: dev
- Last Pushed: 2024-07-25T13:37:56.000Z (4 months ago)
- Last Synced: 2024-07-25T15:36:56.965Z (4 months ago)
- Topics: admin, bash, commits, dco, dependabot, github, gitlab, gitleaks, hotwords, logs, octokit, osint, ruby, shell, signed-off, toolbox, vulnerabilities
- Language: Python
- Homepage:
- Size: 819 KB
- Stars: 19
- Watchers: 11
- Forks: 6
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
[](https://github.com/Orange-OpenSource/floss-toolbox/issues)
[](https://github.com/Orange-OpenSource/floss-toolbox/blob/dev/LICENSE.txt)
[](https://github.com/Orange-OpenSource/floss-toolbox/releases)
[](https://github.com/Orange-OpenSource/floss-toolbox/issues?q=is%3Aissue+is%3Aclosed)
[](https://github.com/Orange-OpenSource/floss-toolbox)
[](https://github.com/Orange-OpenSource/floss-toolbox/search?l=shell)
[](https://github.com/Orange-OpenSource/floss-toolbox/search?l=python)
[](https://github.com/Orange-OpenSource/floss-toolbox/search?l=ruby)
[](https://github.com/Orange-OpenSource/floss-toolbox/search?l=php)
# FLOSS Toolbox
Toolbox to help developers and open source referents to have cleaner projects in _GitHub_ organizations, and more.
Toolbox is mainly written in _Shell_ because this language is very efficient for files processing and provides a strong and rich standard API with cool primitives and nice performances due to system calls. It helps also to call system primitives easily.
Contains also _Ruby_ scripts. _Ruby_ are shiny gems, I love them.
_Python_ is also used.
And a bit of _PHP_ because it is nice to use several languages we are not used to (stop the routine!).
For these needs scripting is enough.
## Environment
You should have mainly the following environments bellow, but have a look on each folder README:
- _Bash_ version **3.2.5**
- _Ruby_ version **2.7.1**
- _Python_ version **3.7**
## Project tree
There are 5 folders containing scripts and programs to make your life a bit easier:
1. _toolbox/diver_ contains scripts to scrap data in Git logs and histories, look for sensitive data in sources, etc ;
2. _toolbox/github_ contains scripts and programs to make requests to GitHub API so as to automate some actions ;
3. _toolbox/gitlab_ contains scripts and programs to make requests to GitLab API so as to automate some actions ;
4. _toolbox/LicensesInventory_ contains program to get licenses of third party components thanks to dependency manager files ;
5. _toolbox/utils_ contains scripts to generate texts and stuff like that.
Feel free to read each README available in all of the subdirectories listed above.
## Dry run
To be sure you have a ready-to-run project, you can run the following dry-run command which will check if runtimes, third party tools and files are available.
```shell
bash dry-run.sh
```
## About the repository
### Renovate
[Renovate](https://docs.renovatebot.com/) is used to as to try to keep updated dependencies of the project.
A _renovate.json_ must be added at the project root with cofiguration details ; but **the organization admins must enable it** (through the [admin console](https://developer.mend.io/)).
By default [Dependabot](https://docs.github.com/fr/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security#what-is-dependabot) was enabled for this project but has been replaced by _Renovate_.
### Gitleaks
[Gitleaks](https://github.com/gitleaks/gitleaks) is used so as to look for secrets and leak of sensitive data.
A _gitleaks.toml_ file has been placed at the project root, picked from the _Gitleaks_ repository, to define rules.
A *gitleaks-action.yml* is also defined to define the GitHub Action to call and some secrets to use to do so.
The *GITLEAKS_LICENSE* is defined in the organization level, **only the organization admins can make it visible to projects**.
This key (dedicated to organization) has been asked to the *Gitleaks* team and received gratefully from them.
### DCO
The *Developer Certificate of Origin* is applied here thanks to a [Probot bot](https://probot.github.io/apps/dco/).
On pull requests all commits must be signed off. This control is processed in an action.