Metadata-Version: 2.1
Name: pyworkon
Version: 0.1.1
Summary: Software Development Project Management Tool
Home-page: https://github.com/chassing/pyworkon
License: MIT
Author: Christian Assing
Author-email: chris@ca-net.org
Requires-Python: >=3.10.0,<4.0.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: PyYAML (>=6.0,<7.0)
Requires-Dist: appdirs (>=1.4.4,<2.0.0)
Requires-Dist: asgiref (>=3.5.0,<4.0.0)
Requires-Dist: fuzzyfinder (>=2.1.0,<3.0.0)
Requires-Dist: httpx (>0.22.0)
Requires-Dist: orm[sqlite] (>=0.3.1,<0.4.0)
Requires-Dist: prompt-toolkit (>=3.0.28,<4.0.0)
Requires-Dist: pydantic (>=1.9.0,<2.0.0)
Requires-Dist: python-nubia (>=0.2b5,<0.3)
Requires-Dist: rich (>=12.1.0,<13.0.0)
Requires-Dist: rich-click (>=1.3.0,<2.0.0)
Requires-Dist: sqlalchemy (>=1.4.41,<2.0.0,!=1.4.42)
Requires-Dist: textual (>=0.2.1,<0.3.0)
Requires-Dist: uplink-httpx (>=2.0,<3.0)
Project-URL: Bug Tracker, https://github.com/chassing/pyworkon/issues
Project-URL: Repository, https://github.com/chassing/pyworkon
Description-Content-Type: text/markdown

```bash
$$$$$$$\            $$\      $$\                     $$\
$$  __$$\           $$ | $\  $$ |                    $$ |
$$ |  $$ |$$\   $$\ $$ |$$$\ $$ | $$$$$$\   $$$$$$\  $$ |  $$\  $$$$$$\  $$$$$$$\
$$$$$$$  |$$ |  $$ |$$ $$ $$\$$ |$$  __$$\ $$  __$$\ $$ | $$  |$$  __$$\ $$  __$$\
$$  ____/ $$ |  $$ |$$$$  _$$$$ |$$ /  $$ |$$ |  \__|$$$$$$  / $$ /  $$ |$$ |  $$ |
$$ |      $$ |  $$ |$$$  / \$$$ |$$ |  $$ |$$ |      $$  _$$<  $$ |  $$ |$$ |  $$ |
$$ |      \$$$$$$$ |$$  /   \$$ |\$$$$$$  |$$ |      $$ | \$$\ \$$$$$$  |$$ |  $$ |
\__|       \____$$ |\__/     \__| \______/ \__|      \__|  \__| \______/ \__|  \__|
          $$\   $$ |
          \$$$$$$  |
           \______/
```
# PyWorkon

[![PyPI version][pypi-version]][pypi-link]
[![PyPI platforms][pypi-platforms]][pypi-link]
[![GitHub Discussion][github-discussions-badge]][github-discussions-link]
[![Conda-Forge][conda-badge]][conda-link]

PyWorkon is a command line interface to enter and manage your software projects. It is powered by [Nubia](https://github.com/facebookincubator/python-nubia) and [Rich](https://github.com/Textualize/rich) for the shell interface and [Textual](https://github.com/Textualize/textual) for it's TUI.

## Installation

You can install this library from [PyPI](https://pypi.org/project/pyworkon/) with `pip`:

```bash
python3 -m pip install pyworkon
```

or install it with `pipx`:
```bash
pipx install pyworkon
```


You can also use `pipx` to run the library without installing it:

```bash
pipx run pyworkon
```

## Features

pyworkon currently provides the following features (get help with `-h` or `--help`):

- Enter existing projects and start your favourite IDE (configurable)
- Project (GIT Repository) management
  - Create new projects from templates
  - Delete or archive projects
- Multiple (GIT hosting) providers
  - [GitHub](http://github.com/) and [GitHub Enterprise](https://github.com/enterprise)
  - [GitLab](https://gitlab.com/) and your self hosted GitLab instance(s)
  - [Bitbucket](https://bitbucket.org/)
- TUI (terminal user interface) and shell interface.
- Highly customizable


## Examples


**`workon` command:**

Enter an existing [GitHub project](https://github.com/chassing/pyworkon). (Github provider must be configured before hand)

![GIF of the workon command](https://github.com/chassing/pyworkon/releases/download/v0.3.0/tui.gif)


![GIF of the TUI functionality](https://github.com/chassing/pyworkon/releases/download/v0.3.0/tui.gif)


## Development

[![pre-commit.ci status][pre-commit-badge]][pre-commit-link]
[![Code style: black][black-badge]][black-link]

See [CONTRIBUTING.md](https://github.com/chassing/pyworkon/blob/main/.github/CONTRIBUTING.md) for details on how to set up a development environment.


[black-badge]:              https://img.shields.io/badge/code%20style-black-000000.svg
[black-link]:               https://github.com/psf/black
[conda-badge]:              https://img.shields.io/conda/vn/conda-forge/pyworkon
[conda-link]:               https://github.com/conda-forge/pyworkon-feedstock
[github-discussions-badge]: https://img.shields.io/static/v1?label=Discussions&message=Ask&color=blue&logo=github
[github-discussions-link]:  https://github.com/chassing/pyworkon/discussions
[pypi-link]:                https://pypi.org/project/pyworkon/
[pypi-platforms]:           https://img.shields.io/pypi/pyversions/pyworkon
[pypi-version]:             https://badge.fury.io/py/pyworkon.svg

