pyperch 0.2.0__tar.gz → 0.2.2__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.
Files changed (45) hide show
  1. {pyperch-0.2.0/pyperch.egg-info → pyperch-0.2.2}/PKG-INFO +33 -6
  2. pyperch-0.2.0/PKG-INFO → pyperch-0.2.2/README.md +26 -18
  3. pyperch-0.2.0/README.md → pyperch-0.2.2/pyperch.egg-info/PKG-INFO +45 -5
  4. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch.egg-info/requires.txt +0 -1
  5. {pyperch-0.2.0 → pyperch-0.2.2}/pyproject.toml +2 -3
  6. {pyperch-0.2.0 → pyperch-0.2.2}/setup.py +13 -2
  7. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/__init__.py +0 -0
  8. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/builder.py +0 -0
  9. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/config/__init__.py +0 -0
  10. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/config/schema.py +0 -0
  11. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/core/__init__.py +0 -0
  12. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/core/callbacks.py +0 -0
  13. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/core/engine.py +0 -0
  14. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/core/metrics.py +0 -0
  15. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/core/trainer.py +0 -0
  16. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/models/__init__.py +0 -0
  17. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/models/mlp.py +0 -0
  18. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/optim/__init__.py +0 -0
  19. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/optim/ga.py +0 -0
  20. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/optim/interface.py +0 -0
  21. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/optim/rhc.py +0 -0
  22. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/optim/sa.py +0 -0
  23. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/search/__init__.py +0 -0
  24. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/search/adapter.py +0 -0
  25. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/search/builder.py +0 -0
  26. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/search/factory.py +0 -0
  27. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/search/optuna_search.py +0 -0
  28. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/search/strategy.py +0 -0
  29. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/utils/__init__.py +0 -0
  30. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/utils/data.py +0 -0
  31. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/utils/freeze.py +0 -0
  32. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/utils/plots.py +0 -0
  33. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/utils/seed.py +0 -0
  34. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch/utils/test.py +0 -0
  35. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch.egg-info/SOURCES.txt +0 -0
  36. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch.egg-info/dependency_links.txt +0 -0
  37. {pyperch-0.2.0 → pyperch-0.2.2}/pyperch.egg-info/top_level.txt +0 -0
  38. {pyperch-0.2.0 → pyperch-0.2.2}/setup.cfg +0 -0
  39. {pyperch-0.2.0 → pyperch-0.2.2}/tests/__init__.py +0 -0
  40. {pyperch-0.2.0 → pyperch-0.2.2}/tests/test_freezing_trainer.py +0 -0
  41. {pyperch-0.2.0 → pyperch-0.2.2}/tests/test_integration_features.py +0 -0
  42. {pyperch-0.2.0 → pyperch-0.2.2}/tests/test_optuna_search_smoke.py +0 -0
  43. {pyperch-0.2.0 → pyperch-0.2.2}/tests/test_perch_learns.py +0 -0
  44. {pyperch-0.2.0 → pyperch-0.2.2}/tests/test_plotting_smoke.py +0 -0
  45. {pyperch-0.2.0 → pyperch-0.2.2}/tests/test_reproducibility.py +0 -0
@@ -1,12 +1,18 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: pyperch
3
- Version: 0.2.0
3
+ Version: 0.2.2
4
4
  Summary: pyperch refactor
5
5
  Home-page: https://github.com/jlm429/pyperch
6
6
  Author: John Mansfield
7
7
  Author-email: jlm429@gmail.com
8
8
  License: MIT
9
9
  Platform: Any
10
+ Classifier: Programming Language :: Python :: 3
11
+ Classifier: Programming Language :: Python :: 3.10
12
+ Classifier: Programming Language :: Python :: 3.11
13
+ Classifier: Programming Language :: Python :: 3.12
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Operating System :: OS Independent
10
16
  Requires-Python: >=3.10
11
17
  Description-Content-Type: text/markdown
12
18
  Provides-Extra: dev
