Metadata-Version: 2.4
Name: zanafacils
Version: 0.2.3
Summary: A Python package bundling casual facilities used by the author
Author: Norbert C. Maier
License-Expression: BSD-3-Clause
Project-URL: Homepage, https://gitlab.com/normai/zanafacilsdev
Keywords: configuration,I/O functions,string functions,utilities
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: license.txt
Dynamic: license-file

<!-- title = 'ZanaFacils'; favicon = './imgs/20260630o0814.tikigiki-screw-002.v1.svg'; -->

<img src="./imgs/20260630o0814.tikigiki-screw-002.v1.svg" class="lmp-img-logo-top-right" width="184" height="184" alt="Logo 20260630°0814">

<div markdown="1" class="lmp-box-nav-menuitems">
 <span class="CurrentChapter">[Projects](./../../../blogdev/trunk/projects.md)</span> →
 <span class="CurrentPage">[ZanaFacilsDev](./README.md)</span> →
 [Changelog](./~changelog.md)
 [Issues](./~issues.md)
 [Notes](./~notes.md)
</div>

# ZanaFacilsDev <sup>v0.2.3</sup> <span class="lmp-title-type">Project</span>

## 1. Overview

Synopsis:
- **Slogan** : A Python package bundling casual facilities used by the author
- **Description** : ZanaFacils is a Python package with facilities for my personal projects.
- **License** : BSD 3-Clause, see [src/filehiker/license.txt](./src/filehiker/license.txt)
- **Copyright** : © 2025 – 2026 Norbert C. Maier
- **System** : Written and tested with Python 3.13 on Windows. Should largely work
                 on Linux/Mac, except some specific keyboard functions
- **Dependencies** : None
- **Motivation** : Diverse casual utilities have amounted, and I like to make a neat pack of them
- **Development Status** : Applicable

Here is the development area. For the user´s Readme in the installed
 package see [zanafacils/README.md](./zanafacils/README.md)

ZanaFacils contains the following the modules:

- [**configur**](./zanafacils/configur.py) — Configuration facility to read/write INI files

- [**iout**](./zanafacils/iout.py) — Some primitive input/output helpers …

- [**itools**](./zanafacils/itools.py) — Some common string operations …

- [**kbdmenu**](./zanafacils/kbdmenu.py) — Keyboard menu helpers …

- [**kieboard**](./zanafacils/kieboard.py) — Some primitive keyboard helpers …

- [**timero**](./zanafacils/timero.py) — Some timer helpers …

- [**timstamps**](./zanafacils/timstamps.py) — Some timestamp readers and formatters …

BTW. About the **package layout** see [notes.md](./~notes.md#id20260631o0723),
 Zana is using the [Semi-Flat-Layout](./~notes.md#id20260631o0727).

BTW. Occasional legastenic typos in identifier names come with the advantage
 to make text search for such identifiers much easier.

## 2. Usage

Install ZanaFacils either from PyPi.org (not yet available) with

```
 > python.exe -m pip install zanafacils
```

or — if you have the sources on your drive — as a local editable development package.
In the console go to the parent folder `zanafacilsdev` and issue the following command:

```
 zanafacilsdev> python.exe -m pip install -e .
```

## 3. API (Application Programmers Interface)

&nbsp;

&nbsp;

&nbsp;

&nbsp;

… ahem …

&nbsp;

&nbsp;

&nbsp;

&nbsp;

## 4. Credits

<img class="lmp-reference-icon" src="./imgs/20260630o0814.tikigiki-screw-002.v1.svg" width="64" height="64" alt=" Icon 20260815°0743">
 The screw logo is made by Norbert after
 [openclipart.org/detail/170818/wood-screw-tools-002](https://openclipart.org/detail/170818/wood-screw-tools-002),
 which is licensed as a Public Domain dedication

&nbsp;

## 5. By the Way

The word *Zana* means 'tools' in Suaheli. *Zana* also is an Albanian fairy.

&nbsp;

---

#### 6. Fineprint

<pre>
   project 20250213°0711 ZanaFacilsDev
   objtype     :
   url         :
   title       : ZanaFacilsDev
   summary     : ZanaFacils is a Python package for miscellaneous personal utility functions
   status      :
   tags        :
   note        :
   ⬞
</pre>

<pre>
   repo 20260820°1211 ZanaFacilsDev
   canonical   : https://gitlab.com/normai/zanafacilsdev
</pre>

<sup>Page 20250213°0721 ⬞Ω</sup>
