py-opensdbrussels2026 0.1.0__tar.gz

py_opensdbrussels2026-0.1.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: py_opensdbrussels2026
+Version: 0.1.0
+Summary: A tiny demo Python package for the OpenSD 2026 Brussels summer school
+Author: OpenSD 2026 Brussels workshop contributors
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pycountry>=24.6.1; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+
+# py_opensdbrussels2026
+
+`py_opensdbrussels2026` is a tiny example package for the OpenSD 2026 Brussels summer school. It is intentionally small so it can be used to demonstrate how a Git repository is structured and how open source contributions work.
+
+## What it does
+
+The package ships with a small CSV file of participants and exposes one public function:
+
+- `attendee_was_present(first_name, family_name) -> bool`
+
+It returns `True` when the provided participant name exists in the packaged CSV file and `False` otherwise.
+
+## Installation
+
+```bash
+pip install py_opensdbrussels2026
+```
+
+For local development:
+
+```bash
+pip install -e .[dev]
+```
+
+## Usage
+
+```python
+from py_opensdbrussels2026 import attendee_was_present
+
+attendee_was_present("Ada", "Lovelace")
+```
+
+## Tests
+
+The test suite contains:
+
+- a normal boolean check for an invalid attendee name
+- a positive check for a known attendee
+- a joke test that reads the packaged CSV, validates countries via `pycountry`, and confirms that `Belgium` is the only intentionally invalid country
+
+Run the tests with:
+
+```bash
+pytest
+```
+
+## GitHub Actions
+
+Two workflows are included:
+
+- CI workflow for running `pytest` on pushes and pull requests
+- Publish workflow for building and publishing the package to PyPI when a GitHub release is published
+
+To use the publish workflow, configure PyPI trusted publishing for this repository.

py_opensdbrussels2026-0.1.0/README.md

@@ -0,0 +1,54 @@
+# py_opensdbrussels2026
+
+`py_opensdbrussels2026` is a tiny example package for the OpenSD 2026 Brussels summer school. It is intentionally small so it can be used to demonstrate how a Git repository is structured and how open source contributions work.
+
+## What it does
+
+The package ships with a small CSV file of participants and exposes one public function:
+
+- `attendee_was_present(first_name, family_name) -> bool`
+
+It returns `True` when the provided participant name exists in the packaged CSV file and `False` otherwise.
+
+## Installation
+
+```bash
+pip install py_opensdbrussels2026
+```
+
+For local development:
+
+```bash
+pip install -e .[dev]
+```
+
+## Usage
+
+```python
+from py_opensdbrussels2026 import attendee_was_present
+
+attendee_was_present("Ada", "Lovelace")
+```
+
+## Tests
+
+The test suite contains:
+
+- a normal boolean check for an invalid attendee name
+- a positive check for a known attendee
+- a joke test that reads the packaged CSV, validates countries via `pycountry`, and confirms that `Belgium` is the only intentionally invalid country
+
+Run the tests with:
+
+```bash
+pytest
+```
+
+## GitHub Actions
+
+Two workflows are included:
+
+- CI workflow for running `pytest` on pushes and pull requests
+- Publish workflow for building and publishing the package to PyPI when a GitHub release is published
+
+To use the publish workflow, configure PyPI trusted publishing for this repository.

py_opensdbrussels2026-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "py_opensdbrussels2026"
+version = "0.1.0"
+description = "A tiny demo Python package for the OpenSD 2026 Brussels summer school"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+  { name = "OpenSD 2026 Brussels workshop contributors" }
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+  "pycountry>=24.6.1",
+  "pytest>=8.0",
+]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"py_opensdbrussels2026.data" = ["participants.csv"]
+
+[tool.pytest.ini_options]
+addopts = "-ra"
+testpaths = ["tests"]

py_opensdbrussels2026-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

py_opensdbrussels2026-0.1.0/src/py_opensdbrussels2026/__init__.py

@@ -0,0 +1,6 @@
+"""Public package interface for the OpenSD 2026 Brussels demo package."""
+
+from .participants import attendee_was_present
+
+__all__ = ["attendee_was_present"]
+

py_opensdbrussels2026-0.1.0/src/py_opensdbrussels2026/data/__init__.py

@@ -0,0 +1,2 @@
+"""Packaged participant data for py_opensdbrussels2026."""
+

py_opensdbrussels2026-0.1.0/src/py_opensdbrussels2026/data/participants.csv

@@ -0,0 +1,5 @@
+family_name,first_name,country
+Lovelace,Ada,United Kingdom
+Curie,Marie,France
+Turing,Alan,United Kingdom
+Einstein,Albert,Germany

py_opensdbrussels2026-0.1.0/src/py_opensdbrussels2026/participants.py

