Z0Z-tools


NameZ0Z-tools JSON
Version 0.8.0 PyPI version JSON
download
home_pageNone
SummaryTools for audio/signal processing, data structure, function parameters, and package management.
upload_time2025-01-27 03:27:05
maintainerNone
docs_urlNone
authorNone
requires_python<3.14,>=3.10
licenseCC-BY-NC-4.0
keywords python development tools
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Z0Z_tools

A collection of tools to solve common Python development frustrations. "Z0Z_" indicates these are prototype solutions - they work, but might not be pretty.

## Tired of handling string vs boolean parameter confusion?

Add `oopsieKwargsie()` to your function: it intelligently converts string parameters to their proper boolean or None types.

## Need flexible control over parallel processing?

Add a flexible parameter to your function, and use `defineConcurrencyLimit()` to give users more control over concurrent processing by using intuitive ratios or counts:

- Use fractions (0.75 = 75% of CPUs)
- Specify exact counts (8 = use 8 CPUs)
- Use negative values (-2 = total CPUs minus 2)

## Need to validate integer inputs?

`intInnit()` rigorously validates and converts input lists to integers:

- Converts valid numeric types to integers
- Rejects non-whole numbers
- Provides clear error messages
- Made for validating user inputs

## Want to unit test the above functions in your package?

Use the pre-built test suites in `pytest_parseParameters.py` to quickly test your implementations:

```python
from Z0Z_tools.pytest_parseParameters import makeTestSuiteOopsieKwargsie

def test_a_function_with_bool():
    smurfSuite = makeTestSuiteOopsieKwargsie(mySmurfyFunction)
    for smurfName, smurfFunction in smurfSuite.items():
        smurfFunction()
```

## Extract data as strings from simple or complex nested data structures?

Extract and standardize values from complex data structures with `stringItUp()`:

- Recursively unpack nested structures
- Convert all elements to strings
- Handle arbitrary iterables and custom objects

## Want to merge multiple dictionaries of lists?

`updateExtendPolishDictionaryLists()` can combine and clean dictionary data with optional:

- Duplicate removal
- List sorting
- Error handling for incompatible data

## "I just want to load the audio: I don't need 714 options!"

Load audio, `readAudioFile()`, and save WAV files, `writeWav()`, without the complexity:

- Automatic stereo conversion
- Sample rate control
- Multi-file batch processing, too: `loadWaveforms()`

## Want to install a package that lacks proper installation files?

If you have a Python package that doesn't have an installation file, `pipAnything()` creates a temporary setup environment to help `pip` install the unpackaged code.

```sh
python -m Z0Z_tools.pipAnything <pathPackage>
```

## Want to create relative paths between any two locations?

Convert between paths easily with `findRelativePath()`:

- Works with files or directories
- Handles paths on different branches
- Supports both string and Path-like inputs
- Returns platform-independent paths

## Installation

