Gitiles
Code Review Sign In
gerrit-public.fairphone.software / vendor / fairphone / tools / 444efd2effb7d7e49ce32a37dfa467dbd2210b5c
commit444efd2effb7d7e49ce32a37dfa467dbd2210b5c[log] [tgz]
authorAndrew Appleby <andrewa@fairphone.com>Mon Oct 29 10:59:47 2018 +0100
committerAndrew Appleby <andrewa@fairphone.com>Thu Nov 08 15:45:40 2018 +0100
tree569bbb859b9662d936d7770eba15a17f8d8971df
parent76a1c484b5d805f545bb7ee7d564c0326b37f0b4 [diff]
JIRA: Add script for importing CSV configurations

Script can add groups, users and configurations into Jira. If a
configurations already exist, its information will be updated if
needed.

Issue: INFRA-85
Change-Id: I6ae484b439f6de18fdeedbe2d37a34f679bd2ef5
5 files changed
tree: 569bbb859b9662d936d7770eba15a17f8d8971df
  1. bin/
  2. jira/
  3. lava/
  4. python-libs/
  5. .gitignore
  6. LICENSE
  7. NOTICE
  8. pylintrc
  9. pyproject.toml
  10. README.md
  11. requirements-dev.txt
  12. tox.ini
  13. vendorsetup.sh
README.md

Fairphone Android tools

A collection of tools developed at Fairphone related to Android development:

  • Standalone scripts live in bin:
    • fetch-and-push-partner: a script to fetch the AOSP partner security branches in the Android tree and push them to our own repositories.
    • merge-partner-on-aosp: a script to merge the AOSP partner security branches in the Android tree.
    • ota_install: a script to push an OTA to a device and initiate the update process with the Fairphone Updater.
  • Installable libraries live in their own directory within <language>-libs:
    • python-libs/android-tools: A support library to work with Android devices and apps in Python 3.
  • Installable tools live in their own directory:
    • lava: tools to interact with LAVA, the automated testing system.
    • jira: Script to import CSV defined configuration into the Fairphone JIRA instance. The script can create users, groups and components. Run ./import_csv_to_jira.py --help for details.

See the individual tools help (--help) or projects README for installation and usage.

TODO: Migrate the LAVA tools in lava to an installable Python package.

Developing

Code style, linters, and formatters must be used before submitting any new tool or patchset. Maximal line lengths are fixed to 80 characters.

Install the selected toolset within a Python 3.6 (virtual) environment:

$ pip3 install -r requirements-dev.txt

We detail below the recommendations (read: requirements) per language and how to run the tools in a standalone fashion.

Bash/Shell (.sh)

Note: Portable shell scripts are favoured over Bash scripts.

Follow what the Bashate style checker recommends.

$ bashate --verbose <file>

Python (.py)

Note: Python 3.6 is the current development choice.

Let Black format Python files for you.

$ black <file>

Trust that the linting tools (flake8 and pylint) know better and follow their advice.

$ flake8 <file>
$ pylint <file>

License

The project is made available under the terms of the Apache 2.0 license. See LICENSE for details.