stdlb 0.0.3__py3-none-any.whl → 0.1.0__py3-none-any.whl

stdlb/__init__.py

@@ -1,31 +1,106 @@
+"""Wildcard-import the Python standard library.
+
+This file is auto-generated by scripts/generate_init.py.
+Do not edit manually.
+"""
+import sys
+
+import abc
+from abc import *
+
+import array
+from array import *
+
+import ast
+from ast import *
+
+import asyncio
+from asyncio import *
+
 import base64
 from base64 import *
 
+import binascii
+from binascii import *
+
+import bisect
+from bisect import *
+
+import calendar
+from calendar import *
+
+import cmath
+from cmath import *
+
+import code
+from code import *
+
+import codecs
+from codecs import *
+
+import collections
+from collections import *
+
 import configparser
 from configparser import *
 
 import contextlib
 from contextlib import *
 
+import copy
+from copy import *
+
+import csv
+from csv import *
+
 import dataclasses
 from dataclasses import *
 
+import datetime as _module_datetime
 from datetime import *
-from datetime import datetime as dt
-import datetime
-fromtimestamp = dt.fromtimestamp
-fromisoformat = dt.fromisoformat
+datetime = _module_datetime
+
+import decimal
+from decimal import *
+
+import difflib
+from difflib import *
+
+import enum
+from enum import *
+
+import fnmatch
+from fnmatch import *
+
+import fractions
+from fractions import *
 
 import functools
 from functools import *
-from .cached_property import cached_property
 
+import glob as _module_glob
 from glob import *
-import glob
+glob = _module_glob
+
+if sys.version_info >= (3, 9):
+    import graphlib
+    from graphlib import *
 
 import hashlib
 from hashlib import *
 
+import heapq
+from heapq import *
+
+import hmac
+from hmac import *
+
+import html
+from html import *
+
+import http
+from http import *
+
 import io
 from io import *
 
@@ -33,52 +108,192 @@ import itertools
 from itertools import *
 
 import json
+from json import *
+
+import locale
+from locale import *
+
+import logging
+from logging import *
 
 import math
 from math import *
 
-import os
+import mimetypes
+from mimetypes import *
+
+import numbers
+from numbers import *
+
+import operator
+from operator import *
+
+import os as _module_os
 from os import *
-open = __builtins__['open']
-from os.path import *
+os = _module_os
 
 import pathlib
 from pathlib import *
 
+import pickle
+from pickle import *
+
+import platform
+from platform import *
+
+import pprint
+from pprint import *
+
+import queue
+from queue import *
+
+import random
+from random import *
+
 import re
 from re import *
 
+import reprlib
+from reprlib import *
+
+import secrets
+from secrets import *
+
+import shelve
+from shelve import *
+
+import shlex as _module_shlex
 from shlex import *
-import shlex
+shlex = _module_shlex
 
 import shutil
 from shutil import *
-join = os.path.join  # seems like a better default than shlex.join
+
+import signal
+from signal import *
+
+import socket
+from socket import *
+
+import sqlite3
+from sqlite3 import *
+
+import statistics
+from statistics import *
+
+import string
+from string import *
+
+import struct
+from struct import *
 
 import subprocess
 from subprocess import *
 
-import sys
+import sys as _module_sys
 from sys import *
-path = os.path
+sys = _module_sys
 
 import tempfile
 from tempfile import *
 
+import textwrap
+from textwrap import *
+
+import threading
+from threading import *
+
+import time as _module_time
 from time import *
-import time
+time = _module_time
+
+import timeit
+from timeit import *
+
+if sys.version_info >= (3, 11):
+    import tomllib
+    from tomllib import *
 
 import traceback
 from traceback import *
 
+import types
+from types import *
+
 import typing
 from typing import *
 
+import unicodedata
+from unicodedata import *
+
 import urllib
 from urllib import *
-from urllib.parse import urlparse
 
 import uuid
 from uuid import *
 
 import warnings
