# Dekimashita
**a library containing a collection of utility functions designed to filter and process text data based on certain criteria. These functions are useful for various text processing tasks, such as removing unwanted characters, extracting specific information, or cleaning input data.**
## Features ✨
- **Alphabetic Filtering**: Easily filter out non-alphabetic characters from text data.
- **Numeric Filtering**: Quickly remove non-numeric characters from text strings.
- **Alphanumeric Filtering**: Filter text to retain only alphanumeric characters, excluding special symbols.
- **Customization**: Ability to customize the filtering criteria based on specific requirements.
- **TextCleaning**: Cleanse input text from unwanted characters to prepare it for further processing or analysis.
- **Normalization**: Standardize text data by removing irregular characters or symbols
## Requirement ⚙️
- [Python](https://www.python.org/) v3.11.6+
## Installation 🛠️
```sh
pip install dekimashita
```
## How To Usage 🤔
#### 1. Dekimashita.vdict(data, [chars])
Filter dictionary values recursively, ignoring specified characters.
Args:
data (dict or list): Data (dictionary or list containing dictionaries) to filter.
chars (list): List of characters to filter.
Returns:
dict or list: Filtered data.
### ⚠️ Sample ⚠️
```python
data = {
"university": {
"name": "Example University",
"location": "City XYZ",
"courses": [
{
"course_id": "CS101",
"title": "Introduction \n to \n Computer \n\n Science",
"lecturer": {
"name": "Dr. Alan\n Smith",
"email": "alan.smith@example.com",
"office": {
"building": "Engineering Tower",
"room_number": "123"
}
},
"students": {
"name": "John Doe",
"student_id": "123456",
"email": "john.doe@example.com",
"grades": {
"assignments": [
{
"assignment_id": "001",
"score": 95,
"comments": "Great job on the assignment!\nKeep up the good work."
},
{
"assignment_id": "002",
"score": 85,
"comments": "Your\n effort is commendable.\r\r However,\nthere is room"
}
],
"final_exam": {
"score": 88,
"comments": "Solid \nperformance overall.\n\rYour understanding of the subject"
}
}
}
}
]
}
}
```
<br>
#### without Dekimashita filter
```python
import json
data = # data_sample
with open("data.json", "w") as json_file:
json.dump(data, json_file, indent=4)
```
#### If you have a very complex dictionary and you write without using the Dekimashita filter you will get results like this
<br>
<div style="text-align: center;">
<img src="https://raw.githubusercontent.com/ryyos/ryyos/main/images/Dekimashita/nopng.png">
</div>
<br>
#### with Dekimashita filter
```python
import json
from dekimashita import Dekimashita
data = # data_sample
clear = Dekimashita.vdict(data, ['\n', '\r'])
with open("data.json", "w") as json_file:
json.dump(clear, json_file, indent=4)
```
#### By using the Dekimashita filter you get a clean dictionary like this
<br>
<div style="text-align: center;">
<img src="https://raw.githubusercontent.com/ryyos/ryyos/main/images/Dekimashita/yeee.png">
</div>
<br>
#### 2. Dekimashita.vspace(text)
Remove extra spaces from text.
Args:
text (str): Input text.
Returns:
str: Text with extra spaces removed.
### sample
```python
from dekimashita import Dekimashita
text = 'moon beautiful isn"t it'
clear = Dekimashita.vspace(text)
print('without Dekimashita filter: '+ text)
print('with Dekimashita filter: ' + clear)
```
```
# output
without Dekimashita filter: moon beautiful isn"t it
with Dekimashita filter: moon beautiful isn"t it
```
#### 3. Dekimashita.valpha(text)
Remove non-alphabetic characters (except a-z, A-Z) from text.
Args:
text (str): Input text.
Returns:
str: Filtered text containing only alphabetic characters.
### sample
```python
from dekimashita import Dekimashita
text = 'mo&on b)(*&^%$e!au!t@#$i*f!ul is!!$#n"t i)(*&^t'
clear = Dekimashita.valpha(text)
print('without Dekimashita filter: '+ text)
print('with Dekimashita filter: ' + clear)
```
```
# output
without Dekimashita filter: mo&on b)(*&^%$e!au!t@#$i*f!ul is!!$#n"t i)(*&^t
with Dekimashita filter: moon beautiful isnt it
```
#### 4. Dekimashita.vnum(text)
Remove non-numeric characters from text.
Args:
text (str): Input text.
Returns:
str: Filtered text containing only numeric characters.
### sample
```python
from dekimashita import Dekimashita
text = ' mo30on be7aut20iful i05sn"t it'
clear = Dekimashita.vnum(text)
print('without Dekimashita filter: '+ text)
print('with Dekimashita filter: ' + clear)
```
```
# output
without Dekimashita filter: mo30on be7aut20iful i05sn"t it
with Dekimashita filter: 3072005
```
#### 5. Dekimashita.vtext(text)
Remove non-alphanumeric characters (except a-z, A-Z, 0-9) from text.
Double spaces are replaced with a single space.
Args:
text (str): Input text.
Returns:
str: Filtered text containing only alphanumeric characters.
### sample
```python
from dekimashita import Dekimashita
text = 'moon \t\t bea^%$#@utiful isn"t it 30705'
clear = Dekimashita.vtext(text)
print('without Dekimashita filter: '+ text)
print('with Dekimashita filter: ' + clear)
```
```
# output
without Dekimashita filter: moon bea^%$#@utiful isn"t it 30705
with Dekimashita filter: moon beautiful isnt it 30705
```
#### 6. Dekimashita.vdir(text, separator)
"""
Remove non-alphanumeric characters (except a-z, A-Z, 0-9) from text.
Convert all letters to lowercase. Replace spaces with a specified separator.
Double separators are replaced with a single separator.
Args:
text (str): Input text.
separator (str): Separator to replace spaces (default is '_').
Returns:
str: Filtered and normalized text.
"""
### sample
```python
from dekimashita import Dekimashita
text = 'Moon Beautiful Isn"t It'
clear = Dekimashita.vdir(text)
print('without Dekimashita filter: '+ text)
print('with Dekimashita filter: ' + clear)
```
```
# output
without Dekimashita filter: Moon Beautiful Isn"t It
with Dekimashita filter: moon_beautiful_isnt_it
```
## 🚀Structure
```
│ LICENSE
│ README.md
│ setup.py
│
└───dekimashita
dekimashita.py
__init__.py
```
## Author
👤 **Rio Dwi Saputra**
- Twitter: [@ryyo_cs](https://twitter.com/ryyo_cs)
- Github: [@ryyos](https://github.com/ryyos)
- Instagram: [@ryyo.cs](https://www.instagram.com/ryyo.cs/)
- LinkedIn: [@rio-dwi-saputra-23560b287](https://www.linkedin.com/in/rio-dwi-saputra-23560b287/)
<a href="https://www.linkedin.com/in/rio-dwi-saputra-23560b287/">
<img align="left" alt="Ryo's LinkedIn" width="24px" src="https://cdn.jsdelivr.net/npm/simple-icons@v3/icons/linkedin.svg" />
</a>
<a href="https://www.instagram.com/ryyo.cs/">
<img align="left" alt="Ryo's Instagram" width="24px" src="https://cdn.jsdelivr.net/npm/simple-icons@v3/icons/instagram.svg" />
</a>
Raw data
{
"_id": null,
"home_page": "",
"name": "dekimashita",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "filter,dictionary,text,textCleaning,alphabetic",
"author": "ryyos (Rio Dwi Saputra)",
"author_email": "<riodwi12174@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/f4/c8/4584c762b180189e461bbc77638bcbc6aeb5c7141cd6c8a9260c04ac2a9c/dekimashita-0.0.3.tar.gz",
"platform": null,
"description": "\r\n# Dekimashita\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n**a library containing a collection of utility functions designed to filter and process text data based on certain criteria. These functions are useful for various text processing tasks, such as removing unwanted characters, extracting specific information, or cleaning input data.**\r\n\r\n\r\n\r\n## Features \u2728\r\n\r\n\r\n\r\n- **Alphabetic Filtering**: Easily filter out non-alphabetic characters from text data.\r\n\r\n- **Numeric Filtering**: Quickly remove non-numeric characters from text strings.\r\n\r\n- **Alphanumeric Filtering**: Filter text to retain only alphanumeric characters, excluding special symbols.\r\n\r\n- **Customization**: Ability to customize the filtering criteria based on specific requirements.\r\n\r\n- **TextCleaning**: Cleanse input text from unwanted characters to prepare it for further processing or analysis.\r\n\r\n- **Normalization**: Standardize text data by removing irregular characters or symbols\r\n\r\n\r\n\r\n## Requirement \u2699\ufe0f\r\n\r\n\r\n\r\n- [Python](https://www.python.org/) v3.11.6+\r\n\r\n\r\n\r\n## Installation \ud83d\udee0\ufe0f\r\n\r\n\r\n\r\n```sh\r\n\r\npip install dekimashita\r\n\r\n```\r\n\r\n\r\n\r\n## How To Usage \ud83e\udd14\r\n\r\n\r\n\r\n#### 1. Dekimashita.vdict(data, [chars])\r\n\r\n\r\n\r\n Filter dictionary values recursively, ignoring specified characters.\r\n\r\n\r\n\r\n Args:\r\n\r\n data (dict or list): Data (dictionary or list containing dictionaries) to filter.\r\n\r\n chars (list): List of characters to filter.\r\n\r\n\r\n\r\n Returns:\r\n\r\n dict or list: Filtered data.\r\n\r\n\r\n\r\n### \u26a0\ufe0f Sample \u26a0\ufe0f\r\n\r\n\r\n\r\n```python\r\n\r\ndata = {\r\n\r\n \"university\": {\r\n\r\n \"name\": \"Example University\",\r\n\r\n \"location\": \"City XYZ\",\r\n\r\n \"courses\": [\r\n\r\n {\r\n\r\n \"course_id\": \"CS101\",\r\n\r\n \"title\": \"Introduction \\n to \\n Computer \\n\\n Science\",\r\n\r\n \"lecturer\": {\r\n\r\n \"name\": \"Dr. Alan\\n Smith\",\r\n\r\n \"email\": \"alan.smith@example.com\",\r\n\r\n \"office\": {\r\n\r\n \"building\": \"Engineering Tower\",\r\n\r\n \"room_number\": \"123\"\r\n\r\n }\r\n\r\n },\r\n\r\n \"students\": {\r\n\r\n \"name\": \"John Doe\",\r\n\r\n \"student_id\": \"123456\",\r\n\r\n \"email\": \"john.doe@example.com\",\r\n\r\n \"grades\": {\r\n\r\n \"assignments\": [\r\n\r\n {\r\n\r\n \"assignment_id\": \"001\",\r\n\r\n \"score\": 95,\r\n\r\n \"comments\": \"Great job on the assignment!\\nKeep up the good work.\"\r\n\r\n },\r\n\r\n {\r\n\r\n \"assignment_id\": \"002\",\r\n\r\n \"score\": 85,\r\n\r\n \"comments\": \"Your\\n effort is commendable.\\r\\r However,\\nthere is room\"\r\n\r\n }\r\n\r\n ],\r\n\r\n \"final_exam\": {\r\n\r\n \"score\": 88,\r\n\r\n \"comments\": \"Solid \\nperformance overall.\\n\\rYour understanding of the subject\"\r\n\r\n }\r\n\r\n }\r\n\r\n }\r\n\r\n }\r\n\r\n ]\r\n\r\n }\r\n\r\n}\r\n\r\n```\r\n\r\n\r\n\r\n<br>\r\n\r\n\r\n\r\n#### without Dekimashita filter\r\n\r\n\r\n\r\n```python\r\n\r\nimport json\r\n\r\n\r\n\r\ndata = # data_sample\r\n\r\n\r\n\r\nwith open(\"data.json\", \"w\") as json_file:\r\n\r\n json.dump(data, json_file, indent=4)\r\n\r\n```\r\n\r\n\r\n\r\n#### If you have a very complex dictionary and you write without using the Dekimashita filter you will get results like this\r\n\r\n\r\n\r\n<br>\r\n\r\n<div style=\"text-align: center;\">\r\n\r\n <img src=\"https://raw.githubusercontent.com/ryyos/ryyos/main/images/Dekimashita/nopng.png\"> \r\n\r\n</div>\r\n\r\n<br>\r\n\r\n\r\n\r\n#### with Dekimashita filter\r\n\r\n\r\n\r\n```python\r\n\r\nimport json\r\n\r\nfrom dekimashita import Dekimashita\r\n\r\n\r\n\r\ndata = # data_sample\r\n\r\nclear = Dekimashita.vdict(data, ['\\n', '\\r'])\r\n\r\n\r\n\r\nwith open(\"data.json\", \"w\") as json_file:\r\n\r\n json.dump(clear, json_file, indent=4)\r\n\r\n```\r\n\r\n\r\n\r\n#### By using the Dekimashita filter you get a clean dictionary like this\r\n\r\n\r\n\r\n<br>\r\n\r\n<div style=\"text-align: center;\">\r\n\r\n <img src=\"https://raw.githubusercontent.com/ryyos/ryyos/main/images/Dekimashita/yeee.png\"> \r\n\r\n</div>\r\n\r\n<br>\r\n\r\n\r\n\r\n#### 2. Dekimashita.vspace(text)\r\n\r\n\r\n\r\n Remove extra spaces from text.\r\n\r\n\r\n\r\n Args:\r\n\r\n text (str): Input text.\r\n\r\n\r\n\r\n Returns:\r\n\r\n str: Text with extra spaces removed.\r\n\r\n\r\n\r\n### sample\r\n\r\n\r\n\r\n```python\r\n\r\nfrom dekimashita import Dekimashita\r\n\r\n\r\n\r\ntext = 'moon beautiful isn\"t it'\r\n\r\n\r\n\r\nclear = Dekimashita.vspace(text)\r\n\r\n\r\n\r\nprint('without Dekimashita filter: '+ text)\r\n\r\nprint('with Dekimashita filter: ' + clear)\r\n\r\n```\r\n\r\n\r\n\r\n```\r\n\r\n# output\r\n\r\n\r\n\r\nwithout Dekimashita filter: moon beautiful isn\"t it\r\n\r\nwith Dekimashita filter: moon beautiful isn\"t it\r\n\r\n```\r\n\r\n\r\n\r\n#### 3. Dekimashita.valpha(text)\r\n\r\n\r\n\r\n Remove non-alphabetic characters (except a-z, A-Z) from text.\r\n\r\n\r\n\r\n Args:\r\n\r\n text (str): Input text.\r\n\r\n\r\n\r\n Returns:\r\n\r\n str: Filtered text containing only alphabetic characters.\r\n\r\n\r\n\r\n### sample\r\n\r\n\r\n\r\n```python\r\n\r\nfrom dekimashita import Dekimashita\r\n\r\n\r\n\r\ntext = 'mo&on b)(*&^%$e!au!t@#$i*f!ul is!!$#n\"t i)(*&^t'\r\n\r\n\r\n\r\nclear = Dekimashita.valpha(text)\r\n\r\n\r\n\r\nprint('without Dekimashita filter: '+ text)\r\n\r\nprint('with Dekimashita filter: ' + clear)\r\n\r\n```\r\n\r\n\r\n\r\n```\r\n\r\n# output\r\n\r\n\r\n\r\nwithout Dekimashita filter: mo&on b)(*&^%$e!au!t@#$i*f!ul is!!$#n\"t i)(*&^t\r\n\r\nwith Dekimashita filter: moon beautiful isnt it\r\n\r\n```\r\n\r\n\r\n\r\n#### 4. Dekimashita.vnum(text)\r\n\r\n\r\n\r\n Remove non-numeric characters from text.\r\n\r\n\r\n\r\n Args:\r\n\r\n text (str): Input text.\r\n\r\n\r\n\r\n Returns:\r\n\r\n str: Filtered text containing only numeric characters.\r\n\r\n\r\n\r\n### sample\r\n\r\n\r\n\r\n```python\r\n\r\nfrom dekimashita import Dekimashita\r\n\r\n\r\n\r\ntext = ' mo30on be7aut20iful i05sn\"t it'\r\n\r\n\r\n\r\nclear = Dekimashita.vnum(text)\r\n\r\n\r\n\r\nprint('without Dekimashita filter: '+ text)\r\n\r\nprint('with Dekimashita filter: ' + clear)\r\n\r\n\r\n\r\n```\r\n\r\n\r\n\r\n```\r\n\r\n# output\r\n\r\n\r\n\r\nwithout Dekimashita filter: mo30on be7aut20iful i05sn\"t it\r\n\r\nwith Dekimashita filter: 3072005\r\n\r\n```\r\n\r\n\r\n\r\n#### 5. Dekimashita.vtext(text)\r\n\r\n\r\n\r\n Remove non-alphanumeric characters (except a-z, A-Z, 0-9) from text.\r\n\r\n Double spaces are replaced with a single space.\r\n\r\n\r\n\r\n Args:\r\n\r\n text (str): Input text.\r\n\r\n\r\n\r\n Returns:\r\n\r\n str: Filtered text containing only alphanumeric characters.\r\n\r\n\r\n\r\n### sample\r\n\r\n\r\n\r\n```python\r\n\r\nfrom dekimashita import Dekimashita\r\n\r\n\r\n\r\ntext = 'moon \\t\\t bea^%$#@utiful isn\"t it 30705'\r\n\r\n\r\n\r\nclear = Dekimashita.vtext(text)\r\n\r\n\r\n\r\nprint('without Dekimashita filter: '+ text)\r\n\r\nprint('with Dekimashita filter: ' + clear)\r\n\r\n\r\n\r\n```\r\n\r\n\r\n\r\n```\r\n\r\n# output\r\n\r\n\r\n\r\nwithout Dekimashita filter: moon bea^%$#@utiful isn\"t it 30705\r\n\r\nwith Dekimashita filter: moon beautiful isnt it 30705\r\n\r\n```\r\n\r\n\r\n\r\n#### 6. Dekimashita.vdir(text, separator)\r\n\r\n\r\n\r\n \"\"\"\r\n\r\n Remove non-alphanumeric characters (except a-z, A-Z, 0-9) from text.\r\n\r\n Convert all letters to lowercase. Replace spaces with a specified separator.\r\n\r\n Double separators are replaced with a single separator.\r\n\r\n\r\n\r\n Args:\r\n\r\n text (str): Input text.\r\n\r\n separator (str): Separator to replace spaces (default is '_').\r\n\r\n\r\n\r\n Returns:\r\n\r\n str: Filtered and normalized text.\r\n\r\n \"\"\"\r\n\r\n\r\n\r\n### sample\r\n\r\n\r\n\r\n```python\r\n\r\nfrom dekimashita import Dekimashita\r\n\r\n\r\n\r\ntext = 'Moon Beautiful Isn\"t It'\r\n\r\n\r\n\r\nclear = Dekimashita.vdir(text)\r\n\r\n\r\n\r\nprint('without Dekimashita filter: '+ text)\r\n\r\nprint('with Dekimashita filter: ' + clear)\r\n\r\n```\r\n\r\n\r\n\r\n```\r\n\r\n# output\r\n\r\n\r\n\r\nwithout Dekimashita filter: Moon Beautiful Isn\"t It\r\n\r\nwith Dekimashita filter: moon_beautiful_isnt_it\r\n\r\n```\r\n\r\n\r\n\r\n## \ud83d\ude80Structure\r\n\r\n\r\n\r\n```\r\n\r\n\u2502 LICENSE\r\n\r\n\u2502 README.md\r\n\r\n\u2502 setup.py\r\n\r\n\u2502\r\n\r\n\u2514\u2500\u2500\u2500dekimashita\r\n\r\n dekimashita.py\r\n\r\n __init__.py\r\n\r\n```\r\n\r\n\r\n\r\n## Author\r\n\r\n\r\n\r\n\ud83d\udc64 **Rio Dwi Saputra**\r\n\r\n\r\n\r\n- Twitter: [@ryyo_cs](https://twitter.com/ryyo_cs)\r\n\r\n- Github: [@ryyos](https://github.com/ryyos)\r\n\r\n- Instagram: [@ryyo.cs](https://www.instagram.com/ryyo.cs/)\r\n\r\n- LinkedIn: [@rio-dwi-saputra-23560b287](https://www.linkedin.com/in/rio-dwi-saputra-23560b287/)\r\n\r\n\r\n\r\n<a href=\"https://www.linkedin.com/in/rio-dwi-saputra-23560b287/\">\r\n\r\n <img align=\"left\" alt=\"Ryo's LinkedIn\" width=\"24px\" src=\"https://cdn.jsdelivr.net/npm/simple-icons@v3/icons/linkedin.svg\" />\r\n\r\n</a>\r\n\r\n<a href=\"https://www.instagram.com/ryyo.cs/\">\r\n\r\n <img align=\"left\" alt=\"Ryo's Instagram\" width=\"24px\" src=\"https://cdn.jsdelivr.net/npm/simple-icons@v3/icons/instagram.svg\" />\r\n\r\n</a>\r\n\r\n",
"bugtrack_url": null,
"license": "",
"summary": "Library designed to process text with various filter criteria",
"version": "0.0.3",
"project_urls": null,
"split_keywords": [
"filter",
"dictionary",
"text",
"textcleaning",
"alphabetic"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "41586280029ee3ddd708adf1917299557a8cf0f62ef69ccda51db1781cc1452a",
"md5": "eedfac6a75ec3bc207c672d9ddf6f516",
"sha256": "74ce20e2e18f8f367d1bfd48e39a2bf895a45fc18517645b67935166d16d22f1"
},
"downloads": -1,
"filename": "dekimashita-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eedfac6a75ec3bc207c672d9ddf6f516",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9071,
"upload_time": "2024-02-20T16:42:36",
"upload_time_iso_8601": "2024-02-20T16:42:36.356947Z",
"url": "https://files.pythonhosted.org/packages/41/58/6280029ee3ddd708adf1917299557a8cf0f62ef69ccda51db1781cc1452a/dekimashita-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f4c84584c762b180189e461bbc77638bcbc6aeb5c7141cd6c8a9260c04ac2a9c",
"md5": "b50c13c63bbaef70d908e657cfb86b27",
"sha256": "2d928f8e2618220d43dfe7809ed08cb85d165b8f4a60d86e475040383b78cec2"
},
"downloads": -1,
"filename": "dekimashita-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "b50c13c63bbaef70d908e657cfb86b27",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9166,
"upload_time": "2024-02-20T16:43:01",
"upload_time_iso_8601": "2024-02-20T16:43:01.842618Z",
"url": "https://files.pythonhosted.org/packages/f4/c8/4584c762b180189e461bbc77638bcbc6aeb5c7141cd6c8a9260c04ac2a9c/dekimashita-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-20 16:43:01",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "dekimashita"
}
JSON