Merge pull request #56 from skirpichev/misc

v0.1.2

Author: skirpichev

.github/workflows/publish.yml

@@ -32,3 +32,37 @@ jobs:
         name: python-gmp
         path: dist/
     - uses: pypa/gh-action-pypi-publish@release/v1
+  github-release:
+    name: >-
+      Sign the Python distribution with Sigstore
+      and upload them to GitHub Release
+    needs:
+      - publish-to-pypi
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+    - uses: actions/download-artifact@v4
+      with:
+        name: python-gmp
+        path: dist/
+    - uses: sigstore/[email protected]
+      with:
+        inputs: >-
+          ./dist/*.tar.gz
+    - name: Create GitHub Release
+      env:
+        GITHUB_TOKEN: ${{ github.token }}
+      run: >-
+        gh release create '${{ github.ref_name }}'
+        --repo '${{ github.repository }}'
+        --prerelease
+        --generate-notes
+    - name: Upload artifact signatures to GitHub Release
+      env:
+        GITHUB_TOKEN: ${{ github.token }}
+      run: >-
+        gh release upload
+        '${{ github.ref_name }}' dist/**
+        --repo '${{ github.repository }}'

.github/workflows/test.yml

@@ -18,7 +18,25 @@ jobs:
           allow-prereleases: true
       - run: sudo apt-get update
       - run: sudo apt-get install libgmp-dev
+      - run: sudo apt-get install texlive texlive-latex-extra latexmk
+        if: matrix.python-version == 3.13
       - run: pip install --upgrade pip
       - run: pip --verbose install --editable .[develop]
+        if: matrix.python-version != 3.13
+      - run: pip --verbose install --editable .[develop,docs]
+        if: matrix.python-version == 3.13
       - run: ruff check
       - run: pytest
+      - name: Building docs
+        if: matrix.python-version == 3.13
+        run: |
+          sphinx-build --color -W --keep-going -b html docs build/sphinx/html
+          sphinx-build --color -W --keep-going -b latex docs build/sphinx/latex
+          make -C build/sphinx/latex all-pdf
+      - name: Archive build artifacts
+        uses: actions/upload-artifact@v4
+        if: matrix.python-version == 3.13
+        with:
+          path: |
+            build/sphinx/html/
+            build/sphinx/latex/python-gmp.pdf

.readthedocs.yaml

@@ -0,0 +1,19 @@
+version: 2
+formats:
+    - htmlzip
+    - pdf
+build:
+    os: ubuntu-22.04
+    apt_packages:
+        - libmpc-dev
+        - gcc
+    tools:
+        python: "3"
+python:
+    install:
+        - method: pip
+          path: .
+          extra_requirements:
+              - docs
+sphinx:
+    fail_on_warning: true

MANIFEST.in

@@ -0,0 +1,53 @@
+"""
+python-gmp documentation build configuration file.
+
+This file is execfile()d with the current directory set to its containing dir.
+
+The contents of this file are pickled, so don't put values in the namespace
+that aren't pickleable (module imports are okay, they're removed
+automatically).
+"""
+
+import packaging.version
+
+import gmp
+
+# Add any Sphinx extension module names here, as strings. They can be extensions
+# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
+extensions = ['sphinx.ext.autodoc']
+
+# The name of a reST role (builtin or Sphinx extension) to use as the
+# default role, that is, for text marked up `like this`.
+default_role = 'py:obj'
+
+# Sphinx will warn about all references where the target cannot be found.
+nitpicky = True
+
+# This value selects if automatically documented members are sorted
+# alphabetical (value 'alphabetical'), by member type (value 'groupwise')
+# or by source order (value 'bysource').
+autodoc_member_order = 'groupwise'
+
+# The default options for autodoc directives. They are applied to all
+# autodoc directives automatically.
+autodoc_default_options = {'members': True}
+
+# General information about the project.
+project = gmp.__package__
+copyright = '2024, Sergey B Kirpichev'
+
+gmp_version = packaging.version.parse(gmp.__version__)
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = f"{gmp_version.major}.{gmp_version.minor}"
+# The full version, including alpha/beta/rc tags.
+release = gmp.__version__
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title, author, documentclass [howto/manual]).
+latex_documents = [('index', 'python-gmp.tex', 'python-gmp Documentation',
+                    'Sergey B Kirpichev', 'manual')]

docs/conf.py

@@ -0,0 +1,5 @@
+Documentation for python-gmp
+============================
+
+.. automodule:: gmp
+   :members:

docs/index.rst

@@ -7,7 +7,7 @@
 #include <gmp.h>
 
 
-static const char python_gmp_version[] = "0.1.1";
+static const char python_gmp_version[] = "0.1.2";
 
 
 static jmp_buf gmp_env;
@@ -1663,6 +1663,21 @@ static PyMethodDef methods[] = {
 };
 
 
+PyDoc_STRVAR(mpz_doc,
+"mpz(x, /)\n\
+mpz(x, /, base=10)\n\
+\n\
+Convert a number or string to an integer, or return 0 if no arguments\n\
+are given.  If x is a number, return x.__int__().  For floating-point\n\
+numbers, this truncates towards zero.\n\
+\n\
+If x is not a number or if base is given, then x must be a string,\n\
+bytes, or bytearray instance representing an integer literal in the\n\
+given base.  The literal can be preceded by '+' or '-' and be surrounded\n\
+by whitespace.  The base defaults to 10.  Valid bases are 0 and 2-36.\n\
+Base 0 means to interpret the base from the string as an integer literal.");
+
+
 PyTypeObject MPZ_Type = {
     PyVarObject_HEAD_INIT(NULL, 0)
     .tp_name = "gmp.mpz",
@@ -1676,6 +1691,7 @@ PyTypeObject MPZ_Type = {
     .tp_hash = (hashfunc) hash,
     .tp_getset = getsetters,
     .tp_methods = methods,
+    .tp_doc = mpz_doc,
 };
 
 
@@ -1856,9 +1872,12 @@ gmp_isqrt(PyObject *self, PyObject *other)
 
 static PyMethodDef functions [] =
 {
-    {"gcd", (PyCFunction)gmp_gcd, METH_FASTCALL, "Greatest Common Divisor."},
+    {"gcd", (PyCFunction)gmp_gcd, METH_FASTCALL,
+     ("gcd($module, /, *integers)\n--\n\n"
+      "Greatest Common Divisor.")},
     {"isqrt", gmp_isqrt, METH_O,
-     "Return the integer part of the square root of the input."},
+     ("isqrt($module, n, /)\n--\n\n"
+      "Return the integer part of the square root of the input.")},
     {NULL}  /* sentinel */
 };
 

main.c

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "python-gmp"
 #dynamic = ["version"]
-version = "0.1.1"
+version = "0.1.2"
 description = "Safe bindings to the GNU GMP library"
 keywords = ['gmp', 'multiple-precision', 'arbitrary-precision', 'bignum']
 license = {text = "MIT"}
@@ -39,17 +39,22 @@ content-type = 'text/x-rst'
 Homepage = 'https://github.com/diofant/python-gmp'
 'Source Code' = 'https://github.com/diofant/python-gmp'
 'Bug Tracker' = 'https://github.com/diofant/python-gmp/issues'
+Documentation = 'https://python-gmp.readthedocs.io/'
 
 [tool.setuptools]
 ext-modules = [{name = "gmp", sources = ["main.c"], libraries = ["gmp"]}]
 
 #[tool.setuptools.dynamic]
 #version = {attr = "gmp.__version__"}
 
+[tool.setuptools.package-data]
+"*" = ["*.h"]
+
 [project.optional-dependencies]
 tests = ["pytest", "hypothesis",
          "gmpy2; platform_python_implementation!='PyPy'"]
 develop = ["python-gmp[tests]", "ruff"]
+docs = ['sphinx']
 
 [tool.pytest.ini_options]
 addopts = "--durations=7"