Metadata-Version: 2.1
Name: UzParser
Version: 0.0.1
Summary: uzparser | Uzbek Syntax Parser on Python
Home-page: https://github.com/UlugbekSalaev/uztagger
Author: Mardona Karimova
Author-email: karimovaam@gmail.com
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/UlugbekSalaev/uztagger/issues
Keywords: mophology,uzbek-language,pos tagging,morphological tagging
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: UzMorphAnalyser
Requires-Dist: pandas

# UzParser

https://pypi.org/project/uzparser <br>
https://github.com/UlugbekSalaev/uzparser

uztagger is focused to make tagging sentence with morphological Part of Speech (POS) tagset of Uzbek word based on morphemes and limited number of lexicon. The tool includes list of POS tagset, tagging method. 
It is created as a python library and uploaded to [PyPI](https://pypi.org/). It is simply easy to use in your python project or other programming language projects via the API. 

## About project
The tool is focused to make tagging sentence with morphological Part of Speech (POS) tagset of Uzbek word based on morphemes. The tool includes list of POS tagset, tagging method.

## Quick links

- [Github](https://github.com/UlugbekSalaev/uztagger)
- [PyPI](https://pypi.org/project/uztagger/)
- [Web-UI](https://nlp.urdu.uz/?menu=uztagger)

## Demo

You can use [web interface](http://nlp.urdu.uz/?menu=uztagger).

## Features

- Tagging 
- POS tag list
- Help function

## Usage

Three options to run uztagger:

- pip
- API 
- Web interface

### pip installation

To install uztagger, simply run:

```code
pip install uztagger
```

After installation, use in python like following:
```yml
# import the library
from uztagger import Tagger
# create an object 
tagger = Tagger()
# call tagging method
tagger.pos_tag('Bizlar bugun maktabga bormoqchimiz.')
# output
[('Bizlar','NOUN'),('bugun', 'NOUN'), ('maktabga', 'NOUN'), ('bormoqchimiz', 'VERB'), ('.', 'PUNC')]
```

### API
API configurations: 
 - Method: `GET`
 - Response type: `string`
 - URL: `https://nlp.urdu.uz:8080/uztagger/pos_tag`
   - Parameters: `text:string`
 - Sample Request: `https://nlp.urdu.uz:8080/uztagger/pos_tag?text=Ular%20maktabga%20borayaptilar.`
 - Sample output: `[("Ular","NOUN"),("maktabga",""),("borayaptilar",""),(".","PUNC")]`

### Web-UI

The web interface created to use easily the library:
You can use web interface [here](http://nlp.urdu.uz/?page=uztagger).

![Demo image](src/UzParser/web-interface-ui.png)

### POS tag list
Tagger using following options as POS tag:<br>
    `NOUN`  Noun<br>
    `VERB`  Verb<br>
    `ADJ `  Adjective<br>
    `NUM `  Numeric<br>
    `ADV `  Adverb<br>
    `PRN `  Pronoun<br>
    `CNJ `  Conjunction<br>
    `ADP `  Adposition<br>
    `PRT `  Particle<br>
    `INTJ`  Interjection<br>
    `MOD `  Modal<br>
    `IMIT`  Imitation<br>
    `AUX `  Auxiliary verb<br>
    `PPN `  Proper noun<br>
    `PUNC`  Punctuation<br>
    `SYM `  Symbol<br>

### Result Explaining

The method ```pos_tag``` returns list, that an item of the list contain tuples for each token of the text with following format: ```(token, pos)```, for POS tag list, see <i>POS Tag List</i> section on above.  
#### Result from `tagger` method
`[('Bizlar','NOUN'),('bugun', 'NOUN'), ('maktabga', 'NOUN'), ('bormoqchimiz', 'VERB'), ('.', 'PUNC')]`

## Documentation

See [here](https://github.com/UlugbekSalaev/uztagger).

## Citation

```tex
@misc{uztagger,
  title={{uztagger}: Morphological Part of Speech Tagger Tool for Uzbek},
  url={https://github.com/UlugbekSalaev/uztagger},
  note={Software available from https://github.com/UlugbekSalaev/uztagger},
  author={
    Ulugbek Salaev},
  year={2022},
}
```

## Contact

For help and feedback, please feel free to contact [the author](https://github.com/UlugbekSalaev).

