Introduction
============
.. image:: https://readthedocs.org/projects/adafruit-circuitpython-pyoa/badge/?version=latest
:target: https://docs.circuitpython.org/projects/pyoa/en/latest/
:alt: Documentation Status
.. image:: https://raw.githubusercontent.com/adafruit/Adafruit_CircuitPython_Bundle/main/badges/adafruit_discord.svg
:target: https://adafru.it/discord
:alt: Discord
.. image:: https://github.com/adafruit/Adafruit_CircuitPython_PYOA/workflows/Build%20CI/badge.svg
:target: https://github.com/adafruit/Adafruit_CircuitPython_PYOA/actions/
:alt: Build Status
.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
:target: https://github.com/astral-sh/ruff
:alt: Code Style: Ruff
A CircuitPython 'Choose Your Own Adventure' framework for PyPortal.
Dependencies
=============
This driver depends on:
* Adafruit CircuitPython <https://github.com/adafruit/circuitpython>
Please ensure all dependencies are available on the CircuitPython filesystem.
This is easily achieved by downloading
`the Adafruit library and driver bundle <https://github.com/adafruit/Adafruit_CircuitPython_Bundle>`_.
Usage Example
=============
.. code-block:: python
import adafruit_sdcard
import storage
from adafruit_pyoa import PYOA_Graphics
import board
import digitalio
try:
sdcard = adafruit_sdcard.SDCard(board.SPI(), digitalio.DigitalInOut(board.SD_CS))
vfs = storage.VfsFat(sdcard)
storage.mount(vfs, "/sd")
print("SD card found") # no biggie
except OSError:
print("No SD card found") # no biggie
gfx = PYOA_Graphics()
gfx.load_game("/cyoa")
current_card = 0 # start with first card
while True:
print("Current card:", current_card)
current_card = gfx.display_card(current_card)
Documentation
=============
API documentation for this library can be found on `Read the Docs <https://docs.circuitpython.org/projects/pyoa/en/latest/>`_.
For information on building library documentation, please check out `this guide <https://learn.adafruit.com/creating-and-sharing-a-circuitpython-library/sharing-our-docs-on-readthedocs#sphinx-5-1>`_.
Contributing
============
Contributions are welcome! Please read our `Code of Conduct
<https://github.com/adafruit/Adafruit_CircuitPython_PYOA/blob/main/CODE_OF_CONDUCT.md>`_
before contributing to help this project stay welcoming.
Raw data
{
"_id": null,
"home_page": null,
"name": "adafruit-circuitpython-PYOA",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "adafruit, pyoa, text, adventure, hardware, micropython, circuitpython",
"author": null,
"author_email": "Adafruit Industries <circuitpython@adafruit.com>",
"download_url": "https://files.pythonhosted.org/packages/d7/a1/ce670d99f933818b7bf29ed5b31dca115ccc7411317bb797c063f4317152/adafruit_circuitpython_pyoa-2.6.6.tar.gz",
"platform": null,
"description": "Introduction\n============\n\n.. image:: https://readthedocs.org/projects/adafruit-circuitpython-pyoa/badge/?version=latest\n :target: https://docs.circuitpython.org/projects/pyoa/en/latest/\n :alt: Documentation Status\n\n.. image:: https://raw.githubusercontent.com/adafruit/Adafruit_CircuitPython_Bundle/main/badges/adafruit_discord.svg\n :target: https://adafru.it/discord\n :alt: Discord\n\n.. image:: https://github.com/adafruit/Adafruit_CircuitPython_PYOA/workflows/Build%20CI/badge.svg\n :target: https://github.com/adafruit/Adafruit_CircuitPython_PYOA/actions/\n :alt: Build Status\n\n.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json\n :target: https://github.com/astral-sh/ruff\n :alt: Code Style: Ruff\n\nA CircuitPython 'Choose Your Own Adventure' framework for PyPortal.\n\n\nDependencies\n=============\nThis driver depends on:\n\n* Adafruit CircuitPython <https://github.com/adafruit/circuitpython>\n\nPlease ensure all dependencies are available on the CircuitPython filesystem.\nThis is easily achieved by downloading\n`the Adafruit library and driver bundle <https://github.com/adafruit/Adafruit_CircuitPython_Bundle>`_.\n\nUsage Example\n=============\n\n.. code-block:: python\n\n import adafruit_sdcard\n import storage\n from adafruit_pyoa import PYOA_Graphics\n import board\n import digitalio\n\n try:\n sdcard = adafruit_sdcard.SDCard(board.SPI(), digitalio.DigitalInOut(board.SD_CS))\n vfs = storage.VfsFat(sdcard)\n storage.mount(vfs, \"/sd\")\n print(\"SD card found\") # no biggie\n except OSError:\n print(\"No SD card found\") # no biggie\n\n gfx = PYOA_Graphics()\n\n gfx.load_game(\"/cyoa\")\n current_card = 0 # start with first card\n\n while True:\n print(\"Current card:\", current_card)\n current_card = gfx.display_card(current_card)\n\n\nDocumentation\n=============\n\nAPI documentation for this library can be found on `Read the Docs <https://docs.circuitpython.org/projects/pyoa/en/latest/>`_.\n\nFor information on building library documentation, please check out `this guide <https://learn.adafruit.com/creating-and-sharing-a-circuitpython-library/sharing-our-docs-on-readthedocs#sphinx-5-1>`_.\n\nContributing\n============\n\nContributions are welcome! Please read our `Code of Conduct\n<https://github.com/adafruit/Adafruit_CircuitPython_PYOA/blob/main/CODE_OF_CONDUCT.md>`_\nbefore contributing to help this project stay welcoming.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python your own Adventure - card & button game",
"version": "2.6.6",
"project_urls": {
"Homepage": "https://github.com/adafruit/Adafruit_CircuitPython_PYOA"
},
"split_keywords": [
"adafruit",
" pyoa",
" text",
" adventure",
" hardware",
" micropython",
" circuitpython"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "fd9d23104f91fbe0fe37658a8e11b7a5419d02cca387236975264be34b7b15ee",
"md5": "d8aaf8e6be46fb0f8991b6b9b89fad15",
"sha256": "15f71903de82064d69b4e2272e5da7cd2c102d10ee9f22cace308a0f4bba4303"
},
"downloads": -1,
"filename": "adafruit_circuitpython_pyoa-2.6.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d8aaf8e6be46fb0f8991b6b9b89fad15",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8017,
"upload_time": "2025-10-20T20:43:56",
"upload_time_iso_8601": "2025-10-20T20:43:56.844875Z",
"url": "https://files.pythonhosted.org/packages/fd/9d/23104f91fbe0fe37658a8e11b7a5419d02cca387236975264be34b7b15ee/adafruit_circuitpython_pyoa-2.6.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d7a1ce670d99f933818b7bf29ed5b31dca115ccc7411317bb797c063f4317152",
"md5": "713d57a220b727c91a2f301e3a5de343",
"sha256": "0c687b0fe4e37b62b69433c9f0f460317f63d9e13a5d1032b557f627d9c44f0c"
},
"downloads": -1,
"filename": "adafruit_circuitpython_pyoa-2.6.6.tar.gz",
"has_sig": false,
"md5_digest": "713d57a220b727c91a2f301e3a5de343",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7233532,
"upload_time": "2025-10-20T20:43:58",
"upload_time_iso_8601": "2025-10-20T20:43:58.437657Z",
"url": "https://files.pythonhosted.org/packages/d7/a1/ce670d99f933818b7bf29ed5b31dca115ccc7411317bb797c063f4317152/adafruit_circuitpython_pyoa-2.6.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-20 20:43:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "adafruit",
"github_project": "Adafruit_CircuitPython_PYOA",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "Adafruit-Blinka",
"specs": []
},
{
"name": "adafruit-blinka-displayio",
"specs": []
},
{
"name": "adafruit-circuitpython-bitmap-font",
"specs": []
},
{
"name": "adafruit-circuitpython-display-button",
"specs": []
},
{
"name": "adafruit-circuitpython-touchscreen",
"specs": []
},
{
"name": "adafruit-circuitpython-display-text",
"specs": []
},
{
"name": "adafruit-circuitpython-cursorcontrol",
"specs": []
}
],
"lcname": "adafruit-circuitpython-pyoa"
}
JSON
