semvec/pypi-packages huggingface dataset:
sphinx-algolia-crawler 1.0.6
This Sphinx extension uses Algolia's v1 Crawler API - and may even be run standalone via CLI (without Sphinx).
License: MIT
Requires Python: >=3.10

# Sphinx Extension: Sphinx Algolia Crawler

<!-- Badges go here on the same line; PyPi doesn't support `\` or single-multi-line (it'll stack vertically) -->
[![PyPI](https://img.shields.io/pypi/v/sphinx-algolia-crawler)](https://pypi.org/project/sphinx-algolia-crawler/) [![PyPI - License](https://img.shields.io/pypi/l/sphinx-algolia-crawler)](https://opensource.org/licenses/MIT)

## Description

This Sphinx extension (that can also be run standalone) uses Algolia's v1 Crawler API 
to trigger a crawl. RTD uses Production stage, but Dev stage can be triggered either 
via standalone Python CLI call or by setting project root `.env` (see `.env.template`).

See [Algolia Crawler API Doc](https://www.algolia.com/doc/rest-api/crawler/#tag/actions/operation/crawlUrls)

## Sphinx Setup

## Set RTD Env

In ReadTheDocs' env var dashboard, set:

1. `ALGOLIA_CRAWLER_USER_ID`
2. `ALGOLIA_CRAWLER_API_KEY`
3. `ALGOLIA_CRAWLER_ID`

💡 Add this to your root proj `.env` to test locally (or as a standalone Python app)

### conf.py

```py
import sys, os

sys.path.append(os.path.abspath(os.path.join('_extensions', 'sphinx_algolia_crawler')))
extensions = [ 'sphinx_algolia_crawler' ]

# While this example merely turns it on, you probably want to check if RTD /latest production
# See `xbe_docs` `conf.py` for examples of how we checked for this
algolia_crawler_enabled = True
```

## Usage

### Standalone

See the `-h` (help) command:

```bash
python3 .\sphinx_algolia_crawler.py -h
```

### Sphinx Ext

If `conf.py` setup is set and `algolia_crawler_enabled`, this will automatically trigger when the build is done.

## Requirements

- Python>=3.6
- Sphinx>=1.8

This may work with older versions, but has not been tested.

## Entry Points

At `sphinx_algolia_crawler.py`:

### Sphinx Extension

See `setup(app)` definition.

### Standalone

See `if is_standalone:` block.

## Tested in

- Windows 11 via PowerShell 7
- Ubuntu 22.04 WSL2 Shell
- ReadTheDocs (RTD) CI Deployment (Ubuntu 22.04)

## Notes

- `__init__.py` is required for both external pathing and to treat the directory as a pkg
pytest-fauna 6.0.3
A collection of helpful test fixtures for Fauna DB.
License: MIT
Requires Python: <4.0,>=3.10

# pytest-fauna

pytest-fauna contains some helpful [pytest] fixtures for [Fauna DB].

# Table of contents

[[_TOC_]]

# Installation

Install with the usual [Python] package manager. Here's an example with [pip]:

```bash
pip install pytest-fauna
```

If you would like to use the [AWS SecretsManager] integration for retrieval of the fauna
secret key, you will need to install the `aws` extra. Here's an example with [pip]:

```bash
pip install pytest-fauna[aws]
```

If you are using [Fluctuate] and want to use the fixtures that automatically apply
migrations, you will need to install the `fluctuate` extra. Here's an example with
[pip]:

```bash
pip install pytest-fauna[fluctuate]
```

# Fixtures

Please see the [plugin.py] file for details on the available fixtures.

[Fauna DB]: https://docs.fauna.com/fauna/current/
[pytest]: https://docs.pytest.org/en/stable/
[Python]: https://www.python.org/
[pip]: https://pip.pypa.io/en/stable/
[AWS SecretsManager]: https://docs.aws.amazon.com/secretsmanager/
[plugin.py]: pytest_fauna/plugin.py
[Fluctuate]: https://gitlab.com/munipal-oss/fluctuate