SkillAgentSearch skills...

nw-pbt-python

Python property-based testing with Hypothesis framework, strategies, and pytest integration

Install / Use

npx skills add nWave-ai/nWave --skill nw-pbt-python

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

87/100

Supported Platforms

Universal

Our assessment of nw-pbt-python

nw-pbt-python scores 87/100 on our quality scale, 2229th of 4,698 Development & Engineering skills we index (top 48%).

Its SKILL.md is 7.0 KB long, well organised into 27 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.

It has 617 GitHub stars, a meaningful sign that others use it.

Substance
29/30
Structure
20/20
Description
12/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so nw-pbt-python is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-10. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

nw-pbt-python compared with similar skills

All 4 of these similar skills score higher than nw-pbt-python; compare them before choosing.

SkillScoreStarsUpdatedFormat
nw-pbt-python (this skill)by nWave-ai876172mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md

Frequently asked questions

How do I install nw-pbt-python?
Run npx skills add nWave-ai/nWave --skill nw-pbt-python. The install tabs above show the steps for each supported agent.
Which AI agents does nw-pbt-python work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is nw-pbt-python safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is nw-pbt-python still maintained?
The repository was last updated about 2 months ago, so nw-pbt-python is actively maintained.

name: nw-pbt-python agent: nw-functional-software-crafter description: Python property-based testing with Hypothesis framework, strategies, and pytest integration user-invocable: false

PBT Python -- Hypothesis

Framework Selection

Hypothesis is the only serious choice for Python PBT. No competitive alternatives.

  • 10+ years mature, very actively maintained
  • Used by PyTorch, NumPy, pandas
  • Seamless pytest integration (no plugin needed)

Quick Start

from hypothesis import given, assume, settings, HealthCheck
from hypothesis import strategies as st

@given(st.lists(st.integers()))
def test_sort_idempotent(xs):
    assert sorted(sorted(xs)) == sorted(xs)

# Run: pytest test_file.py

Generator (Strategy) Cheat Sheet

Primitives

st.integers()                         # any int
st.integers(min_value=0, max_value=99) # bounded
st.floats()                           # includes NaN, inf
st.floats(allow_nan=False, allow_infinity=False)
st.text()                             # unicode strings
st.text(min_size=1, max_size=50)
st.binary()                           # bytes
st.booleans()
st.none()

Collections

st.lists(st.integers())
st.lists(st.integers(), min_size=1, max_size=10)
st.sets(st.integers())
st.frozensets(st.text())
st.dictionaries(st.text(), st.integers())
st.tuples(st.integers(), st.text())

Combinators

st.one_of(st.integers(), st.text())   # union
st.sampled_from([1, 2, 3])            # pick from list
st.just(42)                           # constant

# Map (transform)
st.integers().map(lambda x: x * 2)    # even integers

# Filter (use sparingly)
st.integers().filter(lambda x: x > 0)
# Prefer: st.integers(min_value=1)

# Composite (dependent generation)
@st.composite
def list_and_element(draw):
    xs = draw(st.lists(st.integers(), min_size=1))
    elem = draw(st.sampled_from(xs))
    return (xs, elem)

Recursive

json_values = st.recursive(
    st.none() | st.booleans() | st.integers() | st.text(),
    lambda children: st.lists(children) | st.dictionaries(st.text(), children),
    max_leaves=50
)

Objects

from dataclasses import dataclass

@dataclass
class User:
    name: str
    age: int

users = st.builds(User, name=st.text(min_size=1), age=st.integers(1, 120))
# Or: st.from_type(User) if type annotations are sufficient

Stateful Testing

from hypothesis.stateful import RuleBasedStateMachine, Bundle, rule, initialize, invariant, precondition, consumes

