bloops 0.1.4__tar.gz → 0.2.1__tar.gz

{bloops-0.1.4 → bloops-0.2.1}/.gitignore

@@ -1,4 +1,3 @@
 __pycache__/
 build/
 dist/
-static/

bloops-0.1.4/README.md → bloops-0.2.1/PKG-INFO

@@ -1,5 +1,38 @@
+Metadata-Version: 2.5
+Name: bloops
+Version: 0.2.1
+Summary: An AoPS-like BBCode to HTML transpiler, with live-preview and support for Asymptote geometry diagrams.
+Project-URL: Documentation, https://github.com/Bubu-Droid/bloops/blob/main/docs/api.md
+Project-URL: Issues, https://github.com/Bubu-Droid/bloops/issues
+Project-URL: Repository, https://github.com/Bubu-Droid/bloops
+Author-email: Bubu-Droid <bubu@bubudroid.me>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: aops,asymptote,bbcode,converter,diagrams,geometry,html,latex,live-preview,markup,math,tex,transpiler
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Education
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Text Processing :: Markup
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: livereload>=2.7.1
+Requires-Dist: watchdog>=6
+Description-Content-Type: text/markdown
+
 <div align="center">
-    <img src="https://raw.githubusercontent.com/Bubu-Droid/bloops/main/assets/banner.png" style="width: 90%; height: auto;">
+    <img src="https://raw.githubusercontent.com/Bubu-Droid/bloops/main/assets/banner.png" width="90%">
 </div>
 
 <hr>
@@ -12,11 +45,11 @@ and support for **Asymptote geometry diagrams**.
     <a href="https://github.com/Bubu-Droid/bloops/releases/latest">
         <img alt="PyPI Version" src="https://img.shields.io/pypi/v/bloops?label=PyPI&style=for-the-badge&logo=pypi&logoColor=c0caf5&labelColor=1a1b26&color=7aa2f7&v=1" />
     </a>
-    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/prek.yaml">
-        <img alt="Prek CI Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/prek.yaml?label=CI&style=for-the-badge&logo=githubactions&logoColor=c0caf5&labelColor=1a1b26&color=9ece6a" />
+    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/prek.yml">
+        <img alt="Prek CI Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/prek.yml?label=CI&style=for-the-badge&logo=githubactions&logoColor=c0caf5&labelColor=1a1b26&color=9ece6a" />
     </a>
-    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/pytest.yaml">
-        <img alt="Unit Tests Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/pytest.yaml?label=Unit%20Tests&style=for-the-badge&logo=pytest&logoColor=c0caf5&labelColor=1a1b26&color=9ece6a" />
+    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/pytest.yml">
+        <img alt="Unit Tests Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/pytest.yml?label=Unit%20Tests&style=for-the-badge&logo=pytest&logoColor=c0caf5&labelColor=1a1b26&color=9ece6a" />
     </a>
 </div>
 
@@ -27,8 +60,8 @@ and support for **Asymptote geometry diagrams**.
     <a href="https://github.com/Bubu-Droid/bloops/issues">
         <img alt="GitHub Issues" src="https://img.shields.io/github/issues/Bubu-Droid/bloops?label=Issues&style=for-the-badge&logo=github&logoColor=c0caf5&labelColor=1a1b26&color=e0af68" />
     </a>
-    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/codeql.yaml">
-        <img alt="CodeQL Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/codeql.yaml?label=CodeQL&style=for-the-badge&logo=github&logoColor=c0caf5&labelColor=1a1b26&color=bb9af7" />
+    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/codeql.yml">
+        <img alt="CodeQL Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/codeql.yml?label=CodeQL&style=for-the-badge&logo=github&logoColor=c0caf5&labelColor=1a1b26&color=bb9af7" />
     </a>
 </div>
 
