usts


Nameusts JSON
Version 0.1.81 PyPI version JSON
download
home_pagehttps://notabug.org/loliconshik3/usts
SummarySimple cli tool for creating status text to something like dwm-bar.
upload_time2023-04-08 05:10:57
maintainer
docs_urlNone
authorloliconshik3
requires_python
license
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # usts 

Simple cli tool for creating status text to something like dwm-bar.

## Modules

| Module    | Dependencies | Description                                                                                                            |
| :---:     | :---:        | :---                                                                                                                   |
| `str`     |              | Display string.                                                                                                        |
| `time`    | `datetime`   | Display current time with strftime formating.                                                                          |
| `cpu`     | `psutil`     | Display percent of cpu usage.                                                                                          |
| `ram`     | `psutil`     | Display memory usage (percent, available, etc...)                                                                      |
| `disk`    | `os`         | Display disk usage (free, available, total)                                                                            |
| `temp`    | `psutil`     | Display temperature (cpu, gpu, etc...)                                                                                 | 
| `weather` | `requests`   | Display weather from city with openweathermap.org api. [Weather icons.](https://github.com/erikflowers/weather-icons)  |
| `xkbstate`| `subprocess` | Display keyboard layout with [xkblayout-state](https://github.com/nonpop/xkblayout-state) utility.                     | 
| `bat`     | `psutil`     | Display battery level.                                                                                                 |

## Installation

```sh
$ pip install usts
```

## ~/.config/usts/config.py example

```py
# import modules from mkmod.py file
from usts.mkmod import *
# You also can import each module at self
from usts.modules.modcpu import ModCPU

# setup list of items
items = [
    ModuleWeather("API_KEY", 
                  city="London", country="UK"),
    ModuleTemp(),
    ModuleCPU(),
    # print example -> RAM: 10.1/16.0Gb
    ModuleRAM("RAM: {used}/{total}{data_format}", data_format="Gb"),
    # print example -> /: 121.3Gb
    ModuleDisk("{path}: {free}{data_format}"),  
    ModuleTime(),
    ModuleStr("☭")
]

# Execute is action with status
#   setxroot -> setxroot -name "status"
#   stdout   -> just print status in terminal
execute = "stdout"
# Separator between modules
#   like: text1 SEPARATOR text2 SEPARATOR text3
separator = " | "
# Update periodic is sleep time between updating display
update_periodic = 1.0
```

## Usage

```sh
$ usts
```

## Contacts

| Contact                                               | Description       |
| :---:                                                 | :---              |
| [`Matrix`](https://matrix.to/#/#librehub:matrix.org)  | Matrix server.    |
| [`Discord`](https://discord.gg/naGkzRN)               | Discord server.   |

## Donates
**Monero:** `47KkgEb3agJJjSpeW1LpVi1M8fsCfREhnBCb1yib5KQgCxwb6j47XBQAamueByrLUceRinJqveZ82UCbrGqrsY9oNuZ97xN`


            

Raw data

            {
    "_id": null,
    "home_page": "https://notabug.org/loliconshik3/usts",
    "name": "usts",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "",
    "author": "loliconshik3",
    "author_email": "",
    "download_url": "",
    "platform": null,
    "description": "# usts \n\nSimple cli tool for creating status text to something like dwm-bar.\n\n## Modules\n\n| Module    | Dependencies | Description                                                                                                            |\n| :---:     | :---:        | :---                                                                                                                   |\n| `str`     |              | Display string.                                                                                                        |\n| `time`    | `datetime`   | Display current time with strftime formating.                                                                          |\n| `cpu`     | `psutil`     | Display percent of cpu usage.                                                                                          |\n| `ram`     | `psutil`     | Display memory usage (percent, available, etc...)                                                                      |\n| `disk`    | `os`         | Display disk usage (free, available, total)                                                                            |\n| `temp`    | `psutil`     | Display temperature (cpu, gpu, etc...)                                                                                 | \n| `weather` | `requests`   | Display weather from city with openweathermap.org api. [Weather icons.](https://github.com/erikflowers/weather-icons)  |\n| `xkbstate`| `subprocess` | Display keyboard layout with [xkblayout-state](https://github.com/nonpop/xkblayout-state) utility.                     | \n| `bat`     | `psutil`     | Display battery level.                                                                                                 |\n\n## Installation\n\n```sh\n$ pip install usts\n```\n\n## ~/.config/usts/config.py example\n\n```py\n# import modules from mkmod.py file\nfrom usts.mkmod import *\n# You also can import each module at self\nfrom usts.modules.modcpu import ModCPU\n\n# setup list of items\nitems = [\n    ModuleWeather(\"API_KEY\", \n                  city=\"London\", country=\"UK\"),\n    ModuleTemp(),\n    ModuleCPU(),\n    # print example -> RAM: 10.1/16.0Gb\n    ModuleRAM(\"RAM: {used}/{total}{data_format}\", data_format=\"Gb\"),\n    # print example -> /: 121.3Gb\n    ModuleDisk(\"{path}: {free}{data_format}\"),  \n    ModuleTime(),\n    ModuleStr(\"\u262d\")\n]\n\n# Execute is action with status\n#   setxroot -> setxroot -name \"status\"\n#   stdout   -> just print status in terminal\nexecute = \"stdout\"\n# Separator between modules\n#   like: text1 SEPARATOR text2 SEPARATOR text3\nseparator = \" | \"\n# Update periodic is sleep time between updating display\nupdate_periodic = 1.0\n```\n\n## Usage\n\n```sh\n$ usts\n```\n\n## Contacts\n\n| Contact                                               | Description       |\n| :---:                                                 | :---              |\n| [`Matrix`](https://matrix.to/#/#librehub:matrix.org)  | Matrix server.    |\n| [`Discord`](https://discord.gg/naGkzRN)               | Discord server.   |\n\n## Donates\n**Monero:** `47KkgEb3agJJjSpeW1LpVi1M8fsCfREhnBCb1yib5KQgCxwb6j47XBQAamueByrLUceRinJqveZ82UCbrGqrsY9oNuZ97xN`\n\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Simple cli tool for creating status text to something like dwm-bar.",
    "version": "0.1.81",
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "541c8c9bcdf37969504d4355b02a8591e2d87e35a8fd0e25fbfe83aae40ab08e",
                "md5": "10617ecbd6171b4367990273bf60061f",
                "sha256": "a27bdf7a3b2cbf2dff0e73a87d1aca57a3cf247a2f838d51f549a9826d2867a8"
            },
            "downloads": -1,
            "filename": "usts-0.1.81-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "10617ecbd6171b4367990273bf60061f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 23000,
            "upload_time": "2023-04-08T05:10:57",
            "upload_time_iso_8601": "2023-04-08T05:10:57.116180Z",
            "url": "https://files.pythonhosted.org/packages/54/1c/8c9bcdf37969504d4355b02a8591e2d87e35a8fd0e25fbfe83aae40ab08e/usts-0.1.81-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-04-08 05:10:57",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "usts"
}
        
Elapsed time: 0.06089s