stdlb 0.0.4__tar.gz → 0.1.0__tar.gz

{stdlb-0.0.4/stdlb.egg-info → stdlb-0.1.0}/PKG-INFO

@@ -1,12 +1,21 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: stdlb
-Version: 0.0.4
+Version: 0.1.0
 Summary: Wildcard-import the Python standard library
-Home-page: https://github.com/runsascoded/stdlb
-Author: Ryan Williams
-Author-email: ryan@runsascoded.com
+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
-Platform: UNKNOWN
+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`
@@ -20,22 +29,68 @@ from stdlb import *
 
 # Most of the standard library is now available:
 print(f"Current directory: {getcwd()}")
-stderr.write("Python version: {version}\n")
+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.
 
@@ -88,4 +143,26 @@ 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.0.4/PKG-INFO → stdlb-0.1.0/README.md

@@ -1,14 +1,3 @@
-Metadata-Version: 2.1
-Name: stdlb
-Version: 0.0.4
-Summary: Wildcard-import the Python standard library
-Home-page: https://github.com/runsascoded/stdlb
-Author: Ryan Williams
-Author-email: ryan@runsascoded.com
-License: MIT
-Platform: UNKNOWN
-Description-Content-Type: text/markdown
-
 # `stdlb`
 
 Wildcard-import the Python standard library
@@ -20,22 +9,68 @@ from stdlb import *
 
 # Most of the standard library is now available:
 print(f"Current directory: {getcwd()}")
-stderr.write("Python version: {version}\n")
+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.
 
@@ -88,4 +123,26 @@ 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/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "stdlb"
+version = "0.1.0"
+description = "Wildcard-import the Python standard library"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Ryan Williams", email = "ryan@runsascoded.com"},
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+requires-python = ">=3.10"
+
+[project.urls]
+Homepage = "https://github.com/runsascoded/stdlb"
+Repository = "https://github.com/runsascoded/stdlb"
+Issues = "https://github.com/runsascoded/stdlb/issues"
+
+[dependency-groups]
+dev = [
+    "ipykernel>=6.0.0",
+    "juq.py>=0.0.1",
+    "papermill>=2.0.0",
+    "pytest>=7.0.0",
+]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/stdlb",
+    "/README.md",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["stdlb"]

stdlb-0.1.0/stdlb/__init__.py

@@ -0,0 +1,299 @@
+"""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 *
+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 *
+
+import glob as _module_glob
+from glob import *
+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 *
+
+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 mimetypes
+from mimetypes import *
+
+import numbers
+from numbers import *
+
+import operator
+from operator import *
+
+import os as _module_os
+from os 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 *
+shlex = _module_shlex
+
+import shutil
+from shutil import *
+
+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 as _module_sys
+from sys import *
+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 *
+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 *
+
+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.0.4/README.md

@@ -1,78 +0,0 @@
-# `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("Python version: {version}\n")
-```
-
-- [Install](#install)
-- [Notes](#notes)
-    - [Collision Resolution](#collisions)
-        - [`__builtins` vs. module members](#builtins)
-        - [Module/Members](#module-members)
-    - [Aliases](#aliases)
-    - [Custom `cached_property`](#cached-property)
-
-## Install <a id="install"></a>
-```bash
-pip install stdlb
-```
-
-## 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).

stdlb-0.0.4/setup.cfg

@@ -1,4 +0,0 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-

stdlb-0.0.4/setup.py

@@ -1,15 +0,0 @@
-from setuptools import setup
-
-setup(
-    name="stdlb",
-    version="0.0.4",
-    packages=["stdlb"],
-    license="MIT",
-    author="Ryan Williams",
-    author_email="ryan@runsascoded.com",
-    author_url="https://github.com/ryan-williams",
-    url="https://github.com/runsascoded/stdlb",
-    description="Wildcard-import the Python standard library",
-    long_description=open("README.md").read(),
-    long_description_content_type="text/markdown",
-)

stdlb-0.0.4/stdlb/__init__.py

@@ -1,88 +0,0 @@
-import base64
-from base64 import *
-
-import configparser
-from configparser import *
-
-import contextlib
-from contextlib import *
-
-import dataclasses
-from dataclasses import *
-
-from datetime import *
-from datetime import datetime as dt
-import datetime
-fromtimestamp = dt.fromtimestamp
-fromisoformat = dt.fromisoformat
-
-import functools
-from functools import *
-from .cached_property import cached_property
-
-from glob import *
-import glob
-
-import hashlib
-from hashlib import *
-
-import io
-from io import *
-BlockingIOError = __builtins__['BlockingIOError']
-
-import itertools
-from itertools import *
-
-import json
-
-import math
-from math import *
-pow = __builtins__['pow']
-
-import os
-from os import *
-open = __builtins__['open']
-from os.path import *
-
-import pathlib
-from pathlib import *
-
-import re
-from re import *
-compile = __builtins__['compile']
-
-from shlex import *
-import shlex
-
-import shutil
-from shutil import *
-join = os.path.join  # seems like a better default than shlex.join
-
-import subprocess
-from subprocess import *
-
-import sys
-from sys import *
-path = os.path
-copyright = __builtins__['copyright']
-
-import tempfile
-from tempfile import *
-
-from time import *
-import time
-
-import traceback
-from traceback import *
-
-import typing
-from typing import *
-
-import urllib
-from urllib import *
-from urllib.parse import urlparse
-
-import uuid
-from uuid import *
-
-import warnings

stdlb-0.0.4/stdlb.egg-info/SOURCES.txt

@@ -1,8 +0,0 @@
-README.md
-setup.py
-stdlb/__init__.py
-stdlb/cached_property.py
-stdlb.egg-info/PKG-INFO
-stdlb.egg-info/SOURCES.txt
-stdlb.egg-info/dependency_links.txt
-stdlb.egg-info/top_level.txt

stdlb-0.0.4/stdlb.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

stdlb-0.0.4/stdlb.egg-info/top_level.txt

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