@bharper/atv-js 0.2.6 → 0.3.4

package/pyatv/CODE_OF_CONDUCT.md

@@ -0,0 +1,76 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at pierre.staahl@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

package/pyatv/CONTRIBUTING.md

@@ -0,0 +1,72 @@
+# Contributing
+
+First off, thank you for showing an interest in pyatv and perhaps also contributing!
+Every contribution matters and it's people like you that make pyatv great! :heart:
+
+## Getting Started
+
+### Resources to read
+
+Make sure to read these awesome documents:
+
+[Code of Conduct](CODE_OF_CONDUCT.md)
+
+[FAQ](https://pyatv.readthedocs.io/en/master/faq.html)
+
+### Reporting a bug
+
+If you think you have found a bug, please consider writing an issue about it. Use the "Bug" template
+and be as precise as you can.
+
+[Click here to open a new bug report](https://github.com/postlund/pyatv/issues/new?assignees=&labels=bug&template=bug_report.md&title=)
+
+### Requesting a new feature
+
+New features are always cool, maybe you have some ideas or wishes? There is a template for feature
+requests as well. Just create an issue and fill it out.
+
+[Click here to request a new feature](https://github.com/postlund/pyatv/issues/new?assignees=&labels=feature&template=feature_request.md&title=)
+
+### Questions or ideas
+
+If you have any questions (e.g. "how do I do this with pyatv"), you can write an issue as well. You can also
+leave ideas for other kinds of improvements, like gaps in the documentation or better development tools.
+
+[Click here to ask a general question](https://github.com/postlund/pyatv/issues/new?assignees=&labels=question&template=question-or-idea.md&title=)
+
+## Development
+
+### Getting code and setting up development environment
+
+Getting started with development is quite simple:
+
+```
+1. Fork this project on GitHub
+2. git clone https://github.com/<username>/pyatv.git
+3. cd pyatv
+4. ./scripts/setup_dev_env.sh
+```
+
+This will set everything up. To run tests, linting, etc. just run activate the virtual environment and run chickn:
+
+```shell
+$ source bin/activate
+(pyatv)$ ./scripts/chickn.py
+```
+
+### Pull Requests (PR)
+
+When submitting changes, create a PR and make sure:
+
+* You add tests for new functionality and/or bug fixes
+* All tests must pass
+* Do not decrease code coverage
+* Add pydoc documentation and update `docs/`
+* Linting passes (just run chickn)
+
+PRs will not be merged unless all criterias are met. If you are unsure about anything, just push a PR and ask
+for help in the PR itself :smile:
+
+### License
+
+The MIT license is used by pyatv and by contributing, you agree that your content will be covered by that license.

package/pyatv/CONTRIBUTORS.md

@@ -0,0 +1,3 @@
+# Contributors
+
+See [this page](https://pyatv.dev/support/acknowledgements/#contributors)

package/pyatv/Dockerfile

@@ -0,0 +1,15 @@
+FROM python:3.15.0a5-alpine
+ARG VERSION
+
+WORKDIR .
+COPY dist/pyatv-${VERSION}-py3-none-any.whl .
+COPY requirements/requirements.txt .
+
+RUN apk add gcc musl-dev build-base linux-headers libffi-dev rust cargo openssl-dev git && \
+    pip install setuptools-rust && \
+    pip install -r requirements.txt && \
+    pip install pyatv-${VERSION}-py3-none-any.whl && \
+    apk del gcc musl-dev build-base linux-headers libffi-dev rust cargo openssl-dev git && \
+    rm pyatv-${VERSION}-py3-none-any.whl && \
+    rm requirements.txt && \
+    rm -rf /root/.cache /root/.cargo

package/pyatv/LICENSE.md

@@ -0,0 +1,9 @@
+# The MIT License (MIT)
+
+Copyright (c) 2020 Pierre Ståhl
+
+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.

package/pyatv/MANIFEST.in

@@ -0,0 +1,14 @@
+include CHANGES.md
+include README.md
+include LICENSE.md
+include CONTRIBUTORS.md
+include base_versions.txt
+graft pyatv
+graft tests
+graft docs
+graft examples
+global-exclude *~ __pycache__
+recursive-exclude * *.py[co] .*
+prune docs/vendor
+prune docs/_site
+prune docs/.sass-cache

package/pyatv/README.md

@@ -0,0 +1,111 @@
+A client library for Apple TV and AirPlay devices
+=================================================
+
+<img src="https://raw.githubusercontent.com/postlund/pyatv/master/docs/assets/img/logo.svg?raw=true" width="150">
+
+![Tests](https://github.com/postlund/pyatv/workflows/Tests/badge.svg)
+![pyatv Actions](https://api.meercode.io/badge/postlund/pyatv?type=ci-success-rate&branch=master&lastDay=30)
+[![codecov](https://codecov.io/gh/postlund/pyatv/branch/master/graph/badge.svg)](https://codecov.io/gh/postlund/pyatv)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![PyPi Package](https://badge.fury.io/py/pyatv.svg)](https://badge.fury.io/py/pyatv)
+[![Gitpod Ready-to-Code](https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/postlund/pyatv)
+[![Downloads](https://static.pepy.tech/badge/pyatv)](https://pepy.tech/project/pyatv)
+[![PyPI pyversions](https://img.shields.io/pypi/pyversions/pyatv.svg)](https://pypi.python.org/pypi/pyatv/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+This is an asyncio python library for interacting with Apple TV and AirPlay devices. It mainly
+targets Apple TVs (all generations, **including tvOS 15 and later**), but also supports audio streaming via AirPlay
+to receivers like the HomePod, AirPort Express and third-party speakers. It can act as remote control to the Music
+app/iTunes in macOS.
+
+All the documentation you need is available at **[pyatv.dev](https://pyatv.dev)**.
+
+# What can it do?
+
+Some examples include:
+
+* Remote control commands
+* Metadata retrieval with push updates
+* Stream files via AirPlay
+* List and launch installed apps
+* List and switch user accounts
+* Add, remove or set audio output devices (e.g. HomePods)
+* Keyboard support
+* Persistent storage of credentials and settings
+
+...and lots more! A complete list is available [here](https://pyatv.dev/documentation/supported_features/).
+
+# Great, but how do I use it?
+
+All documentation (especially for developers) are available at [pyatv.dev](https://pyatv.dev).
+It is however possible to install with `pip` and set up a new device `atvremote`:
+
+```raw
+$ pip install pyatv
+$ atvremote wizard
+Looking for devices...
+Found the following devices:
+    Name                      Model                    Address
+--  ------------------------  -----------------------  -----------
+ 1  Receiver+                 airupnp                  10.0.10.200
+ 2  Receiver                  RX-V773                  10.0.10.82
+ 3  Pierre's AirPort Express  AirPort Express (gen 2)  10.0.10.168
+ 4  FakeATV                   Unknown                  10.0.10.254
+ 5  Vardagsrum                Apple TV 4K              10.0.10.81
+ 6  Apple TV                  Apple TV 3               10.0.10.83
+Enter index of device to set up (q to quit): 4
+Starting to set up FakeATV
+Starting to pair Protocol.MRP
+Enter PIN on screen: 1111
+Successfully paired Protocol.MRP, moving on...
+Pairing finished, trying to connect and get some metadata...
+Currently playing:
+  Media type: Music
+Device state: Playing
+       Title: Never Gonna Give You Up
+      Artist: Rick Astley
+    Position: 1/213s (0.0%)
+      Repeat: Off
+     Shuffle: Off
+Device is now set up!
+```
+
+After setting up a new device, other commands can be run directly:
+
+```raw
+$ atvremote -s 10.0.10.254 playing
+  Media type: Music
+Device state: Playing
+       Title: Never Gonna Give You Up
+      Artist: Rick Astley
+    Position: 1/213s (0.0%)
+      Repeat: Off
+     Shuffle: Off
+$ atvremote -s 10.0.10.254 pause
+$ atvremote -n FakeATV play
+```
+
+You can also run it inside a container (x86_64, aarch64, armv7):
+
+```raw
+docker run -it --rm --network=host ghcr.io/postlund/pyatv:0.14.0 atvremote scan
+```
+
+The `master` tag points to latest commit on the `master` branch and `latest`
+points to the latest release.
+
+# I need to change something?
+
+Want to help out with `pyatv`? Press the button below to get a fully prepared development environment and get started right away!
+
+[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/postlund/pyatv)
+
+# Shortcuts to the good stuff
+
+To save you some time, here are some shortcuts:
+
+* [Getting started](https://pyatv.dev/documentation/getting-started/)
+* [Documentation](https://pyatv.dev/documentation)
+* [Development](https://pyatv.dev/development)
+* [API Reference](https://pyatv.dev/api)
+* [Support](https://pyatv.dev/support)

package/pyatv/base_versions.txt

@@ -0,0 +1,13 @@
+aiohttp==3.8.3,<5
+async-timeout==4.0.2;python_version<'3.11'
+cryptography==44.0.1
+chacha20poly1305-reuseable==0.13.2
+ifaddr==0.1.7
+miniaudio==1.45
+protobuf==6.31.1
+pydantic==2.0.0
+requests==2.30.0
+srptools==0.2.0
+tabulate==0.9.0
+tinytag==1.10.0
+zeroconf==0.129.0

package/pyatv/chickn.yaml

@@ -0,0 +1,75 @@
+variables:
+  code_dirs:
+    - pyatv
+    - tests
+    - examples
+    - scripts
+  pydirs:
+    - pyatv
+    - scripts
+    - examples
+  cs_exclude_words: infoms,cann,cant,asai,cafs,assertIn
+  requirements_file: requirements/requirements.txt
+  miniaudio_package: $(grep miniaudio= requirements/requirements.txt)
+
+dependencies:
+  files:
+    - "{requirements_file}"
+    - requirements/requirements_docs.txt
+    - requirements/requirements_test.txt
+
+pipeline:
+  pre:
+    - name: clean
+      run: coverage erase
+    - name: fixup
+      tags: [all, fixup]
+      run:
+        - black .
+        - isort {code_dirs}
+        - python scripts/api.py generate
+        - python scripts/protobuf.py --download generate
+  rebuild_miniaudio:
+    # A lot of builds on GitHub Actions result in "Illegal Instruction"
+    # when calling functions in miniaudio. Seemingly random and not
+    # always. Likely has to do with some instruction set mismatch, but
+    # not sure. Rebuilding miniaudio seems to improve the situation,
+    # so this optional step is used by the tests workflow to do that.
+    - name: miniaudio
+      tags: [all, miniaudio]
+      run:
+        - "pip uninstall -y miniaudio"
+        - "pip install --no-binary :all: {miniaudio_package}"
+  validate:
+    - name: pylint
+      run: pylint -j 0 {pydirs}
+    - name: api
+      run: python scripts/api.py verify
+      tags: [all, py3.8, api]
+    - name: protobuf
+      run: python scripts/protobuf.py --download verify
+    - name: flake8
+      run: flake8 --exclude=pyatv/protocols/mrp/protobuf {pydirs}
+    - name: black
+      run: black --fast --check .
+    - name: pydocstyle
+      run: pydocstyle -v --match='(?!test_).*[^pb2]\.py' {pydirs}
+    - name: isort
+      run: isort -c --diff {code_dirs}
+    - name: cs_docs
+      run: codespell -q 6 -L {cs_exclude_words} -S "lib,vendor,_site,api,assets,*~,.sass-cache,*.lock" docs
+    - name: cs_code
+      run: codespell -q 4 -L {cs_exclude_words} --skip="*.pyc,*.pyi,*~,tests/data" {pydirs} tests
+    - name: typing
+      run: mypy --python-executable "{python_executable}" --ignore-missing-imports --follow-imports=skip pyatv
+    - name: pytest
+      run: pytest -n auto --log-level=debug -q -d --timeout=30 --durations=10 --cov --cov-report=term-missing --cov-report=xml tests
+  post:
+    - name: report
+      run:
+        - coverage report
+        - coverage html
+  package:
+    - name: dist
+      run: python setup.py sdist bdist_wheel
+      tags: [all, package]

package/pyatv/docs/404.html

@@ -0,0 +1,24 @@
+---
+layout: template
+---
+
+<style type="text/css" media="screen">
+  .container {
+    margin: 10px auto;
+    max-width: 600px;
+    text-align: center;
+  }
+  h1 {
+    margin: 30px 0;
+    font-size: 4em;
+    line-height: 1;
+    letter-spacing: -1px;
+  }
+</style>
+
+<div class="container">
+  <h1>404</h1>
+
+  <p><strong>Page not found :(</strong></p>
+  <p>The requested page could not be found.</p>
+</div>

package/pyatv/docs/CNAME

@@ -0,0 +1 @@
+pyatv.dev

package/pyatv/docs/Gemfile

@@ -0,0 +1,31 @@
+source "https://rubygems.org"
+
+# Hello! This is where you manage which Jekyll version is used to run.
+# When you want to use a different version, change it below, save the
+# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
+#
+#     bundle exec jekyll serve
+#
+# This will help ensure the proper Jekyll version is running.
+# Happy Jekylling!
+
+# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
+# uncomment the line below. To upgrade, run `bundle update github-pages`.
+gem "github-pages", group: :jekyll_plugins
+
+# If you have any plugins, put them here!
+group :jekyll_plugins do
+  gem "jekyll-feed", "~> 0.6"
+  gem "jemoji"
+end
+
+# Windows does not include zoneinfo files, so bundle the tzinfo-data gem
+# and associated library.
+install_if -> { RUBY_PLATFORM =~ %r!mingw|mswin|java! } do
+  gem "tzinfo", "~> 1.2"
+  gem "tzinfo-data"
+end
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "~> 0.1.0", :install_if => Gem.win_platform?
+

package/pyatv/docs/_config.yml

@@ -0,0 +1,121 @@
+title: pyatv
+email: pierre.staahl@gmail.com
+description: >- # this means to ignore newlines until "baseurl:"
+  a client library for Apple TV and AirPlay devices
+url: "https://pyatv.dev"
+baseurl: /
+twitter_username: postlund
+github_username:  postlund
+
+markdown: kramdown
+kramdown:
+  parse_block_html: true
+  parse_span_html: true
+  html_to_native: true
+theme: jekyll-theme-cayman
+plugins:
+  - jekyll-feed
+  - jemoji
+
+pyatv_version: "pyatv"
+
+top_pages:
+  - link: /
+    title: Main Page
+  - link: /documentation/
+    title: Documentation
+  - link: /development/
+    title: Development
+  - link: /api/
+    title: API Reference
+  - link: /internals/
+    title: Internals
+  - link: /support/
+    title: Support
+
+page_links:
+  documentation:
+    - link: /documentation/
+      title: Start
+    - link: /documentation/getting-started/
+      title: Getting Started
+    - link: /documentation/tutorial/
+      title: Tutorial
+    - link: /documentation/supported_features/
+      title: Supported Features
+    - link: /documentation/concepts/
+      title: Concepts
+    - link: /documentation/protocols/
+      title: Protocols
+    - link: /documentation/atvremote/
+      title: atvremote
+    - link: /documentation/atvproxy/
+      title: atvproxy
+    - link: /documentation/atvscript/
+      title: atvscript
+    - link: /documentation/atvlog/
+      title: atvlog
+  development:
+    - link: /development/
+      title: Start
+    - link: /development/scan_pair_and_connect/
+      title: Scan, Pair and Connect
+    - link: /development/device_info/
+      title: Device Information
+    - link: /development/control/
+      title: Control
+    - link: /development/power_management/
+      title: Power Management
+    - link: /development/features/
+      title: Features
+    - link: /development/metadata/
+      title: Metadata
+    - link: /development/listeners/
+      title: Listeners
+    - link: /development/stream/
+      title: Stream
+    - link: /development/storage/
+      title: Storage
+    - link: /development/apps/
+      title: Apps
+    - link: /development/audio/
+      title: Audio
+    - link: /development/keyboard/
+      title: Keyboard
+    - link: /development/logging/
+      title: Logging
+    - link: /development/examples/
+      title: Examples
+  internals:
+    - link: /internals/
+      title: Start
+    - link: /internals/design
+      title: Design
+    - link: /internals/interfaces
+      title: Interfaces
+    - link: /internals/testing
+      title: Testing
+    - link: /internals/documentation
+      title: Documentation
+    - link: /internals/submit-pr
+      title: Submit a PR
+    - link: /internals/tools
+      title: Tools
+  support:
+    - link: /support/
+      title: Start
+    - link: /support/migration/
+      title: Migration
+    - link: /support/scanning_issues/
+      title: Scanning Issues
+    - link: /support/troubleshooting/
+      title: Troubleshooting
+    - link: /support/faq/
+      title: FAQ
+    - link: /support/acknowledgements/
+      title: Acknowledgements
+
+exclude:
+  - Gemfile
+  - Gemfile.lock
+  - vendor/

package/pyatv/docs/_includes/api

@@ -0,0 +1,10 @@
+{%- assign module = include.i | split: "." | first -%}
+{%- if module == "pyatv" -%}
+  {%- assign module = "" -%}
+  {%- assign path = "#" | append: include.i | replace: "/", "." -%}
+{%- else -%}
+  {%- assign path = "#pyatv." | append: include.i | replace: "/", "." -%}
+{%- endif -%}
+{%- assign url = '/api/' | append: module | append: path | relative_url -%}
+{%- assign path = include.i | replace: "/", "." -%}
+{{ '<a href="URL">PATH</a>' | replace: "URL", url | replace: "PATH", path }}

package/pyatv/docs/_includes/atvremote_scan

@@ -0,0 +1,32 @@
+```raw
+$ atvremote acan
+Scan Results
+========================================
+       Name: Living Room
+   Model/SW: Apple TV 4K, tvOS 16.6 build 20M73
+    Address: 10.0.0.5
+        MAC: AA:BB:CC:DD:EE:FF
+ Deep Sleep: True
+Identifiers:
+ - 01234567-89AB-CDEF-0123-4567890ABCDE
+ - AA:BB:CC:DD:EE:FF
+ - 01234567-89AB-CDEF-0123-AAAAAAAAAAAA
+ - AABBCCDDEEFF
+Services:
+ - Protocol: Companion, Port: 49153, Credentials:None, Requires Password: False, Password: None, Pairing: Mandatory
+ - Protocol: AirPlay, Port: 7000, Credentials: None, Requires Password: False, Password: None, Pairing: Mandatory
+ - Protocol: MRP, Port: 49154, Credentials: None, Requires Password: False, Password: None, Pairing: NotNeeded (Disabled)
+ - Protocol: RAOP, Port: 7000, Credentials: None, Requires Password: False, Password: None, Pairing: Mandatory
+
+       Name: Pierre's AirPort Express
+   Model/SW: AirPort Express (gen 2), AirPortOS 7.8.1
+    Address: 10.0.0.6
+        MAC: BB:BB:BB:BB:BB:BB
+ Deep Sleep: False
+Identifiers:
+ - BB:BB:BB:BB:BB:BB
+ - BBBBBBBBBBBB
+Services:
+ - Protocol: AirPlay, Port: 7000, Credentials: None, Requires Password: False, Password: None, Pairing: NotNeeded
+ - Protocol: RAOP, Port: 7000, Credentials: None, Requires Password: False, Password: None, Pairing: NotNeeded
+```

package/pyatv/docs/_includes/code

@@ -0,0 +1,6 @@
+{%- assign file = include.file -%}
+{%- assign name = file | replace: "_", "\_" | replace: "../", "" -%}
+{%- capture link -%}
+  <a href="https://github.com/postlund/pyatv/tree/master/pyatv/{{ file }}">{{ name }}</a>
+{%- endcapture -%}
+{{ link }}

package/pyatv/docs/_includes/issue

@@ -0,0 +1,14 @@
+{%- assign numbers = include.no | split: "," -%}
+{%- assign output = Nil -%}
+{%- for number in numbers -%}
+  {%- capture link -%}
+    <a href="https://github.com/postlund/pyatv/issues/{{ number }}">#{{ number }}</a>
+  {%- endcapture -%}
+
+  {%- if output == Nil -%}
+    {%- assign output = link -%}
+  {%- else -%}
+    {%- assign output = output | append: ", " | append: link -%}
+  {%- endif -%}
+{%- endfor -%}
+[{{ output }}]

package/pyatv/docs/_includes/pypi

@@ -0,0 +1,5 @@
+{%- assign package = include.package -%}
+{%- capture link -%}
+  <a href="https://pypi.org/project/{{ package }}">{{ package }}</a>
+{%- endcapture -%}
+{{ link }}