sextile 0.1.0__tar.gz

sextile-0.1.0/.gitignore

@@ -0,0 +1,24 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# The archive Sextile accumulates at runtime
+*.sqlite
+
+# macOS
+.DS_Store
+
+# Editors
+.idea/
+.vscode/
+
+# Sphinx build output and autosummary-generated stubs
+docs/_build/
+uv.lock

sextile-0.1.0/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2026 Robert Smallshire
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The MIT licence above covers the software and its documentation. It does not,
+and cannot, cover third-party material included for testing. See NOTICE.md.

sextile-0.1.0/NOTICE.md

@@ -0,0 +1,51 @@
+# Third-party material
+
+Sextile is MIT licensed (see [LICENSE](LICENSE)). The mosaic font faces and the
+Bedstead font it ships are not ours to license, and are noted here. Each face
+also carries its source and terms in its own header, and the conversion to this
+project's format changes the format and nothing else about the design.
+
+## Fonts
+
+`sextile/viewdata/fonts/` holds bitmap faces converted into this project's own
+format. None is covered by the MIT grant above.
+
+### Free for public use
+
+| face | from |
+|---|---|
+| `acorn` | MDFS ArcNormal (mdfs.net/Apps/Font/Fonts1.zip), by J.G.Harston |
+
+### Public domain (Creative Commons Zero v1.0)
+
+`3x3-mono` (GGBotNet), `boldbash` (Michiel), `lilliputsteps` (Raymond Larabie),
+`pixeloperator` and its variants (Jayvee Enaguas / HarvettFox96), `pixelplace`
+(Michiel), `publicpixel` (GGBotNet).
+
+### SIL Open Font License, Version 1.1
+
+The licence text and copyright notices are in `sextile/viewdata/fonts/OFL-1.1.txt`,
+which ships with the faces because the licence requires it. Converting a font to
+another format makes a Modified Version, which may not use a reserved font name,
+so several carry a name of ours instead; the original is named in each file's
+`source:` line, and the mapping is in the licence file.
+
+`arcade` (QuinqueFive, GGBotNet), `console` and `console-bold` (Dogica, Roberto
+Mocci), `garland` (Birch Leaf, solirides), `grotesque` and `grotesque-bold`
+(Pixeloid Sans, GGBotNet), `roman` (Times9k, Sammy L. Koch), `scientifica` and
+its variants (Akshay Oppiliappan), `silkscreen` and `silkscreen-bold` (Jason
+Kottke).
+
+The CC0 and Open Font faces come from `github.com/michielp1807/more-fonts`, whose
+own MIT licence covers its source and not the faces it collects.
+
+## Bedstead
+
+`sextile/viewdata/static/bedstead.woff2` is Bedstead, the Mullard SAA5050
+teletext character generator recreated as an OpenType font by bjh21 (Ben
+Harris), which draws Viewdata frames as HTML — `sextile render --form html`
+ships it. The program that generates Bedstead and its newly-designed glyphs are
+released into the public domain (CC0-1.0); the original SAA5050 bitmap is stated
+to be public domain in the United Kingdom under Section 55 of the Copyright,
+Designs and Patents Act 1988. Vendored from `https://bjh21.me.uk/bedstead/bedstead.otf`
+and converted to WOFF2 with fontTools; the design is unchanged.