@@ -88,7 +121,11 @@ for vector diagram rendering
 Install `bloops` from PyPI. Here is the
 [PyPI listing](https://pypi.org/project/bloops/).
 
-- I suggest using `uv`: run ```uv tool install bloops```.
+- I suggest using `uv`:
+  - Run `uv tool install bloops` if you'd like to use `bloops`
+  just as a CLI tool.
+  - Run `uv add bloops` if you you'd like to import `bloops`
+  as a package in your project.
 - Or, if you want to use `pip`: run `pip install bloops`.
 - AUR entry is yet to be added.
 
@@ -101,7 +138,7 @@ Install `bloops` from PyPI. Here is the
 | Flag | Long Flag      | Description                                                               |
 | ---- | -------------- | ------------------------------------------------------------------------- |
 | `-h` | `--help`       | Show help message for usage of `bloops`.                                  |
-| `-v` | `--version`    | Show the version of `bloops`.                                             |
+| `-V` | `--version`    | Show the version of `bloops`.                                             |
 | `-c` | `--build-cont` | Watch `content.bbcode` for changes and continuously rebuild `index.html`. |
 | `-p` | `--preview`    | Launch a local web live-server to preview `index.html`.                   |
 | `-i` | `--input`      | (**Required**) Input directory containing `content.bbcode`.               |
@@ -169,9 +206,9 @@ Here are reference tables for each BBCode tag bloops uses:
 
 <details><summary>[color]</summary>
 
-| Option  | Mandatory | Description                              |
-| ------- | :-------: | ---------------------------------------- |
-| `color` |    YES    | Color code in hex (with the leading \#). |
+| Option | Mandatory | Description                              |
+| ------ | :-------: | ---------------------------------------- |
+| `hex`  |    YES    | Color code in hex (with the leading \#). |
 
 </details>
 
@@ -219,6 +256,14 @@ Here are reference tables for each BBCode tag bloops uses:
 
 </details>
 
+<details><summary>[hide]</summary>
+
+| Option  | Mandatory | Description                                         |
+| ------- | :-------: | --------------------------------------------------- |
+| `label` |    YES    | Label to be used as the summary for hidden details. |
+
+</details>
+
 <details><summary>math environments</summary>
 
 Currently, the following math box tags are supported:
@@ -238,6 +283,11 @@ proof and solutions.
 
 <details><summary>tags without any options</summary>
 
+| Tag                                | Purpose                                          |
+| ---------------------------------- | ------------------------------------------------ |
+| `[sidemark][/sidemark]`            | To put a number in the subscript for a sidenote. |
+| `[sidenote]<your-note>[/sidenote]` | To write a note to be put aside.                 |
+
 | Tag     | HTML Counterpart |
 | ------- | ---------------- |
 | `[b]`   | `<strong>`       |
@@ -259,9 +309,9 @@ proof and solutions.
 <br>
 
 An example showcasing the use of tags mentioned above has been
-provided in [example/content.bbcode](example/content.bbcode)
+provided in [example/content.bbcode][content.bbcode]
 and the corresponding generated HTML file is present in
-[example/index.html](example/index.html).
+[example/index.html][example.html].
 
 ## API Reference
 
@@ -277,11 +327,11 @@ If you want to convert a BBCode text into HTML using `bloops`,
 first run `validate_bbcode`, then `compile_asy_diagrams`, and
 finally `convert_bbcode_to_html` on the text.
 
-Bloops also provides the global constants under the `vars` module
-which provides `BBCODE_TAGS`, `STYLESHEET`, and `ERROR_TEMPLATE`.
+Bloops also provides the `BBCODE_TAGS` global constant
+under the `vars` module.
 
 A detailed documentation of these API endpoints can be found in
-[docs/API.md](docs/API.md).
+[docs/api.md][api.md].
 
 ## FAQs
 
@@ -331,7 +381,7 @@ need JS for running simple static pages.
 ## Contribution
 
 Contributions are very welcome!
-Please read [CONTRIBUTING.md](CONTRIBUTING.md) for a guide on
+Please read [CONTRIBUTING.md][CONTRIBUTING.md] for a guide on
 how to contribute. I'm against the idea of using AI
 for writing hobby projects; however, I have no
 problem if someone else uses them. If you're using AI assistance
@@ -346,11 +396,17 @@ how to implement it.
 ## TODOs
 
 - [ ] Implement a post-processor which adds paragraph tags around
-every disjoint block of HTML code.
-- [ ] Change `BBCODE_TAGS` to a dict instead of a list.
-- [ ] Handle `]` inside arguments of BBCode tags.
-- [ ] Add script placeholder to HTML templates.
-- [ ] De-couple templates and stylesheets by moving them
-to their independent files.
+  every disjoint block of HTML code.
+- [ ] Shift avatar to integration server.
+- [ ] Handle `[` or `]` inside arguments of BBCode tags.
+  (I'll be very glad if someone suggests me a solution for this;
+  I've thought about it myself, but couldn't really come up with
+  anything.)
+- [ ] Switch lists to sets to optimize speed.
 
 <p align="right"><a href="#index">&uarr; Back to top</a></p>
+
+[content.bbcode]: https://github.com/Bubu-Droid/bloops/blob/main/example/content.bbcode
+[example.html]: https://github.com/Bubu-Droid/bloops/blob/main/example/index.html
+[api.md]: https://github.com/Bubu-Droid/bloops/blob/main/docs/api.md
+[CONTRIBUTING.md]: https://github.com/Bubu-Droid/bloops/blob/main/CONTRIBUTING.md

bloops-0.1.4/PKG-INFO → bloops-0.2.1/README.md

@@ -1,27 +1,5 @@
-Metadata-Version: 2.5
-Name: bloops
-Version: 0.1.4
-Summary: An AoPS-like BBCode to HTML transpiler, with live-preview and support for Asymptote geometry diagrams.
-Project-URL: Documentation, https://github.com/Bubu-Droid/bloops/blob/main/docs/API.md
-Project-URL: Issues, https://github.com/Bubu-Droid/bloops/issues
-Project-URL: Repository, https://github.com/Bubu-Droid/bloops
-Author-email: Bubu-Droid <bubu@bubudroid.me>
-License-Expression: MIT
-License-File: LICENSE
-Keywords: aops,asymptote,bbcode,converter,diagrams,geometry,html,latex,live-preview,markup,math,tex,transpiler
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Python :: 3.15
-Requires-Python: >=3.12
-Requires-Dist: livereload>=2.7.1
-Requires-Dist: watchdog>=6
-Description-Content-Type: text/markdown
-
 <div align="center">
-    <img src="https://raw.githubusercontent.com/Bubu-Droid/bloops/main/assets/banner.png" style="width: 90%; height: auto;">
+    <img src="https://raw.githubusercontent.com/Bubu-Droid/bloops/main/assets/banner.png" width="90%">
 </div>
 
 <hr>
@@ -34,11 +12,11 @@ and support for **Asymptote geometry diagrams**.
     <a href="https://github.com/Bubu-Droid/bloops/releases/latest">
         <img alt="PyPI Version" src="https://img.shields.io/pypi/v/bloops?label=PyPI&style=for-the-badge&logo=pypi&logoColor=c0caf5&labelColor=1a1b26&color=7aa2f7&v=1" />
     </a>
-    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/prek.yaml">
-        <img alt="Prek CI Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/prek.yaml?label=CI&style=for-the-badge&logo=githubactions&logoColor=c0caf5&labelColor=1a1b26&color=9ece6a" />
+    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/prek.yml">
+        <img alt="Prek CI Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/prek.yml?label=CI&style=for-the-badge&logo=githubactions&logoColor=c0caf5&labelColor=1a1b26&color=9ece6a" />
     </a>
-    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/pytest.yaml">
-        <img alt="Unit Tests Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/pytest.yaml?label=Unit%20Tests&style=for-the-badge&logo=pytest&logoColor=c0caf5&labelColor=1a1b26&color=9ece6a" />
+    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/pytest.yml">
+        <img alt="Unit Tests Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/pytest.yml?label=Unit%20Tests&style=for-the-badge&logo=pytest&logoColor=c0caf5&labelColor=1a1b26&color=9ece6a" />
     </a>
 </div>
 
@@ -49,8 +27,8 @@ and support for **Asymptote geometry diagrams**.
     <a href="https://github.com/Bubu-Droid/bloops/issues">
         <img alt="GitHub Issues" src="https://img.shields.io/github/issues/Bubu-Droid/bloops?label=Issues&style=for-the-badge&logo=github&logoColor=c0caf5&labelColor=1a1b26&color=e0af68" />
     </a>
-    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/codeql.yaml">
-        <img alt="CodeQL Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/codeql.yaml?label=CodeQL&style=for-the-badge&logo=github&logoColor=c0caf5&labelColor=1a1b26&color=bb9af7" />
+    <a href="https://github.com/Bubu-Droid/bloops/actions/workflows/codeql.yml">
+        <img alt="CodeQL Status" src="https://img.shields.io/github/actions/workflow/status/Bubu-Droid/bloops/codeql.yml?label=CodeQL&style=for-the-badge&logo=github&logoColor=c0caf5&labelColor=1a1b26&color=bb9af7" />
     </a>
 </div>
 
@@ -110,7 +88,11 @@ for vector diagram rendering
 Install `bloops` from PyPI. Here is the
 [PyPI listing](https://pypi.org/project/bloops/).
 
-- I suggest using `uv`: run ```uv tool install bloops```.
+- I suggest using `uv`:
+  - Run `uv tool install bloops` if you'd like to use `bloops`
+  just as a CLI tool.
+  - Run `uv add bloops` if you you'd like to import `bloops`
+  as a package in your project.
 - Or, if you want to use `pip`: run `pip install bloops`.
 - AUR entry is yet to be added.
 
@@ -123,7 +105,7 @@ Install `bloops` from PyPI. Here is the
 | Flag | Long Flag      | Description                                                               |
 | ---- | -------------- | ------------------------------------------------------------------------- |
 | `-h` | `--help`       | Show help message for usage of `bloops`.                                  |
-| `-v` | `--version`    | Show the version of `bloops`.                                             |
+| `-V` | `--version`    | Show the version of `bloops`.                                             |
 | `-c` | `--build-cont` | Watch `content.bbcode` for changes and continuously rebuild `index.html`. |
 | `-p` | `--preview`    | Launch a local web live-server to preview `index.html`.                   |
 | `-i` | `--input`      | (**Required**) Input directory containing `content.bbcode`.               |
@@ -191,9 +173,9 @@ Here are reference tables for each BBCode tag bloops uses:
 
 <details><summary>[color]</summary>
 
-| Option  | Mandatory | Description                              |
-| ------- | :-------: | ---------------------------------------- |
-| `color` |    YES    | Color code in hex (with the leading \#). |
+| Option | Mandatory | Description                              |
+| ------ | :-------: | ---------------------------------------- |
+| `hex`  |    YES    | Color code in hex (with the leading \#). |
 
 </details>
 
@@ -241,6 +223,14 @@ Here are reference tables for each BBCode tag bloops uses:
 
 </details>
 
+<details><summary>[hide]</summary>
+
+| Option  | Mandatory | Description                                         |
+| ------- | :-------: | --------------------------------------------------- |
+| `label` |    YES    | Label to be used as the summary for hidden details. |
+
+</details>
+
 <details><summary>math environments</summary>
 
 Currently, the following math box tags are supported:
@@ -260,6 +250,11 @@ proof and solutions.
 
 <details><summary>tags without any options</summary>
 
+| Tag                                | Purpose                                          |
+| ---------------------------------- | ------------------------------------------------ |
+| `[sidemark][/sidemark]`            | To put a number in the subscript for a sidenote. |
+| `[sidenote]<your-note>[/sidenote]` | To write a note to be put aside.                 |
+
 | Tag     | HTML Counterpart |
 | ------- | ---------------- |
 | `[b]`   | `<strong>`       |
@@ -281,9 +276,9 @@ proof and solutions.
 <br>
 
 An example showcasing the use of tags mentioned above has been
-provided in [example/content.bbcode](example/content.bbcode)
+provided in [example/content.bbcode][content.bbcode]
 and the corresponding generated HTML file is present in
-[example/index.html](example/index.html).
+[example/index.html][example.html].
 
 ## API Reference
 
@@ -299,11 +294,11 @@ If you want to convert a BBCode text into HTML using `bloops`,
 first run `validate_bbcode`, then `compile_asy_diagrams`, and
 finally `convert_bbcode_to_html` on the text.
 
-Bloops also provides the global constants under the `vars` module
-which provides `BBCODE_TAGS`, `STYLESHEET`, and `ERROR_TEMPLATE`.
+Bloops also provides the `BBCODE_TAGS` global constant
+under the `vars` module.
 
 A detailed documentation of these API endpoints can be found in
-[docs/API.md](docs/API.md).
+[docs/api.md][api.md].
 
 ## FAQs
 
@@ -353,7 +348,7 @@ need JS for running simple static pages.
 ## Contribution
 
 Contributions are very welcome!
-Please read [CONTRIBUTING.md](CONTRIBUTING.md) for a guide on
+Please read [CONTRIBUTING.md][CONTRIBUTING.md] for a guide on
 how to contribute. I'm against the idea of using AI
 for writing hobby projects; however, I have no
 problem if someone else uses them. If you're using AI assistance
@@ -368,11 +363,17 @@ how to implement it.
 ## TODOs
 
 - [ ] Implement a post-processor which adds paragraph tags around
-every disjoint block of HTML code.
-- [ ] Change `BBCODE_TAGS` to a dict instead of a list.
-- [ ] Handle `]` inside arguments of BBCode tags.
-- [ ] Add script placeholder to HTML templates.
-- [ ] De-couple templates and stylesheets by moving them
-to their independent files.
+  every disjoint block of HTML code.
+- [ ] Shift avatar to integration server.
+- [ ] Handle `[` or `]` inside arguments of BBCode tags.
+  (I'll be very glad if someone suggests me a solution for this;
+  I've thought about it myself, but couldn't really come up with
+  anything.)
+- [ ] Switch lists to sets to optimize speed.
 
 <p align="right"><a href="#index">&uarr; Back to top</a></p>
+
+[content.bbcode]: https://github.com/Bubu-Droid/bloops/blob/main/example/content.bbcode
+[example.html]: https://github.com/Bubu-Droid/bloops/blob/main/example/index.html
+[api.md]: https://github.com/Bubu-Droid/bloops/blob/main/docs/api.md
+[CONTRIBUTING.md]: https://github.com/Bubu-Droid/bloops/blob/main/CONTRIBUTING.md

bloops-0.1.4/docs/API.md → bloops-0.2.1/docs/api.md

@@ -14,11 +14,15 @@ with MathJax and Syntax Highlighting support.
 
 Args:
     text: Raw BBCode text content.
-    bbcode_tags: List of tag configurations and rule definitions.
+    bbcode_tags: Mapping of tag names to their opening pattern,
+        closing pattern and permitted arguments. See `BBCODE_TAGS`.
 
 Returns:
     A fully formatted HTML document string.
 
+Raises:
+    SyntaxError: If a tag has no matching closing tag.
+
 ## `bracer.py`
 
 ### `gobble_inside_delim` (Function)
@@ -68,6 +72,16 @@ Raises:
         matching closing tag cannot be found.
     RuntimeError: If parser enters an unexpected state.
 
+## `cli.py`
+
+### `main` (Function)
+
+Parse command-line arguments and run the build and preview process.
+
+Reads input/output paths and continuous build or live preview flags
+from CLI arguments, setting default fallback paths when necessary,
+and invokes the build and preview pipeline.
+
 ## `validator.py`
 
 ### `validate_bbcode` (Function)
@@ -80,13 +94,14 @@ dictionary mapping each diagram label to its character index.
 
 Args:
     text: Raw BBCode input string.
-    bbcode_tags: List of tag configurations, matching patterns,
-        and permitted argument lists.
+    bbcode_tags: Mapping of tag names to their opening pattern,
+        closing pattern and permitted arguments. See `BBCODE_TAGS`.
 
 Returns:
     A dictionary mapping diagram labels to their starting index.
 
 Raises:
+    SyntaxError: If a tag has no matching closing tag.
     ValueError: If an invalid argument is supplied or duplicate
         diagram labels are encountered.
 
@@ -104,6 +119,10 @@ Args:
     text: Entire input text containing BBCode and Asymptote code.
     in_dir: Source directory containing the build cache folder.
     out_dir: Target directory where compiled SVG images are stored.
+    bbcode_tags: Mapping of tag names to their opening pattern,
+        closing pattern and permitted arguments. See `BBCODE_TAGS`.
 
 Raises:
+    FileNotFoundError: If `build/cache.json` does not exist in
+        `in_dir`, or the `asy` executable is not installed.
     ValueError: If Asymptote compilation fails.

{bloops-0.1.4 → bloops-0.2.1}/example/content.bbcode

@@ -87,7 +87,9 @@ dot("$Y$", Y, NW,       tnMagenta);
 
 Here's a cute diagram from my
 [url link="https://aops.com/community/c6h3106748p32782057"]IMO 2023 G4[/url]
-solve.
+solve.[sidemark][/sidemark]
+
+[sidenote]One of my favorite problems ever. :)[/sidenote]
 
 [asy src=static/mewtwo.svg label=mewtwo width=80 caption="cute diagram from IMO 2023 P2"]
 import graph;
@@ -220,6 +222,8 @@ Prove that this process will eventually reach the number 1,
 regardless of which positive integer is chosen initially.
 [/lemma]
 
+[hide label="The proof is hidden inside this block."]
 [proof]
 [s]Left as an exercise to the reader[/s] Skipped, too easy.
 [/proof]
+[/hide]

{bloops-0.1.4 → bloops-0.2.1}/example/index.html

@@ -9,24 +9,25 @@
       type="image/x-icon"
       href="https://avatar.artofproblemsolving.com/avatar_778606.png"
     />
-    <link rel="stylesheet" href="static/style.css" />
-    <link rel="preconnect" href="https://fonts.googleapis.com" />
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-    <link
-      href="https://fonts.googleapis.com/css2?family=Lora:ital,wght@0,400..700;1,400..700&display=swap"
-      rel="stylesheet"
-    />
-    <link
-      href="https://fonts.googleapis.com/css2?family=Open+Sans:ital,wght@0,300..800;1,300..800&display=swap"
-      rel="stylesheet"
-    />
     <link
-      href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&display=swap"
       rel="stylesheet"
+      href="https://cdn.jsdelivr.net/npm/@catppuccin/highlightjs@1.0.1/css/catppuccin-variables.css"
     />
+    <link rel="stylesheet" href="static/style.css" />
+    <script>
+      try {
+        document.documentElement.dataset.theme =
+          localStorage.getItem("theme") ||
+          (matchMedia("(prefers-color-scheme: dark)").matches
+            ? "night"
+            : "day");
+      } catch {}
+    </script>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link
+      href="https://fonts.googleapis.com/css2?family=Literata:ital,opsz,wght@0,7..72,200..900;1,7..72,200..900&family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&display=swap"
       rel="stylesheet"
-      href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.12.0/styles/tokyo-night-dark.min.css"
     />
     <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.12.0/highlight.min.js"></script>
     <script>
@@ -55,16 +56,13 @@
       defer
       src="https://cdn.jsdelivr.net/npm/mathjax@4/tex-svg.js"
     ></script>
+    <script src="static/script.js" defer></script>
   </head>
   <body>
     <h1>Page Heading</h1>
 
     Here is a <span style="color: #9ece6a">code</span> block:
-    <pre>
-<code class="language-python">
-print("hello world!")
-</code>
-</pre>
+    <pre><code class="language-python">print("hello world!")</code></pre>
 
     Here's an <strong>Asymptote</strong> diagram:
     <figure>
@@ -76,7 +74,9 @@ print("hello world!")
     <a href="https://aops.com/community/c6h3106748p32782057" target="_blank"
       >IMO 2023 G4</a
     >
-    solve.
+    solve.<span class="sidemark"></span>
+
+    <span class="sidenote">One of my favorite problems ever. :)</span>
 
     <figure>
       <img src="static/mewtwo.svg" style="width: 80%; height: auto" />
@@ -128,12 +128,15 @@ print("hello world!")
       which positive integer is chosen initially.
     </div>
 
-    <div>
-      <i class="proof">Proof.</i>
-      <s>Left as an exercise to the reader</s> Skipped, too easy.<span
-        class="qed"
-        >&#9633;</span
-      >
-    </div>
+    <details>
+      <summary>The proof is hidden inside this block.</summary>
+      <div>
+        <i class="proof">Proof.</i>
+        <s>Left as an exercise to the reader</s> Skipped, too easy.<span
+          class="qed"
+          >&#9633;</span
+        >
+      </div>
+    </details>
   </body>
 </html>

{bloops-0.1.4 → bloops-0.2.1}/pyproject.toml

@@ -26,22 +26,33 @@ license-files = [ "LICEN[CS]E*" ]
 authors = [ { name = "Bubu-Droid", email = "bubu@bubudroid.me" } ]
 requires-python = ">=3.12"
 classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Education",
+  "Natural Language :: English",
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3 :: Only",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
   "Programming Language :: Python :: 3.15",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Topic :: Education",
+  "Topic :: Scientific/Engineering :: Mathematics",
+  "Topic :: Text Processing :: Markup",
+  "Topic :: Text Processing :: Markup :: HTML",
+  "Typing :: Typed",
 ]
 dynamic = [ "version" ]
 dependencies = [
   "livereload>=2.7.1",
   "watchdog>=6",
 ]
-urls.Documentation = "https://github.com/Bubu-Droid/bloops/blob/main/docs/API.md"
+urls.Documentation = "https://github.com/Bubu-Droid/bloops/blob/main/docs/api.md"
 urls.Issues = "https://github.com/Bubu-Droid/bloops/issues"
 urls.Repository = "https://github.com/Bubu-Droid/bloops"
-scripts.bloops = "bloops.__main__:main"
+scripts.bloops = "bloops.cli:main"
 
 [dependency-groups]
 dev = [
@@ -52,12 +63,18 @@ dev = [
 [tool.hatch]
 version.path = "src/bloops/__about__.py"
 build.targets.wheel.packages = [ "src/bloops" ]
+build.targets.sdist.include = [ "/src", "/tests", "/docs", "/example" ]
 
 [tool.ruff]
 line-length = 80
-lint.extend-select = [ "ANN" ]
+lint.extend-select = [ "ANN", "D", "DOC" ]
+lint.per-file-ignores.".github/**" = [ "D", "DOC" ]
+lint.per-file-ignores."tests/**" = [ "D", "DOC" ]
 lint.unfixable = [ "F401" ]
 
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
 [tool.basedpyright]
 executionEnvironments = [
   { root = "tests", reportPrivateUsage = false },

bloops-0.2.1/src/bloops/__about__.py

@@ -0,0 +1,5 @@
+"""Version, author and license metadata for bloops."""
+
+__version__ = "0.2.1"
+__author__ = "Bubu-Droid"
+__license__ = "MIT"

bloops-0.2.1/src/bloops/__init__.py

@@ -0,0 +1,6 @@
+"""An AoPS-like BBCode to HTML transpiler with Asymptote diagram support.
+
+Use `bloops.validator.validate_bbcode` and
+`bloops.validator.compile_asy_diagrams` to check a document and render its
+diagrams, then `bloops.bloopser.convert_bbcode_to_html` to produce the HTML.
+"""

bloops-0.2.1/src/bloops/__main__.py

@@ -0,0 +1,6 @@
+"""Run the bloops command-line interface with `python -m bloops`."""
+
+from bloops.cli import main
+
+if __name__ == "__main__":
+    main()