pyw-core 0.0.0.post1__tar.gz → 0.0.0.post2__tar.gz

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,91 @@
1
+ # pyw-core 🌐
2
+ [![PyPI](https://img.shields.io/pypi/v/pyw-core.svg)](https://pypi.org/project/pyw-core/)
3
+ [![CI](https://github.com/pythonWoods/pyw-core/actions/workflows/ci.yml/badge.svg)](https://github.com/pythonWoods/pyw-core/actions/workflows/ci.yml)
4
+ [![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
+ > Namespace seed & common utilities for the **pythonWoods** ecosystem.
6
+
7
+ ## Ecosystem Overview
8
+
9
+ | Package | Description | Status |
10
+ |---------|-------------|--------|
11
+ | **pyw-core** | Namespace & common utilities | placeholder `0.0.0` |
12
+ | **pyw-logger** | Structured logging (rich + structlog) | placeholder `0.0.0` |
13
+ | **pyw-fs** | Unified filesystem (local/S3/GCS) | placeholder `0.0.0` |
14
+ | **pyw-secret** | Secret backends (.env, Vault, SSM) | placeholder `0.0.0` |
15
+ | **pyw-cli** | Typer CLI scaffolding | placeholder `0.0.0` |
16
+ | **pyw-config** | Configuration utilities | placeholder `0.0.0` |
17
+ | **pyw-vision** | Vision utilities & helpers | placeholder `0.0.0` |
18
+ | **pyw-motion** | Motion detection & tracking | placeholder `0.0.0` |
19
+ | **pyw-music21** | Music21 stubs & helpers | placeholder `0.0.0` |
20
+ | **pyw-musicparser** | Parse MIDI/Lilypond | placeholder `0.0.0` |
21
+
22
+ ## Bundle Packages
23
+
24
+ | Bundle | Description | Includes |
25
+ |--------|-------------|----------|
26
+ | **pyw-devtools** | Developer toolkit | logger, fs, cli, secret |
27
+ | **pyw-music** | Music processing | music21, musicparser |
28
+ | **pyw-cv** | Computer vision | vision, motion |
29
+
30
+ ## Philosophy
31
+
32
+ * **Namespace package** – `import pyw.*` per evitare conflitti.
33
+ * **Small, composable modules** – scegli solo ciò che ti serve.
34
+ * **Typed APIs** – Pydantic / dataclass per zero sorprese.
35
+ * **No heavy deps by default** – le librerie "costose" (Torch, OpenCV) sono extra.
36
+
37
+ ## Installation (nothing to use yet)
38
+
39
+ ```bash
40
+ pip install pyw-core
41
+ ```
42
+
43
+ *(Core è quasi vuoto: fornisce solo il namespace e helper comuni.)*
44
+
45
+ ## Usage
46
+
47
+ ```python
48
+ from pyw.core import BaseConfig, TypedDict
49
+ from pyw.core.utils import ensure_list, deep_merge
50
+
51
+ # Common utilities available across all pyw modules
52
+ config = BaseConfig()
53
+ data = ensure_list("single_item") # → ["single_item"]
54
+ merged = deep_merge(dict1, dict2)
55
+ ```
56
+
57
+ ## Bundle Installation
58
+
59
+ Per installare gruppi di moduli correlati:
60
+
61
+ ```bash
62
+ pip install pyw-devtools # logger + fs + cli + secret
63
+ pip install pyw-music # music21 + musicparser
64
+ pip install pyw-cv # vision + motion
65
+ ```
66
+
67
+ ## Roadmap
68
+
69
+ - 🏗️ **Core utilities**: Config base classes, type helpers
70
+ - 📦 **Namespace management**: Plugin discovery, module registry
71
+ - 🔧 **Development tools**: Testing utilities, debugging helpers
72
+ - 📚 **Documentation**: Sphinx integration, API reference
73
+ - 🎯 **Quality**: Type stubs, linting rules, best practices
74
+
75
+ ## Contributing
76
+
77
+ 1. Fork il repo del modulo che ti interessa (`pyw-fs`, ecc.).
78
+ 2. Crea virtual-env via Poetry: `poetry install && poetry shell`.
79
+ 3. Lancia linter e mypy: `ruff check . && mypy`.
80
+ 4. Apri la PR: CI esegue lint, type-check, build.
81
+
82
+ Felice coding nella foresta di **pythonWoods**! 🌲🐾
83
+
84
+ ## Links utili
85
+ Documentazione dev (work-in-progress) → https://pythonwoods.dev/docs/pyw-core/latest/
86
+
87
+ Issue tracker → https://github.com/pythonWoods/pyw-core/issues
88
+
89
+ Changelog → https://github.com/pythonWoods/pyw-core/releases
90
+
91
+ © pythonWoods — MIT License
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "pyw-core"
7
- version = "0.0.0.post1"
7
+ version = "0.0.0.post2"
8
8
  description = "Reserved placeholder for pyw-core (umbrella namespace)"
9
9
  authors = [{name = "pythonWoods"}]
10
10
  license = {text = "MIT"}
@@ -1,52 +0,0 @@
1
- # pyw-core 🌐
2
- [![PyPI](https://img.shields.io/pypi/v/pyw-core.svg)](https://pypi.org/project/pyw-core/)
3
- [![CI](https://github.com/pythonWoods/pyw-core/actions/workflows/ci.yml/badge.svg)](https://github.com/pythonWoods/pyw-core/actions/workflows/ci.yml)
4
- [![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
- > Namespace seed & common utilities for the **pythonWoods** ecosystem.
6
-
7
- ## Components
8
-
9
- | Package | Description | Status |
10
- |---------|-------------|--------|
11
- | **pyw-core** | Structured + colorful logging | placeholder `0.0.0` |
12
- | **pyw-fs** | Unified filesystem (local/S3/GCS) | 0.0.0 |
13
- | **pyw-secret** | Secret back-ends (.env, Vault, SSM) | 0.0.0 |
14
- | **pyw-cli** | Typer CLI scaffold | 0.0.0 |
15
- | **pyw-music21** | Music21 stubs & helpers | 0.0.0 |
16
- | **pyw-musicparser** | Parse MIDI/Lilypond | 0.0.0 |
17
- | **pyw-core** | Meta-package: install everything | 0.0.0 |
18
- | **pyw-devtools** | Bundle for devs (logger, fs, cli, secret) | 0.0.0 |
19
-
20
- ## Philosophy
21
-
22
- * **Namespace package** – `import pyw.*` per evitare conflitti.
23
- * **Small, composable modules** – scegli solo ciò che ti serve.
24
- * **Typed APIs** – Pydantic / dataclass per zero sorprese.
25
- * **No heavy deps by default** – le librerie “costose” (Torch, OpenCV) sono extra.
26
-
27
- ### Installation (nothing to use yet)
28
-
29
- ```bash
30
- pip install pyw-core
31
- ```
32
-
33
- *(Core è quasi vuoto: fornisce solo il namespace e helper comuni.)*
34
-
35
- ## Contributing
36
-
37
- 1. Fork il repo del modulo che ti interessa (`pyw-fs`, ecc.).
38
- 2. Crea virtual-env via Poetry: `poetry install && poetry shell`.
39
- 3. Lancia linter e mypy: `ruff check . && mypy`.
40
- 4. Apri la PR: CI esegue lint, type-check, build.
41
-
42
- Felice coding nella foresta di **pythonWoods**! 🌲🐾
43
-
44
-
45
- ## Links utili
46
- Documentazione dev (work-in-progress) → https://pythonwoods.dev/docs/pyw-core/latest/
47
-
48
- Issue tracker → https://github.com/pythonWoods/pyw-core/issues
49
-
50
- Changelog → https://github.com/pythonWoods/pyw-core/releases
51
-
52
- © pythonWoods — MIT License
File without changes