Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

gh-102471, PEP 757: Add PyLong import and export API#121339

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
vstinner merged 54 commits intopython:mainfromvstinner:long_export
Dec 13, 2024
Merged
Show file tree
Hide file tree
Changes from1 commit
Commits
Show all changes
54 commits
Select commitHold shift + click to select a range
f4fdbf2
gh-102471: Add PyLong import and export API
vstinnerJul 2, 2024
c2e568e
Add layout
vstinnerJul 23, 2024
f0d9525
Merge branch 'main' into long_export
vstinnerSep 3, 2024
b19764f
Rename word_endian to digits_order
vstinnerSep 3, 2024
6f7fd11
Replace Py_digit* type with void*
vstinnerSep 3, 2024
080e079
Add PyLongWriter_Discard() function
vstinnerSep 4, 2024
1a7902f
Fixes
vstinnerSep 5, 2024
b70a6dd
Use unsigned type for ndigits
vstinnerSep 5, 2024
07552a7
Remove again layout
vstinnerSep 5, 2024
0d0f942
Revert "Use unsigned type for ndigits"
vstinnerSep 6, 2024
762c33a
doc: adjust ndigits documentation
vstinnerSep 6, 2024
20be7a3
Update doc
vstinnerSep 13, 2024
d92bf1e
Make PyLong_DigitArray.obj private
vstinnerSep 16, 2024
b3b02a2
Remove reserved documentation
vstinnerSep 16, 2024
caca2d7
PyLong_FreeDigitArray() only clears _reserved
vstinnerSep 16, 2024
4221a49
Make PyLong_LAYOUT static
vstinnerSep 16, 2024
37b1d49
Add PyLong_AsDigitArray.value
vstinnerSep 16, 2024
d70a121
Inline PyLong_AsInt64() to avoid the exception
vstinnerSep 17, 2024
4aa25f6
Remove Py_digit type; update the doc
vstinnerSep 17, 2024
90973d4
Merge branch 'main' into long_export
vstinnerSep 17, 2024
5d3e224
Add long_asnativebytes() function
vstinnerSep 17, 2024
c7d7cb2
Remove reference to removed Py_digit type
vstinnerSep 17, 2024
a3d601a
Address Antoine's review
vstinnerSep 17, 2024
c049268
Merge branch 'main' into long_export
vstinnerSep 17, 2024
06b196b
Merge branch 'main' into long_export
skirpichevSep 18, 2024
3e8d296
Apply suggestions from code review
skirpichevSep 18, 2024
86c68c2
Merge branch 'main' into long_export
skirpichevSep 18, 2024
a8fd669
Revert "Add long_asnativebytes() function"
vstinnerSep 18, 2024
a04f9d0
Use PyLong_AsLongAndOverflow()
vstinnerSep 18, 2024
b2be94a
Try PyLong_AsLongLongAndOverflow() first
vstinnerSep 18, 2024
ca98ad1
Merge branch 'main' into long_export
vstinnerSep 18, 2024
167d75e
Update Doc/c-api/long.rst
vstinnerSep 19, 2024
5e53a5b
Sync implementation with PEP (#8)
skirpichevOct 16, 2024
c24789f
Merge branch 'main' into long_export
skirpichevNov 13, 2024
0422f9d
fix NL in Doc/c-api/long.rst (sorry, damn web editor)
skirpichevNov 13, 2024
a529a48
rename news
skirpichevNov 13, 2024
3db44f3
Address Erlend's review
vstinnerNov 13, 2024
1d2863e
Address Sergey's review
vstinnerNov 13, 2024
d663511
Merge branch 'main' into long_export
vstinnerNov 13, 2024
816798d
Merge branch 'main' into long_export
vstinnerNov 28, 2024
033bd65
Update documentation from PEP 757
vstinnerNov 28, 2024
36b87d4
Update Modules/_testcapi/long.c
vstinnerNov 28, 2024
94d852e
Sync implementation with PEP (#9)
skirpichevDec 9, 2024
a72ff83
Merge branch 'main' into long_export
vstinnerDec 9, 2024
53d584b
Cleanup
vstinnerDec 9, 2024
577598a
Update Doc/c-api/long.rst
vstinnerDec 9, 2024
b08cd55
Address Steve's review
vstinnerDec 9, 2024
eaebef3
Address Bénédikt's review
vstinnerDec 10, 2024
03248c7
Apply suggestions from code review
vstinnerDec 10, 2024
0a26f97
Address Steve's review
vstinnerDec 11, 2024
88a62fe
Add PyLong_Export to Doc/data/refcounts.dat
vstinnerDec 12, 2024
45517ab
Address Serhiy's review
vstinnerDec 12, 2024
92007d1
Address Petr's review
vstinnerDec 12, 2024
6d3cb80
Add PyLongWriter to Doc/data/refcounts.dat
vstinnerDec 12, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
PrevPrevious commit
NextNext commit
Update documentation from PEP 757
Remove doc from the header file, only keep doc in Doc/c-api/long.rstto avoid the documentation to be outdated in one place.
  • Loading branch information
@vstinner
vstinner committedNov 28, 2024
commit033bd65f837e173398d8b45427be7182f33735f4
13 changes: 8 additions & 5 deletionsDoc/c-api/long.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -724,7 +724,7 @@ Export API

.. c:member:: uint8_t negative

1 if the number is negative,0 otherwise.
``1`` if the number is negative,``0`` otherwise.
Only valid if :c:member:`digits` is not ``NULL``.

.. c:member:: Py_ssize_t ndigits
Expand All@@ -741,11 +741,11 @@ Export API

Export a Python :class:`int` object.

On success, set *\*export_long* and return0.
On error, set an exception and return-1.
On success, set *\*export_long* and return``0``.
On error, set an exception and return``-1``.

If *export_long.digits* is not ``NULL``, :c:func:`PyLong_FreeExport` must be
called when the export is no longer needed.
If *export_long->digits* is not ``NULL``, :c:func:`PyLong_FreeExport` must
becalled when the export is no longer needed.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Suggested change
..impl-detail::
This function always succeeds if *obj* is a Python:class:`int` object
or a subclass.

Lets see if we can restore this in a that way. It might be helpful for e.g. Sage, which doesn't support PyPy.

Copy link
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

I would prefer to not add this note. It was controversial during PEP 757 design.

@serhiy-storchaka@encukou: What do you think? Would you be ok to declare that the PyLong_Export() function cannot fail if the argument is a Python int?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

It was controversial during PEP 757 design.

It was proposed unconditionally, not as CPython's implementation detail.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

I'm fine with it, as an implementation detail.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.


.. c:function:: void PyLong_FreeExport(PyLongExport *export_long)
Expand DownExpand Up@@ -794,6 +794,9 @@ The :c:type:`PyLongWriter` API can be used to import an integer.
On success, return a Python :class:`int` object.
On error, set an exception and return ``NULL``.

The function takes care of normalizing the digits and converts the object
to a compact integer if needed.


.. c:function:: void PyLongWriter_Discard(PyLongWriter *writer)

Expand Down
11 changes: 0 additions & 11 deletionsInclude/cpython/longintrepr.h
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -142,20 +142,9 @@ _PyLong_CompactValue(const PyLongObject *op)
/* --- Import/Export API -------------------------------------------------- */

typedef struct PyLongLayout {
// Bits per digit
uint8_t bits_per_digit;

// Digit size in bytes
uint8_t digit_size;

// Digits order:
// * 1 for most significant digit first
// * -1 for least significant first
int8_t digits_order;

// Digit endianness:
// * 1 for most significant byte first (big endian)
// * -1 for least significant first (little endian)
int8_t endianness;
} PyLongLayout;

Expand Down
Loading

[8]ページ先頭

©2009-2025 Movatter.jp