otsutil 2.8.3

A library of self-made functions to be reused.

otsutil

よく使う自作関数、クラスを纏めたパッケージです。

発生したトラブル等に当方は一切責任を負いません。

使用は自己責任でお願いします。

目次

• otsutil
  • 目次
  • インストール
    • pip
    • pipenv
• モジュール
  • funcs
    • 概要
    • 機能
      • フォルダ選択ダイアログから Path オブジェクトを取得
      • ファイル選択ダイアログから Path オブジェクトを取得
      • ファイルやフォルダの名前に使用できる文字列に変換
      • 外部ファイルからオブジェクトを読み込む
      • 外部ファイルにオブジェクトを保存する
      • リスト等から重複を取り除いたリストを生成する
      • リスト等から重複を取り除いて 1 行ずつ外部ファイルに書き出す
      • 質問を行い真偽値の回答を取得する
      • 入力を受け取り指定した型に変換する
      • 辞書オブジェクトから例外を起こさずに値を取得する
      • 標準出力で進捗表示など同じ行を使いまわす
      • 標準出力でキーワード引数を指定形式で出力する
      • 関数の平均実行時間を求めるラッパー
  • pickle_dict
    • 概要
    • 使い方
      • 管理オブジェクトの生成
      • 要素の追加・変更
        • add
        • rewrite
        • 辞書風に追加
      • 要素の削除
        • remove
        • del
      • 一覧の取得・出力
        • キーと値の一覧の出力
        • キー一覧の取得
        • 値の一覧の取得
      • キーの存在確認
      • 要素数の確認
      • iter
• 制作環境

インストール

pip

インストール

pip install otsutil

更新

pip install otsutil -U

アンインストール

pip uninstall otsutil

pipenv

インストール

pipenv install otsutil

更新

pipenv update otsutil

アンインストール

pipenv uninstall otsutil

モジュール

funcs

概要

自作関数を纏めたモジュールです。

機能

フォルダ選択ダイアログから Path オブジェクトを取得

choice_dir(title=None)

ディレクトリ選択ダイアログを表示し、選択されたディレクトリのPathを返します。

ディレクトリが選択されなかった場合、呼び出し元オブジェクトのPath返ります。

• title: ダイアログのタイトルです。

ファイル選択ダイアログから Path オブジェクトを取得

choice_file(*types, title=None, multi=False, strict=True)

ファイル選択ダイアログを表示し、選択されたファイルのPathを返します。

• types(str): 拡張子でフィルターを掛けることができます。 *.binファイルだけ選択できるようにするためにはbinを設定してください。 複数設定すると、フィルターを追加できます。
• title(str): ダイアログのタイトルです。
• multi(bool): True にすると、複数ファイルが選択できるようになります。 また、戻り値がlist[Path]に変わるので注意してください。 これは選択されたオブジェクトが結果的に一つであっても変わりません。
• strict(bool): ファイルの選択がキャンセルされたとき、NotSelectedErrorを投げます。 Falseにすると、例外を投げる代わりにNoneを返すようになります。

ファイルやフォルダの名前に使用できる文字列に変換

create_system_name(name, *, dir_mode=True)

ファイル名、及びフォルダ名に使用できない文字を使用可能な文字に置き換えた文字列を返します。

標準ではフォルダモードで動作します。
フォルダモードでは、末尾の.を消去します。

また、先頭と末尾の空白は除去され、2文字以上の連続した半角空白は半角空白1つに変換されます。

また、name=''のような場合にはValueErrorを、
加工をし、最終的にreturn ''になる場合にはInvalidStringErrorがそれぞれ投げられます。

• name(str): ファイル名、フォルダ名に使用したい文字列です。
• dir_mode(bool): フォルダモードです。

使い方

string = 'A: b....c....'
dir_mode_result = create_system_name(string)
not_dir_mode_result = create_system_name(string, dir_mode=False)
print('dir_mode_result:', dir_mode_result)
print('not_dir_mode_result:', not_dir_mode_result)
"""
dir_mode_result: A： b....c
not_dir_mode_result: A： b....c....
"""

例外発生の補足

p = lambda x: print(f'<<{x}>>')  # 出力用の無名関数

valid_string = '  A....B....&C.......'
invalid_string1 = ''
invalid_string2 = '  .  　'
invalid_string3 = ' . . . . '

p(create_system_name(valid_string))
p(create_system_name(valid_string, dir_mode=False))
p(create_system_name(invalid_string2, dir_mode=False))
p(create_system_name(invalid_string3, dir_mode=False))

# p(create_system_name(invalid_string1))  # ValueError
# p(create_system_name(invalid_string2))  # InvalidStringError
# p(create_system_name(invalid_string3))  # InvalidStringError
"""
<<A....B....＆C>>
<<A....B....＆C.......>>
<<.>>
<<. . . .>>
"""