@@ -21,9 +27,7 @@ Provides-Extra: dev
21
27
  [![CircleCI](https://dl.circleci.com/status-badge/img/circleci/WH9eaoZnQRJ8SGFDrvqQAd/5meq6x5R3uDA3KSuHARdVk/tree/master.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/circleci/WH9eaoZnQRJ8SGFDrvqQAd/5meq6x5R3uDA3KSuHARdVk/tree/master)
22
28
 
23
29
 
24
- A lightweight, modular library for **neural network weight optimization** using randomized search algorithms built directly on top of **PyTorch**. Pyperch provides flexible alternatives to gradient-based optimization, enabling experimentation with Randomized Hill Climbing, Simulated Annealing, and Genetic Algorithms - as well as hybrid approaches where these methods work alongside traditional optimizers like Adam or SGD.
25
-
26
- The current version introduces a unified training API, improved configuration system, deterministic behavior, and a cleaner separation between optimization logic and training.
30
+ A lightweight, modular library for **neural network weight optimization** using randomized search algorithms built directly on top of **PyTorch**. Pyperch is a research and teaching-oriented library for training neural networks using randomized optimization methods (RHC, SA, GA), gradient-based methods, and hybrid combinations.
27
31
 
28
32
  ---
29
33
 
@@ -80,9 +84,32 @@ poetry install
80
84
 
81
85
  ---
82
86
 
83
- ## Quick Start and Examples (Coming Soon)
87
+ ## API and Examples
88
+
89
+ The public API and usage examples are documented and organized as follows:
90
+
91
+ ### API Documentation
92
+
93
+ The user-facing APIs are documented under:
94
+
95
+ - [`docs/api/entrypoints/`](docs/api/entrypoints)
96
+
97
+ Key entry points include:
98
+ - **Perch Builder API** - experiment construction, training, and hybrid optimization
99
+ - **Optuna Search API** - hyperparameter search using an adapter-based Optuna integration
100
+
101
+ ### Examples
102
+
103
+ Notebook/colab examples showing common workflows can be found in:
104
+
105
+ - [`examples/`](examples)
84
106
 
85
- will be added after the refactor merge:
107
+ The examples cover:
108
+ - Classification and regression
109
+ - Randomized optimization (RHC, SA, GA)
110
+ - Gradient and hybrid optimization
111
+ - Layer freezing and meta-optimization
112
+ - Optuna-based hyperparameter search
86
113
 
87
114
  ---
88
115
 
@@ -1,16 +1,3 @@
1
- Metadata-Version: 2.1
2
- Name: pyperch
3
- Version: 0.2.0
4
- Summary: pyperch refactor
5
- Home-page: https://github.com/jlm429/pyperch
6
- Author: John Mansfield
7
- Author-email: jlm429@gmail.com
8
- License: MIT
9
- Platform: Any
10
- Requires-Python: >=3.10
11
- Description-Content-Type: text/markdown
12
- Provides-Extra: dev
13
-
14
1
  # pyperch
15
2
 
16
3
  ![PyPI](https://img.shields.io/pypi/v/pyperch.svg)
@@ -21,9 +8,7 @@ Provides-Extra: dev
21
8
  [![CircleCI](https://dl.circleci.com/status-badge/img/circleci/WH9eaoZnQRJ8SGFDrvqQAd/5meq6x5R3uDA3KSuHARdVk/tree/master.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/circleci/WH9eaoZnQRJ8SGFDrvqQAd/5meq6x5R3uDA3KSuHARdVk/tree/master)
22
9
 
23
10
 
24
- A lightweight, modular library for **neural network weight optimization** using randomized search algorithms built directly on top of **PyTorch**. Pyperch provides flexible alternatives to gradient-based optimization, enabling experimentation with Randomized Hill Climbing, Simulated Annealing, and Genetic Algorithms - as well as hybrid approaches where these methods work alongside traditional optimizers like Adam or SGD.
25
-
26
- The current version introduces a unified training API, improved configuration system, deterministic behavior, and a cleaner separation between optimization logic and training.
11
+ A lightweight, modular library for **neural network weight optimization** using randomized search algorithms built directly on top of **PyTorch**. Pyperch is a research and teaching-oriented library for training neural networks using randomized optimization methods (RHC, SA, GA), gradient-based methods, and hybrid combinations.
27
12
 
28
13
  ---
29
14
 
@@ -80,9 +65,32 @@ poetry install
80
65
 
81
66
  ---
82
67
 
83
- ## Quick Start and Examples (Coming Soon)
68
+ ## API and Examples
69
+
70
+ The public API and usage examples are documented and organized as follows:
71
+
72
+ ### API Documentation
73
+
74
+ The user-facing APIs are documented under:
75
+
76
+ - [`docs/api/entrypoints/`](docs/api/entrypoints)
77
+
78
+ Key entry points include:
79
+ - **Perch Builder API** - experiment construction, training, and hybrid optimization
80
+ - **Optuna Search API** - hyperparameter search using an adapter-based Optuna integration
81
+
82
+ ### Examples
83
+
84
+ Notebook/colab examples showing common workflows can be found in:
85
+
86
+ - [`examples/`](examples)
84
87
 
85
- will be added after the refactor merge:
88
+ The examples cover:
89
+ - Classification and regression
90
+ - Randomized optimization (RHC, SA, GA)
91
+ - Gradient and hybrid optimization
92
+ - Layer freezing and meta-optimization
93
+ - Optuna-based hyperparameter search
86
94
 
87
95
  ---
88
96
 
@@ -1,3 +1,22 @@
1
+ Metadata-Version: 2.1
2
+ Name: pyperch
3
+ Version: 0.2.2
4
+ Summary: pyperch refactor
5
+ Home-page: https://github.com/jlm429/pyperch
6
+ Author: John Mansfield
7
+ Author-email: jlm429@gmail.com
8
+ License: MIT
9
+ Platform: Any
10
+ Classifier: Programming Language :: Python :: 3
11
+ Classifier: Programming Language :: Python :: 3.10
12
+ Classifier: Programming Language :: Python :: 3.11
13
+ Classifier: Programming Language :: Python :: 3.12
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Operating System :: OS Independent
16
+ Requires-Python: >=3.10
17
+ Description-Content-Type: text/markdown
18
+ Provides-Extra: dev
19
+
1
20
  # pyperch
2
21
 
3
22
  ![PyPI](https://img.shields.io/pypi/v/pyperch.svg)
@@ -8,9 +27,7 @@
8
27
  [![CircleCI](https://dl.circleci.com/status-badge/img/circleci/WH9eaoZnQRJ8SGFDrvqQAd/5meq6x5R3uDA3KSuHARdVk/tree/master.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/circleci/WH9eaoZnQRJ8SGFDrvqQAd/5meq6x5R3uDA3KSuHARdVk/tree/master)
9
28
 
10
29
 
11
- A lightweight, modular library for **neural network weight optimization** using randomized search algorithms built directly on top of **PyTorch**. Pyperch provides flexible alternatives to gradient-based optimization, enabling experimentation with Randomized Hill Climbing, Simulated Annealing, and Genetic Algorithms - as well as hybrid approaches where these methods work alongside traditional optimizers like Adam or SGD.
12
-
13
- The current version introduces a unified training API, improved configuration system, deterministic behavior, and a cleaner separation between optimization logic and training.
30
+ A lightweight, modular library for **neural network weight optimization** using randomized search algorithms built directly on top of **PyTorch**. Pyperch is a research and teaching-oriented library for training neural networks using randomized optimization methods (RHC, SA, GA), gradient-based methods, and hybrid combinations.
14
31
 
15
32
  ---
16
33
 
@@ -67,9 +84,32 @@ poetry install
67
84
 
68
85
  ---
69
86
 
70
- ## Quick Start and Examples (Coming Soon)
87
+ ## API and Examples
88
+
89
+ The public API and usage examples are documented and organized as follows:
90
+
91
+ ### API Documentation
92
+
93
+ The user-facing APIs are documented under:
94
+
95
+ - [`docs/api/entrypoints/`](docs/api/entrypoints)
96
+
97
+ Key entry points include:
98
+ - **Perch Builder API** - experiment construction, training, and hybrid optimization
99
+ - **Optuna Search API** - hyperparameter search using an adapter-based Optuna integration
100
+
101
+ ### Examples
102
+
103
+ Notebook/colab examples showing common workflows can be found in:
104
+
105
+ - [`examples/`](examples)
71
106
 
72
- will be added after the refactor merge:
107
+ The examples cover:
108
+ - Classification and regression
109
+ - Randomized optimization (RHC, SA, GA)
110
+ - Gradient and hybrid optimization
111
+ - Layer freezing and meta-optimization
112
+ - Optuna-based hyperparameter search
73
113
 
74
114
  ---
75
115
 
@@ -1,7 +1,6 @@
1
1
  torch
2
2
  numpy
3
3
  matplotlib
4
- notebook<8.0.0,>=7.5.0
5
4
  scikit-learn<2.0.0,>=1.7.2
6
5
  pytest<10.0.0,>=9.0.2
7
6
  optuna<4.0.0,>=3.6.0
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "pyperch"
3
- version = "0.2.0"
3
+ version = "0.2.2"
4
4
  description = "pyperch refactor"
5
5
  requires-python = ">=3.10"
6
6
  readme = "README.md"
@@ -10,9 +10,8 @@ dependencies = [
10
10
  "torch",
11
11
  "numpy",
12
12
  "matplotlib",
13
- "notebook>=7.5.0,<8.0.0",
14
13
  "scikit-learn>=1.7.2,<2.0.0",
15
- "pytest>=9.0.2,<10.0.0",
14
+ "pytest>=9.0.2,<10.0.0", # workaround for circleci
16
15
  "optuna>=3.6.0,<4.0.0",
17
16
  ]
18
17
 
@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as f:
5
5
 
6
6
  setup(
7
7
  name="pyperch",
8
- version="0.2.0",
8
+ version="0.2.2",
9
9
  url="https://github.com/jlm429/pyperch",
10
10
  author="John Mansfield",
11
11
  author_email="jlm429@gmail.com",
@@ -16,12 +16,23 @@ setup(
16
16
  platforms=["Any"],
17
17
  packages=find_packages(),
18
18
  include_package_data=True,
19
+
20
+ # --- Python version support ---
19
21
  python_requires=">=3.10",
22
+
23
+ classifiers=[
24
+ "Programming Language :: Python :: 3",
25
+ "Programming Language :: Python :: 3.10",
26
+ "Programming Language :: Python :: 3.11",
27
+ "Programming Language :: Python :: 3.12",
28
+ "License :: OSI Approved :: MIT License",
29
+ "Operating System :: OS Independent",
30
+ ],
31
+
20
32
  install_requires=[
21
33
  "torch",
22
34
  "numpy",
23
35
  "matplotlib",
24
- "notebook>=7.5.0,<8.0.0",
25
36
  "scikit-learn>=1.7.2,<2.0.0",
26
37
  "optuna>=3.6.0,<4.0.0",
27
38
  ],
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes