trackparse 0.3.1__tar.gz → 0.3.3__tar.gz

{trackparse-0.3.1 → trackparse-0.3.3}/PKG-INFO

@@ -1,8 +1,9 @@
 Metadata-Version: 2.5
 Name: trackparse
-Version: 0.3.1
+Version: 0.3.3
 Summary: Spec-driven parser for music track titles and tracklists: artists, feat, remixes, versions, junk, positions, times.
-Project-URL: Homepage, https://github.com/4matic/trackparse
+Project-URL: Homepage, https://4matic.github.io/trackparse/
+Project-URL: Documentation, https://4matic.github.io/trackparse/start/getting-started/
 Project-URL: Repository, https://github.com/4matic/trackparse
 Project-URL: Issues, https://github.com/4matic/trackparse/issues
 Project-URL: Changelog, https://github.com/4matic/trackparse/blob/main/python/CHANGELOG.md
@@ -37,6 +38,8 @@ Description-Content-Type: text/markdown
 [![python](https://img.shields.io/github/actions/workflow/status/4matic/trackparse/python.yml?branch=main&label=tests&logo=github)](https://github.com/4matic/trackparse/actions/workflows/python.yml)
 [![license](https://img.shields.io/badge/license-MIT-blue)](https://github.com/4matic/trackparse/blob/main/LICENSE)
 
+**[Documentation](https://4matic.github.io/trackparse/)** · **[Getting started](https://4matic.github.io/trackparse/start/getting-started/)** · **[Playground](https://4matic.github.io/trackparse/playground/)**
+
 **Turn messy track names into structured data: who made it, who's featured, who remixed it, and
 what's just noise.**
 
@@ -69,6 +72,8 @@ uv add trackparse
 
 ## Quick start
 
+**Docs:** [Getting started](https://4matic.github.io/trackparse/start/getting-started/)
+
 ```python
 from trackparse import format_track, parse
 
@@ -140,6 +145,8 @@ print(json.dumps(track.to_dict(), indent=2))
 
 ## API
 
+**Docs:** [Other functions](https://4matic.github.io/trackparse/reference/functions/)
+
 ```python
 parse(input, *, mode="auto", uploader=None, known_artists=(), split_and="auto", keywords=None) -> ParsedTrack
 parse_artists(input, *, <same options>) -> list[Artist]
@@ -153,6 +160,8 @@ SPEC_VERSION, __version__
 
 ### `parse(input, **options)`
 
+**Docs:** [parse and ParsedTrack](https://4matic.github.io/trackparse/reference/parse/) · [Options](https://4matic.github.io/trackparse/reference/options/)
+
 | Option | Default | |
 |---|---|---|
 | `mode` | `"auto"` | `"clean"`, `"youtube"`, `"filename"`, `"tracklist"`, or `"auto"` to detect from the string |
@@ -193,6 +202,8 @@ the defaults. Passing something that isn't a `str` raises `TypeError`.
 
 ### `ParsedTrack`
 
+**Docs:** [ParsedTrack fields](https://4matic.github.io/trackparse/reference/parse/#parsedtrack)
+
 | Attribute | Type | |
 |---|---|---|
 | `input` | `str` | The original string, untouched |
@@ -229,12 +240,14 @@ parse("Queen - Bohemian Rhapsody (Live at Wembley 1986)").versions[0]
 ```
 
 Version types, junk kinds and warnings are listed in the
-[main README](https://github.com/4matic/trackparse#api) and typed as `Literal` aliases
+[API reference](https://4matic.github.io/trackparse/reference/parse/) and typed as `Literal` aliases
 (`VersionType`, `JunkKind`, `Warning`, `ArtistRole`, `ArtistSource`, `Mode`, `ModeOption`,
 `VersionDelimiter`).
 
 ### `to_dict()` and `from_dict()`
 
+**Docs:** [JSON and Python objects](https://4matic.github.io/trackparse/reference/parse/#json-and-python-objects)
+
 Every result class has `to_dict()`, which returns plain dicts and lists matching
 [`parsed-track.schema.json`](https://github.com/4matic/trackparse/blob/main/spec/schema/parsed-track.schema.json)
 (`fullTitle`, `unknownArtist`, ...). With `json.dumps(track.to_dict(), separators=(",", ":"),
@@ -247,6 +260,8 @@ ParsedTrack.from_dict(track.to_dict()) == track  # True
 
 ### `parse_artists(input, **options)`
 
+**Docs:** [parseArtists](https://4matic.github.io/trackparse/reference/functions/#parseartistsinput-options)
+
 Splits a bare artist string. Takes the same options as `parse`.
 
 ```python
@@ -258,6 +273,8 @@ from trackparse import parse_artists
 
 ### `format_track(track, **options)`
 
+**Docs:** [format](https://4matic.github.io/trackparse/reference/functions/#formattrack-options) · [Formatting](https://4matic.github.io/trackparse/guides/formatting/)
+
 Renders a track back to a string.
 
 | Option | Default | |
@@ -287,6 +304,8 @@ format_track(track, position=True)
 
 ### `normalize(s)`
 
+**Docs:** [normalize](https://4matic.github.io/trackparse/reference/functions/#normalizeinput)
+
 The Unicode cleanup every function runs first: NFC, invisible characters, and dash, bracket and
 quote variants.
 
@@ -299,6 +318,8 @@ normalize("Noisia​ – Stigma （VIP）")
 
 ### `all_artists(track)`
 
+**Docs:** [allArtists](https://4matic.github.io/trackparse/reference/functions/#allartiststrack)
+
 Credits plus every remixer, deduplicated.
 
 ```python
@@ -310,6 +331,8 @@ from trackparse import all_artists
 
 ### `create_parser(**options)`
 
+**Docs:** [createParser](https://4matic.github.io/trackparse/reference/functions/#createparseroptions)
+
 Compiles the options once, for many calls. Per-call options are merged over the parser's: a value
 passed per call replaces the base one (`known_artists` included), `None` leaves it alone, and
 `keywords` dicts are merged.
@@ -332,6 +355,8 @@ released together and always share one version number.
 
 ## Modes
 
+**Docs:** [Modes](https://4matic.github.io/trackparse/guides/modes/)
+
 | Mode | For | Adds |
 |---|---|---|
 | `clean` | Store metadata, tags | Only a spaced dash separates artist and title |
@@ -355,6 +380,8 @@ parse("Shelter", mode="youtube", uploader="Porter Robinson").artists
 
 ## Tracklists
 
+**Docs:** [Tracklists](https://4matic.github.io/trackparse/guides/tracklists/) · [Editing tracklists](https://4matic.github.io/trackparse/guides/editing-tracklists/)
+
 `trackparse.tracklist` parses a whole tracklist, one entry per line, and checks it. Each entry
 keeps its line exactly as written plus its own line ending, so `"".join(e.raw + e.eol for e in
 tl.entries)` is always the input, CRLF or not.
@@ -447,7 +474,7 @@ Warning codes: `time-missing`, `time-out-of-order`, `time-duplicate`, `no-start-
 `position-duplicate`, `line-unparsed`. Edits: `set-time {line, seconds}`, `shift {seconds, lines? | from?}`
 (all timed lines when neither is given), `sort-by-time {}`, `set-rest {line, rest}`,
 `insert {after, text}` (`after: 0` inserts at the top), `delete {line}`. The
-[main README](https://github.com/4matic/trackparse#tracklist-api) explains each one.
+[Tracklist API reference](https://4matic.github.io/trackparse/reference/tracklist/) explains each one.
 `to_dict()` gives the camelCase JSON from
 [`tracklist.schema.json`](https://github.com/4matic/trackparse/blob/main/spec/schema/tracklist.schema.json),
 byte-identical to the JS package's output.
@@ -464,6 +491,8 @@ parse("Electrosoul System - Liquid Metal", mode="tracklist").title
 
 ## Typing
 
+**Docs:** [Types](https://4matic.github.io/trackparse/reference/parse/#types)
+
 The package ships `py.typed` and passes `mypy --strict`. `ParsedTrack`, `Artist`, `Version`,
 `Junk`, `Flags`, `Position` and `Timestamp` are frozen dataclasses with snake_case attributes, and
 so are the tracklist results in `trackparse.tracklist`.
@@ -492,8 +521,11 @@ same spec rule IDs. Behaviour changes start in the spec, not here: see
 
 ## Links
 
+- [Documentation](https://4matic.github.io/trackparse/), with every example in Python and JavaScript, and a
+  [playground](https://4matic.github.io/trackparse/playground/) that runs the parser in your browser
 - [Spec](https://github.com/4matic/trackparse/blob/main/spec/SPEC.md)
-- [Project README](https://github.com/4matic/trackparse#readme), with a table of real outputs
+- [Project README](https://github.com/4matic/trackparse#readme)
+- [GitHub repository](https://github.com/4matic/trackparse)
 - [Changelog](https://github.com/4matic/trackparse/blob/main/python/CHANGELOG.md)
 - [npm package](https://www.npmjs.com/package/trackparse)
 

{trackparse-0.3.1 → trackparse-0.3.3}/README.md

@@ -5,6 +5,8 @@
 [![python](https://img.shields.io/github/actions/workflow/status/4matic/trackparse/python.yml?branch=main&label=tests&logo=github)](https://github.com/4matic/trackparse/actions/workflows/python.yml)
 [![license](https://img.shields.io/badge/license-MIT-blue)](https://github.com/4matic/trackparse/blob/main/LICENSE)
 
+**[Documentation](https://4matic.github.io/trackparse/)** · **[Getting started](https://4matic.github.io/trackparse/start/getting-started/)** · **[Playground](https://4matic.github.io/trackparse/playground/)**
+
 **Turn messy track names into structured data: who made it, who's featured, who remixed it, and
 what's just noise.**
 
@@ -37,6 +39,8 @@ uv add trackparse
 
 ## Quick start
 
+**Docs:** [Getting started](https://4matic.github.io/trackparse/start/getting-started/)
+
 ```python
 from trackparse import format_track, parse
 
@@ -108,6 +112,8 @@ print(json.dumps(track.to_dict(), indent=2))
 
 ## API
 
+**Docs:** [Other functions](https://4matic.github.io/trackparse/reference/functions/)
+
 ```python
 parse(input, *, mode="auto", uploader=None, known_artists=(), split_and="auto", keywords=None) -> ParsedTrack
 parse_artists(input, *, <same options>) -> list[Artist]
@@ -121,6 +127,8 @@ SPEC_VERSION, __version__
 
 ### `parse(input, **options)`
 
+**Docs:** [parse and ParsedTrack](https://4matic.github.io/trackparse/reference/parse/) · [Options](https://4matic.github.io/trackparse/reference/options/)
+
 | Option | Default | |
 |---|---|---|
 | `mode` | `"auto"` | `"clean"`, `"youtube"`, `"filename"`, `"tracklist"`, or `"auto"` to detect from the string |
@@ -161,6 +169,8 @@ the defaults. Passing something that isn't a `str` raises `TypeError`.
 
 ### `ParsedTrack`
 
+**Docs:** [ParsedTrack fields](https://4matic.github.io/trackparse/reference/parse/#parsedtrack)
+
 | Attribute | Type | |
 |---|---|---|
 | `input` | `str` | The original string, untouched |
@@ -197,12 +207,14 @@ parse("Queen - Bohemian Rhapsody (Live at Wembley 1986)").versions[0]
 ```
 
 Version types, junk kinds and warnings are listed in the
-[main README](https://github.com/4matic/trackparse#api) and typed as `Literal` aliases
+[API reference](https://4matic.github.io/trackparse/reference/parse/) and typed as `Literal` aliases
 (`VersionType`, `JunkKind`, `Warning`, `ArtistRole`, `ArtistSource`, `Mode`, `ModeOption`,
 `VersionDelimiter`).
 
 ### `to_dict()` and `from_dict()`
 
+**Docs:** [JSON and Python objects](https://4matic.github.io/trackparse/reference/parse/#json-and-python-objects)
+
 Every result class has `to_dict()`, which returns plain dicts and lists matching
 [`parsed-track.schema.json`](https://github.com/4matic/trackparse/blob/main/spec/schema/parsed-track.schema.json)
 (`fullTitle`, `unknownArtist`, ...). With `json.dumps(track.to_dict(), separators=(",", ":"),
@@ -215,6 +227,8 @@ ParsedTrack.from_dict(track.to_dict()) == track  # True
 
 ### `parse_artists(input, **options)`
 
+**Docs:** [parseArtists](https://4matic.github.io/trackparse/reference/functions/#parseartistsinput-options)
+
 Splits a bare artist string. Takes the same options as `parse`.
 
 ```python
@@ -226,6 +240,8 @@ from trackparse import parse_artists
 
 ### `format_track(track, **options)`
 
+**Docs:** [format](https://4matic.github.io/trackparse/reference/functions/#formattrack-options) · [Formatting](https://4matic.github.io/trackparse/guides/formatting/)
+
 Renders a track back to a string.
 
 | Option | Default | |
@@ -255,6 +271,8 @@ format_track(track, position=True)
 
 ### `normalize(s)`
 
+**Docs:** [normalize](https://4matic.github.io/trackparse/reference/functions/#normalizeinput)
+
 The Unicode cleanup every function runs first: NFC, invisible characters, and dash, bracket and
 quote variants.
 
@@ -267,6 +285,8 @@ normalize("Noisia​ – Stigma （VIP）")
 
 ### `all_artists(track)`
 
+**Docs:** [allArtists](https://4matic.github.io/trackparse/reference/functions/#allartiststrack)
+
 Credits plus every remixer, deduplicated.
 
 ```python
@@ -278,6 +298,8 @@ from trackparse import all_artists
 
 ### `create_parser(**options)`
 
+**Docs:** [createParser](https://4matic.github.io/trackparse/reference/functions/#createparseroptions)
+
 Compiles the options once, for many calls. Per-call options are merged over the parser's: a value
 passed per call replaces the base one (`known_artists` included), `None` leaves it alone, and
 `keywords` dicts are merged.
@@ -300,6 +322,8 @@ released together and always share one version number.
 
 ## Modes
 
+**Docs:** [Modes](https://4matic.github.io/trackparse/guides/modes/)
+
 | Mode | For | Adds |
 |---|---|---|
 | `clean` | Store metadata, tags | Only a spaced dash separates artist and title |
@@ -323,6 +347,8 @@ parse("Shelter", mode="youtube", uploader="Porter Robinson").artists
 
 ## Tracklists
 
+**Docs:** [Tracklists](https://4matic.github.io/trackparse/guides/tracklists/) · [Editing tracklists](https://4matic.github.io/trackparse/guides/editing-tracklists/)
+
 `trackparse.tracklist` parses a whole tracklist, one entry per line, and checks it. Each entry
 keeps its line exactly as written plus its own line ending, so `"".join(e.raw + e.eol for e in
 tl.entries)` is always the input, CRLF or not.
@@ -415,7 +441,7 @@ Warning codes: `time-missing`, `time-out-of-order`, `time-duplicate`, `no-start-
 `position-duplicate`, `line-unparsed`. Edits: `set-time {line, seconds}`, `shift {seconds, lines? | from?}`
 (all timed lines when neither is given), `sort-by-time {}`, `set-rest {line, rest}`,
 `insert {after, text}` (`after: 0` inserts at the top), `delete {line}`. The
-[main README](https://github.com/4matic/trackparse#tracklist-api) explains each one.
+[Tracklist API reference](https://4matic.github.io/trackparse/reference/tracklist/) explains each one.
 `to_dict()` gives the camelCase JSON from
 [`tracklist.schema.json`](https://github.com/4matic/trackparse/blob/main/spec/schema/tracklist.schema.json),
 byte-identical to the JS package's output.
@@ -432,6 +458,8 @@ parse("Electrosoul System - Liquid Metal", mode="tracklist").title
 
 ## Typing
 
+**Docs:** [Types](https://4matic.github.io/trackparse/reference/parse/#types)
+
 The package ships `py.typed` and passes `mypy --strict`. `ParsedTrack`, `Artist`, `Version`,
 `Junk`, `Flags`, `Position` and `Timestamp` are frozen dataclasses with snake_case attributes, and
 so are the tracklist results in `trackparse.tracklist`.
@@ -460,8 +488,11 @@ same spec rule IDs. Behaviour changes start in the spec, not here: see
 
 ## Links
 
+- [Documentation](https://4matic.github.io/trackparse/), with every example in Python and JavaScript, and a
+  [playground](https://4matic.github.io/trackparse/playground/) that runs the parser in your browser
 - [Spec](https://github.com/4matic/trackparse/blob/main/spec/SPEC.md)
-- [Project README](https://github.com/4matic/trackparse#readme), with a table of real outputs
+- [Project README](https://github.com/4matic/trackparse#readme)
+- [GitHub repository](https://github.com/4matic/trackparse)
 - [Changelog](https://github.com/4matic/trackparse/blob/main/python/CHANGELOG.md)
 - [npm package](https://www.npmjs.com/package/trackparse)
 

{trackparse-0.3.1 → trackparse-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "trackparse"
-version = "0.3.1"
+version = "0.3.3"
 description = "Spec-driven parser for music track titles and tracklists: artists, feat, remixes, versions, junk, positions, times."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -44,7 +44,8 @@ classifiers = [
 dependencies = []
 
 [project.urls]
-Homepage = "https://github.com/4matic/trackparse"
+Homepage = "https://4matic.github.io/trackparse/"
+Documentation = "https://4matic.github.io/trackparse/start/getting-started/"
 Repository = "https://github.com/4matic/trackparse"
 Issues = "https://github.com/4matic/trackparse/issues"
 Changelog = "https://github.com/4matic/trackparse/blob/main/python/CHANGELOG.md"

{trackparse-0.3.1 → trackparse-0.3.3}/src/trackparse/__init__.py

@@ -33,7 +33,7 @@ from .types import (
     Warning,
 )
 
-__version__ = "0.3.1"  # x-release-please-version
+__version__ = "0.3.3"  # x-release-please-version
 
 __all__ = [
     "SPEC_VERSION",

{trackparse-0.3.1 → trackparse-0.3.3}/src/trackparse/_data.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 
 from typing import Any
 
-SPEC_VERSION = "0.3.1"  # x-release-please-version
+SPEC_VERSION = "0.3.3"  # x-release-please-version
 
 # spec/data/descriptors.json
 DESCRIPTORS_DATA: dict[str, Any] = {