pyw-core 0.0.0.post1__py3-none-any.whl → 0.0.0.post2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pyw-core
3
- Version: 0.0.0.post1
3
+ Version: 0.0.0.post2
4
4
  Summary: Reserved placeholder for pyw-core (umbrella namespace)
5
5
  Project-URL: Homepage, https://github.com/pythonWoods/pyw-core
6
6
  Project-URL: Documentation, https://pythonwoods.dev/docs/pyw-core/latest/
@@ -23,27 +23,37 @@ Description-Content-Type: text/markdown
23
23
  [![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
24
24
  > Namespace seed & common utilities for the **pythonWoods** ecosystem.
25
25
 
26
- ## Components
26
+ ## Ecosystem Overview
27
27
 
28
28
  | Package | Description | Status |
29
29
  |---------|-------------|--------|
30
- | **pyw-core** | Structured + colorful logging | placeholder `0.0.0` |
31
- | **pyw-fs** | Unified filesystem (local/S3/GCS) | 0.0.0 |
32
- | **pyw-secret** | Secret back-ends (.env, Vault, SSM) | 0.0.0 |
33
- | **pyw-cli** | Typer CLI scaffold | 0.0.0 |
34
- | **pyw-music21** | Music21 stubs & helpers | 0.0.0 |
35
- | **pyw-musicparser** | Parse MIDI/Lilypond | 0.0.0 |
36
- | **pyw-core** | Meta-package: install everything | 0.0.0 |
37
- | **pyw-devtools** | Bundle for devs (logger, fs, cli, secret) | 0.0.0 |
30
+ | **pyw-core** | Namespace & common utilities | placeholder `0.0.0` |
31
+ | **pyw-logger** | Structured logging (rich + structlog) | placeholder `0.0.0` |
32
+ | **pyw-fs** | Unified filesystem (local/S3/GCS) | placeholder `0.0.0` |
33
+ | **pyw-secret** | Secret backends (.env, Vault, SSM) | placeholder `0.0.0` |
34
+ | **pyw-cli** | Typer CLI scaffolding | placeholder `0.0.0` |
35
+ | **pyw-config** | Configuration utilities | placeholder `0.0.0` |
36
+ | **pyw-vision** | Vision utilities & helpers | placeholder `0.0.0` |
37
+ | **pyw-motion** | Motion detection & tracking | placeholder `0.0.0` |
38
+ | **pyw-music21** | Music21 stubs & helpers | placeholder `0.0.0` |
39
+ | **pyw-musicparser** | Parse MIDI/Lilypond | placeholder `0.0.0` |
40
+
41
+ ## Bundle Packages
42
+
43
+ | Bundle | Description | Includes |
44
+ |--------|-------------|----------|
45
+ | **pyw-devtools** | Developer toolkit | logger, fs, cli, secret |
46
+ | **pyw-music** | Music processing | music21, musicparser |
47
+ | **pyw-cv** | Computer vision | vision, motion |
38
48
 
39
49
  ## Philosophy
40
50
 
41
51
  * **Namespace package** – `import pyw.*` per evitare conflitti.
42
52
  * **Small, composable modules** – scegli solo ciò che ti serve.
43
53
  * **Typed APIs** – Pydantic / dataclass per zero sorprese.
44
- * **No heavy deps by default** – le librerie costose (Torch, OpenCV) sono extra.
54
+ * **No heavy deps by default** – le librerie "costose" (Torch, OpenCV) sono extra.
45
55
 
46
- ### Installation (nothing to use yet)
56
+ ## Installation (nothing to use yet)
47
57
 
48
58
  ```bash
49
59
  pip install pyw-core
@@ -51,6 +61,36 @@ pip install pyw-core
51
61
 
52
62
  *(Core è quasi vuoto: fornisce solo il namespace e helper comuni.)*
53
63
 
64
+ ## Usage
65
+
66
+ ```python
67
+ from pyw.core import BaseConfig, TypedDict
68
+ from pyw.core.utils import ensure_list, deep_merge
69
+
70
+ # Common utilities available across all pyw modules
71
+ config = BaseConfig()
72
+ data = ensure_list("single_item") # → ["single_item"]
73
+ merged = deep_merge(dict1, dict2)
74
+ ```
75
+
76
+ ## Bundle Installation
77
+
78
+ Per installare gruppi di moduli correlati:
79
+
80
+ ```bash
81
+ pip install pyw-devtools # logger + fs + cli + secret
82
+ pip install pyw-music # music21 + musicparser
83
+ pip install pyw-cv # vision + motion
84
+ ```
85
+
86
+ ## Roadmap
87
+
88
+ - 🏗️ **Core utilities**: Config base classes, type helpers
89
+ - 📦 **Namespace management**: Plugin discovery, module registry
90
+ - 🔧 **Development tools**: Testing utilities, debugging helpers
91
+ - 📚 **Documentation**: Sphinx integration, API reference
92
+ - 🎯 **Quality**: Type stubs, linting rules, best practices
93
+
54
94
  ## Contributing
55
95
 
56
96
  1. Fork il repo del modulo che ti interessa (`pyw-fs`, ecc.).
@@ -60,7 +100,6 @@ pip install pyw-core
60
100
 
61
101
  Felice coding nella foresta di **pythonWoods**! 🌲🐾
62
102
 
63
-
64
103
  ## Links utili
65
104
  Documentazione dev (work-in-progress) → https://pythonwoods.dev/docs/pyw-core/latest/
66
105
 
@@ -0,0 +1,5 @@
1
+ pyw/__init__.py,sha256=TAxMvzzecHUbYSemZ7gBbqi-3hYmsODLKrbmxrtbaUQ,66
2
+ pyw_core-0.0.0.post2.dist-info/METADATA,sha256=Mqcefcl_cKY1jC6C6iQ7chdWsOoGzA3gzWAOXh56csk,4082
3
+ pyw_core-0.0.0.post2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
4
+ pyw_core-0.0.0.post2.dist-info/licenses/LICENSE,sha256=Jn96Lhnfqd-Zr3dFIJhaDlIZJSk-pbfnZ6sGlp0Gv5E,12
5
+ pyw_core-0.0.0.post2.dist-info/RECORD,,
@@ -1,5 +0,0 @@
1
- pyw/__init__.py,sha256=TAxMvzzecHUbYSemZ7gBbqi-3hYmsODLKrbmxrtbaUQ,66
2
- pyw_core-0.0.0.post1.dist-info/METADATA,sha256=LphCqhvSw0LkMI0HfGQ5BQKBrRw-SA-TriXbRAW47AY,2733
3
- pyw_core-0.0.0.post1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
4
- pyw_core-0.0.0.post1.dist-info/licenses/LICENSE,sha256=Jn96Lhnfqd-Zr3dFIJhaDlIZJSk-pbfnZ6sGlp0Gv5E,12
5
- pyw_core-0.0.0.post1.dist-info/RECORD,,