+from warnings import *
+
+import weakref
+from weakref import *
+
+import xml
+from xml import *
+
+import zipfile
+from zipfile import *
+
+import zlib
+from zlib import *
+
+if sys.version_info >= (3, 9):
+    import zoneinfo
+    from zoneinfo import *
+
+# Preserve builtins that may be shadowed by module members
+_builtins_dict = __builtins__ if isinstance(__builtins__, dict) else __builtins__.__dict__
+if 'BlockingIOError' in _builtins_dict:
+    BlockingIOError = _builtins_dict['BlockingIOError']
+if 'TimeoutError' in _builtins_dict:
+    TimeoutError = _builtins_dict['TimeoutError']
+if 'Warning' in _builtins_dict:
+    Warning = _builtins_dict['Warning']
+if 'abs' in _builtins_dict:
+    abs = _builtins_dict['abs']
+if 'compile' in _builtins_dict:
+    compile = _builtins_dict['compile']
+if 'copyright' in _builtins_dict:
+    copyright = _builtins_dict['copyright']
+if 'enumerate' in _builtins_dict:
+    enumerate = _builtins_dict['enumerate']
+if 'exit' in _builtins_dict:
+    exit = _builtins_dict['exit']
+if 'filter' in _builtins_dict:
+    filter = _builtins_dict['filter']
+if 'open' in _builtins_dict:
+    open = _builtins_dict['open']
+if 'pow' in _builtins_dict:
+    pow = _builtins_dict['pow']
+if 'property' in _builtins_dict:
+    property = _builtins_dict['property']
+if 'repr' in _builtins_dict:
+    repr = _builtins_dict['repr']
+if 'slice' in _builtins_dict:
+    slice = _builtins_dict['slice']
+if 'str' in _builtins_dict:
+    str = _builtins_dict['str']
+
+# Datetime convenience aliases
+dt = datetime.datetime
+fromtimestamp = dt.fromtimestamp
+fromisoformat = dt.fromisoformat
+
+# Collision resolution preferences
+join = os.path.join
+path = os.path
+
+# Custom implementations
+from .cached_property import cached_property
+
+

