# `Membrane.Source`
[🔗](https://github.com/membraneframework/membrane-core/blob/v1.2.7/lib/membrane/source.ex#L1)

Module that should be used in sources - elements producing data. Declares
appropriate behaviours implementation and provides default callbacks implementation.

Behaviours for sources are specified in modules
`Membrane.Element.Base` and
`Membrane.Element.WithOutputPads`.

Source elements can define only output pads. Job of a usual source is to produce
some data (read from soundcard, download through HTTP, etc.) and send it through
such pad. If the pad has the flow control set to `:manual`, then element is also
responsible for receiving demands and send buffers only if they have previously
been demanded (for more details, see `c:Membrane.Element.WithOutputPads.handle_demand/5`
callback). Sources, like all elements, can of course have multiple pads if needed to
provide more complex solutions.

## List of available callbacks
Below there is a list of all the callbacks available in a module, that implements `Membrane.Source` behaviour.
We have put it for your convenience, as some of these callbacks aren't directly defined in that module and
their specification is available in different modules.

The callbacks available in `Membrane.Source` behaviour:

`Membrane.Element.Base`
* `c:Membrane.Element.Base.__struct__/0`
* `c:Membrane.Element.Base.__struct__/1`
* `c:Membrane.Element.Base.handle_event/4`
* `c:Membrane.Element.Base.handle_info/3`
* `c:Membrane.Element.Base.handle_init/2`
* `c:Membrane.Element.Base.handle_pad_added/3`
* `c:Membrane.Element.Base.handle_pad_removed/3`
* `c:Membrane.Element.Base.handle_parent_notification/3`
* `c:Membrane.Element.Base.handle_playing/2`
* `c:Membrane.Element.Base.handle_setup/2`
* `c:Membrane.Element.Base.handle_terminate_request/2`
* `c:Membrane.Element.Base.handle_tick/3`

`Membrane.Element.WithOutputPads`
* `c:Membrane.Element.WithOutputPads.handle_demand/5`

# `__using__`
*macro* 

Brings all the stuff necessary to implement a source element.

Options:
  - `:bring_pad?` - if true (default) requires and aliases `Membrane.Pad`
  - `:flow_control_hints?` - if true (default) generates compile-time warnings     if the number, direction, and type of flow control of pads are likely to cause unintended     behaviours.

---

*Consult [api-reference.md](api-reference.md) for complete listing*