exactor-cli 1.28.0__tar.gz → 1.28.1__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.
@@ -12,7 +12,7 @@ También sirve el JWT de sesión (`/api/auth/register` → `token`) como Bearer
12
12
 
13
13
  ```bash
14
14
  # Opción A — pip (recomendada; paquete `exactor-cli`)
15
- pip install exactor-cli
15
+ pip install exactor-cli # en PyPI; mientras tanto: pip install git+https://gitlab.com/exactorresearch/exactor/exactor-cloud-service-v128.git
16
16
 
17
17
  # Opción B — instaladores one-liner
18
18
  curl -sSL https://exactor.tech/install.sh | bash # Linux / macOS
@@ -57,7 +57,8 @@ curl -X POST https://exactor.tech/api/simplify \
57
57
 
58
58
  - `variables`: **array de nombres**; `variables[0]` es el bit **más significativo** del índice de minterm (xespresso v1, MSB-first).
59
59
  - `minterms`: enteros `0..2^n` del conjunto ON. `dont_cares` para "don't care".
60
- - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists `exactor-netlist-v1` (salida de `exactor_netlist -format json` del plugin Yosys — incluye cortes secuenciales con `flops`).
60
+ - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists estructurales — `exactor-netlist-v1` JSON (salida de `exactor_netlist -format json` del plugin Yosys, incluye cortes secuenciales con `flops`), **BLIF** (`.names`, salida de `write_blif` en ABC/Yosys), **AIGER ASCII** `.aag` (salida de Simplifier/`write_aiger`; los latches se tratan como flop-cut) e **ISCAS `.bench`** — el servidor autodetecta el formato por contenido, sin conversión.
61
+ - `POST /api/simplify/netlist` devuelve por output `blif` (emit `"blif"`): BLIF listo para ABC/Yosys.
61
62
 
62
63
  ## Como librería Python
63
64
 
@@ -77,7 +78,7 @@ print(res["result"], "| su_used:", res["su_used"])
77
78
  # Pre-análisis gratis (0 SU)
78
79
  print(client.analyze(["a","b","c"], [0,1,5,7]))
79
80
 
80
- # Netlist estructural (exactor-netlist-v1) con FSM
81
+ # Netlist estructural con FSM (JSON exactor-netlist-v1 o BLIF/AAG/bench)
81
82
  res = client.simplify_netlist(open("net.json").read(),
82
83
  fsm_minimize=True, fsm_init="0")
83
84
  print(res["fsm_analysis"], res["minimized_state_bits"])
@@ -102,17 +103,6 @@ exactor minimize net.json --fsm-minimize # (vía API: fsm_minimize/fsm_init e
102
103
 
103
104
  Jobs ligeros (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates / ≤64 out) = **0 SU en todos los planes** — el registro FREE te da acceso inmediato. Las SU solo se consumen en jobs pesados; el tier FREE tiene rate limit diario.
104
105
 
105
- ## Self-host (opcional)
106
-
107
- Para correr tu propia instancia del servicio (no es necesario para usar la API):
108
-
109
- ```bash
110
- git clone <repo> && cd exactor-cloud-service-v128
111
- cargo run # escucha en 127.0.0.1:3000, SQLite embebido, JWT dev — cero .env
112
- ```
113
-
114
- Luego apunta el cliente: `exactor login --token <JWT> --endpoint http://localhost:3000`.
115
-
116
106
  ## Troubleshooting
117
107
 
