README.md

# ThatLib

![](https://raw.githubusercontent.com/juancarlospaco/thatlib/nim/thatlib-logo.jpg "Faster pathlib for Python")

[![Benchmark Results](https://raw.githubusercontent.com/juancarlospaco/thatlib/nim/results_graph.png "Benchmark Results")](https://youtu.be/QiKwnlyhKrk?t=5)

![](https://img.shields.io/github/languages/top/juancarlospaco/thatlib?style=for-the-badge)
![](https://img.shields.io/github/languages/count/juancarlospaco/thatlib?logoColor=green&style=for-the-badge)
![](https://img.shields.io/github/stars/juancarlospaco/thatlib?style=for-the-badge)
![](https://img.shields.io/github/languages/code-size/juancarlospaco/thatlib?style=for-the-badge)
![](https://img.shields.io/github/issues-raw/juancarlospaco/thatlib?style=for-the-badge)
![](https://img.shields.io/github/issues-pr-raw/juancarlospaco/thatlib?style=for-the-badge)
![](https://img.shields.io/github/last-commit/juancarlospaco/thatlib?style=for-the-badge)


# Using Pathlib can make your project +50x Slower

[![Using Pathlib can make your project 50x Slower](https://img.youtube.com/vi/tFrh9hKMS6Y/0.jpg)](https://www.youtube.com/watch?v=tFrh9hKMS6Y)


# Use

- Same API as `pathlib`, nothing new to remember.
- [See the examples folder (20+ simple tiny examples).](https://github.com/juancarlospaco/thatlib/tree/nim/examples)
- https://juancarlospaco.github.io/thatlib


# Type-safe DotEnv

Thatlib has builtin support for Type-safe `.env`. Type-safe `.env` file is just a `.env` but Typed.

Types are enforced via a comment, so it is still a "vanilla" `.env`.

Type-safe `.env` file can be used with unsafe `.env` parsers, legacy parsers will ignore the comment.

Keys must be a non-empty ASCII string `[a-zA-Z0-9_]`, keys are validated. Key-Value separator must be `=`.

Parses the same `.env` file from the vanilla implementation tests.

Several orders of magnitude faster than the vanilla implementation. Implementation is ~ 50 lines of code.

Examples:

```ini
# This is a comment
DB_HOST=localhost  # string
DB_USER=root       # string
DB_PASS="123"      # string
DB_TIMEOUT=42      # int
DELAY=3.14         # float
ACTIVE=true        # bool
```

- `.env` file example https://github.com/juancarlospaco/thatlib/blob/nim/examples/.env
- Python use example https://github.com/juancarlospaco/thatlib/blob/nim/examples/example_dotenv.py


# Requisites

- Python 1.x or 2.x or 3.x, 64Bit, CPython implementation.


# PYPI

- https://pypi.org/project/thatlib


# Dependencies

- None.


# 💰➡️🍕

<details> 
<summary title="Send Bitcoin"><kbd> Bitcoin BTC </kbd></summary>

**BEP20 Binance Smart Chain Network BSC**
```
0xb78c4cf63274bb22f83481986157d234105ac17e
```
**BTC Bitcoin Network**
```
1Pnf45MgGgY32X4KDNJbutnpx96E4FxqVi
```
**Lightning Network**
```
juancarlospaco@bitrefill.me
```  
</details>

<details> 
<summary title="Send Ethereum and DAI"><kbd> Ethereum ETH </kbd> <kbd> Dai DAI </kbd> <kbd> Uniswap UNI </kbd> <kbd> Axie Infinity AXS </kbd> <kbd> Smooth Love Potion SLP </kbd> <kbd> Uniswap UNI </kbd> <kbd> USDC </kbd> </summary>

**BEP20 Binance Smart Chain Network BSC**
```
0xb78c4cf63274bb22f83481986157d234105ac17e
```
**ERC20 Ethereum Network**
```
0xb78c4cf63274bb22f83481986157d234105ac17e
```
</details>
<details> 
<summary title="Send Tether"><kbd> Tether USDT </kbd></summary>

**BEP20 Binance Smart Chain Network BSC**
```
0xb78c4cf63274bb22f83481986157d234105ac17e
```
**ERC20 Ethereum Network**
```
0xb78c4cf63274bb22f83481986157d234105ac17e
```
**TRC20 Tron Network**
```
TWGft53WgWvH2mnqR8ZUXq1GD8M4gZ4Yfu
```
</details>
<details> 
<summary title="Send Solana"><kbd> Solana SOL </kbd></summary>

**BEP20 Binance Smart Chain Network BSC**
```
0xb78c4cf63274bb22f83481986157d234105ac17e
```
**SOL Solana Network**
```
FKaPSd8kTUpH7Q76d77toy1jjPGpZSxR4xbhQHyCMSGq
```
</details>
<details> 
<summary title="Send Cardano"><kbd> Cardano ADA </kbd></summary>

**BEP20 Binance Smart Chain Network BSC**
```
0xb78c4cf63274bb22f83481986157d234105ac17e
```
**ADA Cardano Network**
```
DdzFFzCqrht9Y1r4Yx7ouqG9yJNWeXFt69xavLdaeXdu4cQi2yXgNWagzh52o9k9YRh3ussHnBnDrg7v7W2hSXWXfBhbo2ooUKRFMieM
```
</details>
<details> 
<summary title="Send Sandbox"><kbd> Sandbox SAND </kbd> <kbd> Decentraland MANA </kbd></summary>

**ERC20 Ethereum Network**
```
0xb78c4cf63274bb22f83481986157d234105ac17e
```
</details>
<details> 
<summary title="Send Algorand"><kbd> Algorand ALGO </kbd></summary>

**ALGO Algorand Network**
```
WM54DHVZQIQDVTHMPOH6FEZ4U2AU3OBPGAFTHSCYWMFE7ETKCUUOYAW24Q
```
</details>
<details> 
<summary title="Send Polkadot"><kbd> Polkadot DOT </kbd></summary>

**DOT Network**
```
13GdxHQbQA1K6i7Ctf781nQkhQhoVhGgUnrjn9EvcJnYWCEd
```
**BEP20 Binance Smart Chain Network BSC**
```
0xb78c4cf63274bb22f83481986157d234105ac17e
```  
</details>
<details> 
<summary title="Send via Binance Pay"> Binance </summary>
  
[https://pay.binance.com/en/checkout/e92e536210fd4f62b426ea7ee65b49c3](https://pay.binance.com/en/checkout/e92e536210fd4f62b426ea7ee65b49c3 "Send via Binance Pay")
</details>


# Stars

![](https://starchart.cc/juancarlospaco/thatlib.svg)
:star: [@juancarlospaco](https://github.com/juancarlospaco '2022-02-16')	
:star: [@hamidb80](https://github.com/hamidb80 '2022-02-16')	
:star: [@nikitavoloboev](https://github.com/nikitavoloboev '2022-02-16')	
:star: [@mxschmitt](https://github.com/mxschmitt '2022-02-17')	
:star: [@harrtho](https://github.com/harrtho '2022-02-17')	
:star: [@kangkot](https://github.com/kangkot '2022-04-12')	
:star: [@crox-safe](https://github.com/crox-safe '2022-04-13')	
:star: [@carno](https://github.com/carno '2022-06-01')	
:star: [@xdroff](https://github.com/xdroff '2022-06-01')	
:star: [@tumregels](https://github.com/tumregels '2022-06-18')	
:star: [@Pebaz](https://github.com/Pebaz '2022-07-17')	
:star: [@Siss3l](https://github.com/Siss3l '2022-11-19')	
:star: [@daweedkob](https://github.com/daweedkob '2022-11-19')	
:star: [@xilicode](https://github.com/xilicode '2022-11-25')	
:star: [@pietroppeter](https://github.com/pietroppeter '2023-01-20')	
:star: [@linwaytin](https://github.com/linwaytin '2023-01-22')	
:star: [@thomas-mckay](https://github.com/thomas-mckay '2023-06-09')	
:star: [@hansalemaos](https://github.com/hansalemaos '2023-08-07')	
:star: [@benzolium](https://github.com/benzolium '2023-08-09')	
:star: [@T145](https://github.com/T145 '2023-08-13')	
:star: [@Xynonners](https://github.com/Xynonners '2023-08-13')	
:star: [@BlackNurse](https://github.com/BlackNurse '2023-08-19')	
:star: [@xjzh123](https://github.com/xjzh123 '2023-10-11')	
:star: [@JoeBarouneD](https://github.com/JoeBarouneD '2023-12-17')	
:star: [@wrath-codes](https://github.com/wrath-codes '2025-01-12')