Metadata-Version: 2.1
Name: podmena
Version: 0.6.1
Summary: Enhance your commit messages with emoji
Home-page: https://github.com/bmwant/podmena
License: Unlicense
Keywords: git,hook,fun,emoji,commit
Author: Misha Behersky
Author-email: bmwant@gmail.com
Requires-Python: >=3.6.2,<4.0.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Unix Shell
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Topic :: Utilities
Requires-Dist: click (>=8.0,<9.0)
Project-URL: Blog post, https://bmwlog.pp.ua/
Project-URL: Repository, https://github.com/bmwant/podmena
Description-Content-Type: text/markdown

<h2 align="center">podmena</h2>

<p align="center">
  <a href="https://github.com/bmwant/podmena/actions">
    <img alt="Checks" src="https://github.com/bmwant/podmena/actions/workflows/tests.yml/badge.svg">
  </a>

  <a href="https://pypi.org/project/podmena/">
    <img alt="PyPI" src="https://img.shields.io/pypi/v/podmena">
  </a>

  <a href="https://github.com/psf/black">
    <img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg">
  </a>
</p>
<p align="center">
Enhance your commit messages with emoji 🍒
</p>

podmena will automatically add random emoji to every commit message for any
git repository installed for.

![emoji](https://github.com/bmwant/podmena/blob/main/podmena.png)

**868** items in database so far!

Credits go to [WebFX](https://www.webfx.com/tools/emoji-cheat-sheet/) for list of emoji!

### Installation

```bash
$ pip install podmena
```

* Activate for current git repository

```bash
$ podmena add local
```

You can also replace `add` with a different alias

`activate` / `enable` / `install` / `on`

e.g. `podmena enable local`

* Activate globally for all repositories (works with git `2.9.1` and above)

```bash
$ git --version
$ podmena add global  # Aliases work here as well
```

* Deactivate it
```bash
$ podmena rm local
$ podmena rm global
```

You can replace `rm` with any of these available aliases

`remove` / `delete` / `deactivate` / `disable` / `off` / `uninstall`

e.g. `podmena deactivate local`

* Check current status if you not sure

```bash
$ podmena status
```

* And finally `podmena --version` and `podmena --help` in case you need more
details.

> **NOTE:** uninstalling globally will not remove hooks from repositories where
it was installed locally. You need to switch to that directory manually and uninstall it locally as well.

### Preview

See [PREVIEW.md](https://github.com/bmwant/podmena/blob/main/PREVIEW.md) for the full list of icons in the database and to check how GitHub renders them.
### Contribute

See [DEVELOP.md](https://github.com/bmwant/podmena/blob/main/DEVELOP.md) to setup your local development environment and feel free to create a pull request with a new feature.

### Releases

See [CHANGELOG.md](https://github.com/bmwant/podmena/blob/main/CHANGELOG.md) for the new features included within each release.

### See also

* [GitHooks](https://githooks.com/)
* [Atlassian tutorial for git hooks](https://www.atlassian.com/git/tutorials/git-hooks)
Thanks [@kakovskyi](https://github.com/kakovskyi) working for Atlassian!
* It's a wrong place to search if you are looking for 🍋 lemonparty.fun 🍋 club

### Say thanks!

🐶 `D7DA74qzZUyh9cctCxWovPTEovUSjGzL2S` this is [Dogecoin](https://dogecoin.com/) wallet to support the project.