外部ファイルからオブジェクトを読み込む

load_object(file, *, encoding='utf-8')
外部ファイルからオブジェクトを読み込みます。

この関数はsave_objectで保存したオブジェクトの読み込みを想定しています。

ファイルに保存されているオブジェクトは単一である必要があります。
複数のオブジェクトを扱いたい場合は、pickle_dictを使用してください。

• file(str or Path): 読み込むファイルです。
• encoding(str): 外部ファイルのエンコードです。

外部ファイルにオブジェクトを保存する

save_object(obj, file, *, encoding='utf-8', protocol=4)

オブジェクトを外部ファイルに保存します。
pickleで保存できないオブジェクトには未対応です。

読み込みにはload_objectの使用を想定しています。

この関数で保存されるオブジェクトは単一です。
複数のオブジェクトを扱いたい場合は、pickle_dictを使用してください。

• obj(object): 保存したいオブジェクトです。
• file(str or Path): 書き出し先のファイルです。
• encoding(str): 外部ファイルのエンコードです。
• protocol(int): pickleで使用するプロトコルです。

リスト等から重複を取り除いたリストを生成する

deduplicate(list_)

リスト等から重複を除去します。

順番を保持するので、set()で順番を破壊したくない際に使用できます。
type(list_) is strの場合、文字列から重複が除去されてしまうので注意してください。

• list_(iter): 重複を除去したいオブジェクト。

リスト等から重複を取り除いて 1 行ずつ外部ファイルに書き出す

deduplicate_file(file=None, *adds, show_result=False, encoding='utf-8', strict=True)

txtファイルから重複行と空行を取り除きます。

• file(str or Path): 対象のファイルです。

• adds(tuple): 渡したオブジェクトをそれぞれstr()してファイルの先頭に追加します。

• show_result(bool): 何行削除したか結果を表示します。

• encoding(str): 外部ファイルのエンコードです。

• strict(bool): 特定条件で例外を投げます。

  例外の発生条件

  • 引数fileがNone時に表示されるダイアログでファイルを選択しない、かつ、strict=True。
  • fileが存在せず、かつ、addsに値が存在しない、かつ、strict=True。
  • fileの拡張子が.txt以外、かつ、strict=True。

使い方

# テストファイル生成用関数
def create_testfile():
    lines = [1, 3, 3, 3, 5, 5, 5, 5, 5, 7, 7, 7, 7, 7, 7, 7, 9, 9, 9, 9, 9, 9, 9, 9, 9, 0, 2, 2, 4, 4, 4, 4, 6, 6, 6, 6, 6, 6, 8, 8, 8, 8, 8, 8, 8, 8]
    with open('test.txt', 'w') as f:
        f.write("\n".join(map(str, lines)))

# 存在するファイルから重複除去
create_testfile()
deduplicate_file('test.txt', show_result=True, strict=True)
"""
36行削除しました。
"""
# test.txtの中身は[1, 3, 5, 7, 9, 0, 2, 4, 6, 8]の改行区切り


# 存在するファイルに要素を追加して重複除去
create_testfile()
deduplicate_file('test.txt', *range(10), show_result=True, strict=True)
"""
46行削除しました。
"""
# test.txtの中身は[0, 1, 2, 3 , 4, 5, 6, 7, 8, 9]の改行区切り

# 存在しないファイルに要素を追加して除去
not_exists_file = 'test2.txt'
deduplicate_file(not_exists_file, *['odd' if x % 2 else x for x in range(10)], show_result=True, strict=True)
"""
4行削除しました。
"""
# test2.txtの中身は[0, odd, 2, 4, 6, 8]の改行区切り

# 存在しないファイルから重複除去
not_exists_file = 'test2.txt'
deduplicate_file(not_exists_file, show_result=True, strict=True)
"""
.
.
.
...
FileNotFoundError: test2.txtは存在しません。
"""

質問を行い真偽値の回答を取得する

confirm(message, use_gui=True, prompt='>')

はい、いいえで答えられるような質問を行ってユーザーからの回答をbool値として取得します。

use_guiが有効の場合、質問をtkinter.messagebox.askyesnoで行います。
無効の場合は標準出力で質問を行います。
また、その場合は[yes, y, はい, ハイ, no, n, いいえ, イイエ]以外の入力は受け取りません。

※大文字、小文字は区別されません。前後の空白は除去されます。

• message(str): 質問文です。
• use_gui(bool): 質問を GUI で行うか、標準出力で行うかです。
• prompt (str): 標準出力で質問する時のプロンプト文字列です。

入力を受け取り指定した型に変換する

type_input(convert_type=str, message="", prompt='>', allow_empty=False)

