# please_do_not_define
Python library that prevents you from defining variables, functions or classes with names that contain female-related terms.
Now that a small number of women declare that they are undefinedable. The library will make sure that you won't offend them.
## Installation
`pip install please_do_not_define`
## Purpose
This library helps maintain gender-neutral naming in your Python code by detecting and blocking the use of female-related terms in variable, function, and class names.
## Features
- Scans Python code for names containing female-related terms
- Blocks execution if prohibited names are found
- Supports detection of both English and Chinese female-related terms
- Works with various file encodings
## Usage
Simply import the library in your Python script:
`import please_do_not_define`
The library will automatically scan your main script file when imported and raise a NameError if any prohibited names are found.
## Prohibited Terms
The library checks for names containing any of the following terms (case insensitive):
- Chinese Terms:
`女, 姑, 婆, 媳, 妇, 娘, 嬷, 姐, 妹, 嬢, 媛`
- English Terms:
`woman, women, girl, lady, Miss, Mrs, queen, female, she, her`
## Example
If your code contains:
```
def print_girl_name():
pass
```
The library will raise:
`NameError: name 'print_girl_name' is illegal. Please don't try to define a female.`
## bin
The bin name is `checkname`, the usage is as follows:
- `checkname filename` check whether your filename has the illegal name
- `checkname -s code` check whether your input code has the illegal name
- `checkname -v` show the version of the library
- `checkname -h` show the help information
## Note
This library is intended to satirize a point of view, not to actually express this.
## License
MIT
Raw data
{
"_id": null,
"home_page": "https://github.com/Locked-chess-official/please_do_not_define",
"name": "please-do-not-define",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "naming-conventions code-quality gender-neutral",
"author": "Your Name",
"author_email": "13140752715@163.com",
"download_url": "https://files.pythonhosted.org/packages/fc/a2/67c492e39e4e4f3806ef8a6a66620be718c075d151b47e1ef4d2122dc66b/please_do_not_define-0.3.5.tar.gz",
"platform": null,
"description": "# please_do_not_define\r\nPython library that prevents you from defining variables, functions or classes with names that contain female-related terms.\r\nNow that a small number of women declare that they are undefinedable. The library will make sure that you won't offend them.\r\n\r\n## Installation\r\n\r\n`pip install please_do_not_define`\r\n\r\n## Purpose\r\n\r\nThis library helps maintain gender-neutral naming in your Python code by detecting and blocking the use of female-related terms in variable, function, and class names.\r\n\r\n## Features\r\n- Scans Python code for names containing female-related terms\r\n\r\n- Blocks execution if prohibited names are found\r\n\r\n- Supports detection of both English and Chinese female-related terms\r\n\r\n- Works with various file encodings\r\n\r\n## Usage\r\n\r\nSimply import the library in your Python script:\r\n\r\n`import please_do_not_define`\r\n\r\nThe library will automatically scan your main script file when imported and raise a NameError if any prohibited names are found.\r\n\r\n## Prohibited Terms\r\n\r\nThe library checks for names containing any of the following terms (case insensitive):\r\n\r\n- Chinese Terms:\r\n\r\n`\u5973, \u59d1, \u5a46, \u5ab3, \u5987, \u5a18, \u5b37, \u59d0, \u59b9, \u5b22, \u5a9b`\r\n\r\n- English Terms:\r\n\r\n`woman, women, girl, lady, Miss, Mrs, queen, female, she, her`\r\n\r\n## Example\r\n\r\nIf your code contains:\r\n```\r\ndef print_girl_name():\r\n pass\r\n```\r\n\r\nThe library will raise:\r\n\r\n`NameError: name 'print_girl_name' is illegal. Please don't try to define a female.`\r\n\r\n## bin\r\n\r\nThe bin name is `checkname`, the usage is as follows:\r\n\r\n- `checkname filename` check whether your filename has the illegal name\r\n- `checkname -s code` check whether your input code has the illegal name\r\n- `checkname -v` show the version of the library\r\n- `checkname -h` show the help information\r\n\r\n## Note\r\n\r\nThis library is intended to satirize a point of view, not to actually express this.\r\n\r\n## License\r\n\r\nMIT\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python library that prevents defining female-related names in code",
"version": "0.3.5",
"project_urls": {
"Bug Reports": "https://github.com/Locked-chess-official/please_do_not_define/issues",
"Homepage": "https://github.com/Locked-chess-official/please_do_not_define",
"Source": "https://github.com/Locked-chess-official/please_do_not_define"
},
"split_keywords": [
"naming-conventions",
"code-quality",
"gender-neutral"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "63e1e155b9e831c191729d0304f309903c04688823563646f26c1ad226966657",
"md5": "6ad040c632140e9772d31377afad5856",
"sha256": "cd3854194a145ffc9189798808f3e5a2fd6e8c8809bd0d773860f908ffcabb26"
},
"downloads": -1,
"filename": "please_do_not_define-0.3.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6ad040c632140e9772d31377afad5856",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 6926,
"upload_time": "2025-08-09T01:19:50",
"upload_time_iso_8601": "2025-08-09T01:19:50.463911Z",
"url": "https://files.pythonhosted.org/packages/63/e1/e155b9e831c191729d0304f309903c04688823563646f26c1ad226966657/please_do_not_define-0.3.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "fca267c492e39e4e4f3806ef8a6a66620be718c075d151b47e1ef4d2122dc66b",
"md5": "72bdaf5024bda3559b9bdc1071ccf766",
"sha256": "960f7b0d58ce2ed9d3edaaec3b86682ad9fa1f7ef49d82cc65a7c50b3fe6034c"
},
"downloads": -1,
"filename": "please_do_not_define-0.3.5.tar.gz",
"has_sig": false,
"md5_digest": "72bdaf5024bda3559b9bdc1071ccf766",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 49316,
"upload_time": "2025-08-09T01:19:51",
"upload_time_iso_8601": "2025-08-09T01:19:51.650656Z",
"url": "https://files.pythonhosted.org/packages/fc/a2/67c492e39e4e4f3806ef8a6a66620be718c075d151b47e1ef4d2122dc66b/please_do_not_define-0.3.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-09 01:19:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Locked-chess-official",
"github_project": "please_do_not_define",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "please-do-not-define"
}
JSON
