Metadata-Version: 2.4
Name: who_added_this_tag
Version: 0.0.3
Summary: A tool to research who added given OSM tags currently in use
Home-page: https://codeberg.org/matkoniecz/who-added-this-tag
Author: Mateusz Konieczny
Author-email: matkoniecz@tutanota.com
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: COPYING
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: summary

Tool for tracking down who added specific tag. It exists as a Python package, so you need to write a Python script to use it (see an example below).

Will work fine for tags used on a small scale.

As it will use editing API to retrieve old versions of each object, it is acceptable to use it sparingly. For serious uses lease use less hacky tool (import [planet](https://planet.openstreetmap.org/) history)

But for investigating who added tag appearing 1017 times every few days? Should be fine.

It can be useful to

- notify editors about tagging discussion
- easily track down who was adding specific tag which is unclear/dubious/problematic

# Usage example

```
import who_added_this_tag
import rich

config = {
    'key': 'related:wikipedia',
    'value': None, # may be None - in such case it looks for all values of key
    'area_identifier_key': None, # may be None, in such case search is worldwide, 'ISO3166-1' is a good identifier
    'area_identifier_value': 'PL', # ignored if area_identifier_key is None
    'list_all_edits': True,
    'list_all_edits_made_by_this_users': [], # ignored with list_all_edits set to True
    'download_engine_used': "overpass", # postpass can be also used
    'queried_object_limit': 5_000,
}
data = who_added_this_tag.statistics.process_case(config)
for entry in data:
    rich.print(entry)
```

note: experimental `who_added_this_tag.statistics.process_case(config, download_engine_used="postpass")` is also available

# Run tests

```
python3 -m unittest
```

# pypi

See [https://pypi.org/project/who-added-this-tag/](https://pypi.org/project/who-added-this-tag/)
