Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zpoint/CPython-Internals

Dive into CPython internals, trying to illustrate every detail of CPython implementation
https://github.com/zpoint/CPython-Internals

c cpython cpython-internals interpreter learning-material python python3

Last synced: about 1 month ago
JSON representation

Dive into CPython internals, trying to illustrate every detail of CPython implementation

Host: GitHub
URL: https://github.com/zpoint/CPython-Internals
Owner: zpoint
Created: 2019-04-15T15:16:42.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-07-08T03:55:22.000Z (5 months ago)
Last Synced: 2024-10-16T10:21:55.490Z (about 2 months ago)
Topics: c, cpython, cpython-internals, interpreter, learning-material, python, python3
Language: C
Homepage:
Size: 33.4 MB
Stars: 4,136
Watchers: 332
Forks: 435
Open Issues: 3
Metadata Files:
- Readme: README.md
- Changelog: change_code_reference.py

Awesome Lists containing this project

my-awesome - zpoint/CPython-Internals - internals,interpreter,learning-material,python,python3 pushed_at:2024-07 star:4.2k fork:0.4k Dive into CPython internals, trying to illustrate every detail of CPython implementation (C)
awesome-starts - zpoint/CPython-Internals - Dive into CPython internals, trying to illustrate every detail of CPython implementation (Python)

README

        # Cpython Internals![image title](http://www.zpoint.xyz:8080/count/tag.svg?url=github%2FCPython-Internals)

![cpython logo](https://docs.google.com/drawings/d/e/2PACX-1vQKKPvv9xI22zZcRtElIMx_-G22qYcLUvl-gbngubjf76dr80ZjsYQZCCKVqEvJnmBnwZyDXqG9GPlu/pub?w=300&h=200) 

* [简体中文](https://github.com/zpoint/CPython-Internals/blob/master/README_CN.md)

* [한국어](https://github.com/zpoint/CPython-Internals/blob/master/README_KR.md)

*  **Watch** this repo if you need to be notified when there's update

This repository is my notes/blog for [cpython](https://github.com/python/cpython) source code

Trying to illustrate every detail of cpython implementation

```shell script

# based on version 3.8.0a0

cd cpython

git reset --hard ab54b9a130c88f708077c2ef6c4963b632c132b3

```

The following contents are suitable for those who have python programming experience and interested in internal of python interpreter, for those who needs beginner or advanced material please refer to [awesome-python-books](https://github.com/Junnplus/awesome-python-books)

# Table of Contents

* [Objects](#Objects)

* [Modules](#Modules)

* [Lib](#Lib)

* [Interpreter](#Interpreter)

* [Extension](#Extension)

* [Learning material](#Learning-material)

* [Contribution](#Contribution)

* [License](#License)

# Objects

 - [x] [dict](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/dict/dict.md)

 - [x] [long/int](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/long/long.md)

 - [x] [unicode/str](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/str/str.md)

 - [x] [set](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/set/set.md)

 - [x] [list(timsort)](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/list/list.md)

 - [x] [tuple](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/tuple/tuple.md)

 - [x] [bytes](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/bytes/bytes.md)

 - [x] [bytearray(buffer protocol)](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/bytearray/bytearray.md)

 - [x] [float](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/float/float.md)

 - [x] [func(user-defined method)](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/func/func.md)

 - [x] [method(builtin method)](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/method/method.md)

 - [x] [iter](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/iter/iter.md)

 - [x] [gen(generator/coroutine/async generator)](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/gen/gen.md)

 - [x] [class(bound method/classmethod/staticmethod)](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/class/class.md)

 - [x] [complex](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/complex/complex.md)

 - [x] [enum](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/enum/enum.md)

 - [x] [type(mro/metaclass/creation of class/instance)](https://github.com/zpoint/CPython-Internals/blob/master/BasicObject/type/type.md)

# Modules

 - [ ] io

 	- [x] [fileio](https://github.com/zpoint/CPython-Internals/blob/master/Modules/io/fileio/fileio.md)

 - [x] [pickle](https://github.com/zpoint/CPython-Internals/blob/master/Modules/pickle/pickle.md)

# Lib

 - [x] [re(regex)](https://github.com/zpoint/CPython-Internals/blob/master/Modules/re/re.md)

 - [ ] asyncio

# Interpreter

 - [x] [gil(Global Interpreter Lock)](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/gil/gil.md)

 - [x] [gc(Garbage Collection)](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/gc/gc.md)

 - [x] [memory management](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/memory_management/memory_management.md)

 - [x] [descr(how does attribute access work/`__get__`/`__getattribute__`/`__getattr__`)](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/descr/descr.md)

 - [x] [exception(exception handling)](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/exception/exception.md)

 - [x] [module(how does import work)](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/module/module.md)

 - [x] [frame](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/frame/frame.md)

 - [x] [code](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/code/code.md)

 - [x] [slots/`__slots__`(how does attribute initialized in the creation of class/instance)](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/slot/slot.md)

 - [x] [thread](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/thread/thread.md)

 - [x] [PyObject(overview)](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/pyobject/pyobject.md)

# Extension

 - [x] [C API(profile python code and write pure C extension)](https://github.com/zpoint/CPython-Internals/blob/master/Extension/C/c.md)

 - [ ] Cython(C extension)

 - [x] [Boost C++ libaries (C\+\+ extension)](https://github.com/zpoint/Boost-Python-Examples)

 - [ ] [C++ extension](https://github.com/zpoint/CPython-Internals/blob/master/Extension/CPP/cpp.md)

 	- [x] integrate with NumPy

 	- [x] bypass the GIL

# Grammar

 - [x] [Compile Phase](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/compile/compile.md)

    - [x] [Grammar/MetaGrammar to DFA](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/compile/compile.md)

    - [x] [CST to AST](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/compile2/compile.md)

    - [x] [AST to python byte code](https://github.com/zpoint/CPython-Internals/blob/master/Interpreter/compile3/compile.md)

# Learning material

I will only recommend what I've read

* [CPython internals - Interpreter and source code overview(youtube video)](https://www.youtube.com/watch?v=LhadeL7_EIU&list=PLzV58Zm8FuBL6OAv1Yu6AwXZrnsFbbR0S)

* [< < Inside The Python Virtual Machine > >](https://leanpub.com/insidethepythonvirtualmachine)

* [< < Python源码剖析 > >](https://book.douban.com/subject/3117898/)

* [rushter(blog/eng)](https://rushter.com/)

* [YET ANOTHER PYTHON INTERNALS BLOG(blog/eng)](https://pythoninternal.wordpress.com/)

* [Junnplus(blog/cn)](https://github.com/Junnplus/blog/issues)

* [manjusaka(blog/cn)](https://manjusaka.itscoder.com/)

* [aoik-Python's compiler series(blog/eng)](https://aoik.me/blog/posts/python-compiler-from-grammar-to-dfa)

# Contribution

All kinds of contributions are welcome

* submit a pull request

  *  if you want to share any knowledge you know

  * post a new article

  * correct any technical mistakes

  * correct english grammar

  * translation

  * anything else

* open an issue 

  * any suggestions

  * any questions

  * correct mistakes

  * anything else

# [License](https://creativecommons.org/licenses/by-nc-sa/4.0/)