https://github.com/selamy-labs/python-repo-template

Selamy Labs Python repository template — starts at the OSS-excellence bar (LICENSE, reusable CI, src layout, passing tests)
https://github.com/selamy-labs/python-repo-template

oss-template python repository-template reusable-ci testing

Last synced: 12 days ago
JSON representation

Selamy Labs Python repository template — starts at the OSS-excellence bar (LICENSE, reusable CI, src layout, passing tests)

• Host: GitHub
• URL: https://github.com/selamy-labs/python-repo-template
• Owner: selamy-labs
• License: mit
• Created: 2026-06-18T01:20:30.000Z (17 days ago)
• Default Branch: main
• Last Pushed: 2026-06-18T14:33:58.000Z (17 days ago)
• Last Synced: 2026-06-18T16:25:02.807Z (17 days ago)
• Topics: oss-template, python, repository-template, reusable-ci, testing
• Language: Python
• Homepage: https://selamy.dev
• Size: 3.91 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# example-pkg

[![Test](https://github.com/selamy-labs/example-pkg/actions/workflows/test.yml/badge.svg)](https://github.com/selamy-labs/example-pkg/actions/workflows/test.yml)

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)

> Selamy Labs Python repository template. Create a repo from this template,

> then rename `example_pkg` everywhere and replace the placeholder logic. It

> starts at the OSS-excellence bar by construction: LICENSE, the shared reusable

> CI (lint + tests + coverage), a `src/` layout, and tests that already pass.

## Use this template

1. Click **Use this template** → create your repo.

2. Rename the package: `src/example_pkg/` → `src//`, and update

   `name`, `[tool.hatch.build.targets.wheel] packages`, and

   `[tool.coverage.run] source` in `pyproject.toml`.

3. Replace `core.py` + its tests with your real code, keeping coverage ≥ 90%.

4. Fill in this README (what/why/install/usage), set the repo description + topics,

   and keep [`CHANGELOG.md`](./CHANGELOG.md) current for every release.

## Install

```bash

pip install -e ".[test]"        # local dev

# or, for an MCP/CLI entry point, expose it under [project.scripts]

```

## Usage

```python

from example_pkg import greet

greet("world")  # "Hello, world!"

```

## Develop

```bash

ruff format . && ruff check .

coverage run -m pytest && coverage report --fail-under=90

```

CI runs the same steps via the shared reusable workflow

(`selamy-labs/.github` → `python-ci.yml`), so the repo's check is defined once,

org-wide.

## Standards

This repo meets the [public-repo bar](https://github.com/selamy-labs/.github):

LICENSE, CHANGELOG, reusable CI with a coverage floor, `src/` layout, and the

org-wide community-health defaults. Keep them.