Claude Development Notes

Project Setup

This project uses a Makefile for most development operations. Use make commands instead of running tools directly.

Common Development Tasks

Testing

Run tests: make test
- This installs development dependencies and runs the test suite with py.test
- Tests are located in make_post_sell/tests/

Installation & Setup

Install from source for development: make install-from-source
Install from PyPI: make install-from-pypi
Initialize database: make init-db

Development Server

Start development server: make serve
- Runs with auto-reload enabled
- Uses data/development.ini configuration

Environment Management

Create virtual environment: make venv
Clean up environment: make clean
Activate environment: source env/bin/activate

Code Structure

Key Directories

make_post_sell/views/ - View controllers
make_post_sell/models/ - Database models
make_post_sell/tests/ - Test suite

Important Files

make_post_sell/views/cart.py - Cart and checkout logic
development.ini - Configuration file

Testing Notes

The project uses pytest with unittest framework. There are three types of tests:

Test Types

Unit tests (test_models.py) - Test individual model methods and properties in isolation
Integration tests (test_integration.py) - Test interactions between models and business logic
Functional tests (test_functional.py) - End-to-end tests through the web interface

Running Tests

Before running tests: Source environment variables with source vars.sh to set required Stripe API keys and other configuration.

# Run all tests
make test

# Run specific test types
env/bin/py.test make_post_sell/tests/test_models.py     # Unit tests
env/bin/py.test make_post_sell/tests/test_integration.py # Integration tests  
env/bin/py.test make_post_sell/tests/test_functional.py  # Functional tests

# Run with coverage
env/bin/py.test --cov=make_post_sell.models.cart --cov-report=term-missing make_post_sell/tests/test_models.py::TestCart

Current Coverage

Cart model unit tests cover critical business logic like requires_payment threshold (64 cents)
Integration tests verify the original AttributeError bug fix for free coupon checkout
Functional tests provide end-to-end coverage of cart/checkout/payment flows

Common Issues and Solutions

UUID Objects

Always use uuid_str when you need a string copy of the identifier. Models inherit uuid_str property from RBase.

Commit Message Guidelines

CRITICAL: Do not include Claude Code attribution in commit messages. Attributing human work to Claude is inappropriate and misrepresents the actual authorship of the code. All code changes should be attributed to the human developer who reviewed, approved, and committed the work.

2.8 KiB Raw Blame History