ユーザーからの入力を受け取り、指定した型に変換した値を返します。
変換が正常に行われる文字列を受け取るまで、この処理が継続されます。

変換可能な型は、__call__で文字列からの変換が定義されているものになります。

• convert_type(type): 変換する型です。
• message(str): ユーザーへの入力を促すメッセージです。
• prompt(str): ユーザーへの入力を促すメッセージの末尾です。
• allow_empty(bool): 空文字列を受け取った場合 None を返して終了するかです。

辞書オブジェクトから例外を起こさずに値を取得する

get_dict_in_value(dict_)

辞書オブジェクトから例外を起こさずに値を取得する関数です。

初めに引数dict_を与えるとdict_から値を取得するための_(key)関数を返します。
この関数は__getitem__が定義されているクラスであれば動作する場合があります。

• dict_(dict): 辞書オブジェクトです。
• _(function): 値取得用関数です。
  • key(str): 取得したいキーです。

使い方

# テスト用辞書
sample_dict = {'test1': 1, 'test2': 'test2', 'test3': 3.0}

# 読み込み用関数の取得
getter = get_dict_in_value(sample_dict)

# get_dict_in_value(sample_dict)の戻り値の型
getter_type = type(getter)

# 存在するキーの取得
get_exists_key = getter('test2')

# 存在しないキーの取得
get_not_exists_key = getter('test4')

# 変数の内容を出力
print(f'{sample_dict=}')
print(f'{getter_type=}')
print(f'{get_exists_key=}')
print(f'{get_not_exists_key=}')
"""
sample_dict={'test1': 1, 'test2': 'test2', 'test3': 3.0}
getter_type=<class 'function'>
get_exists_key='test2'
get_not_exists_key=None
"""

標準出力で進捗表示など同じ行を使いまわす

fline(text='', end=False)

標準出力で同じ行を更新したい時などに使える関数です。

textにオブジェクトを渡すとstr(text)してから出力されます。
endをTrueにすることで出力後に改行します。

fline(1) # 直後の2に上書きされる。
fline(2, True)
fline(3)
"""
2
3
"""

標準出力でキーワード引数を指定形式で出力する

parg(__space__=' = ', __sep__='\n', __repr__=False, **kwargs)

標準出力でキーワード引数の内容を出力したい時に使える関数です。
__space__でキーと値間に挿入する文字列を指定し、
__sep__でキー間に挿入する文字列を指定することができます。
また、__repr__=Trueでキーと値をreprした値に変更することができます。

parg(test1=100, test2='100')
parg(test1=100, test2='100', __repr__=True)
parg(test1=100, test2='100', __space__=': ', __sep__=',\t')
"""
test1 = 100
test2 = 100
'test1' = 100
'test2' = '100'
test1: 100,     test2: 100
"""

関数の平均実行時間を求めるラッパー

@watch_exec_time(count=1)

引数countに与えた回数だけデコレートした関数を実行し、関数名、実行回数、実行時間の平均を出力します。
また、(実行時間の平均, 最後に関数を実行した際の戻り値)のタプルを返します。

countに1未満の数またはint(count)した際に例外が発生するような値を指定することはできません。

import time


@watch_exec_time()
def sub(x, y):
    time.sleep(0.00001)  # 所要時間が短すぎると0になるので
    return x - y


@watch_exec_time(10)
def add(x, y):
    time.sleep(0.00001)  # 所要時間が短すぎると0になるので
    return x + y


sub_average_time, sub_result = sub(10, 1)
add_average_time, add_result = add(x=30, y=1)

print('sub_average_time:', sub_average_time)
print('sub_result:', sub_result)
print('add_average_time:', add_average_time)
print('add_result:', add_result)

"""
subを1回実行した結果、実行時間の平均は0.0010051727294921875秒となりました。
addを10回実行した結果、実行時間の平均は0.0017982721328735352秒となりました。
sub_average_time: 0.0010051727294921875
sub_result: 9
add_average_time: 0.0017982721328735352
add_result: 31
"""

pickle_dict

概要

このモジュールではpickleでのオブジェクト管理を辞書オブジェクト風に行えるようにする為のPDictクラスを定義しています。

使い方

管理オブジェクトの生成

PDict(file, reset_data=False)

以降紹介する方法は、ここで紹介する方法のどちらかを実行してから行ってください。

オブジェクト生成時にreset_data=Trueを設定すると既存の管理ファイルを初期化してから開始します。

• file(str or Path): 管理ファイルです。
• reset_data(bool): 管理ファイルが既に存在する場合に初期化するかです。

# インポートします。
from otsutil.pickle_dict import PDict

# 利用するファイルを設定します。
file = 'pdata/ptest.bin'

