# {py:mod}`pypercard.core`

```{py:module} pypercard.core
:noindex:
```

```{autodoc2-docstring} pypercard.core
:allowtitles:
```

## Module Contents

### Classes

````{list-table}
:class: autosummary longtable
:align: left

* - {py:obj}`Card <pypercard.core.Card>`
  - ```{autodoc2-docstring} pypercard.core.Card
    :summary:
    ```
* - {py:obj}`App <pypercard.core.App>`
  - ```{autodoc2-docstring} pypercard.core.App
    :summary:
    ```
````

### API

`````{py:class} Card(name, template=None, on_show=None, on_hide=None, auto_advance=None, transition=None, sound=None, sound_loop=False, background=None, background_repeat=False)
:canonical: pypercard.core.Card
:noindex:

```{autodoc2-docstring} pypercard.core.Card
```

```{rubric} Initialization
```

```{autodoc2-docstring} pypercard.core.Card.__init__
```

````{py:method} register_app(app)
:canonical: pypercard.core.Card.register_app
:noindex:

```{autodoc2-docstring} pypercard.core.Card.register_app
```

````

````{py:method} show()
:canonical: pypercard.core.Card.show
:noindex:

```{autodoc2-docstring} pypercard.core.Card.show
```

````

````{py:method} _add_dom_event_listeners()
:canonical: pypercard.core.Card._add_dom_event_listeners
:noindex:

```{autodoc2-docstring} pypercard.core.Card._add_dom_event_listeners
```

````

````{py:method} _start_auto_advance_timer()
:canonical: pypercard.core.Card._start_auto_advance_timer
:noindex:

```{autodoc2-docstring} pypercard.core.Card._start_auto_advance_timer
```

````

````{py:method} hide()
:canonical: pypercard.core.Card.hide
:noindex:

```{autodoc2-docstring} pypercard.core.Card.hide
```

````

````{py:method} _remove_dom_event_listeners()
:canonical: pypercard.core.Card._remove_dom_event_listeners
:noindex:

```{autodoc2-docstring} pypercard.core.Card._remove_dom_event_listeners
```

````

````{py:method} register_transition(dom_event_name, element_id=None, query=None)
:canonical: pypercard.core.Card.register_transition
:noindex:

```{autodoc2-docstring} pypercard.core.Card.register_transition
```

````

````{py:method} get_by_id(element_id)
:canonical: pypercard.core.Card.get_by_id
:noindex:

```{autodoc2-docstring} pypercard.core.Card.get_by_id
```

````

````{py:method} get_element(selector)
:canonical: pypercard.core.Card.get_element
:noindex:

```{autodoc2-docstring} pypercard.core.Card.get_element
```

````

````{py:method} get_elements(selector)
:canonical: pypercard.core.Card.get_elements
:noindex:

```{autodoc2-docstring} pypercard.core.Card.get_elements
```

````

`````

`````{py:class} App(name=None, datastore=None, cards=None, sounds=None)
:canonical: pypercard.core.App
:noindex:

```{autodoc2-docstring} pypercard.core.App
```

```{rubric} Initialization
```

```{autodoc2-docstring} pypercard.core.App.__init__
```

````{py:method} _new_id()
:canonical: pypercard.core.App._new_id
:noindex:

```{autodoc2-docstring} pypercard.core.App._new_id
```

````

````{py:method} _harvest_cards_from_dom()
:canonical: pypercard.core.App._harvest_cards_from_dom
:noindex:

```{autodoc2-docstring} pypercard.core.App._harvest_cards_from_dom
```

````

````{py:method} _resolve_card(card_reference)
:canonical: pypercard.core.App._resolve_card
:noindex:

```{autodoc2-docstring} pypercard.core.App._resolve_card
```

````

````{py:method} show_card(card)
:canonical: pypercard.core.App.show_card
:noindex:

```{autodoc2-docstring} pypercard.core.App.show_card
```

````

````{py:method} hide_card(card)
:canonical: pypercard.core.App.hide_card
:noindex:

```{autodoc2-docstring} pypercard.core.App.hide_card
```

````

````{py:method} add_card(card)
:canonical: pypercard.core.App.add_card
:noindex:

```{autodoc2-docstring} pypercard.core.App.add_card
```

````

````{py:method} get_next_card(card)
:canonical: pypercard.core.App.get_next_card
:noindex:

```{autodoc2-docstring} pypercard.core.App.get_next_card
```

````

````{py:method} remove_card(card_reference)
:canonical: pypercard.core.App.remove_card
:noindex:

```{autodoc2-docstring} pypercard.core.App.remove_card
```

````

````{py:method} add_sound(name, url)
:canonical: pypercard.core.App.add_sound
:noindex:

```{autodoc2-docstring} pypercard.core.App.add_sound
```

````

````{py:method} get_sound(name)
:canonical: pypercard.core.App.get_sound
:noindex:

```{autodoc2-docstring} pypercard.core.App.get_sound
```

````

````{py:method} remove_sound(name)
:canonical: pypercard.core.App.remove_sound
:noindex:

```{autodoc2-docstring} pypercard.core.App.remove_sound
```

````

````{py:method} play_sound(name, loop=False, multitrack=False, restart=False)
:canonical: pypercard.core.App.play_sound
:noindex:

```{autodoc2-docstring} pypercard.core.App.play_sound
```

````

````{py:method} pause_sound(name, keep_place=False)
:canonical: pypercard.core.App.pause_sound
:noindex:

```{autodoc2-docstring} pypercard.core.App.pause_sound
```

````

````{py:method} register_transition(dom_event_name, element_id=None, selector=None)
:canonical: pypercard.core.App.register_transition
:noindex:

```{autodoc2-docstring} pypercard.core.App.register_transition
```

````

````{py:method} set_background(background='')
:canonical: pypercard.core.App.set_background
:noindex:

```{autodoc2-docstring} pypercard.core.App.set_background
```

````

````{py:method} transition(from_card_name_or_list, dom_event_name, id=None, query=None)
:canonical: pypercard.core.App.transition
:noindex:

```{autodoc2-docstring} pypercard.core.App.transition
```

````

````{py:method} start(card_reference=None)
:canonical: pypercard.core.App.start
:noindex:

```{autodoc2-docstring} pypercard.core.App.start
```

````

````{py:method} dump()
:canonical: pypercard.core.App.dump
:noindex:

```{autodoc2-docstring} pypercard.core.App.dump
```

````

````{py:method} load(tree)
:canonical: pypercard.core.App.load
:noindex:

```{autodoc2-docstring} pypercard.core.App.load
```

````

````{py:method} _create_auto_advance_transition(from_card)
:canonical: pypercard.core.App._create_auto_advance_transition
:noindex:

```{autodoc2-docstring} pypercard.core.App._create_auto_advance_transition
```

````

````{py:method} _create_dom_event_transition(from_card_name, transition_fn_or_card_name, dom_event_name, element_id=None, selector=None)
:canonical: pypercard.core.App._create_dom_event_transition
:noindex:

```{autodoc2-docstring} pypercard.core.App._create_dom_event_transition
```

````

````{py:method} _create_card_state(card)
:canonical: pypercard.core.App._create_card_state
:noindex:

```{autodoc2-docstring} pypercard.core.App._create_card_state
```

````

````{py:method} _get_name_of_card_to_transition_to(from_card, transition_fn_or_card_name, input_)
:canonical: pypercard.core.App._get_name_of_card_to_transition_to
:noindex:

```{autodoc2-docstring} pypercard.core.App._get_name_of_card_to_transition_to
```

````

`````