```sh
pip install Z0Z_tools
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "Z0Z-tools",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<3.14,>=3.10",
    "maintainer_email": null,
    "keywords": "Python, development, tools",
    "author": null,
    "author_email": "Hunter Hogan <HunterHogan@pm.me>",
    "download_url": "https://files.pythonhosted.org/packages/01/c7/53b00a0003a74e3c5b0b2f3f58fa6621b7f62c019840a57c858ae001dde2/z0z_tools-0.8.0.tar.gz",
    "platform": null,
    "description": "# Z0Z_tools\n\nA collection of tools to solve common Python development frustrations. \"Z0Z_\" indicates these are prototype solutions - they work, but might not be pretty.\n\n## Tired of handling string vs boolean parameter confusion?\n\nAdd `oopsieKwargsie()` to your function: it intelligently converts string parameters to their proper boolean or None types.\n\n## Need flexible control over parallel processing?\n\nAdd a flexible parameter to your function, and use `defineConcurrencyLimit()` to give users more control over concurrent processing by using intuitive ratios or counts:\n\n- Use fractions (0.75 = 75% of CPUs)\n- Specify exact counts (8 = use 8 CPUs)\n- Use negative values (-2 = total CPUs minus 2)\n\n## Need to validate integer inputs?\n\n`intInnit()` rigorously validates and converts input lists to integers:\n\n- Converts valid numeric types to integers\n- Rejects non-whole numbers\n- Provides clear error messages\n- Made for validating user inputs\n\n## Want to unit test the above functions in your package?\n\nUse the pre-built test suites in `pytest_parseParameters.py` to quickly test your implementations:\n\n```python\nfrom Z0Z_tools.pytest_parseParameters import makeTestSuiteOopsieKwargsie\n\ndef test_a_function_with_bool():\n    smurfSuite = makeTestSuiteOopsieKwargsie(mySmurfyFunction)\n    for smurfName, smurfFunction in smurfSuite.items():\n        smurfFunction()\n```\n\n## Extract data as strings from simple or complex nested data structures?\n\nExtract and standardize values from complex data structures with `stringItUp()`:\n\n- Recursively unpack nested structures\n- Convert all elements to strings\n- Handle arbitrary iterables and custom objects\n\n## Want to merge multiple dictionaries of lists?\n\n`updateExtendPolishDictionaryLists()` can combine and clean dictionary data with optional:\n\n- Duplicate removal\n- List sorting\n- Error handling for incompatible data\n\n## \"I just want to load the audio: I don't need 714 options!\"\n\nLoad audio, `readAudioFile()`, and save WAV files, `writeWav()`, without the complexity:\n\n- Automatic stereo conversion\n- Sample rate control\n- Multi-file batch processing, too: `loadWaveforms()`\n\n## Want to install a package that lacks proper installation files?\n\nIf you have a Python package that doesn't have an installation file, `pipAnything()` creates a temporary setup environment to help `pip` install the unpackaged code.\n\n```sh\npython -m Z0Z_tools.pipAnything <pathPackage>\n```\n\n## Want to create relative paths between any two locations?\n\nConvert between paths easily with `findRelativePath()`:\n\n- Works with files or directories\n- Handles paths on different branches\n- Supports both string and Path-like inputs\n- Returns platform-independent paths\n\n## Installation\n\n```sh\npip install Z0Z_tools\n```\n",
    "bugtrack_url": null,
    "license": "CC-BY-NC-4.0",
    "summary": "Tools for audio/signal processing, data structure, function parameters, and package management.",
    "version": "0.8.0",
    "project_urls": {
        "Donate": "https://www.patreon.com/integrated",
        "Homepage": "https://github.com/hunterhogan/mapFolding"
    },
    "split_keywords": [
        "python",
        " development",
        " tools"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f5b8054ff75f35589fb36c892318eb0b3ca45d89e12fdb00a0032040e75b72b6",
                "md5": "420c4a52381d584258245939077faca4",
                "sha256": "aa386a08d6dd40a0998631d96148d709809987803fb57657cbd5e053066a9b9e"
            },
            "downloads": -1,
            "filename": "Z0Z_tools-0.8.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "420c4a52381d584258245939077faca4",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.14,>=3.10",
            "size": 38096,
            "upload_time": "2025-01-27T03:27:02",
            "upload_time_iso_8601": "2025-01-27T03:27:02.919138Z",
            "url": "https://files.pythonhosted.org/packages/f5/b8/054ff75f35589fb36c892318eb0b3ca45d89e12fdb00a0032040e75b72b6/Z0Z_tools-0.8.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "01c753b00a0003a74e3c5b0b2f3f58fa6621b7f62c019840a57c858ae001dde2",
                "md5": "2f1b573c67fd19b47f43b611e71b0e0d",
                "sha256": "8a30e63a192e11ac063130cb443b94ce470c378dca6de41239c9b7bb36a9e69a"
            },
            "downloads": -1,
            "filename": "z0z_tools-0.8.0.tar.gz",
            "has_sig": false,
            "md5_digest": "2f1b573c67fd19b47f43b611e71b0e0d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.14,>=3.10",
            "size": 33428,
            "upload_time": "2025-01-27T03:27:05",
            "upload_time_iso_8601": "2025-01-27T03:27:05.008254Z",
            "url": "https://files.pythonhosted.org/packages/01/c7/53b00a0003a74e3c5b0b2f3f58fa6621b7f62c019840a57c858ae001dde2/z0z_tools-0.8.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-01-27 03:27:05",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "hunterhogan",
    "github_project": "mapFolding",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "z0z-tools"
}
        
Elapsed time: 1.28124s