python / python/cpython

`Py_SETREF` and `Py_NewRef` is not explained in extending new types using a C extension

Offen
#101,233 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

docs
Vorherrschende Sprache
Python
Sterne
77.2k
Forks
36k
PR-Merge-Kennzahlen
PR-Kennzahlen ausstehend

Beschreibung

Documentation

The documentation for extending new types using a C extension just uses Py_SETREF and Py_NewRef with no extra clarification as to what those functions do. It'd be nicer and more convenient if they were explained on-the-spot instead of having to search for it in the docs. They are also not explained in the previous topic (that explains Py_INCREF and Py_DECREF) and the other topics thereafter.

Linked PRs
  • gh-101234

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginnen Sie mit dem Abschnitt „Feinere Kontrolle über Datenattribute“ des verlinkten Tutorials zu neuen Typen. Erklären Sie Py_SETREF und Py_NewRef an den Stellen, an denen sie verwendet werden, und überprüfen Sie die umgebenden Themen zur Referenzzählung auf eine konsistente Abdeckung. Die Dokumentation ist fertig, wenn Leser beide Funktionen verstehen können, ohne an anderer Stelle suchen zu müssen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
c
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
1/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Veraltet
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
25/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.