semvec/pypi-packages huggingface dataset:
naclfile 0.0.6
A python xxxFile like (ie GzipFile, BZ2File, ...) for manipulating Nacl encrypted files.
Requires Python: >=3.9

[![CircleCI](https://dl.circleci.com/status-badge/img/gh/bibi21000/NaclFile/tree/main.svg?style=shield)](https://dl.circleci.com/status-badge/redirect/gh/bibi21000/NaclFile/tree/main)
[![CodeQL](https://github.com/bibi21000/NaclFile/actions/workflows/codeql.yml/badge.svg)](https://github.com/bibi21000/NaclFile/actions/workflows/codeql.yml)
[![codecov](https://codecov.io/gh/bibi21000/NaclFile/graph/badge.svg?token=4124GIOJAK)](https://codecov.io/gh/bibi21000/NaclFile)
![PyPI - Downloads](https://img.shields.io/pypi/dm/naclfile)

# NaclFile

A python xxxFile like (ie TarFile, GzipFile, BZ2File, pyzstd.ZstdFile, ...)
for encrypting files with PyNacl SecretBox.

This project is part of the CofferFile : https://github.com/bibi21000/CofferFile.

If you're looking for a more powerfull storage for your sensible datas,
look at PyCoffer : https://github.com/bibi21000/PyCoffer.

## Install

```
    pip install naclfile
```

## Create your encryption key

```
    from nacl import utils

    key = utils.random(SecretBox.KEY_SIZE)
```
and store it in a safe place (disk, database, ...).

This key is essential to encrypt and decrypt data.
Losing this key means losing the data.

## "open" your encrypted files like normal files

Text files :

```
    from naclfile import open as nacl_open

    with nacl_open('test.nacl', mode='wt', secret_key=key, encoding="utf-8") as ff:
        ff.write(data)

    with nacl_open('test.nacl', "rt", secret_key=key, encoding="utf-8") as ff:
        data = ff.read()

    with nacl_open('test.nacl', mode='wt', secret_key=key, encoding="utf-8") as ff:
        ff.writelines(data)

    with nacl_open('test.nacl', "rt", secret_key=key, encoding="utf-8") as ff:
        data = ff.readlines()
```

Binary files :

```

    with nacl_open('test.nacl', mode='wb', secret_key=key) as ff:
        ff.write(data)

    with nacl_open('test.nacl', "rb", secret_key=key) as ff:
        data = ff.read()
```

## Crypt and compress ... for better performances.

Look at https://github.com/bibi21000/CofferFile/blob/main/BENCHMARK.md.

```
    from naclfile.zstd import open as nacl_open

    with nacl_open('test.nacz', mode='wb', secret_key=key) as ff:
        ff.write(data)

    with nacl_open('test.nacz', "rb", secret_key=key) as ff:
        data = ff.read()
```

## Crypt and compress your tar files

```
    from naclfile.tar import open as tar_open

    with tar_open('test.tarcz', mode='w', secret_key=key) as ff:
        ff.add(file1,'file1.data')
        ff.add(file2,'file2.data')

    with tar_open('test.tarcz', "r", secret_key=key) as ff:
        ff.extractall()
```

Look at documentation : https://bibi21000.github.io/NaclFile/
zangetsu-logger 0.1.1
Add your description here
Requires Python: >=3.11

# zangetsu-logger

zangetsu のロギング関連のライブラリ

## このライブラリをインストールして使用する方法

```bash
pip install zangetsu-logger
```

## 環境変数の設定

ロギング設定は環境変数で制御できます。`.env`ファイルや`export`コマンドで以下の環境変数を設定できます：

```bash
zangetsu_LOG_DIR=<ログファイルの出力ディレクトリ>
```

## ライブラリの更新

```bash
pip install --upgrade zangetsu-logger
```

## 使い方

### 基本的な使用方法

```python
from zangetsu_logger import initialize

# 基本的な初期化
logger = initialize()
logger.info("アプリケーションを開始しました")

# カスタム設定での初期化する場合
logger = initialize(
    config_path='/path/to/custom/config.yaml',  # カスタム設定がある場合
    log_level='DEBUG',  # ロギングレベルを DEBUG に設定
    app_name='my_app',  # アプリケーション名を指定
    enable_file_logging=True,  # ファイルへのログ出力を有効化
    log_dir='/path/to/logs'  # デフォルトはカレントディレクトリ
)
```

### 名前付きロガーの取得

```python
from zangetsu_logger import get_logger

# モジュール固有のロガーを取得
module_logger = get_logger('my_module')
module_logger.debug("デバッグメッセージ")
```

## `initialize()` 関数の引数詳細

| 引数名                | デフォルト値 | 説明                           | 設定例と効果                                                                                                                                              |
| --------------------- | ------------ | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `config_path`         | `None`       | カスタム設定ファイルのパス     | `/path/to/logging_config.yaml` を指定すると、デフォルト設定の代わりにそのファイルから設定を読み込みます                                                   |
| `log_level`           | `None`       | ロギングレベル                 | `'DEBUG'`: すべてのログを出力<br>`'INFO'`: 情報レベル以上のログを出力<br>`'WARNING'`: 警告レベル以上のログを出力<br>`'ERROR'`: エラーレベルのログのみ出力 |
| `app_name`            | `None`       | アプリケーション名             | 指定しない場合、呼び出し元のモジュール名が使用されます。特定の名前を付けることで、ロガーを明示的に識別できます                                            |
| `enable_file_logging` | `False`      | ファイルへのログ出力を有効化   | `True`: `zangetsu_app.log` と `zangetsu_error.log` にログを出力<br>`False`: コンソール出力のみ                                                            |
| `log_dir`             | `None`       | ログファイルの出力ディレクトリ | `/var/log/myapp` などを指定すると、指定したディレクトリにログファイルを出力                                                                               |

## 開発者向け

### ライブラリ更新手順

```toml
# pyproject.toml
version = "x.x.x" # バージョンを更新
```

```bash
git add .
git commit -m "バージョンを更新"
git tag x.x.x
git push origin master --tags
```
whatthetype 1.1
Derives type hints from data captured during runtime. Updates source files with type hints. USE SOURCE CONTROL before upating in-place!!!!

# How to use
```python
from whatthetype.whatthetype import trace, type_it_like_its_hot

def foo(i,
        x):
    return {'a': [(i + x,)]}

with trace() as data:
    foo(11, 2)
type_it_like_its_hot(data, update_files=True, backup_file_suffix=None, dump_intermediate_data=False)
```

# Result
```python
from whatthetype.whatthetype import trace, type_it_like_its_hot

def foo(i: int,
        x: int) -> dict[str, list[tuple[int]]]:
    return {'a': [(i + x,)]}

with trace() as data:
    foo(11, 2)
type_it_like_its_hot(data, update_files=True, backup_file_suffix=None, dump_intermediate_data=False)
```

# What
Inspects code at runtime, derives types from arguments and updates in-place source files with detected type hints and required imports.

# Requirements
At minimum 3.5 - I haven't tested properly.
Ideally use 3.9 or higher ( This lib supports both Union and '|' operators)

# Install
```bash
pip install whatthetype
```

# Params
```python
""" params
update_files: updates source files in place with new types, this is a destructive action! 
            If False, results json will be saved to a file with unix timestamp. 
            Default = False.
backup_file_suffix: creates backup files and adds suffix to them.
            Example: backup_file_suffix="bak" will create `foo.py.bak`. 
            Default = "bak"
dump_intermediate_data: will create 3 files with intermediate data used to derive final results. 
            Default = False
"""
```