setproctitle 1.3.8__cp315-cp315-win_amd64.whl

setproctitle/__init__.py

@@ -0,0 +1,57 @@
+"""Allow customization of the process title."""
+
+import os
+import sys
+import logging
+
+logger = logging.getLogger("setproctitle")
+
+__version__ = "1.3.8"
+
+__all__ = [
+    "setproctitle",
+    "getproctitle",
+    "setthreadtitle",
+    "getthreadtitle",
+]
+
+
+def setproctitle(title: str) -> None:
+    logger.debug("setproctitle C module not available")
+    return None
+
+
+def getproctitle() -> str:
+    logger.debug("setproctitle C module not available")
+    return " ".join(sys.argv)
+
+
+def setthreadtitle(title: str) -> None:
+    logger.debug("setproctitle C module not available")
+    return None
+
+
+def getthreadtitle() -> str:
+    logger.debug("setproctitle C module not available")
+    return ""
+
+
+try:
+    from . import _setproctitle  # type: ignore
+except ImportError as e:
+    # Emulate SPT_DEBUG showing process info in the C module.
+    if os.environ.get("SPT_DEBUG", ""):
+        logging.basicConfig()
+        logger.setLevel(logging.DEBUG)
+    logger.debug("failed to import setproctitle: %s", e)
+else:
+    setproctitle = _setproctitle.setproctitle  # noqa: F811
+    getproctitle = _setproctitle.getproctitle  # noqa: F811
+    setthreadtitle = _setproctitle.setthreadtitle  # noqa: F811
+    getthreadtitle = _setproctitle.getthreadtitle  # noqa: F811
+
+
+# Call getproctitle to initialize structures and avoid problems caused
+# by fork() on macOS (see #113).
+if sys.platform == "darwin":
+    getproctitle()

setproctitle-1.3.8.dist-info/METADATA