118
108
  | Síntoma | Causa | Fix |
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: exactor-cli
3
- Version: 1.28.0
3
+ Version: 1.28.1
4
4
  Summary: Exactor thin-client CLI — boolean logic minimization via the Exactor Cloud Engine (https://exactor.tech)
5
5
  Author: Exactor Research
6
6
  License: Proprietary
@@ -29,7 +29,7 @@ También sirve el JWT de sesión (`/api/auth/register` → `token`) como Bearer
29
29
 
30
30
  ```bash
31
31
  # Opción A — pip (recomendada; paquete `exactor-cli`)
32
- pip install exactor-cli
32
+ pip install exactor-cli # en PyPI; mientras tanto: pip install git+https://gitlab.com/exactorresearch/exactor/exactor-cloud-service-v128.git
33
33
 
34
34
  # Opción B — instaladores one-liner
35
35
  curl -sSL https://exactor.tech/install.sh | bash # Linux / macOS
@@ -74,7 +74,8 @@ curl -X POST https://exactor.tech/api/simplify \
74
74
 
75
75
  - `variables`: **array de nombres**; `variables[0]` es el bit **más significativo** del índice de minterm (xespresso v1, MSB-first).
76
76
  - `minterms`: enteros `0..2^n` del conjunto ON. `dont_cares` para "don't care".
77
- - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists `exactor-netlist-v1` (salida de `exactor_netlist -format json` del plugin Yosys — incluye cortes secuenciales con `flops`).
77
+ - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists estructurales — `exactor-netlist-v1` JSON (salida de `exactor_netlist -format json` del plugin Yosys, incluye cortes secuenciales con `flops`), **BLIF** (`.names`, salida de `write_blif` en ABC/Yosys), **AIGER ASCII** `.aag` (salida de Simplifier/`write_aiger`; los latches se tratan como flop-cut) e **ISCAS `.bench`** — el servidor autodetecta el formato por contenido, sin conversión.
78
+ - `POST /api/simplify/netlist` devuelve por output `blif` (emit `"blif"`): BLIF listo para ABC/Yosys.
78
79
 
79
80
  ## Como librería Python
80
81
 
@@ -94,7 +95,7 @@ print(res["result"], "| su_used:", res["su_used"])
94
95
  # Pre-análisis gratis (0 SU)
95
96
  print(client.analyze(["a","b","c"], [0,1,5,7]))
96
97
 
97
- # Netlist estructural (exactor-netlist-v1) con FSM
98
+ # Netlist estructural con FSM (JSON exactor-netlist-v1 o BLIF/AAG/bench)
98
99
  res = client.simplify_netlist(open("net.json").read(),
99
100
  fsm_minimize=True, fsm_init="0")
100
101
  print(res["fsm_analysis"], res["minimized_state_bits"])
@@ -119,17 +120,6 @@ exactor minimize net.json --fsm-minimize # (vía API: fsm_minimize/fsm_init e
119
120
 
120
121
  Jobs ligeros (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates / ≤64 out) = **0 SU en todos los planes** — el registro FREE te da acceso inmediato. Las SU solo se consumen en jobs pesados; el tier FREE tiene rate limit diario.
121
122
 
122
- ## Self-host (opcional)
123
-
124
- Para correr tu propia instancia del servicio (no es necesario para usar la API):
125
-
126
- ```bash
127
- git clone <repo> && cd exactor-cloud-service-v128
128
- cargo run # escucha en 127.0.0.1:3000, SQLite embebido, JWT dev — cero .env
129
- ```
130
-
131
- Luego apunta el cliente: `exactor login --token <JWT> --endpoint http://localhost:3000`.
132
-
133
123
  ## Troubleshooting
134
124
 
135
125
  | Síntoma | Causa | Fix |
@@ -4,14 +4,18 @@ A high-performance cloud service for boolean function simplification using the E
4
4
 
5
5
  ## Features
6
6
 
7
- - Boolean function simplification via Exactor Engine (Superior to Quine-McCluskey/ESPRESSO, supports native XOR, AND, OR, and NOT with O(n) linear complexity).
8
- - Supports massive scale simplifications up to **128 variables** via Background Async Jobs processing.
9
- - Multi-format support: Accepts both `.json` (minterms) and Espresso `.pla` standard file formats.
10
- - RESTful API endpoints for synchronous simplification, asynchronous background file processing, and payments.
7
+ - Boolean function simplification via the Exactor Engine — canonical ESOP/XOR-native output (`xespresso`), verifiable per result.
8
+ - Structural netlist optimization (`/api/simplify/netlist`): hybrid DAG→minterm/structural path with XOR-native rewriting; accepts `exactor-netlist-v1` JSON **and competitor interchange formats — BLIF, ASCII AIGER `.aag`, ISCAS `.bench`** (auto-detected).
9
+ - Sequential coverage: flop/latch cut extraction + FSM state minimization (`fsm_minimize`, optional `fsm_init` reachability) — small enumerable machines.
10
+ - Multi-format output: `verilog`, `vhdl`, `blif`, `espresso`, `bristol`, `circom`, `testbench`, `yosys` script, `cert`.
11
+ - Python client + CLI: `pip install exactor-cli` → `exactor` command and `from exactor import ExactorClient` (see [GETTING_STARTED.md](GETTING_STARTED.md)).
12
+ - RESTful API endpoints for synchronous simplification, asynchronous background jobs, plans/billing (SU) and payments.
11
13
  - Built with async/await (`tokio` / `axum`) for high concurrency.
12
14
  - Comprehensive logging and tracing
13
15
  - Health check endpoint
14
16
 
17
+ > **Honest scope:** the SaaS self-service boundary is 128 variables / enumerable FSMs; larger designs are engineering-expansion projects. See `docs/exactor/competitive-parity.md` for the ABC/Yosys/Simplifier operations matrix.
18
+
15
19
  ## Prerequisites
16
20
 
17
21
  - Rust 1.70 or later
@@ -33,12 +37,22 @@ Exactor Cloud Service provides interactive API documentation using Swagger UI.
33
37
 
34
38
  ### Installation
35
39
 
40
+ > **Note:** this repository is private. End users don't need it — use the
41
+ > hosted API at `https://exactor.tech` (`pip install exactor-cli`, see
42
+ > [GETTING_STARTED.md](GETTING_STARTED.md)). Self-hosted/on-premise
43
+ > deployments are an Enterprise offering — contact us.
44
+
45
+ For contributors with repository access:
46
+
36
47
  1. Clone the repository:
37
48
  ```bash
38
- git clone https://github.com/yourusername/exactor.git
39
- cd exactor/exactor-cloud-service
49
+ git clone https://gitlab.com/exactorresearch/exactor/exactor-cloud-service-v128.git
50
+ cd exactor-cloud-service-v128
40
51
  ```
41
52
 
53
+ Or just use the hosted API at `https://exactor.tech` — no build needed
54
+ (`pip install exactor-cli`, see [GETTING_STARTED.md](GETTING_STARTED.md)).
55
+
42
56
  2. Build the project:
43
57
  ```bash
44
58
  cargo build --release
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: exactor-cli
3
- Version: 1.28.0
3
+ Version: 1.28.1
4
4
  Summary: Exactor thin-client CLI — boolean logic minimization via the Exactor Cloud Engine (https://exactor.tech)
5
5
  Author: Exactor Research
6
6
  License: Proprietary
@@ -29,7 +29,7 @@ También sirve el JWT de sesión (`/api/auth/register` → `token`) como Bearer
29
29
 
30
30
  ```bash
31
31
  # Opción A — pip (recomendada; paquete `exactor-cli`)
32
- pip install exactor-cli
32
+ pip install exactor-cli # en PyPI; mientras tanto: pip install git+https://gitlab.com/exactorresearch/exactor/exactor-cloud-service-v128.git
33
33
 
34
34
  # Opción B — instaladores one-liner
35
35
  curl -sSL https://exactor.tech/install.sh | bash # Linux / macOS
@@ -74,7 +74,8 @@ curl -X POST https://exactor.tech/api/simplify \
74
74
 
75
75
  - `variables`: **array de nombres**; `variables[0]` es el bit **más significativo** del índice de minterm (xespresso v1, MSB-first).
76
76
  - `minterms`: enteros `0..2^n` del conjunto ON. `dont_cares` para "don't care".
77
- - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists `exactor-netlist-v1` (salida de `exactor_netlist -format json` del plugin Yosys — incluye cortes secuenciales con `flops`).
77
+ - El CLI acepta `.pla` (Espresso), `.json` (`{variables, minterms, dont_cares}`) y netlists estructurales — `exactor-netlist-v1` JSON (salida de `exactor_netlist -format json` del plugin Yosys, incluye cortes secuenciales con `flops`), **BLIF** (`.names`, salida de `write_blif` en ABC/Yosys), **AIGER ASCII** `.aag` (salida de Simplifier/`write_aiger`; los latches se tratan como flop-cut) e **ISCAS `.bench`** — el servidor autodetecta el formato por contenido, sin conversión.
78
+ - `POST /api/simplify/netlist` devuelve por output `blif` (emit `"blif"`): BLIF listo para ABC/Yosys.
78
79
 
79
80
  ## Como librería Python
80
81
 
@@ -94,7 +95,7 @@ print(res["result"], "| su_used:", res["su_used"])
94
95
  # Pre-análisis gratis (0 SU)
95
96
  print(client.analyze(["a","b","c"], [0,1,5,7]))
96
97
 
97
- # Netlist estructural (exactor-netlist-v1) con FSM
98
+ # Netlist estructural con FSM (JSON exactor-netlist-v1 o BLIF/AAG/bench)
98
99
  res = client.simplify_netlist(open("net.json").read(),
99
100
  fsm_minimize=True, fsm_init="0")
100
101
  print(res["fsm_analysis"], res["minimized_state_bits"])
@@ -119,17 +120,6 @@ exactor minimize net.json --fsm-minimize # (vía API: fsm_minimize/fsm_init e
119
120
 
120
121
  Jobs ligeros (≤32 vars / ≤2K minterms; netlists ≤32 in / ≤5K gates / ≤64 out) = **0 SU en todos los planes** — el registro FREE te da acceso inmediato. Las SU solo se consumen en jobs pesados; el tier FREE tiene rate limit diario.
121
122
 
122
- ## Self-host (opcional)
123
-
124
- Para correr tu propia instancia del servicio (no es necesario para usar la API):
125
-
126
- ```bash
127
- git clone <repo> && cd exactor-cloud-service-v128
128
- cargo run # escucha en 127.0.0.1:3000, SQLite embebido, JWT dev — cero .env
129
- ```
130
-
131
- Luego apunta el cliente: `exactor login --token <JWT> --endpoint http://localhost:3000`.
132
-
133
123
  ## Troubleshooting
134
124
 
135
125
  | Síntoma | Causa | Fix |
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "exactor-cli"
7
- version = "1.28.0"
7
+ version = "1.28.1"
8
8
  description = "Exactor thin-client CLI — boolean logic minimization via the Exactor Cloud Engine (https://exactor.tech)"
9
9
  readme = "GETTING_STARTED.md"
10
10
  requires-python = ">=3.8"
File without changes