# with文で生成(推奨)
with PDict(file) as p:
  # このブロックで以降紹介する処理を記述します。

# 変数に代入して生成
p = PDict(file)
# 以降紹介する処理を記述します。
p.close()  # ファイルの保守を行います。

要素の追加・変更

追加には 2 つの方法があり、1 つのシンタックスシュガーがあります

add

add(**kargs)

追加専用メソッド。

このメソッドでは未定義のキーに要素を追加することができます。
複数キーを同時に定義することもできます。
既存のキーを指定した場合、警告を出力し、上書きは行われません。

• kargs: key=object。

# 要素の追加
p.add(test1='add')

# 複数要素の追加
p.add(test2=2, test3=3.0)

# 定義済みのキーに要素を追加しようとする
p.add(test1=1)

# 出力。
p.show_all()
"""
[key='test1']の追加に失敗しました。
既に存在するキーです。
このキーを上書きしたい場合は、[rewrite]メソッドを使用してください。
test1: add
test2: 2
test3: 3.0
"""

rewrite

rewrite(key, value, *, allow_add)

追加・変更可能メソッド。

このメソッドでは既存キーの値を上書きすることができます。
このメソッドでは既存キーにも影響を与えられる性質上、ヒューマンエラー対策で一つずつしか変更できません。

• key(str): 対象のキーです。
• value(object): 保存するオブジェクトです。
• allow_add(bool): 存在しないキーの追加を許可するかです。

p.rewrite('test2', '書き換え')
p.rewrite('test4', 'rewriteで追加')
p.show_all()
"""
test1: add
test2: 書き換え
test3: 3.0
test4: rewriteで追加
"""

辞書風に追加

シンタックスシュガー。

内部的にはrewrite(key="test1", value=1, allow_add=True)されています。

p['test1'] = '辞書風に書き換え'
p['test5'] = '辞書風に追加'
p.show_all()
"""
test1: 辞書風に書き換え
test2: 書き換え
test3: 3.0
test4: rewriteで追加
test5: 辞書風に追加
"""

要素の削除

要素の削除はdel文とremoveメソッドで行えます。

remove

remove(key)

指定したキーを削除します。

キーを削除したあと管理ファイルの保守処理を呼び出します。
存在しないキーを指定した場合何もしません。

• key(str): 削除するキーです。

p.remove('test1')
p.show_all()
"""
test2: 書き換え
test3: 3.0
test4: rewriteで追加
test5: 辞書風に追加
"""

del

シンタックスシュガー。

内部的にはremove(key='test4')されています。

del p['test4']
p.show_all()

一覧の取得・出力

キーと値の一覧の出力

show_all()

このメソッドでは保存しているオブジェクトの一覧を出力します。

{key}: {value}という形で 1 行ずつ出力します。
{value}は文字列として出力されるので型によっては意味の分からない出力になる可能性があります。

p.show_all()
"""
test2: 書き換え
test3: 3.0
test5: 辞書風に追加
"""

キー一覧の取得

get_keys()

p.keysでも取得することができますが、pop()やdelなど、リストに変更を加えると、管理オブジェクトに影響が出てしまうので、こちらを利用してください。

keys = p.get_keys()
print(f'{keys=}')
"""
keys=['test2', 'test3', 'test5']
"""

値の一覧の取得

values()

一つのリストに全てのオブジェクトを格納して返すので、メモリを圧迫する可能性があります。
使用は推奨しません。

values = p.values()
print(f'{values=}')
"""
values=['書き換え', 3.0, '辞書風に追加']
"""

キーの存在確認

キーの存在確認にはhas_keyかin文が使えます。

内部的には等価です。

# 'test1'の確認
has_test1 = p.has_key('test1')
in_test1 = 'test1' in p

# 'test2'の確認
has_test2 = p.has_key('test2')
in_test2 = 'test2' in p
"""
has_test1=False
in_test1=False
has_test2=True
in_test2=True
"""

要素数の確認

len(p)

管理しているオブジェクトの数を取得できます。

p.show_all()
length = len(p)
print(f'{length=}')
"""
test2: 書き換え
test3: 3.0
test5: 辞書風に追加
length=3
"""

iter

for文では key を一つずつ取り出します。

for key in p:
  print(f'{key=}')
"""
key='test2'
key='test3'
key='test5'
"""

制作環境

• バージョン情報
  • プロセッサ Intel(R) Core(TM) i7-3630QM CPU @ 2.40GHz 2.40GHz
  • 実装 RAM 8.00GB (7.88GB 使用可能)
  • システムの種類 64 ビットオペレーティングシステム、x64 ベースプロセッサ
• Windows の仕様
  • エディション Windows 10 Home
  • バージョン 1809
  • OS ビルド 17763.864