semvec/pypi-packages huggingface dataset:
pypicky 0.6
Run a PyPI server with version requirements applied

About PyPIcky
=============

PyPIcky is a tiny package that provides a proxy to the PyPI server but with
version requirements pre-applied.

Installing
----------

To install::

    pip install pypicky

Using
-----

Once installed, create a
`requirements file <https://pip.readthedocs.io/en/1.1/requirements.html>`_
(using the same syntax that you would normally use for pip) and then start up
PyPIcky by using the ``pypicky`` command and passing it the name of the
requirements file as a command-line argument::

    pypicky requirements.txt

This will start up a small web server, and will print out a line such as::

    Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

You can then call pip with::

    pip install --index-url http://127.0.0.1:5000/ astropy

and this will then install the requested packages and all dependencies, ignoring
packages excluded by the requirements file.

This can then be used for example with other tools that support PyPI index URLs,
such as `tox <https://tox.readthedocs.io/en/latest/>`_.

Caveats/warnings
----------------

If a package is already installed, pip will not try installing it again. This
means that if e.g. you try and run pip as described above, but the package you
are trying to install (or any of its dependencies) is already installed, no
matter how recent the version, it will not be installed again. Therefore, I
recommend using pip with the custom index URL inside a clean environment (but
you can run the pypicky command inside your regular environment.)
behsareport 0.4.1
A simple CLI to convert markdown files to HTML using GitHub API using the GitHub Markdown style.
Requires Python: >=3.6
Keywords: markdown, github, cli, html, converter

# ghmd

ghmd (GitHub Markdown) is an extremely light-weight and simple command line tool to convert GitHub Flavored Markdown (or [plain Markdown](#no-gfm)) to HTML.

It does so by using the [GitHub Markdown API](https://docs.github.com/en/free-pro-team@latest/rest/reference/markdown) in combination with [GitHub Markdown CSS](https://github.com/sindresorhus/github-markdown-css).

## Installation

```bash
pip install ghmd
```

## Usage

Simply run `ghmd` with the path to the markdown file(s) you want to convert. An HTML file will be created in the same directory as the markdown file with the same filename.

```bash
ghmd README.md
# or
ghmd README.md CONTRIBUTING.md
```

> [!NOTE]
> If you don't have the `ghmd` command available after installing, you may need to add the Python scripts directory to your PATH environment variable.
>
> Otherwise you, can use `python -m ghmd` instead of `ghmd`.

## Options

### GitHub API Token

By default, ghmd uses unauthenticated requests to the GitHub API, which has a rate limit of 60 requests per hour. To increase this limit to 5000 requests per hour, you can set the `GITHUB_TOKEN` environment variable with a GitHub personal access token:

```bash
export GITHUB_TOKEN=your_github_token_here
ghmd README.md
```

To create a personal access token, visit your [GitHub Settings > Developer Settings > Personal access tokens](https://github.com/settings/tokens) and create a new token (no specific scopes are required).

### `--embed-css`

By default, ghmd will add the remote CSS as a `<link>` tag in the HTML file. If you want to embed the CSS directly into the HTML file so that, for example, you can send the HTML file to someone else and they can view it without an internet connection, you can use the `--embed-css` option.

```bash
ghmd README.md --embed-css
```

### `--light` and `--dark`

The default CSS styles adapt to the system's dark mode setting of the reader. If you want to force the CSS to be light or dark, you can use the `--light` or `--dark` options.

```bash
ghmd README.md --light
# or
ghmd README.md --dark
```

Both `--light` and `--dark` can be used in combination with `--embed-css`.

> [!NOTE]
> Using the `--embed-css` option will result in a ~25 KB larger HTML file size (~18 KB when using `--light` or `--dark`).

### `--no-gfm`

The tool offers two modes: GitHub Flavored Markdown (gfm, default) and plain Markdown. To use the later, the `--no-gfm` option can be used:

```bash
ghmd README.md --no-gfm
```