semvec/pypi-packages huggingface dataset:
xorange-sphinx-theme 2022.12.13
xorange theme for Sphinx and Read The Docs
License: MIT

xorange Sphinx Theme
====================

A `Sphinx theme`_ for xorange's documentation, based on `Read The Docs`_'
default theme (sphinx_rtd_theme_).

Installation
------------

This theme is distributed on PyPI as xorange-sphinx-theme_ and can be
installed with ``pip``:

.. code:: console

    $ python3 -m pip install xorange-sphinx-theme

To use the theme in your Sphinx project, you will need to add the following to
your ``conf.py`` file:

.. code:: python

    html_theme = "xorange-sphinx-theme"

This theme is based on sphinx_rtd_theme_ and accepts most of the same
`configuration options`_ settable via ``html_theme_option`` and a few
additional options as well:

:logo: Boolean determining if the xorange logo should be displayed.
       Defaults to true.

:logo_link: URL to use for the logo's link.  Defaults to
            <https://docs.xorange.org>.

:logo_only: Ignored.  Inherited from sphinx_rtd_theme_.  Instead, the project
            name and version info will not be displayed (thus showing only the
            logo) when ``subproject`` is true.

:subproject: Boolean determining if this is a subproject of the main xorange
             documentation project on <https://docs.xorange.org>.  Defaults
             to true.

If your project wants to display its own logo, just set Sphinx's ``html_logo``
to point to the image file in your Sphinx project.

.. code:: python

    html_logo = "_static/your-logo.png"

This will automatically take precedence over the default xorange logo
provided by the theme.

Development
-----------

.. code:: bash

    python3 -m pip install -e .
    make clean # not always needed, but better to be cautious
    make html
    open build/html/index.html

Releasing
---------

1. Make sure all your changes have been commited to the ``main`` branch.
2. Add a commit which describes the changes from the previous version to ``CHANGES.rst`` and updates the version number in ``lib/xorange/sphinx/theme/VERSION``.
3. Tag this commit with the version number, e.g. ``git tag -a 2020.4 -m "version 2020.4"``.
4. Push the commit and tag to GitHub, e.g. ``git push origin main 2020.4``.
5. Publish to PyPI by invoking a GitHub Actions workflow:

   1. Go to the workflow: `publish.yml <https://github.com/xorange/sphinx-theme/actions/workflows/publish.yml>`_.
   2. Select **Run workflow**. In the new menu:

      1. Select **Use workflow from** > **Tags** > new version number (e.g. 2020.4).
      2. Set **PyPI instance for publishing** as *PyPI* (default) or *TestPyPI*. `More info <https://packaging.python.org/en/latest/guides/using-testpypi/>`_
      3. Select **Run workflow**.

.. _Sphinx theme: https://www.sphinx-doc.org/en/master/theming.html
.. _Read The Docs: https://readthedocs.org
.. _sphinx_rtd_theme: https://github.com/readthedocs/sphinx_rtd_theme
.. _xorange-sphinx-theme: https://pypi.org/project/xorange-sphinx-theme/
.. _configuration options: https://sphinx-rtd-theme.readthedocs.io/en/latest/configuring.html
bepospliz 1.0.1
BePosPliz (be positional please) is a lightweight module to anonymize the arguments of a function.
License: MIT
Requires Python: >=3.11

# BePosPliz

BePosPliz (be positional please) is a lightweight module to anonymize the arguments of a function.

Relevant PEP: <https://peps.python.org/pep-0646>

I am not really sure if this has a real world purpose, but playing with new Python features is very enjoyable.
I appreciate the effort to improve type expressiveness, and I am looking forward to PEPs 695 and 696 for even more fun :D

## Features

### `anon_args`

#### Usage

Let the following function:

```py
from bepospliz import anon_args

@anon_args
def div(a: int, b: int) -> float:
    """Divide a by b"""
    return a / b
```

`div`'s original signature is `div(a: int, b: int) -> float`.

![`div` without decorator](https://raw.githubusercontent.com/qexat/bepospliz/main/docs/assets/div_original.png)

With the decorator `@anon_args`, it becomes `div(int, int) -> float`, meaning that it cannot be called by specifically naming the args anymore (e.g. `div(b=3, a=2)`)

![`div` with the decorator](https://raw.githubusercontent.com/qexat/bepospliz/main/docs/assets/div_anon_args.png)

---

#### Signature

```py
anon_args(function: Callable[[*Ps], R]) -> Callable[[*Ps], R]
```

with `Ps` being the set of types of `function`'s arguments, and `R` its return type.

**Example**

Given the previous `div` function, `Ps` would be `(int, int)` and `R` would be `float`.
application-tracker 0.1.0
A simple CLI to save and view job applications.
License: MIT
Requires Python: >=3.9,<4.0

# Job Application Tracker
A simple command line interface to track job applications.
Built using [Typer](https://github.com/tiangolo/typer). This project
was an exercise in basic software development, testing, and packaging. Tutorials followed:
<br />
* [https://realpython.com/command-line-interfaces-python-argparse/](https://realpython.com/command-line-interfaces-python-argparse/)
* [https://realpython.com/pypi-publish-python-package/#prepare-your-package-for-publication](https://realpython.com/pypi-publish-python-package/#prepare-your-package-for-publication)