stdlb-0.1.0.dist-info/METADATA

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: stdlb
+Version: 0.1.0
+Summary: Wildcard-import the Python standard library
+Project-URL: Homepage, https://github.com/runsascoded/stdlb
+Project-URL: Repository, https://github.com/runsascoded/stdlb
+Project-URL: Issues, https://github.com/runsascoded/stdlb/issues
+Author-email: Ryan Williams <ryan@runsascoded.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# `stdlb`
+
+Wildcard-import the Python standard library
+
+[![PyPI badge: "stdlb" library](https://img.shields.io/pypi/v/stdlb.svg)](https://pypi.python.org/pypi/stdlb)
+
+```python
+from stdlb import *
+
+# Most of the standard library is now available:
+print(f"Current directory: {getcwd()}")
+stderr.write(f"Python version: {version}\n")
+print(f"Today: {dt.now()}")
+data = {"key": "value"}
+dumps(data)  # json.dumps
+```
+
+**Features:**
+- 🎯 **Comprehensive coverage**: 79+ stdlib modules available (up from ~20 in earlier versions)
+- 🐍 **Python 3.10-3.13 support**: Automatically includes version-specific modules
+- ⚡ **Fast**: Imports in ~2ms
+- 🔒 **Safe**: Preserves all `__builtins__`, resolves name collisions intelligently
+
+- [Install](#install)
+- [Coverage](#coverage)
+- [Notes](#notes)
+    - [Collision Resolution](#collisions)
+        - [`__builtins` vs. module members](#builtins)
+        - [Module/Members](#module-members)
+    - [Aliases](#aliases)
+    - [Custom `cached_property`](#cached-property)
+- [Development](#development)
+
+## Install <a id="install"></a>
+```bash
+pip install stdlb
+```
+
+## Coverage <a id="coverage"></a>
+
+`stdlb` now includes 79+ stdlib modules, including:
+
+**Core utilities**: `os`, `sys`, `pathlib`, `subprocess`, `tempfile`, `shutil`, `glob`, `fnmatch`
+
+**Data structures & algorithms**: `collections`, `itertools`, `heapq`, `bisect`, `array`, `queue`
+
+**Text processing**: `re`, `string`, `textwrap`, `difflib`, `unicodedata`
+
+**Data formats**: `json`, `csv`, `configparser`, `pickle`, `base64`, `binascii`
+
+**Math & numbers**: `math`, `cmath`, `decimal`, `fractions`, `statistics`, `random`, `secrets`
+
+**Date & time**: `datetime`, `time`, `calendar`, `timeit`
+
+**Functional programming**: `functools`, `operator`, `itertools`
+
+**Type hints**: `typing`, `types`, `dataclasses`, `enum`
+
+**Concurrency**: `threading`, `asyncio`, `subprocess`, `signal`
+
+**Networking**: `socket`, `urllib`, `http`, `html`, `mimetypes`
+
+**Cryptography**: `hashlib`, `hmac`, `secrets`
+
+**Compression**: `zlib`, `zipfile`
+
+**And more**: `logging`, `warnings`, `traceback`, `pprint`, `platform`, `locale`, etc.
+
+### Version-specific modules
+
+- **Python 3.9+**: `graphlib`, `zoneinfo`
+- **Python 3.11+**: `tomllib`
+
+## Notes <a id="notes"></a>
+I've found this especially useful in Jupyter notebooks, where I don't have an easy "add `import` statements as I add code" setup.
+
+Importing seems to take a few milliseconds (on my Macbook Air):
+```ipython
+%%time
+from stdlb import *
+# CPU times: user 914 µs, sys: 397 µs, total: 1.31 ms
+# Wall time: 1.6 ms
+```
+
+### Collision Resolution <a id="collisions"></a>
+
+#### `__builtins` vs. module members <a id="builtins"></a>
+`stdlb` avoids overwriting `__builtins__` with conflicting module members, e.g.:
+- `open` vs. `os.open`
+- `compile` vs. `re.compile`
+- `pow` vs. `math.pow`
+- `copyright` vs. `sys.copyright`
+- `BlockingIOError` vs. `io.BlockingIOError`
+
+[`test.ipynb`](test.ipynb) is executed as part of [`ci.yml`](.github/workflows/ci.yml) to verify there are no `__builtins__` are unexpectedly shadowed.
+
+#### Module/Members <a id="module-members"></a>
+In a few cases, a top-level standard library module also contains a member with the same name (e.g. `datetime`, `shlex`, `time`). `stdlb` makes an effort to ensure the module "wins" in this case:
+
+```python
+from stdlb import *
+
+datetime  # <module 'datetime' from '$PYTHON_HOME/lib/python3.9/datetime.py'>
+shlex     # <module 'shlex' from '$PYTHON_HOME/lib/python3.9/shlex.py'>
+time      # <module 'time' (built-in)>
+```
+
+A few names are disambiguated with the most sensible-seeming defaults:
+```python
+path  # resolves to os.path, not sys.path
+join  # os.path.join, not shlex.join
+```
+
+### Aliases <a id="aliases"></a>
+
+For convenience, `datetime.datetime` is also exposed as `dt`, and a few of its members are exported directly:
+```python
+dt.now()       # datetime.datetime(2023, 8, 3, 10, 9, 43, 981458)
+fromtimestamp  # datetime.datetime.fromtimestamp
+fromisoformat  # datetime.datetime.fromisoformat
+```
+
+### Custom `cached_property` <a id="cached-property"></a>
+One additional bit of functionality is [this custom `cached_property` decorator](stdlb/cached_property.py), which omits an unnecessary/unserializable lock found in `functools.cached_property`. [cpython#87634](https://github.com/python/cpython/issues/87634) has more info, seems like [a fix is coming in Python 3.12](https://github.com/python/cpython/issues/87634#issuecomment-1467140709).
+
+## Development <a id="development"></a>
+
+This project uses [uv](https://github.com/astral-sh/uv) for development.
+
+```bash
+# Install dependencies
+uv sync
+
+# Run tests
+uv run pytest tests/ -v
+
+# Test across multiple Python versions
+for v in .venv/3.*/bin/python; do $v scripts/quick_test.py; done
+
+# Regenerate __init__.py (if needed)
+uv run python scripts/generate_init.py > stdlb/__init__.py
+```
+
+### Scripts
+
+- `scripts/discover_stdlib.py`: Analyze the stdlib and identify modules to include
+- `scripts/generate_init.py`: Generate `stdlb/__init__.py` from stdlib discovery
+- `scripts/quick_test.py`: Quick functionality test across Python versions

stdlb-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+stdlb/__init__.py,sha256=gkNYAY5Mu9PuSrqqFHm9p9aoYK7f0yZiF4toM3qHTxo,4861
+stdlb/cached_property.py,sha256=-fSgW9c7qIpeVaMQ21TyssdH2MbxIJVBDdWuuQIA_Ro,617
+stdlb-0.1.0.dist-info/METADATA,sha256=cI1dOrPJpbOTCIATFKzELOvmBTT_jDRlmG5xp_CP760,5937
+stdlb-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+stdlb-0.1.0.dist-info/RECORD,,

{stdlb-0.0.3.dist-info → stdlb-0.1.0.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.41.0)
+Generator: hatchling 1.27.0
 Root-Is-Purelib: true
 Tag: py3-none-any
-

stdlb-0.0.3.dist-info/METADATA

@@ -1,67 +0,0 @@
-Metadata-Version: 2.1
-Name: stdlb
-Version: 0.0.3
-Summary: Wildcard-import the Python standard library
-Home-page: UNKNOWN
-Author: Ryan Williams
-Author-email: ryan@runsascoded.com
-License: MIT
-Platform: UNKNOWN
-Description-Content-Type: text/markdown
-
-# `stdlb`
-
-Wildcard-import the Python standard library
-
-```python
-from stdlb import *
-
-# Most of the standard library is now available:
-print(f"Current directory: {getcwd()}")
-stderr.write("Python version: {version}\n")
-```
-
-## Install
-```bash
-pip install stdlb
-```
-
-## Notes
-I've found this especially useful in Jupyter notebooks, where I don't have an easy "add `import` statements as I add code" setup.
-
-Importing seems to take a few milliseconds (on my Macbook Air):
-```ipython
-%%time
-from stdlb import *
-# CPU times: user 914 µs, sys: 397 µs, total: 1.31 ms
-# Wall time: 1.6 ms
-```
-
-### Collisions / Aliases
-In a few cases, a top-level standard library module also contains a member with the same name (e.g. `datetime`, `shlex`, `time`). `stdlb` makes an effort to ensure the module "wins" in this case:
-
-```python
-from stdlb import *
-
-datetime  # <module 'datetime' from '$PYTHON_HOME/lib/python3.9/datetime.py'>
-shlex     # <module 'shlex' from '$PYTHON_HOME/lib/python3.9/shlex.py'>
-time      # <module 'time' (built-in)>
-```
-
-A few names are disambiguated with the most sensible-seeming defaults:
-```python
-path  # resolves to os.path, not sys.path
-join  # os.path.join, not shlex.join
-```
-
-For convenience, `datetime.datetime` is also exposed as `dt`, and a few of its members are exported directly:
-```python
-dt.now()       # datetime.datetime(2023, 8, 3, 10, 9, 43, 981458)
-fromtimestamp  # datetime.datetime.fromtimestamp
-fromisoformat  # datetime.datetime.fromisoformat
-```
-
-### Custom `cached_property`
-One additional bit of functionality is [this custom `cached_property` decorator](stdlb/cached_property.py), which omits an unnecessary/unserializable lock found in `functools.cached_property`. [cpython#87634](https://github.com/python/cpython/issues/87634) has more info, seems like [a fix is coming in Python 3.12](https://github.com/python/cpython/issues/87634#issuecomment-1467140709).
-
-

stdlb-0.0.3.dist-info/RECORD

@@ -1,6 +0,0 @@
-stdlb/__init__.py,sha256=z5IngI-97MEBIVf-rfYyjeLdCY6q2eZ0FW0dulFfZq8,1226
-stdlb/cached_property.py,sha256=-fSgW9c7qIpeVaMQ21TyssdH2MbxIJVBDdWuuQIA_Ro,617
-stdlb-0.0.3.dist-info/METADATA,sha256=c5zeQ4akqQ33zfnpIP1Zg9Q11RCW69ERRx8lZAHN_Dk,2161
-stdlb-0.0.3.dist-info/WHEEL,sha256=AtBG6SXL3KF_v0NxLf0ehyVOh0cold-JbJYXNGorC6Q,92
-stdlb-0.0.3.dist-info/top_level.txt,sha256=CR0nzaBSdkIbdFxO8KiV7fA6MVGndY-kc48vsnImc0E,6
-stdlb-0.0.3.dist-info/RECORD,,

stdlb-0.0.3.dist-info/top_level.txt

@@ -1 +0,0 @@
-stdlb