@@ -0,0 +1,410 @@
+Metadata-Version: 2.4
+Name: setproctitle
+Version: 1.3.8
+Summary: A Python module to customize the process title
+Home-page: https://github.com/dvarrazzo/py-setproctitle
+Download-URL: http://pypi.python.org/pypi/setproctitle/
+Author: Daniele Varrazzo
+Author-email: daniele.varrazzo@gmail.com
+License: BSD-3-Clause
+Platform: GNU/Linux
+Platform: BSD
+Platform: MacOS X
+Platform: Windows
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: POSIX :: BSD
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Topic :: Software Development
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: download-url
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: platform
+Dynamic: provides-extra
+Dynamic: requires-python
+Dynamic: summary
+
+A Python module to customize the process title
+==============================================
+
+.. image:: https://github.com/dvarrazzo/py-setproctitle/workflows/Tests/badge.svg
+    :target: https://github.com/dvarrazzo/py-setproctitle/actions?query=workflow%3ATests
+    :alt: Tests
+
+:author: Daniele Varrazzo
+
+The ``setproctitle`` module allows a process to change its title (as displayed
+by system tools such as ``ps``, ``top`` or MacOS Activity Monitor).
+
+Changing the title is mostly useful in multi-process systems, for example
+when a master process is forked: changing the children's title allows to
+identify the task each process is busy with.  The technique is used by
+PostgreSQL_ and the `OpenSSH Server`_ for example.
+
+The procedure is hardly portable across different systems.  PostgreSQL provides
+a good `multi-platform implementation`__:  this package was born as a wrapper
+around PostgreSQL code.
+
+- `Homepage <https://github.com/dvarrazzo/py-setproctitle>`__
+- `Download <http://pypi.python.org/pypi/setproctitle/>`__
+- `Bug tracker <https://github.com/dvarrazzo/py-setproctitle/issues>`__
+
+
+.. _PostgreSQL: http://www.postgresql.org
+.. _OpenSSH Server: http://www.openssh.com/
+.. __: http://doxygen.postgresql.org/ps__status_8c_source.html
+
+
+Installation
+------------
+
+``setproctitle`` is a C extension: in order to build it you will need a C
+compiler and the Python development support (the ``python-dev`` or
+``python3-dev`` package in most Linux distributions). No further external
+dependencies are required.
+
+You can use ``pip`` to install the module::
+
+    pip install setproctitle
+
+You can use ``pip -t`` or ``virtualenv`` for local installations, ``sudo pip``
+for a system-wide one... the usual stuff. Read pip_ or virtualenv_ docs for
+all the details.
+
+.. _pip: https://pip.readthedocs.org/
+.. _virtualenv: https://virtualenv.readthedocs.org/
+
+
+Usage
+-----
+
+.. note::
+   You should import and use the module (even just calling ``getproctitle()``)
+   pretty early in your program lifetime: code writing env vars `may
+   interfere`__ with the module initialisation.
+
+    .. __: https://github.com/dvarrazzo/py-setproctitle/issues/42
+
+
+The ``setproctitle`` module exports the following functions:
+
+``setproctitle(title)``
+    Set *title* as the title for the current process.
+
+``getproctitle()``
+    Return the current process title.
+
+The process title is usually visible in files such as ``/proc/PID/cmdline``,
+``/proc/PID/status``, ``/proc/PID/comm``, depending on the operating system
+and kernel version. These information are used by user-space tools such as
+``ps`` and ``top``.
+
+
+``setthreadtitle(title)``
+    Set *title* as the title for the current thread.
+
+``getthreadtitle()``
+    Get the current thread title.
+
+The thread title is exposed by some operating systems as the file
+``/proc/PID/task/TID/comm``, which is used by certain tools such as ``htop``.
+
+
+Environment variables
+~~~~~~~~~~~~~~~~~~~~~
+
+A few environment variables can be used to customize the module behavior:
+
+``SPT_NOENV``
+    Avoid clobbering ``/proc/PID/environ``.
+
+    On many platforms, setting the process title will clobber the
+    ``environ`` memory area. ``os.environ`` will work as expected from within
+    the Python process, but the content of the file ``/proc/PID/environ`` will
+    be overwritten.  If you require this file not to be broken you can set the
+    ``SPT_NOENV`` environment variable to any non-empty value: in this case
+    the maximum length for the title will be limited to the length of the
+    command line.
+
+``SPT_DEBUG``
+    Print debug information on ``stderr``.
+
+    If the module doesn't work as expected you can set this variable to a
+    non-empty value to generate information useful for debugging.  Note that
+    the most useful information is printed when the module is imported, not
+    when the functions are called.
+
+
+Module status
+-------------
+
+The module can be currently compiled and effectively used on the following
+platforms:
+
+- GNU/Linux
+- BSD
+- MacOS X
+- Windows
+
+Note that on Windows there is no way to change the process string:
+what the module does is to create a *Named Object* whose value can be read
+using a tool such as `Process Explorer`_ (contribution of a more useful tool
+to be used together with ``setproctitle`` would be well accepted).
+
+The module can probably work on HP-UX, but I haven't found any to test with.
+It is unlikely that it can work on Solaris instead.
+
+.. _Process Explorer: http://technet.microsoft.com/en-us/sysinternals/bb896653.aspx
+
+Releases history
+----------------
+
+Version 1.3.8
+-------------
+
+- Add support for Python 3.15.
+- Fix segfault calling setproctitle() after clearenv() on Python 3.15
+  (issue #157).
+- Add support for riscv64 (issue #156).
+
+
+Version 1.3.7
+-------------
+
+- Add support for Python 3.14 (issue #152).
+
+
+Version 1.3.6
+-------------
+
+- Add support for free-threading (issue #147).
+
+
+Version 1.3.5
+-------------
+
+- Fix bouncing Dock icon on macOS (issue #143).
+- Fix building on C23 compilers (issue #145).
+
+
+Version 1.3.4
+-------------
+
+- Add support for Python 3.13 (issue #139).
+- Drop support for Python 3.7.
+
+
+Version 1.3.3
+-------------
+
+- Add support for Python 3.12.
+- Fix package metadata to include Python 3.11, 3.12.
+
+
+Version 1.3.2
+-------------
+
+- Restore import-time initialization of macOS to avoid crash on thread+fork
+  (issue #113).
+
+
+Version 1.3.1
+-------------
+
+- Fixed segfault on macOS 12.5 in forked processes (issue #111).
+  Note that, as a workaround, Activity Monitor will show the title of the
+  parent.
+
+
+Version 1.3.0
+-------------
+
+- Added fallback no-op implementation if building the extension fails.
+- Added support for displaying title as the process name in MacOS Activity
+  Monitor (issue #10).
+- Fixed "Symbol not found: _Py_GetArgcArgv" error when using Xcode provided
+  Python (issues #82, #103).
+- Fixed FreeBSD support, broken in 1.2 (issue #94).
+- Added package type annotations (issue #101).
+- Dropped support for Python 3.6.
+
+
+Version 1.2.3
+-------------
+
+- Added Python 3.10 packages (issue #102).
+- Added Wheel packages for macOS (issue #96).
+- Package build moved to cibuildwheel, other wheels provided (issue #47).
+
+
+Version 1.2.2
+-------------
+
+- Fixed Windows build (issues #89, #90).
+- Added wheel packages for Windows (issues #47, #90).
+- Added wheel packages for aarch64 (issue #95).
+
+
+Version 1.2.1
+-------------
+
+- Fixed segfault after ``os.environ.clear()`` (issue #88).
+
+
+Version 1.2
+~~~~~~~~~~~
+
+- added ``getthreadtitle()`` and ``setthreadtitle()``.
+- Initialisation of the module moved to the first usage: importing the module
+  doesn't cause side effects.
+- Manage much longer command lines (issue #52)
+- Improved build on BSD, dropped ancient versions (issue #67).
+- Fixed build for Python 3.8 (issues #66, #72)
+- Added support for Python 3.9
+- Dropped support for Python < 3.6
+
+
+Version 1.1.10
+~~~~~~~~~~~~~~
+
+- Fixed building with certain ``prctl.h`` implementations (issue #44).
+- Use ``setuptools`` if available (issue #48).
+
+
+Version 1.1.9
+~~~~~~~~~~~~~
+
+- Fixed build on VC (issues #20, #33).
+- Added ``MANIFEST.in`` to the source distribution to help with RPM building
+  (issue #30).
+
+
+Version 1.1.8
+~~~~~~~~~~~~~
+
+- Added support for Python "diehard" 2.4 (pull request #3).
+- Fixed build on Mac OS X 10.9 Maverick (issue #27).
+
+
+Version 1.1.7
+~~~~~~~~~~~~~
+
+- Added PyPy support, courtesy of Ozan Turksever - http://www.logsign.net
+  (pull request #2).
+
+
+Version 1.1.6
+~~~~~~~~~~~~~
+
+- The module can be compiled again on Windows (issue #21).
+
+
+Version 1.1.5
+~~~~~~~~~~~~~
+
+- No module bug, but a packaging issue: files ``README`` and ``HISTORY``
+  added back into the distribution.
+
+
+Version 1.1.4
+~~~~~~~~~~~~~
+
+- The module works correctly in embedded Python.
+- ``setproctitle()`` accepts a keyword argument.
+- Debug output support always compiled in: the variable ``SPT_DEBUG`` can be
+  used to emit debug log.
+
+
+Version 1.1.3
+~~~~~~~~~~~~~
+
+- Don't clobber environ if the variable ``SPT_NOENV`` is set (issue #16).
+
+
+Version 1.1.2
+~~~~~~~~~~~~~
+
+- Find the setproctitle include file on OpenBSD (issue #11).
+- Skip test with unicode if the file system encoding wouldn't make it pass
+  (issue #13).
+
+
+Version 1.1.1
+~~~~~~~~~~~~~
+
+- Fixed segfault when the module is imported under mod_wsgi (issue #9).
+
+
+Version 1.1
+~~~~~~~~~~~
+
+- The module works correctly with Python 3.
+
+
+Version 1.0.1
+~~~~~~~~~~~~~
+
+- ``setproctitle()`` works even when Python messes up with argv, e.g. when run
+  with the -m option (issue #8).
+
+
+Version 1.0
+~~~~~~~~~~~
+
+No major change since the previous version.  The module has been heavily used
+in production environment without any problem reported, so it's time to declare
+it stable.
+
+
+Version 0.4
+~~~~~~~~~~~
+
+- Module works on BSD (tested on FreeBSD 7.2).
+
+- Module works on Windows. Many thanks to `Develer`_ for providing a neat `GCC
+  package for Windows with Python integration`__ that made the Windows porting
+  painless.
+
+  .. _Develer: http://www.develer.com/
+  .. __: http://www.develer.com/oss/GccWinBinaries
+
+
+Version 0.3
+~~~~~~~~~~~
+
+- Module works on Mac OS X 10.2. Reported working on OS X 10.6 too.
+
+
+Version 0.2
+~~~~~~~~~~~
+
+- Added ``prctl()`` call on Linux >= 2.6.9 to update ``/proc/self/status``.
+
+
+Version 0.1
+~~~~~~~~~~~
+
+- Initial public release.

setproctitle-1.3.8.dist-info/RECORD

@@ -0,0 +1,8 @@
+setproctitle/__init__.py,sha256=k056SjO4kRWATgrRtjyHCgreIapxRiRnmPPUOY8CsNw,1466
+setproctitle/_setproctitle.cp315-win_amd64.pyd,sha256=BSajh3K5eNZceIoZGwjl5IbeQGc7V6XxsunMR4lPUr0,13312
+setproctitle/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setproctitle-1.3.8.dist-info/licenses/LICENSE,sha256=HT9sg1eIr84Jp6PhUdv_iietlLQS22FfO4YOp4HsUOM,1558
+setproctitle-1.3.8.dist-info/METADATA,sha256=fDVy3rp7pqjAg5lR50GsIe-eK0vs2kzG2nLUHGjSI3k,11319
+setproctitle-1.3.8.dist-info/WHEEL,sha256=geuJoH1aW6kS7q0cKuoOBUdE-tpBsTvRf9l5rOGbxQs,101
+setproctitle-1.3.8.dist-info/top_level.txt,sha256=khlu2SuNEK2Ct594XhMTT62ll8p0oFza-4dmzUFTBhQ,13
+setproctitle-1.3.8.dist-info/RECORD,,

setproctitle-1.3.8.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: false
+Tag: cp315-cp315-win_amd64
+

setproctitle-1.3.8.dist-info/licenses/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2009, Daniele Varrazzo <daniele.varrazzo@gmail.com>
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

setproctitle-1.3.8.dist-info/top_level.txt

@@ -0,0 +1 @@
+setproctitle