mtg-card-puller 0.0.1__tar.gz

mtg_card_puller-0.0.1/.dockerignore

@@ -0,0 +1,3 @@
+notebooks/
+data/
+tests/

mtg_card_puller-0.0.1/.gitignore

@@ -0,0 +1,112 @@
+# Template Specific
+data/*
+!data/README.md
+
+# IDE
+.vscode/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# IDE settings
+.vscode/

mtg_card_puller-0.0.1/.pre-commit-config.yaml

@@ -0,0 +1,9 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.7
+    hooks:
+      - id: ruff
+        name: Ruff Check
+      - id: ruff-format
+        name: Ruff Format
+        args: [--check]

mtg_card_puller-0.0.1/LICENSE

@@ -0,0 +1,16 @@
+Apache Software License 2.0
+
+Copyright (c) 2025, Rob Fletcher
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+

mtg_card_puller-0.0.1/Makefile

@@ -0,0 +1,128 @@
+.PHONY: clean clean-test clean-pyc clean-build docs help
+.DEFAULT_GOAL := help
+
+define BROWSER_PYSCRIPT
+import os, webbrowser, sys
+
+from urllib.request import pathname2url
+
+webbrowser.open("file://" + pathname2url(os.path.abspath(sys.argv[1])))
+endef
+export BROWSER_PYSCRIPT
+
+define PRINT_HELP_PYSCRIPT
+import re, sys
+
+for line in sys.stdin:
+	match = re.match(r'^([a-zA-Z_-]+):.*?## (.*)$$', line)
+	if match:
+		target, help = match.groups()
+		print("%-20s %s" % (target, help))
+endef
+export PRINT_HELP_PYSCRIPT
+
+BROWSER := python -c "$$BROWSER_PYSCRIPT"
+
+help:
+	@python -c "$$PRINT_HELP_PYSCRIPT" < $(MAKEFILE_LIST)
+
+clean: clean-build clean-pyc clean-test ## remove all build, test, coverage and Python artifacts
+
+clean-build: ## remove build artifacts
+	rm -fr build/
+	rm -fr dist/
+	rm -fr .eggs/
+	find . -name '*.egg-info' -exec rm -fr {} +
+	find . -name '*.egg' -exec rm -f {} +
+
+clean-pyc: ## remove Python file artifacts
+	find . -name '*.pyc' -exec rm -f {} +
+	find . -name '*.pyo' -exec rm -f {} +
+	find . -name '*~' -exec rm -f {} +
+	find . -name '__pycache__' -exec rm -fr {} +
+
+clean-test: ## remove test and coverage artifacts
+	rm -fr .tox/
+	rm -f .coverage
+	rm -fr htmlcov/
+	rm -fr .pytest_cache
+
+lint: ## check style with flake8
+	flake8 mtg_card_puller tests
+
+test: ## run tests quickly with the default Python
+	pytest
+
+test-all: ## run tests on every Python version with tox
+	tox
+
+coverage: ## check code coverage quickly with the default Python
+	coverage run --source mtg_card_puller -m pytest
+	coverage report -m
+	coverage html
+	$(BROWSER) htmlcov/index.html
+
+docs: ## generate Sphinx HTML documentation, including API docs
+	rm -f docs/mtg_card_puller.rst
+	rm -f docs/modules.rst
+	sphinx-apidoc -o docs/ mtg_card_puller
+	$(MAKE) -C docs clean
+	$(MAKE) -C docs html
+	$(BROWSER) docs/_build/html/index.html
+
+servedocs: docs ## compile the docs watching for changes
+	watchmedo shell-command -p '*.rst' -c '$(MAKE) -C docs html' -R -D .
+
+release: dist ## package and upload a release
+	twine upload dist/*
+
+dist: clean ## builds source and wheel package
+	python setup.py sdist
+	python setup.py bdist_wheel
+	ls -l dist
+
+install: clean ## install the package to the active Python's site-packages
+	python setup.py install
+
+SHELL:=/bin/bash
+model_dir := models/$(model)
+step_dir := models/$(model)/$(step)
+image_name := $(model).$(step):latest
+dockerfile := $(step_dir)/Dockerfile
+
+model-build:
+	@if [ -z "$(model)" ]; then \
+		echo "must specify a 'model' and 'step'"; \
+		exit 1; \
+	fi
+
+	docker build \
+		--progress=plain \
+		--ssh=default \
+		-t $(image_name) \
+		-f $(dockerfile) \
+		$(step_dir)
+
+model-run:
+	@if [ -z "$(model)" ]; then \
+		echo "must specify a 'model' and 'step'"; \
+		exit 1; \
+	fi
+
+	cd $(step_dir) && docker compose up --force-recreate run-local
+
+model-shell:
+	@if [ -z "$(model)" ]; then \
+		echo "must specify a 'model' and 'step'"; \
+		exit 1; \
+	fi
+
+	cd $(step_dir) && docker compose run --entrypoint bash run-local
+
+model-dev:
+	@if [ -z "$(model)" ]; then \
+		echo "must specify a 'model' and 'step'"; \
+		exit 1; \
+	fi
+
+	cd $(step_dir) && docker compose up --force-recreate dev

mtg_card_puller-0.0.1/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: mtg_card_puller
+Version: 0.0.1
+Summary: Pull MTG card images in b
+Project-URL: Homepage, https://github.com/seerai/mtg_card_puller
+Author-email: Rob Fletcher <robroy.fletcher@gmail.com>
+License: Apache Software License 2.0
+        
+        Copyright (c) 2025, Rob Fletcher
+        
+        Licensed under the Apache License, Version 2.0 (the "License");
+        you may not use this file except in compliance with the License.
+        You may obtain a copy of the License at
+        
+        http://www.apache.org/licenses/LICENSE-2.0
+        
+        Unless required by applicable law or agreed to in writing, software
+        distributed under the License is distributed on an "AS IS" BASIS,
+        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+        See the License for the specific language governing permissions and
+        limitations under the License.
+        
+License-File: LICENSE
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.10
+Requires-Dist: click>=7.0
+Requires-Dist: geodesic-api
+Provides-Extra: dev
+Requires-Dist: coverage; extra == 'dev'
+Requires-Dist: jupyterlab; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# mtg_card_puller
+
+Pull MTG card images in b
+
+## Installation
+To setup mtg_card_puller create a conda environment with the generated `environment.yaml`.
+This sets up a development environment with all the required packages. This is what is used when building 
+out the functionality of this project.
+```bash
+conda env create -f environment.yaml
+conda activate mtg_puller
+```
+
+Then install the python module. This installs the module the same way as if someone just wanting 
+to use this package would install it. This is what is used when using this package as a dependency.
+**Note:** This installs the `dev` extra dependencies. When installing this to use as a standalone package,
+you should leave off the `[dev]` part.
+```bash
+python -m pip install .[dev]
+```
+
+If functionality from this repo is needed in another project, you can install this package as a dependency
+directly from the GitHub repo.
+```bash
+python -m pip install git+https://github.com/seerai/mtg_card_puller.git
+```
+
+You can then test that the docker image builds and runs correctly.
+```bash
+docker build -t mtg_card_puller:latest .
+```
+Once the build is complete, test the image:
+```bash
+docker run --rm mtg_card_puller:latest
+```
+You should see a message printed:
+```
+Replace this message by putting your code into mtg_card_puller.cli.main
+See click documentation at https://click.palletsprojects.com/
+```
+
+## Development
+
+### READMEs and Notes
+Every folder in this project other than `mtg_card_puller`` should have a README.md
+file (the template does this automatically for all folders). Each of these READMEs should be kept 
+up to date and should describe the contents of the folder. This is especially important for the
+the data folder and should include all data files, their sources and how to download them. This
+is also a good place to put any notes about the contents of the folder. For example, if you are
+working on a notebook and want to save some notes about what you are doing, you can put them in
+the README for that folder. **You should always be asking yourself** "If someone else were to look at
+this folder, would they know what is going on?". If the answer is no, then you should add more
+information to the README.
+
+### Dependency Management
+When developing on this project, **make sure that you never directly `pip install` any packages**. This
+leads to situations where peoples environemnts are different and the code will not run correctly
+when another person tries to install the package. Instead, always add the dependency to the
+`pyproject.toml` file and reinstall the package. This ensures that all dependencies are tracked and
+others can use this package without issue. When possible, you should also pin a version or version range
+of the dependency. i.e. `numpy==1.19.2` or `numpy>=1.19.2,<1.20.0`.
+
+### Testing
+Any functions implemened in this package should be covered by tests if possible. This doesnt mean that
+every line of code needs to be tested, but that the functionality of the code is tested. Anything 
+that is used only for development purposes can sometimes be excluded from testing. However, any 
+function/class you expect someone to use after installing this as a package should be tested. 
+**You should always be asking yourself** "If someone else were to use this code, would they know that it
+works correctly?". If the answer is no, then you should add tests.
+
+This project uses `pytest` for testing. To run the tests, cd to the root of the project and run:
+```bash
+coverage run -m pytest
+```
+This will run all the tests and generate a coverage report. To view the coverage report, run:
+```bash
+coverage report
+```

mtg_card_puller-0.0.1/README.md

@@ -0,0 +1,78 @@
+# mtg_card_puller
+
+Pull MTG card images in b
+
+## Installation
+To setup mtg_card_puller create a conda environment with the generated `environment.yaml`.
+This sets up a development environment with all the required packages. This is what is used when building 
+out the functionality of this project.
+```bash
+conda env create -f environment.yaml
+conda activate mtg_puller
+```
+
+Then install the python module. This installs the module the same way as if someone just wanting 
+to use this package would install it. This is what is used when using this package as a dependency.
+**Note:** This installs the `dev` extra dependencies. When installing this to use as a standalone package,
+you should leave off the `[dev]` part.
+```bash
+python -m pip install .[dev]
+```
+
+If functionality from this repo is needed in another project, you can install this package as a dependency
+directly from the GitHub repo.
+```bash
+python -m pip install git+https://github.com/seerai/mtg_card_puller.git
+```
+
+You can then test that the docker image builds and runs correctly.
+```bash
+docker build -t mtg_card_puller:latest .
+```
+Once the build is complete, test the image:
+```bash
+docker run --rm mtg_card_puller:latest
+```
+You should see a message printed:
+```
+Replace this message by putting your code into mtg_card_puller.cli.main
+See click documentation at https://click.palletsprojects.com/
+```
+
+## Development
+
+### READMEs and Notes
+Every folder in this project other than `mtg_card_puller`` should have a README.md
+file (the template does this automatically for all folders). Each of these READMEs should be kept 
+up to date and should describe the contents of the folder. This is especially important for the
+the data folder and should include all data files, their sources and how to download them. This
+is also a good place to put any notes about the contents of the folder. For example, if you are
+working on a notebook and want to save some notes about what you are doing, you can put them in
+the README for that folder. **You should always be asking yourself** "If someone else were to look at
+this folder, would they know what is going on?". If the answer is no, then you should add more
+information to the README.
+
+### Dependency Management
+When developing on this project, **make sure that you never directly `pip install` any packages**. This
+leads to situations where peoples environemnts are different and the code will not run correctly
+when another person tries to install the package. Instead, always add the dependency to the
+`pyproject.toml` file and reinstall the package. This ensures that all dependencies are tracked and
+others can use this package without issue. When possible, you should also pin a version or version range
+of the dependency. i.e. `numpy==1.19.2` or `numpy>=1.19.2,<1.20.0`.
+
+### Testing
+Any functions implemened in this package should be covered by tests if possible. This doesnt mean that
+every line of code needs to be tested, but that the functionality of the code is tested. Anything 
+that is used only for development purposes can sometimes be excluded from testing. However, any 
+function/class you expect someone to use after installing this as a package should be tested. 
+**You should always be asking yourself** "If someone else were to use this code, would they know that it
+works correctly?". If the answer is no, then you should add tests.
+
+This project uses `pytest` for testing. To run the tests, cd to the root of the project and run:
+```bash
+coverage run -m pytest
+```
+This will run all the tests and generate a coverage report. To view the coverage report, run:
+```bash
+coverage report
+```

mtg_card_puller-0.0.1/dockerfile

@@ -0,0 +1,17 @@
+FROM python:3.10-slim AS builder
+
+RUN mkdir /install
+WORKDIR /app
+COPY mtg_card_puller/ /app/mtg_card_puller
+COPY pyproject.toml LICENSE README.md /app
+
+RUN python -m pip install . --prefix=/install
+
+FROM python:3.10-slim
+WORKDIR /app
+COPY --from=builder /install /usr/local
+
+ENV PATH="/usr/local/bin:${PATH}"
+ENV PYTHONPATH="${PYTHONPATH}:/usr/local/"
+
+CMD ["mtg_card_puller"]

mtg_card_puller-0.0.1/environment.yaml

@@ -0,0 +1,8 @@
+name: "mtg_puller"
+channels:
+  - defaults
+dependencies:
+  - python=3.10
+  - pip
+variables:
+  DATA_PATH: /home/rob/projects/mtg_card_puller/data

mtg_card_puller-0.0.1/mtg_card_puller/__init__.py

@@ -0,0 +1,5 @@
+"""Top-level package for mtg_card_puller."""
+
+__author__ = """Rob Fletcher"""
+__email__ = 'robroy.fletcher@gmail.com'
+__version__ = '0.0.1'

mtg_card_puller-0.0.1/mtg_card_puller/cli.py

@@ -0,0 +1,23 @@
+"""Console script for mtg_card_puller."""
+
+import sys
+import click
+from mtg_card_puller import mtg_card_puller
+
+CONTEXT_SETTINGS = dict(help_option_names=["-h", "--help"])
+
+@click.command(context_settings=CONTEXT_SETTINGS)
+@click.option(
+    "-v", "--verbose", is_flag=True, help="Enable verbose output for debugging"
+)
+@click.option(
+    "-f", "--file", type=str, required=True, help="Path to the file containing card names"
+)
+def main(verbose, file):
+    """Console script for mtg_card_puller."""
+    mtg_card_puller.main(deck_file=file) 
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())  # pragma: no cover

mtg_card_puller-0.0.1/mtg_card_puller/mtg_card_puller.py

@@ -0,0 +1,100 @@
+"""Main module."""
+
+import re
+import tqdm
+import requests
+import time
+from pathlib import Path
+import logging
+from typing import Tuple
+
+logger = logging.getLogger(__name__)
+
+def extract_card_id(mox_full_name: str) -> Tuple[str, str, int]:
+    """Extracts the card ID from the full name of a card.
+
+    Args:
+        mox_full_name (str): The full name of the card.
+
+    Returns:
+        Tuple[str, str, int]: A tuple containing the card name, card series, and card number.
+    """
+    # Extract the card ID using regex
+    card_name = ""
+    card_series = ""
+    card_number = ""
+    match = re.search(r'\d (.*) \(([A-Z0-9]{3})\) (\d{1,3})', mox_full_name)
+    if match:
+        card_name = match.group(1)
+        card_series = match.group(2)
+        card_number = int(match.group(3))
+
+        logger.debug(f"Extracted card series: {card_series}, card number: {card_number} from full name: {mox_full_name}")
+    else:
+        raise ValueError("Problem matching card ID from full name: " + mox_full_name)
+
+    return card_name, card_series, card_number
+
+def execute_request(card_name: str, card_series: str, card_number: int) -> None:
+    """Executes a request to the MTG API to fetch card details.
+
+    Args:
+        card_name (str): The name of the card.
+        card_series (str): The card series.
+        card_number (int): The card number.
+    """
+    normalized_name = card_name.strip(".'").replace(" ", "_")
+    headers = {'User-Agent': 'mtg_card_puller', 'Accept': '*/*'}
+
+    # Check if the image already exists
+    img_path = Path(f"{normalized_name}.png")
+    if img_path.is_file():
+        logger.info(f"Image for {card_name} already exists, skipping download.")
+        return
+
+    time.sleep(0.1) # Avoid hitting the API too fast
+    r = requests.get(f"https://api.scryfall.com/cards/{card_series}/{card_number}", headers=headers)
+    if r.status_code != 200:
+        logger.error(f"Failed to fetch card details for {card_name} ({card_series} {card_number})")
+        return
+
+    img_url = r.json().get('image_uris', {}).get('png')
+
+    time.sleep(0.1) # Avoid hitting the API too fast
+    r = requests.get(img_url, stream=True, headers=headers)
+    if r.status_code != 200:
+        logger.error(f"Failed to fetch image for {card_name} ({card_series} {card_number})")
+        return
+
+    # Save the image to a file
+    with open(f"{normalized_name}.png", 'wb') as f:
+        for chunk in r.iter_content(1024):
+            f.write(chunk)
+
+
+def main(deck_file: str, verbose: bool = False) -> None:
+    """Main entrypoint for the script
+    
+    Args:
+        deck_file (str): Path to the file containing card names.
+        verbose (bool): Enable verbose output for debugging.
+    """
+    logger.setLevel(logging.DEBUG if verbose else logging.INFO)
+    with open(deck_file, 'r') as f:
+        pbar = tqdm.tqdm(f.readlines(), desc="Processing cards", colour="green", unit="card")
+        for line in pbar:
+            try:
+                card_name, card_series, card_number = extract_card_id(line.strip())
+                pbar.set_description(f"Fetching {card_name[:20]:20}")
+            except ValueError as e:
+                logger.error(e)
+
+            try:
+                execute_request(card_name, card_series, card_number)
+                # time.sleep(1)
+
+            except Exception as e:
+                logger.error(f"Error fetching card details: {e}")
+                continue
+
+

