semvec/pypi-packages huggingface dataset:
sevco-api 0.0.1
A client library for accessing Sevco API
Requires Python: >=3.6,<4.0

# sevco-api-client
A client library for accessing Sevco API

## Usage
First, create a client:

```python
from sevco_api_client import Client

client = Client(base_url="https://api.example.com")
```

If the endpoints you're going to hit require authentication, use `AuthenticatedClient` instead:

```python
from sevco_api_client import AuthenticatedClient

client = AuthenticatedClient(base_url="https://api.example.com", token="SuperSecretToken")
```

Now call your endpoint and use your models:

```python
from sevco_api_client.models import MyDataModel
from sevco_api_client.api.my_tag import get_my_data_model
from sevco_api_client.types import Response

my_data: MyDataModel = get_my_data_model.sync(client=client)
# or if you need more info (e.g. status_code)
response: Response[MyDataModel] = get_my_data_model.sync_detailed(client=client)
```

Or do the same thing with an async version:

```python
from sevco_api_client.models import MyDataModel
from sevco_api_client.api.my_tag import get_my_data_model
from sevco_api_client.types import Response

my_data: MyDataModel = await get_my_data_model.asyncio(client=client)
response: Response[MyDataModel] = await get_my_data_model.asyncio_detailed(client=client)
```

Things to know:
1. Every path/method combo becomes a Python module with four functions:
    1. `sync`: Blocking request that returns parsed data (if successful) or `None`
    1. `sync_detailed`: Blocking request that always returns a `Request`, optionally with `parsed` set if the request was successful.
    1. `asyncio`: Like `sync` but the async instead of blocking
    1. `asyncio_detailed`: Like `sync_detailed` by async instead of blocking
     
1. All path/query params, and bodies become method arguments.
1. If your endpoint had any tags on it, the first tag will be used as a module name for the function (my_tag above)
1. Any endpoint which did not have a tag will be in `sevco_api_client.api.default`    

## Building / publishing this Client
This project uses [Poetry](https://python-poetry.org/) to manage dependencies  and packaging.  Here are the basics:
1. Update the metadata in pyproject.toml (e.g. authors, version)
1. If you're using a private repository, configure it with Poetry
    1. `poetry config repositories.<your-repository-name> <url-to-your-repository>`
    1. `poetry config http-basic.<your-repository-name> <username> <password>`
1. Publish the client with `poetry publish --build -r <your-repository-name>` or, if for public PyPI, just `poetry publish --build`

If you want to install this client into another project without publishing it (e.g. for development) then:
1. If that project **is using Poetry**, you can simply do `poetry add <path-to-this-client>` from that project
1. If that project is not using Poetry:
    1. Build a wheel with `poetry build -f wheel`
    1. Install that wheel from the other project `pip install <path-to-wheel>`
pandoc_static_katex 0.1.3
A pandoc filter that renders math at build time using KaTeX.
Requires Python: >3.7

# pandoc-static-katex

A simple [pandoc](https://pandoc.org/) [filter](https://pandoc.org/filters.html)
that uses [KaTeX](https://katex.org/) to render math equations at build time. It
makes possible to display equations without any JavaScript execution in the
browser.


## Example usage

```bash
$ cat math.md
# A title and whatnot.

This is inline $\log(\frac{1}{2})$ and this is display:

$$
\int_{-\infty}^{+\infty}\LambdaLamda(x)dx
$$

$ pandoc -s  math.md --filter pandoc-static-katex --to html5 --css https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.8.3/katex.min.css -o math.html
```

Note that the `--katex` option of `pandoc` option doesn't add the styles since
`pandoc` doesn't see any math element after the filter pass.

## Installation

The script can be installed by pip:

```
python3 -m pip install pandoc_static_katex
```

The filter runs in Python 3.7+.

When the filter is run, KaTeX needs to be installed with
[nodejs](https://nodejs.org/en/); the command

```bash
npx katex
```

must work on the current path. The filter has been developed with version 0.10.2
of KaTeX.

Additionally, `pandoc` is needed for most usages.

### Development mode

It requires [flit](https://flit.readthedocs.io/en/latest/) to be installed from
source in development mode.

```bash
flit install --symlink
```

## Test script

If `pandoc`, `katex` and the filter have all been installed correctly, the
command:

```
python3 run_test.py
```

should produce rendered results in the `test_results` folder.