Metadata-Version: 2.4
Name: TermuxUO
Version: 0.2.8
Summary: A lightweight utility to open urls with python or with the cli that requires Zero extra dependencys
Author: Ruizennis
License: MIT
Project-URL: Homepage, https://github.com/Ruizennis/TermuxUO
Project-URL: Issues, https://github.com/Ruizennis/TermuxUO/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# TermuxUO
## Aka TermuxUrlOpener
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python Version](https://img.shields.io/badge/python-3.6%2B-blue.svg)](https://www.python.org)
[![PyPI version](https://img.shields.io/pypi/v/TermuxUO.svg?color=blue)](https://pypi.org/project/TermuxUO/)
[![PyPI downloads](https://img.shields.io/pypi/dm/TermuxUO.svg)](https://pypi.org/project/TermuxUO)

**Zero** Dependencys Required.

This dual function pip package & cli tool was made to solve an issue with Termux, not allowing opening urls in browser easily without their companion app; This package solves that.

Required packages:
**None**

Yeah thats right, this requires **Zero** extra packages to work it only needs access to ActivityManager and some python packages that are auto installed when getting python on 3.10+

## Cli Usage
Its dead simple.

All you have to do is type the command and then the url
```bash
termuxuo <url>
```
## Package Usage
Simply import the library and your good to go, just use the open_url function to open whatever url you passed in
```python
import TermuxUO
TermuxUO.openurl('https://example.com')
```
## Allow verbose output in python enviornment
To allow verbose in a python script import the varible and set it to True
```python
from TermuxUO import openurl, python_verbose_allowed
python_verbose_allowed = True
openurl('https://example.com', verbose=True)
```

## Installation
```bash
pip install TermuxUO
```
## Uninstallation
```bash
pip uninstall TermuxUO
```

## Flags
|Flag|Function        |
|----|----------------|
| -v | Verbose output |
| -V | Show version information|
| -h | Show help menu |

#### Aditional flag alliases
- --verbose
- --version
- --help

## Links!
View the pypi package [here](https://pypi.org/project/TermuxUO/)!

Open an issue [here](https://github.com/Ruizennis/TermuxUO/issues)!

View Android Developer docs on activity manager [here](https://developer.android.com/reference/android/app/ActivityManager)

## License information
This project is licensed under the Mit license, see [LICENSE](LICENSE)
