semvec/pypi-packages huggingface dataset:
birdfeeder-coinalpha 1.4.1
Helper library for CoinAlpha projects
License: MIT
Requires Python: <4.0,>=3.8

# birdfeeder

Helper library for CoinAlpha projects

## Usage

The library is published to pypi as [birdfeeder-coinalpha](https://pypi.org/project/birdfeeder-coinalpha/)

### Installing

```
pip install birdfeeder-coinalpha
```

```
poetry add 'birdfeeder-coinalpha@^1'
```


### How to install old versions

In pyproject.toml:

```
birdfeeder-coinalpha = { git = "https://github.com/coinalpha/birdfeeder.git", branch = "master" }
birdfeeder-coinalpha = { git = "https://github.com/coinalpha/birdfeeder.git", rev = "29cdd7229d0d35a989322f5026382400d1332da4" }
birdfeeder-coinalpha = { git = "https://github.com/coinalpha/birdfeeder.git", tag = "0.1.0" }
```

pip:

```
git+https://github.com/coinalpha/birdfeeder.git@master#egg=birdfeeder
git+https://github.com/coinalpha/birdfeeder.git@29cdd7229d0d35a989322f5026382400d1332da4#egg=birdfeeder
git+https://github.com/coinalpha/birdfeeder.git@0.1.0#egg=birdfeeder
```


## Development

To install library for development in conda environment, run

```
./install
```

Alternativelly (preferred), you can use poetry env:

```
poetry install
poetry shell
```

## How to add a dependency

1. If you're running in conda, you need to install required package first.
1. Then, see installed version in `conda env export`
1. Take this version and add into pyproject.toml, into `[tool.poetry.dependencies]` (or dev section, if the package is needed for development only). Specify version (or range) according to [Dependency Specification](https://python-poetry.org/docs/dependency-specification/)

If using poetry:

1. Run `poetry add <package>`

## Releasing a new version

Idea: we're keeping own version and dependencies info in `pyproject.toml`, and then generating `setup.py` so that the library could be installed via tools like pip. We're also generating `environment.yml` file because we're mostly using conda to manage development environments at CoinAlpha.

1. Change version in `pyproject.toml` and `birdfeeder/__init__.py`
1. Generate `setup.py`: `dephell deps convert`
1. Generate `environment.yml`: `poetry2conda --dev pyproject.toml environment.yml`
1. Commit updates `git add -u && git commit`
1. Create git tag `x.y.z`: `git tag -s x.y.z`
1. Run `git push && git push --tags`
1. Publish to pypi: `poetry publish --build`
named-ids 0.1.0
Human-readable unique identifiers
License: MIT
Requires Python: >=3.6

# Named IDs

A Python module for generating human-readable unique identifiers.

## Installation

```bash
pip install named_ids
```

## Usage

The default size is "small" (adjective + noun). Here's how to use the module:

```python
import named_ids

# Optional. Set a seed for reproducible results
random.seed(42)

# Optional. Only needed if you want to use a different size than the default (small)
named_ids.set("large")

# Generate ID
print(named_ids.next())

# Or just sample 
print(named_ids.sample()) # defaults to the one set
print(named_ids.sample("huge")) # can also set the size
```

`next()` ensures unique IDs by stepping through combinations sequentially. `sample()` provides random IDs without maintaining sequence.

## Size Options

| Name   | Pool Size           | Components               | Example             |
|--------|---------------------|--------------------------|---------------------|
| tiny   | 1,5 thousand               | noun                     | `queen`             |
| small  | 2 million           | adjective + noun         | `red_queen`         |
| medium | 2 billion       | adjective + noun + verb  | `red_queen_bomb`  |
| large  | 624 billion     | adjective + noun + verb + adverb | `red_queen_bomb_carefully` |
| huge   | 623 trillion | number + adjective + noun + verb + adverb | `371_red_queen_bomb_carefully` |

## License

MIT