zanafacils 0.2.1__tar.gz

zanafacils-0.2.1/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: zanafacils
+Version: 0.2.1
+License-File: license.txt
+Dynamic: license-file

zanafacils-0.2.1/README.md

@@ -0,0 +1,124 @@
+<!-- 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.1</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>

zanafacils-0.2.1/license.txt

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright © 2025 - 2026, Norbert C. Maier
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

zanafacils-0.2.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

zanafacils-0.2.1/setup.py

@@ -0,0 +1,17 @@
+## @file        20250308°0731 zanafacils/setup.py
+#  @brief       This file´s version number is used by the build, not that of pyproject.toml
+#  @details     How is the relation to pyproject.toml? Can one of the two be discarded?!
+#  @copyright   BSD-3-Clause License | © 2023 – 2026 Norbert C. Maier
+#  @remark      Status : First test
+#  @remark      Usage : Run pip from the parent folder of zana
+#  @see         https://chat.mistral.ai/chat/3cf237a1-78b3-4c85-b3cf-855536be9aff [ref 20250308°0724]
+#  @see         Screenshot 20250308°1735 console--pip-install-flat-editable--heureka
+#  @see         https://www.perplexity.ai/search/in-windows-i-installed-success-eavssEJ9TkCpyfncKWFTSQ [ref 20250728°1334] 👍 Quest "In Windows I installed successfully a Python package with command "pip.exe install -e .", command line "pip.exe list" does show it, but Python command "help() modules" does not show it."
+
+from setuptools import setup, find_packages
+
+setup(
+    name     = 'zanafacils',
+    version  = '0.2.1',
+    packages = find_packages(),
+)

zanafacils-0.2.1/zanafacils/__init__.py

@@ -0,0 +1,11 @@
+# file : 20250213°0727 zanafacilsdev/zanafacils/__init__.py
+# note : Content comes with chg 20250308°0717 solution of issue 20250306°1111 'ModuleNotFoundError in flat package'
+# see : https://www.perplexity.ai/search/in-windows-i-installed-success-eavssEJ9TkCpyfncKWFTSQ [ref 20250728°1334] 👍 Quest "In Windows I installed successfully a Python package with command "pip.exe install -e .", command line "pip.exe list" does show it, but Python command "help() modules" does not show it."
+
+from .configur import *
+from .iout import *
+from .itools import *
+from .kbdmenu import *
+from .kieboard import *
+from .timero import *
+from .timstamps import *