sextile-0.1.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.5
+Name: sextile
+Version: 0.1.0
+Summary: A framework for Prestel-style Viewdata services
+Project-URL: Homepage, https://github.com/rob-smallshire/sextile
+Project-URL: Documentation, https://rob-smallshire.github.io/sextile/
+Project-URL: Repository, https://github.com/rob-smallshire/sextile
+Project-URL: Issues, https://github.com/rob-smallshire/sextile/issues
+Project-URL: Changelog, https://github.com/rob-smallshire/sextile/blob/master/CHANGELOG.md
+Author-email: Robert Smallshire <robert@smallshire.org.uk>
+License-Expression: MIT
+License-File: LICENSE
+License-File: NOTICE.md
+Keywords: bbc-micro,prestel,retrocomputing,teletext,videotex,viewdata
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Terminals
+Requires-Python: >=3.12
+Requires-Dist: anyascii>=0.3
+Description-Content-Type: text/markdown
+
+# Sextile
+
+[![CI](https://github.com/rob-smallshire/sextile/actions/workflows/ci.yml/badge.svg)](https://github.com/rob-smallshire/sextile/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/sextile.svg)](https://pypi.org/project/sextile/)
+[![Python](https://img.shields.io/pypi/pyversions/sextile.svg)](https://pypi.org/project/sextile/)
+[![Licence](https://img.shields.io/pypi/l/sextile.svg)](https://github.com/rob-smallshire/sextile/blob/master/LICENSE)
+[![Docs](https://img.shields.io/badge/docs-github.io-blue)](https://rob-smallshire.github.io/sextile/)
+
+A framework for Viewdata services, in Python. Sextile is to a Prestel-style
+service what Flask or Starlette is to a web application: it owns the connection,
+the session, the page numbering and the frames on the wire, and you write what
+the pages say. The [documentation](https://rob-smallshire.github.io/sextile/)
+opens with what Viewdata is.
+
+```sh
+uv add sextile          # or pip install sextile
+```
+
+```python
+from sextile import Page, PageRequest, Sextile, notice_page
+
+app = Sextile(name="My service")
+
+@app.page("1", name="main", keywords=("MAIN",))
+async def main(request: PageRequest) -> Page:
+    return notice_page(request, "Hello, 1981.")
+```
+
+```sh
+sextile serve my_service:app     # answer calls on port 6850
+nc localhost 6850                # and call it
+```
+
+## What it gives you
+
+**Routing by page number.** Patterns of literal digits and named fields, so
+`82{post_id:int}` answers every page beginning 82 and hands the rest to the
+handler already read as an integer. `app.address_for("post", post_id=...)` reads
+the same pattern backwards, so a page linking to another does not respell the
+numbering. Keywords — `*MAIN#` for `*1#` — are the route's `keywords=`.
+
+**Sessions that last as long as the line.** A Viewdata terminal is a display and
+nothing more: it holds the frame on screen and nothing else. So the server holds
+where the reader is, what they have seen, and the menu they came through, and a
+handler is a function of a request rather than of a number. The reasoning is in
+[the explanation](https://rob-smallshire.github.io/sextile/explanation/why-sextile.html).
+
+**The wire, measured rather than assumed.** Attributes travel as `ESC` + code +
+0x40, a frame is 24 rows of 40 that wraps at the bottom-right back to the top
+left, `RETURN` transmits 0x5F. Those were settled by driving real Commstar under
+an emulator, and are written up in
+[the encoding reference](https://rob-smallshire.github.io/sextile/reference/viewdata-encoding.html).
+
+**Nobody is cut off without warning.** After half the idle timeout a silent
+caller's footer becomes a bar that drains, reading `Press a key`. The first key
+dismisses it and does nothing else, so it is safe to press whatever comes to
+hand. Every service gets this without writing anything.
+
+**Forty columns, accounted for.** A colour attribute occupies a character cell,
+so a row that changes colour twice has thirty-eight columns for text. `Canvas`
+does that arithmetic so nothing above it has to.
+
+**Drawable without a Beeb.** `sextile render` draws any page four ways: `ansi`
+colour as the Beeb would draw it, `grid` for the character and attribute layers,
+`bytes` for the wire stream, and `html` for a self-contained web page with the
+Bedstead font embedded, opening from disk with no server.
+
+## Documentation
+
+The full documentation is at
+[rob-smallshire.github.io/sextile](https://rob-smallshire.github.io/sextile/):
+[the tutorial](https://rob-smallshire.github.io/sextile/tutorial/index.html)
+builds a service step by step, the
+[how-to guides](https://rob-smallshire.github.io/sextile/how-to/index.html)
+answer particular questions, the
+[reference](https://rob-smallshire.github.io/sextile/reference/index.html) states
+the surface, the glossary and the wire, and the
+[explanation](https://rob-smallshire.github.io/sextile/explanation/index.html)
+says why the framework is shaped as it is.
+
+## Status
+
+Young, and extracted from a working service rather than designed in the abstract.
+Three applications use it in the
+[source repository](https://github.com/rob-smallshire/sextile): a real Stardot
+forum reader, a weather service, and a calendar written to be read.
+
+MIT licensed. The bundled font faces and the Bedstead font are third-party
+material; see
+[NOTICE.md](https://github.com/rob-smallshire/sextile/blob/master/packages/sextile/NOTICE.md).

sextile-0.1.0/README.md

@@ -0,0 +1,90 @@
+# Sextile
+
+[![CI](https://github.com/rob-smallshire/sextile/actions/workflows/ci.yml/badge.svg)](https://github.com/rob-smallshire/sextile/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/sextile.svg)](https://pypi.org/project/sextile/)
+[![Python](https://img.shields.io/pypi/pyversions/sextile.svg)](https://pypi.org/project/sextile/)
+[![Licence](https://img.shields.io/pypi/l/sextile.svg)](https://github.com/rob-smallshire/sextile/blob/master/LICENSE)
+[![Docs](https://img.shields.io/badge/docs-github.io-blue)](https://rob-smallshire.github.io/sextile/)
+
+A framework for Viewdata services, in Python. Sextile is to a Prestel-style
+service what Flask or Starlette is to a web application: it owns the connection,
+the session, the page numbering and the frames on the wire, and you write what
+the pages say. The [documentation](https://rob-smallshire.github.io/sextile/)
+opens with what Viewdata is.
+
+```sh
+uv add sextile          # or pip install sextile
+```
+
+```python
+from sextile import Page, PageRequest, Sextile, notice_page
+
+app = Sextile(name="My service")
+
+@app.page("1", name="main", keywords=("MAIN",))
+async def main(request: PageRequest) -> Page:
+    return notice_page(request, "Hello, 1981.")
+```
+
+```sh
+sextile serve my_service:app     # answer calls on port 6850
+nc localhost 6850                # and call it
+```
+
+## What it gives you
+
+**Routing by page number.** Patterns of literal digits and named fields, so
+`82{post_id:int}` answers every page beginning 82 and hands the rest to the
+handler already read as an integer. `app.address_for("post", post_id=...)` reads
+the same pattern backwards, so a page linking to another does not respell the
+numbering. Keywords — `*MAIN#` for `*1#` — are the route's `keywords=`.
+
+**Sessions that last as long as the line.** A Viewdata terminal is a display and
+nothing more: it holds the frame on screen and nothing else. So the server holds
+where the reader is, what they have seen, and the menu they came through, and a
+handler is a function of a request rather than of a number. The reasoning is in
+[the explanation](https://rob-smallshire.github.io/sextile/explanation/why-sextile.html).
+
+**The wire, measured rather than assumed.** Attributes travel as `ESC` + code +
+0x40, a frame is 24 rows of 40 that wraps at the bottom-right back to the top
+left, `RETURN` transmits 0x5F. Those were settled by driving real Commstar under
+an emulator, and are written up in
+[the encoding reference](https://rob-smallshire.github.io/sextile/reference/viewdata-encoding.html).
+
+**Nobody is cut off without warning.** After half the idle timeout a silent
+caller's footer becomes a bar that drains, reading `Press a key`. The first key
+dismisses it and does nothing else, so it is safe to press whatever comes to
+hand. Every service gets this without writing anything.
+
+**Forty columns, accounted for.** A colour attribute occupies a character cell,
+so a row that changes colour twice has thirty-eight columns for text. `Canvas`
+does that arithmetic so nothing above it has to.
+
+**Drawable without a Beeb.** `sextile render` draws any page four ways: `ansi`
+colour as the Beeb would draw it, `grid` for the character and attribute layers,
+`bytes` for the wire stream, and `html` for a self-contained web page with the
+Bedstead font embedded, opening from disk with no server.
+
+## Documentation
+
+The full documentation is at
+[rob-smallshire.github.io/sextile](https://rob-smallshire.github.io/sextile/):
+[the tutorial](https://rob-smallshire.github.io/sextile/tutorial/index.html)
+builds a service step by step, the
+[how-to guides](https://rob-smallshire.github.io/sextile/how-to/index.html)
+answer particular questions, the
+[reference](https://rob-smallshire.github.io/sextile/reference/index.html) states
+the surface, the glossary and the wire, and the
+[explanation](https://rob-smallshire.github.io/sextile/explanation/index.html)
+says why the framework is shaped as it is.
+
+## Status
+
+Young, and extracted from a working service rather than designed in the abstract.
+Three applications use it in the
+[source repository](https://github.com/rob-smallshire/sextile): a real Stardot
+forum reader, a weather service, and a calendar written to be read.
+
+MIT licensed. The bundled font faces and the Bedstead font are third-party
+material; see
+[NOTICE.md](https://github.com/rob-smallshire/sextile/blob/master/packages/sextile/NOTICE.md).