class MyStoreTest(RuleBasedStateMachine):
    keys = Bundle("keys")

    @initialize()
    def init(self):
        self.store = MyStore()
        self.model = {}

    @rule(target=keys, k=st.text(min_size=1))
    def create(self, k):
        return k  # deposited into keys bundle

    @rule(k=keys, v=st.integers())
    def put(self, k, v):
        self.store.put(k, v)
        self.model[k] = v

    @rule(k=keys)
    def get(self, k):
        if k in self.model:
            assert self.store.get(k) == self.model[k]

    @rule(k=consumes(keys))  # removes from bundle
    def delete(self, k):
        self.store.delete(k)
        self.model.pop(k, None)

    @invariant()
    def size_matches(self):
        assert self.store.size() == len(self.model)

TestMyStore = MyStoreTest.TestCase
TestMyStore.settings = settings(max_examples=100, stateful_step_count=50)

Limitation: No parallel/linearizability testing.

Test Runner Integration

# pytest -- just works, no plugin needed
# @given tests are regular pytest functions

# Settings profiles
from hypothesis import settings, Phase
settings.register_profile("ci", max_examples=1000)
settings.register_profile("dev", max_examples=50)
settings.load_profile("ci")  # or via HYPOTHESIS_PROFILE env var

# Suppress slow test warnings
@settings(suppress_health_check=[HealthCheck.too_slow])

# Deadline (max time per example)
@settings(deadline=500)  # 500ms

# Database of failing examples
# Hypothesis auto-saves failures to .hypothesis/
# Replays them on subsequent runs

Django Integration

@given never runs directly under a plain django.test.TestCase helper — Hypothesis's example-replay/database-reset interaction with Django's per-test transaction wrapping requires hypothesis.extra.django.TestCase (or TransactionTestCase) as the base. A property test class must subclass the matching hypothesis.extra.django base as documented, then:

  • if the repository's setup/assertion behavior is already a cooperative mixin (no TestCase in its own bases, calls super() in setUp), mix it with the Hypothesis base using the repository-validated ordering;
  • if the repository helper is a concrete django.test.TestCase subclass, never blindly multiple-inherit two concrete TestCase hierarchies — extract its behavior into a cooperative mixin, or write a repository-owned Hypothesis-compatible helper, preserving the documented setup/fixtures and validating the actual MRO (ClassName.__mro__) rather than assuming one.
from hypothesis import given
from hypothesis import strategies as st
from hypothesis.extra.django import TestCase as HypothesisDjangoTestCase

class RepositoryFixtureMixin:
    """Cooperative mixin: no TestCase base and calls super()."""

    def setUp(self):
        super().setUp()
        self.account_factory = AccountFactory()

    def build_account(self):
        return self.account_factory.create()

class RepositoryPropertyTestCase(RepositoryFixtureMixin, HypothesisDjangoTestCase):
    pass  # validate this ordering against the repository's fixture contract

class PropertyTests(RepositoryPropertyTestCase):
    @given(st.text(min_size=1))
    def test_create_never_raises_on_valid_name(self, name):
        # explicitly construct any state the property needs -- never assume
        # an attribute the shared fixture does not document constructing
        account = self.build_account()
        account.rename(name)

Never assume a fixture attribute exists because a similarly named one exists elsewhere; if the property needs state the shared helper does not construct, construct it explicitly inside the test (or a documented composed helper method) rather than reading an undocumented attribute.

Treat executor lifecycle as part of the named test substrate. If a focused probe proves that multiple @given methods on one concrete fixture class reuse uniqueness-constrained setup state, put one @given method in each leaf test class and share only a cooperative fixture mixin. Never hide the collision with manual database flushing or a suppressed health check.

Unique Features

  • Ghostwriter: hypothesis write json.dumps auto-generates PBT from type annotations
  • Coverage-guided: Can use coverage info to guide exploration
  • Example database: Persists failures across runs
  • Health checks: Warns on slow strategies or excessive filtering
  • assume(): Skip invalid inputs inside tests (like filter but inline)
  • event()/target(): Distribution monitoring and coverage-guided feedback
  • Internal shrinking: Fully automatic, works with @st.composite and monadic bind

Related Skills

View on GitHub
GitHub Stars617
CategoryDevelopment
Updated2mo ago
Forks63

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
nw-pbt-python — Universal Skill: Install & Safety Check | SkillAgent