Skip to main content

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

Metadata

Release files for please-do-not-define 0.3.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for please-do-not-define 0.3.6
File Size Uploaded Provenance
please_do_not_define-0.3.6.tar.gz 49.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for please-do-not-define 0.3.6
File Interpreter ABI Platform
please_do_not_define-0.3.6-py3-none-any.whl Python 3 none any Details

Total release size: 56.1 kB

Release files / please_do_not_define-0.3.6.tar.gz

Download URL please_do_not_define-0.3.6.tar.gz
Size 49.3 kB
Tags Source
SHA-256 checksum
How to use checksums
7780c5a543fcf49842fe32f3f1b154e0d5aa6ca5e6789d8c220a4e305825c016
BLAKE2b-256 checksum
How to use checksums
567bbff3275a71c7975e5100f5cec060c629eb1857520c4f11bf20a4576330fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release files / please_do_not_define-0.3.6-py3-none-any.whl

Download URL please_do_not_define-0.3.6-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2583b2f4720ef1faa19dc16265edfb1d06d46bdbd697e4a8309322ca83eb8175
BLAKE2b-256 checksum
How to use checksums
57de90d18258768a8a76eb568b66d069d41349add25c8ca06d3ac200c970d3ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Security for please-do-not-define 0.3.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page