Metadata-Version: 2.4
Name: clickable-ut
Version: 8.8.0
Summary: Compile, build, and deploy Ubuntu Touch click packages all from the command line.
Home-page: https://clickable-ut.dev/
Author: Brian Douglass
License: GPL3
Project-URL: Documentation, https://clickable-ut.dev/en/latest/
Project-URL: Source, https://gitlab.com/clickable/clickable
Project-URL: Bug Tracker, https://gitlab.com/clickable/clickable/-/issues
Keywords: click ubuntu touch ubports
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Code Generators
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cookiecutter
Requires-Dist: requests
Requires-Dist: PyYaml
Requires-Dist: jsonschema
Requires-Dist: argcomplete
Requires-Dist: watchdog
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: summary

# [Clickable](https://clickable-ut.dev/en/latest/)

Compile, build, deploy an debug Ubuntu Touch click packages all from the command line.

## Docs

* [Install](https://clickable-ut.dev/en/latest/install.html)
* [Getting Started](https://clickable-ut.dev/en/latest/getting-started.html)
* [Usage](https://clickable-ut.dev/en/latest/usage.html)
* [Commands](https://clickable-ut.dev/en/latest/commands.html)
* [Project Config Format](https://clickable-ut.dev/en/latest/clickable-json.html)
* [App Templates](https://clickable-ut.dev/en/latest/app-templates.html)
* [Builders](https://clickable-ut.dev/en/latest/builders.html)

## Code Editor Integrations

Start QtCreator shipped by Clickable in a project folder via `clickable ide`.

## Development

Please base any development on the branch `dev` and file merge requests against it.

### Run Clickable from Repository

Make sure to install the dependencies listed in `setup.py`, via your package
manager or pipx.

You can run Clickable directly from sources via the `clickable-dev` script.
Add the `--verbose` option for additional output.

It is recommended to add your clickable repo folder to `PATH`.
This can be done by adding `export PATH="$PATH:$HOME/clickable"` to your `.bashrc`.
Replace `$HOME/clickable` with your path.

### Linting

Clickable uses flake8 and pylint for linting as well as autopep8 for formatting.
Install them using `pipx install flake8 pylint autopep8`.
Inject some dependencies with
`pipx inject pylint requests PyYaml jsonschema cookiecutter` to avoid
false-positives import-error lints.

Run `make lint` to lint and `make format` to format the source code.

### Run the tests

Install the pytest modules: `pipx install pytest pytest-cov`.

Run pytest to complete the tests: `make test`.

### Related Repositories

* [Clickable docker images and app templates](https://gitlab.com/clickable)

## License

Copyright (C) 2025 Clickable Team

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3, as published
by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranties of MERCHANTABILITY, SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program.  If not, see <http://www.gnu.org/licenses/>.