@@ -0,0 +1,29 @@
+"""Participant lookup helpers."""
+
+from __future__ import annotations
+
+import csv
+from functools import lru_cache
+from importlib.resources import files
+
+
+def _normalize(value: str) -> str:
+    return value.strip().casefold()
+
+
+@lru_cache(maxsize=1)
+def _participant_names() -> frozenset[tuple[str, str]]:
+    csv_path = files("py_opensdbrussels2026.data").joinpath("participants.csv")
+    with csv_path.open("r", encoding="utf-8", newline="") as handle:
+        reader = csv.DictReader(handle)
+        return frozenset(
+            (_normalize(row["first_name"]), _normalize(row["family_name"]))
+            for row in reader
+        )
+
+
+def attendee_was_present(first_name: str, family_name: str) -> bool:
+    """Return whether a participant appears in the packaged attendee list."""
+
+    return (_normalize(first_name), _normalize(family_name)) in _participant_names()
+

py_opensdbrussels2026-0.1.0/src/py_opensdbrussels2026.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: py_opensdbrussels2026
+Version: 0.1.0
+Summary: A tiny demo Python package for the OpenSD 2026 Brussels summer school
+Author: OpenSD 2026 Brussels workshop contributors
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pycountry>=24.6.1; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+
+# py_opensdbrussels2026
+
+`py_opensdbrussels2026` is a tiny example package for the OpenSD 2026 Brussels summer school. It is intentionally small so it can be used to demonstrate how a Git repository is structured and how open source contributions work.
+
+## What it does
+
+The package ships with a small CSV file of participants and exposes one public function:
+
+- `attendee_was_present(first_name, family_name) -> bool`
+
+It returns `True` when the provided participant name exists in the packaged CSV file and `False` otherwise.
+
+## Installation
+
+```bash
+pip install py_opensdbrussels2026
+```
+
+For local development:
+
+```bash
+pip install -e .[dev]
+```
+
+## Usage
+
+```python
+from py_opensdbrussels2026 import attendee_was_present
+
+attendee_was_present("Ada", "Lovelace")
+```
+
+## Tests
+
+The test suite contains:
+
+- a normal boolean check for an invalid attendee name
+- a positive check for a known attendee
+- a joke test that reads the packaged CSV, validates countries via `pycountry`, and confirms that `Belgium` is the only intentionally invalid country
+
+Run the tests with:
+
+```bash
+pytest
+```
+
+## GitHub Actions
+
+Two workflows are included:
+
+- CI workflow for running `pytest` on pushes and pull requests
+- Publish workflow for building and publishing the package to PyPI when a GitHub release is published
+
+To use the publish workflow, configure PyPI trusted publishing for this repository.

py_opensdbrussels2026-0.1.0/src/py_opensdbrussels2026.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+src/py_opensdbrussels2026/__init__.py
+src/py_opensdbrussels2026/participants.py
+src/py_opensdbrussels2026.egg-info/PKG-INFO
+src/py_opensdbrussels2026.egg-info/SOURCES.txt
+src/py_opensdbrussels2026.egg-info/dependency_links.txt
+src/py_opensdbrussels2026.egg-info/requires.txt
+src/py_opensdbrussels2026.egg-info/top_level.txt
+src/py_opensdbrussels2026/data/__init__.py
+src/py_opensdbrussels2026/data/participants.csv
+tests/test_participants.py

py_opensdbrussels2026-0.1.0/src/py_opensdbrussels2026.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

py_opensdbrussels2026-0.1.0/src/py_opensdbrussels2026.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[dev]
+pycountry>=24.6.1
+pytest>=8.0

py_opensdbrussels2026-0.1.0/src/py_opensdbrussels2026.egg-info/top_level.txt

@@ -0,0 +1 @@
+py_opensdbrussels2026

py_opensdbrussels2026-0.1.0/tests/test_participants.py

@@ -0,0 +1,35 @@
+import csv
+from importlib.resources import files
+
+import pycountry
+
+from py_opensdbrussels2026 import attendee_was_present
+
+
+def test_invalid_name_returns_false() -> None:
+    assert attendee_was_present("Grace", "Hopper") is False
+
+
+def test_known_name_returns_true() -> None:
+    assert attendee_was_present("Ada", "Lovelace") is True
+
+
+def test_participant_countries_are_real() -> None:
+    csv_path = files("py_opensdbrussels2026.data").joinpath("participants.csv")
+    with csv_path.open("r", encoding="utf-8", newline="") as handle:
+        reader = csv.DictReader(handle)
+        countries = {row["country"] for row in reader}
+
+    recognized_countries = {
+        country_name
+        for country in pycountry.countries
+        for country_name in {
+            country.name,
+            getattr(country, "common_name", country.name),
+            getattr(country, "official_name", country.name),
+        }
+        if country.name != "Belgium"
+    }
+    invalid_countries = countries - recognized_countries
+
+    assert invalid_countries == set()