Skip to main content

proofs

This is a proofs validator to help students and hobbyists do mathematical thinking and problem solving.

It’s for when you buy a math book from the local used book store, so you have a piece of software to use to explore the mathematical concepts alongside you that’s fun and easy to use for anybody with a programming background.

It’s supposed to validate what you’re doing in a “black box” kind of manner, and try to offer you guardrails enough that you can spot your mistakes and feel reasonably more confident you know what you’re doing.

Not perfectly confident, reasonably.

Features:

  • human-readable proofs that run in code. Clear from each line what is being achieved mathematically.
  • Pure python. Duck typing and abstracts allow for quick end-to-end proof designs, only implementing what you need.
  • Relies on python abstractions you know, like the type system for defining input and output types
  • Great, human readable errors so it’s clear where your logic is breaking down, why, how you might fix it.

Principles

  • Minimal abstractions, small API
  • minimal dependencies (just sympy right now)
  • declarative, functional api
  • simple to use
  • batteries included

Install

pip install proofs

How to use

Let’s start with something simple, first, let’s prove that “Given x, Assume x + 1 = x is false for all x”

This should be obvious, which makes is great to show how to approach a proof.

  1. Define the problem
  2. Look at examples
  3. Decide on a proof strategy
  4. Write the proof
# Start by defining your domain
arbitrary_x = variable("x")
expression = arbitrary_x + 2
print(expression)
x + 2
# select a few examples from the reals
make_examples('real', 3, expression)
[(-39, -37), (-13, -11), (7, 9)]

Hopefully these examples convice us that the statement is false. This suggests that we can prove it by contradiction.

# Then define your goal
contradiction_goal = not_equals(expression, arbitrary_x)
@contradiction_proof
def proof_of_x_plus_one(x):
    # Given x, Assume x + 1 = x is true for arbitrary x
    assumed_eq = equals(x + 1, x)

    # Calculate x + 1
    next = x + 1

    # Observing x + 1 != x, we have reached a contradiction
    return not_equals(next, assumed_eq.rhs)

#Select an arbitrary x from the domain
prove(contradiction_goal, proof_of_x_plus_one, arbitrary_x)

$$\mathtt{\text{Given x, Assume x + 1 = x is true for arbitrary x}}$$

$$x + 1 = x$$

$$\mathtt{\text{Calculate x + 1}}$$

$$x + 1$$

$$\mathtt{\text{Observing x + 1 != x, we have reached a contradiction}}$$

Proof failed: Derived result Ne(x + 1, x) does not match goal Ne(x + 2, x)
Check your assumptions and proof function for errors.

False

With this, we get:

  1. Complete latex rendering of the math we are doing in python and our logic
  2. validation that what we are returning from the proof matches the expected goal
  3. some additional helpful errors

Next steps

Likes:

  • simple API

  • structure is about proving things now

  • Like that the goal is to create a prove function that matches the goal given the input you have. I think that’s very straightforward.

Dislikes

  • type system not doing anything. Can we use mypy or isinstance to actually check that the correct type is being returned?

  • no error handling to help detect where the proof is going wrong. should provide better error messages than just AttributeError: 'BooleanFalse' object has no attribute 'lhs' — why is that a booleanFalse object? what else might I want to try? Also needs to be build into library, not user defined all the time

Must haves:

  • Needs to be clearer that the flow is to generate a proof spec, decide on an input, and then generate a proof function to do this. Solve this by providing a function that helps do common problem setups, and prints them as Latex, then outputs something that can be used in the _proof strategy decorators.

Feature requests:

  • I really want simple, composable visualization features. It will be really much more interesting if we can see visually what is happening – see start below https://docs.manim.community/en/stable/examples.html#animations

  • build in a simple type unification feature. see research on [[proofs - inductive types and unification]]

  • better latex printing

nice to haves

  • some common ‘tactics’ mirroring lean; rewrite, reflexivity, etc. Pull from sympy as well
  • integrate hypothesis to show that the

Content:

Metadata

Release files for proofs 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for proofs 0.0.3
File Size Uploaded
proofs-0.0.3.tar.gz 17.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for proofs 0.0.3
File Interpreter ABI Platform
proofs-0.0.3-py3-none-any.whl Python 3 none any Details

Total release size: 31.9 kB

Release files / proofs-0.0.3.tar.gz

Download URL proofs-0.0.3.tar.gz
Size 17.7 kB
Tags Source
SHA-256 checksum
How to use checksums
c03a016756df7643d7a66634fae5531cfa9a57d21deb36d0f2cc53f97e43561b
BLAKE2b-256 checksum
How to use checksums
0ac87a5625546f1c3c23b12ea39fd57b9ecc231509a4f53c8737b2e16dc129da
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.8.13

Release files / proofs-0.0.3-py3-none-any.whl

Download URL proofs-0.0.3-py3-none-any.whl
Size 14.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
688f3d6e43fc8aed1f4737afc7b6b4aa95f11f12c65b480a690432ae3fb922f4
BLAKE2b-256 checksum
How to use checksums
e2b696299ae0c1c49e01ee5c6fedeb6662bbbd58bc162cb59be8e5c3ab12fc60
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.8.13

Release history Release notifications | RSS feed

This release

0.0.3 This release

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page