Welcome to PyPy’s documentation! — PyPy documentation (original) (raw)

• What is PyPy?
• Goals and Architecture Overview
• Downloading and Installing PyPy
• Building PyPy from Source
• Translating on Windows
• Frequently Asked Questions
• Differences between PyPy and CPython
• Writing extension modules for pypy
• Garbage collector documentation and configuration
• JIT hooks
• Resetting the JIT
• Application-level Stackless features
• The __pypy__ module
• PyPy’s sandboxing features
• Software Transactional Memory
• Contributing Guidelines
• PyPy’s Configuration Handling
• Potential Project List
• Project Documentation
• Source Code Documentation
• PyPy’s Release Process
• Historical release notes
• Changelogs
• Contributors
• Glossary

PyPy

• Welcome to PyPy’s documentation!
• View page source

Welcome to the documentation for PyPy, a fast, compliant alternative implementation of the Python language.

• If you want to find out more about what PyPy is, have a look at our What is PyPy?or consult the PyPy website.
• If you’re interested in trying PyPy out, check out the installation instructions.
• If you want to help develop PyPy, please have a look at contributing and at the repo on https://github.com/pypy/pypyand get in touch (Contact)!

All of the documentation and source code is available under the MIT license, unless otherwise specified. Consult LICENSE.

Using PyPy¶

• Differences between PyPy and CPython
  • Differences related to garbage collection strategies
  • Missing sys.getrefcount
  • Subclasses of built-in types
  • Mutating classes of objects which are already used as dictionary keys
  • Ignored exceptions
  • Object Identity of Primitive Values, is and id
  • Permitted ABI tags in extensions
  • C-API Differences
  • Performance Differences
  • Miscellaneous
  • Extension modules
• Writing extension modules for pypy
  • CFFI
  • CTypes
  • cppyy
  • RPython Mixed Modules
• Garbage collector documentation and configuration
  • Incminimark
  • Semi-manual GC management
  • Fragmentation
  • gc.get_stats
  • GC Hooks
  • Environment variables
• JIT hooks
• Resetting the JIT
• Application-level Stackless features
  • Introduction
  • Theory
  • Application level interface
• The __pypy__ module
  • Generally available functionality
  • Fast String Concatenation
  • Interacting with the PyPy debug log
  • Transparent Proxy Functionality
  • Additional Clocks for Timing
  • Extended Signal Handling
  • Integer Operations with Overflow
  • Functionality available on py.py (not after translation)
• PyPy’s sandboxing features
  • Introduction
  • Overview
  • Howto
• Software Transactional Memory
  • What pypy-stm is for
  • Getting Started
  • Python 3, CPython, and others
  • User Guide
  • Implementation
  • See also

Development¶

• Contributing Guidelines
  • Getting involved
  • Your first contribution
  • Architecture
  • Building
  • Testing
  • Tooling & Utilities
  • Demos
  • graphviz & pygame for flow graph viewing (highly recommended)
• PyPy’s Configuration Handling
  • Main Assumption
  • API Details
  • The usage of config objects in PyPy
• Potential Project List
  • Getting involved
  • Simple tasks for newcomers
  • Mid-to-large tasks
  • Explicit typing in RPython
  • Make bytearray type fast
  • Implement copy-on-write list slicing
  • NumPy rebooted
  • Improving the jitviewer
  • Convert RPython to Python3
  • Improve performance
  • Improve warmup
  • Translation Toolchain
  • Various GCs
  • STM (Software Transactional Memory)
  • Introduce new benchmarks
  • Interfacing with C
• Project Documentation
• Source Code Documentation
• PyPy’s Release Process
  • Release Policy
  • How to Create a PyPy Release
  • Release Steps