mtg_card_puller-0.0.1/notebooks/scratch.ipynb

@@ -0,0 +1,79 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import requests"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "https://cards.scryfall.io/png/front/2/3/23eb3cf7-c90d-4bfa-b125-4fbcb5614468.png?1710673416\n"
+     ]
+    }
+   ],
+   "source": [
+    "headers = {'User-Agent': 'mtg_card_puller', 'Accept': '*/*'}\n",
+    "r = requests.get(\"https://api.scryfall.com/cards/pip/7\", headers=headers)\n",
+    "if r.status_code == 200:\n",
+    "    img_uri = r.json()['image_uris']['png']\n",
+    "    print(r.json()['image_uris']['png'])\n",
+    "else:\n",
+    "    print(\"Error: \", r.status_code)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "r = requests.get(img_uri, headers=headers, stream=True)\n",
+    "if r.status_code == 200:\n",
+    "    with open('card.png', 'wb') as f:\n",
+    "        for chunk in r.iter_content(1024):\n",
+    "            f.write(chunk)\n",
+    "else:\n",
+    "    print(\"Error: \", r.status_code)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "mtg_puller",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.16"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

mtg_card_puller-0.0.1/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["hatchling>=1.21.0"]
+build-backend = "hatchling.build"
+
+
+
+[project]
+name = "mtg_card_puller"
+description = "Pull MTG card images in b"
+readme = "README.md"
+license.file = "LICENSE"
+authors = [
+    { name = "Rob Fletcher", email = "robroy.fletcher@gmail.com" }
+]
+maintaners = [
+    { name = "Rob Fletcher", email = "robroy.fletcher@gmail.com" }
+]
+requires-python = ">=3.10"
+classifiers=[
+    'Development Status :: 2 - Pre-Alpha',
+    'Intended Audience :: Developers',
+    'License :: OSI Approved :: Apache Software License',
+    'Natural Language :: English',
+    'Programming Language :: Python :: 3',
+    'Programming Language :: Python :: 3.10',
+]
+dependencies = [
+    "click>=7.0",
+    "geodesic-api"
+]
+dynamic = ["version"]
+
+[project.scripts]
+mtg_card_puller = "mtg_card_puller.cli:main"
+
+[project.optional-dependencies]
+dev = [
+    "ruff",
+    "pytest",
+    "coverage",
+    "pre-commit",
+    "jupyterlab",
+]
+
+[project.urls]
+Homepage = "https://github.com/seerai/mtg_card_puller"
+
+[tool.hatch.version]
+path = "mtg_card_puller/__init__.py"
+
+[tool.hatch.build.targets.sdist]
+exclude = [".github", "data/", "docs/"]

mtg_card_puller-0.0.1/scripts/README.md

@@ -0,0 +1,3 @@
+# Scripts
+
+Any scripts that get run as standalone things (not to be imported as packages).

mtg_card_puller-0.0.1/tests/__init__.py

@@ -0,0 +1 @@
+"""Unit test package for mtg_card_puller."""

mtg_card_puller-0.0.1/tests/test_mtg_card_puller.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python
+
+"""Tests for `mtg_card_puller` package."""
+
+from mtg_card_puller import mtg_card_puller
+from mtg_card_puller import cli
+from click.testing import CliRunner
+import pytest
+
+
+@pytest.fixture
+def test_deck_data():
+    """Load sample data
+
+    Load the sample data file in the data folder to test with
+    """
+    with open('tests/data/sample_deck.txt', 'r') as f:
+        yield f 
+
+card_id_cases = [
+    ("1 Mr. House, President and CEO (PIP) 7 *F*", "PIP", 7),
+    ("1 Arcane Signet (M3C) 283", "M3C", 283),
+    ("1 Arid Mesa (MH2) 244", "MH2", 244),
+    ("1 Attempted Murder (UNF) 66 *F*", "UNF", 66),
+    ("1 Automated Artificer (NEO) 239 *F*", "NEO", 239),
+    ("1 Bag of Devouring (AFC) 21", "AFC", 21),
+    ("1 Barbarian Class (AFR) 131", "AFR", 131),
+    ("1 Battlefield Forge (C21) 278", "C21", 278),
+    ("1 Bennie Bracks, Zoologist (NCC) 86", "NCC", 86),
+    ("1 Berserker's Frenzy (AFC) 29", "AFC", 29),
+    ("1 Big Score (SNC) 102 *F*", "SNC", 102),
+    ("1 Blood Crypt (RNA) 245", "RNA", 245),
+    ("1 Bloodstained Mire (KTK) 230", "KTK", 230),
+    ("1 Boros Signet (SLD) 291 *E*", "SLD", 291),
+    ("1 Brazen Dwarf (AFR) 134", "AFR", 134),
+]
+
+def test_command_line_interface():
+    """Test the CLI."""
+    runner = CliRunner()
+    result = runner.invoke(cli.main)
+    assert result.exit_code == 2
+    assert "Missing option '-f'" in result.output
+    help_result = runner.invoke(cli.main, ['--help'])
+    assert help_result.exit_code == 0
+    assert 'Console script for mtg_card_puller' in help_result.output
+
+@pytest.mark.parametrize("card_line, expected_series, expected_number", card_id_cases)
+def test_extract_card_id(card_line, expected_series, expected_number):
+    assert mtg_card_puller.extract_card_id(card_line)[1:] == (expected_series, expected_number)
+