Metadata-Version: 2.1
Name: mac-tag
Version: 2019.3.22
Summary: MacOS Finder tags. github.com/jdberry/tag python implementation
Home-page: https://github.com/looking-for-a-job/mac-tag.py
License: UNKNOWN
Keywords: finder tag
Platform: UNKNOWN
Classifier: License :: Public Domain
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 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: Topic :: Software Development
Description-Content-Type: text/markdown
Requires-Dist: public
Requires-Dist: runcmd
Requires-Dist: setuptools
Requires-Dist: values

<!--
https://pypi.org/project/readme-generator/
-->

[![](https://img.shields.io/badge/OS-MacOS-blue.svg?longCache=True)]()
[![](https://img.shields.io/pypi/pyversions/mac-tag.svg?longCache=True)](https://pypi.org/project/mac-tag/)

#### Installation
```bash
$ [sudo] pip install mac-tag
```

#### Requirements
```bash
$ brew install tag
```

#### Functions
function|`__doc__`
-|-
`mac_tag.add(tags, path)` |add tags to path(s)
`mac_tag.find(tags, path=None)` |return a list of all paths with tags, limited to path(s) if present
`mac_tag.get(path)` |return dict where keys are paths, values are lists of tags. equivalent of `tag -l`
`mac_tag.match(tags, path)` |return a list of paths with with matching tags
`mac_tag.parse_list_output(out)` |parse `tag -l` output and return dict
`mac_tag.remove(tags, path)` |remove tags from path(s)
`mac_tag.update(tags, path)` |set path(s) tags. equivalent of `tag -s | --set`

#### Examples
```python
>>> mac_tag.update(["red","blue"],["path1","path2"])
>>> mac_tag.add(["green"],["path1","path2"])
```

```python
>>> mac_tag.get(["path1"])
{'path1': ['blue', 'red', 'green']}
```

```python
>>> mac_tag.remove(["red"],["path1","path2"])
>>> mac_tag.remove(["*"],["path1","path2"])
```

#### Links
+   [github.com/jdberry/tag](https://github.com/jdberry/tag)

<p align="center">
    <a href="https://pypi.org/project/readme-generator/">readme-generator</a>
</p>

