# pydub-stubs
Pydub version: **0.25.1**
**`pydub-stubs` provides type information for [Pydub].**<br>
Only the public interface is guaranteed to be typed, however there
are type definitions for some private and undocumented functions.
[Pydub]: https://github.com/jiaaro/pydub
```
pip install pydub-stubs
```
<br>
## Anticipated Questions
### Q: What is `_Metadata` and `_PartialMetadata`?
These are legacy types that have been replaced by the `channels`,
`frame_rate`, and `sample_rate` keyword arguments.
<br>
## Changelog
### Version 0.25.1.5
* **Fixed incorrect `WhiteNoise` generator name**<br>
Previously, the generator was incorrectly named `Whitenoise`.
([#7](https://github.com/clo4/pydub-stubs/pull/7) - thanks, [@Kakadus](https://github.com/Kakadus)!)
### Version 0.25.1.4
* **Added "effect" functions as methods on `AudioSegment`**<br>
The methods have always been accessible on AudioSegment, but since they are
not defined on the class, they were not previously defined in the type stubs.
Note that if `pydub.scipy_effects` is imported, the effect methods may have
slightly different definitions.
### Version 0.25.1.3
* **Added `typing.BinaryIO` to `_PathLike`**<br>
Pydub supports using an IO object in place of a file for both creating and
exporting AudioSegments. (Fixes [#5](https://github.com/clo4/pydub-stubs/issues/5))
### Version 0.25.1.2
* **Added `pathlib.Path` to `_PathLike`**<br>
Allows you to use `Path` objects in place of strings. (thanks,
[@qthequartermasterman](https://github.com/qthequartermasterman)!)
### Version 0.25.1.1
* **Removed literal type fallback overloads**<br>
The fallbacks removed all the advantages of using literals at all.
* **Modernized the type stubs**<br>
Uses new union syntax, and more. ([#2](https://github.com/clo4/pydub-stubs/pull/2)
and [#3](https://github.com/clo4/pydub-stubs/pull/3) - thanks, [@Viicos](https://github.com/Viicos)!)
* **Add `WavSubChunk`, `WavData`, and undocumented functions**<br>
These previously existed and were available but were untyped. (thanks again, [@Viicos](https://github.com/Viicos)!)
<details>
<summary>Previous versions</summary>
### Version 0.25.1.0
* **Added v0.25.0 features**<br>
This includes `pydub.scipy_effects.eq` and new classmethod parameters.
* **Signatures now use literals where possible**<br>
Overloaded implementations exist as a fallback.
* **Added missing modules**<br>
`pydub.silence` and `pydub.utils`
### Version 0.24.1.9
* **Add undocumented parameter of `AudioSegment.from_file`**<br>
`read_ahead_limit` is absent from the documentation but is a supported
keyword argument.
### Version 0.24.1.8
* **Export other modules**<br>
Adds exports for effects, exceptions, generators, playback, and scipy_effects
### Version 0.24.1.7
* **Added `AudioSegment._spawn` (again)**<br>
This was accidentally removed in an earlier version.
* **Improved `pydub.effects.invert_phase`**<br>
This is technically less accurate as `(0, 0)` is equivalent to `(0, 1)`.
### Version 0.24.1.6
* **Removed testing symbols from `pydub.audio_segment`**<br>
### Version 0.24.1.5
* **Fixed `AudioSegment.export`**<br>
First param is named `out_f` and isn't required.
### Version 0.24.1.4
* **Improved signature of `AudioSegment.from_file`**<br>
The keyword arguments for raw/PCM audio don't require `format` to be set to
either `raw` or `pcm`.
* **Fixed package exports**<br>
Exports `AudioSegment` from `__init__.py`.
### Version 0.24.1.3
* **Fixed overloads of `AudioSegment.fade`**<br>
Exactly two of `start`, `end`, and `duration` must be given.
### Version 0.24.1.2
* **Improved `AudioSegment.fade`**<br>
Changed to use overloads to prevent invalid method calls.
* **Improved `AudioSegment.from_mono_audiosegments`**<br>
Use a positional-only parameter to ensure there's at least 1 argument.
### Version 0.24.1.1
* **Fixed `AudioSegment.__init__`**<br>
Use overloads to model correct parameters.
* **Fixed `AudioSegment._spawn`**<br>
Parameter `overrides` accepts a partial dictionary.
* **Fixed `pydub.scipy_effects.high_pass_filter`**<br>
Parameter `order` should be `int`, not `float`.
### Version 0.24.1.0
Released
</details>
Raw data
{
"_id": null,
"home_page": "https://github.com/clo4/pydub-stubs",
"name": "pydub-stubs",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "pydub, types, typing, stubs",
"author": "SeparateRecords",
"author_email": "hey@clo4.net",
"download_url": "https://files.pythonhosted.org/packages/c1/f5/0482df00f87e95295888007c4dc94bf33bed74daf910f0587bcb9a2b6cf5/pydub_stubs-0.25.1.5.tar.gz",
"platform": null,
"description": "# pydub-stubs\n\nPydub version: **0.25.1**\n\n**`pydub-stubs` provides type information for [Pydub].**<br>\nOnly the public interface is guaranteed to be typed, however there\nare type definitions for some private and undocumented functions.\n\n[Pydub]: https://github.com/jiaaro/pydub\n\n```\npip install pydub-stubs\n```\n\n<br>\n\n## Anticipated Questions\n\n### Q: What is `_Metadata` and `_PartialMetadata`?\n\nThese are legacy types that have been replaced by the `channels`,\n`frame_rate`, and `sample_rate` keyword arguments.\n\n<br>\n\n## Changelog\n\n### Version 0.25.1.5\n\n* **Fixed incorrect `WhiteNoise` generator name**<br>\n Previously, the generator was incorrectly named `Whitenoise`.\n ([#7](https://github.com/clo4/pydub-stubs/pull/7) - thanks, [@Kakadus](https://github.com/Kakadus)!)\n\n### Version 0.25.1.4\n\n* **Added \"effect\" functions as methods on `AudioSegment`**<br>\n The methods have always been accessible on AudioSegment, but since they are\n not defined on the class, they were not previously defined in the type stubs.\n Note that if `pydub.scipy_effects` is imported, the effect methods may have\n slightly different definitions.\n\n### Version 0.25.1.3\n\n* **Added `typing.BinaryIO` to `_PathLike`**<br>\n Pydub supports using an IO object in place of a file for both creating and\n exporting AudioSegments. (Fixes [#5](https://github.com/clo4/pydub-stubs/issues/5))\n\n### Version 0.25.1.2\n\n* **Added `pathlib.Path` to `_PathLike`**<br>\n Allows you to use `Path` objects in place of strings. (thanks,\n [@qthequartermasterman](https://github.com/qthequartermasterman)!)\n\n### Version 0.25.1.1\n\n* **Removed literal type fallback overloads**<br>\n The fallbacks removed all the advantages of using literals at all.\n\n* **Modernized the type stubs**<br>\n Uses new union syntax, and more. ([#2](https://github.com/clo4/pydub-stubs/pull/2)\n and [#3](https://github.com/clo4/pydub-stubs/pull/3) - thanks, [@Viicos](https://github.com/Viicos)!)\n\n* **Add `WavSubChunk`, `WavData`, and undocumented functions**<br>\n These previously existed and were available but were untyped. (thanks again, [@Viicos](https://github.com/Viicos)!)\n\n<details>\n<summary>Previous versions</summary>\n\n### Version 0.25.1.0\n\n* **Added v0.25.0 features**<br>\n This includes `pydub.scipy_effects.eq` and new classmethod parameters.\n\n* **Signatures now use literals where possible**<br>\n Overloaded implementations exist as a fallback.\n\n* **Added missing modules**<br>\n `pydub.silence` and `pydub.utils`\n\n### Version 0.24.1.9\n\n* **Add undocumented parameter of `AudioSegment.from_file`**<br>\n `read_ahead_limit` is absent from the documentation but is a supported\n keyword argument.\n\n### Version 0.24.1.8\n\n* **Export other modules**<br>\n Adds exports for effects, exceptions, generators, playback, and scipy_effects\n\n### Version 0.24.1.7\n\n* **Added `AudioSegment._spawn` (again)**<br>\n This was accidentally removed in an earlier version.\n\n* **Improved `pydub.effects.invert_phase`**<br>\n This is technically less accurate as `(0, 0)` is equivalent to `(0, 1)`.\n\n### Version 0.24.1.6\n\n* **Removed testing symbols from `pydub.audio_segment`**<br>\n\n### Version 0.24.1.5\n\n* **Fixed `AudioSegment.export`**<br>\n First param is named `out_f` and isn't required.\n\n### Version 0.24.1.4\n\n* **Improved signature of `AudioSegment.from_file`**<br>\n The keyword arguments for raw/PCM audio don't require `format` to be set to\n either `raw` or `pcm`.\n\n* **Fixed package exports**<br>\n Exports `AudioSegment` from `__init__.py`.\n\n### Version 0.24.1.3\n\n* **Fixed overloads of `AudioSegment.fade`**<br>\n Exactly two of `start`, `end`, and `duration` must be given.\n\n### Version 0.24.1.2\n\n* **Improved `AudioSegment.fade`**<br>\n Changed to use overloads to prevent invalid method calls.\n\n* **Improved `AudioSegment.from_mono_audiosegments`**<br>\n Use a positional-only parameter to ensure there's at least 1 argument.\n\n### Version 0.24.1.1\n\n* **Fixed `AudioSegment.__init__`**<br>\n Use overloads to model correct parameters.\n\n* **Fixed `AudioSegment._spawn`**<br>\n Parameter `overrides` accepts a partial dictionary.\n\n* **Fixed `pydub.scipy_effects.high_pass_filter`**<br>\n Parameter `order` should be `int`, not `float`.\n\n### Version 0.24.1.0\n\nReleased\n\n</details>\n",
"bugtrack_url": null,
"license": "ISC",
"summary": "Stub-only package containing type information for pydub",
"version": "0.25.1.5",
"project_urls": {
"Homepage": "https://github.com/clo4/pydub-stubs",
"Repository": "https://github.com/clo4/pydub-stubs"
},
"split_keywords": [
"pydub",
" types",
" typing",
" stubs"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "849c7c6fffba2b87dfda8248701d4fc28bc662562d5687123084fe63aa330b1c",
"md5": "4e5d0f5292bb6110f74553b48457b621",
"sha256": "a463a81c832e4b720478c5e2e8f6c76000765c821797457b253aa695a352c414"
},
"downloads": -1,
"filename": "pydub_stubs-0.25.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4e5d0f5292bb6110f74553b48457b621",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 9326,
"upload_time": "2024-11-20T14:56:02",
"upload_time_iso_8601": "2024-11-20T14:56:02.852158Z",
"url": "https://files.pythonhosted.org/packages/84/9c/7c6fffba2b87dfda8248701d4fc28bc662562d5687123084fe63aa330b1c/pydub_stubs-0.25.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c1f50482df00f87e95295888007c4dc94bf33bed74daf910f0587bcb9a2b6cf5",
"md5": "9afd70c4ac10a9abbfc084cbdc93f17f",
"sha256": "fa5e98441e7de3be3b8329c02c8a34c7900a2712d49cf52e47cd58c722c779e6"
},
"downloads": -1,
"filename": "pydub_stubs-0.25.1.5.tar.gz",
"has_sig": false,
"md5_digest": "9afd70c4ac10a9abbfc084cbdc93f17f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 8413,
"upload_time": "2024-11-20T14:56:04",
"upload_time_iso_8601": "2024-11-20T14:56:04.132874Z",
"url": "https://files.pythonhosted.org/packages/c1/f5/0482df00f87e95295888007c4dc94bf33bed74daf910f0587bcb9a2b6cf5/pydub_stubs-0.25.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-20 14:56:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "clo4",
"github_project": "pydub-stubs",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pydub-stubs"
}
JSON
