https://github.com/moi15moi/ass_tag_analyzer

A Python library for serialization and deserialization of ASS subtitle file format tags markup.
https://github.com/moi15moi/ass_tag_analyzer

Last synced: 3 months ago
JSON representation

A Python library for serialization and deserialization of ASS subtitle file format tags markup.

• Host: GitHub
• URL: https://github.com/moi15moi/ass_tag_analyzer
• Owner: moi15moi
• Created: 2022-04-28T20:58:24.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-01-14T00:33:10.000Z (10 months ago)
• Last Synced: 2024-07-06T16:07:58.787Z (4 months ago)
• Language: Python
• Homepage: https://pypi.org/project/ass-tag-analyzer/
• Size: 275 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# AssTagAnalyzer

Tag analyzer for Advanced SubStation Alpha file.

This tool allows to parse .ass tag and manipulate them.

## Installation and Update

```

pip install ass-tag-analyzer

```

## Example

```py

from ass_tag_analyzer import parse_line, ass_item_to_text, Format, AssTagFontName, AssValidTagFontName, AssInvalidTagFontName

# Parse an .ass line

line = parse_line(r"{\an7\pos(158,501)\fnArial\bord0.155884}Example")

print(line)

# Convert line to text

print(ass_item_to_text(line))

# Change how to convert float to string

Format.format_float = lambda number: round(number)

# Reconvert line to text. See how the \bord result is different

print(ass_item_to_text(line))

# Search an tag

for ass_item in line:

    if isinstance(ass_item, AssTagFontName):

        if isinstance(ass_item, AssValidTagFontName):

            print(f'An \\fn tag has been found and the value is "{ass_item.name}"')

        elif isinstance(ass_item, AssInvalidTagFontName):

            # You need to get the style that is applied on the line.

            pass

```

### Result

```py console

[

    AssTagListOpening(),

    AssValidTagAlignment(is_legacy_tag=False, _AssValidTagAlignment__alignment=),

    AssValidTagPosition(x=158.0, y=501.0),

    AssValidTagFontName(_AssValidTagFontName__name='Arial'),

    AssValidTagBorder(_AssValidTagBorder__size=0.155884),

    AssTagListEnding(),

    AssText(text='Example')

]

{\an7\pos(158,501)\fnArial\bord0.156}Example

{\an7\pos(158,501)\fnArial\bord0}Example

An \fn tag has been found and the value is "Arial"

```

## Dependencies

-  [Python 3.8 or more](https://www.python.org/downloads/)

## Acknowledgments

 - [ass_tag_parser](https://github.com/bubblesub/ass_tag_parser) I used his library to create mine. I got a lot of inspiration from his work.