fancy-google-meet 0.2.0__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.
@@ -0,0 +1,24 @@
1
+ node_modules/
2
+ dist/
3
+ vendor/
4
+ .venv/
5
+ __pycache__/
6
+ *.egg-info/
7
+ .pytest_cache/
8
+ .ruff_cache/
9
+ .mypy_cache/
10
+
11
+ # Lockfiles are NOT source of a generated repo.
12
+ #
13
+ # The generator cannot emit one -- a lockfile is the result of a network
14
+ # resolve -- and "a provider repo must be generated and re-generatable" is the
15
+ # constraint the whole estate rests on. At a few hundred repos, a committed
16
+ # lockfile each is a few hundred files nothing can regenerate and a few hundred
17
+ # Dependabot surfaces.
18
+ #
19
+ # The trade is real and worth stating: CI resolves fresh on every run, so an
20
+ # upstream release inside the declared range can break a build with no change
21
+ # here. That is early warning rather than a surprise at publish time, and the
22
+ # ranges are deliberately narrow (>=X <2.0, never a caret on a 0.x).
23
+ composer.lock
24
+ package-lock.json
@@ -0,0 +1,56 @@
1
+ # Changelog — Google Meet
2
+
3
+ All four packages — `@particle-academy/google-meet-ui`, `@particle-academy/google-meet-js`,
4
+ `particle-academy/google-meet-php` and `fancy-google-meet` — are released together
5
+ under one version. They are generated from one `provider/` definition, so a
6
+ change to it changes all four, and separate version lines would only record
7
+ which of the four somebody remembered to bump.
8
+
9
+ **Write entries HERE**, in the weaver envelope at `providers/google-meet/CHANGELOG.md`,
10
+ then regenerate. This file is the one thing in a release that cannot be
11
+ derived — somebody has to write what changed — but writing it in the
12
+ provider repo would be a hand-edit that `.weaver.json` flags and the next
13
+ sync destroys.
14
+
15
+ ## [0.2.0] — 2026-11-08
16
+
17
+ ### Added
18
+
19
+ - **Laravel integration, in this package** (`src/Laravel/`), auto-discovered
20
+ through composer's `extra.laravel`. Laravel is SUGGESTED, never required:
21
+ outside a Laravel app none of it loads.
22
+ - a service provider that merges `config/google-meet.php` under
23
+ `connectors.google-meet` (credentials from the environment, or per call for a
24
+ multi-account app);
25
+ - the `GoogleMeet` facade: `GoogleMeet::call('<operation>', [...])` runs any action;
26
+ - `GoogleMeet::fake()`, answered from the connector's faker, with
27
+ `assertSent` / `assertNotSent` / `assertNothingSent` / `assertSentCount`;
28
+ - its own Pest test of all of it against a booted Laravel app.
29
+
30
+ ### Changed
31
+
32
+ - **Tests: Pest `^5`**, and `laravel/framework` `^13` as a DEV-ONLY test
33
+ dependency (the framework this package integrates with; nothing ships in
34
+ `require`).
35
+
36
+ ## [0.1.0] — 2026-09-16
37
+
38
+ ### Added
39
+
40
+ - **`space_create`** — create a Meet space and get its join link (`POST /spaces`, scope `meetings.space.created`).
41
+ - **`space_get`** — read a space's current state, including whether a conference is live right now (`GET /spaces/{spaceId}`).
42
+ - **`conference_record_list`** — past conferences, optionally filtered to one space with Google's own filter grammar passed through verbatim (`GET /conferenceRecords`).
43
+ - **`participant_list`** — who attended, as one of signed-in / anonymous / phone-dial-in per row, the whole attendance span rather than a single join/leave pair.
44
+ - **`transcript_list`** / **`transcript_entry_list`** — a finished conference's transcript, one utterance per entry, when transcription was on.
45
+ - OAuth2, standard reusable Google refresh tokens. Sandbox `unverified`: no separate test estate found, but nobody has confirmed there is truly nothing.
46
+
47
+ **This is the CONNECTOR half of Tynn #9 (MOIC's meeting bot).** A LIVE
48
+ transcript and live participant status (waiting room / admitted / left) are
49
+ NOT offered by the stable Meet REST API v2 this connector uses — that needs
50
+ Meet's Media API, developer-preview as of this writing, and the bot RUNTIME
51
+ that would actually join a call and stream media is explicitly the owner's
52
+ architecture decision, not this connector's. What ships here: creating a
53
+ space, and reading what happened after the fact.
54
+
55
+ Verified against the Meet API v2 Discovery Document
56
+ (`https://meet.googleapis.com/$discovery/rest?version=v2`) on 2026-09-16.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Particle Academy
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,179 @@
1
+ Metadata-Version: 2.5
2
+ Name: fancy-google-meet
3
+ Version: 0.2.0
4
+ Summary: Google Meet for Python — the service descriptor, its faker, its webhook verification, and one function per operation. Plain HTTP; no vendor SDK.
5
+ Project-URL: Homepage, https://github.com/Fancy-Friends/google-meet
6
+ Project-URL: Issues, https://github.com/Fancy-Friends/google-meet/issues
7
+ Project-URL: Source, https://github.com/Fancy-Friends/google-meet
8
+ Author: Particle Academy
9
+ License-Expression: MIT
10
+ License-File: LICENSE
11
+ Keywords: api,connector,fancy-flow,google_meet,messaging,particle-academy
12
+ Classifier: Development Status :: 3 - Alpha
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Programming Language :: Python :: 3.13
18
+ Classifier: Topic :: Software Development :: Libraries
19
+ Classifier: Typing :: Typed
20
+ Requires-Python: >=3.11
21
+ Description-Content-Type: text/markdown
22
+
23
+ # Google Meet
24
+
25
+ [![Fancified](art/fancified.svg)](https://particle.academy)
26
+
27
+ Google Meet for [fancy-flow][flow] — as **four imported, versioned packages**, one
28
+ per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
29
+ change.
30
+
31
+ [flow]: https://github.com/Particle-Academy/fancy-flow
32
+
33
+ | Runtime | Package | Install |
34
+ |---|---|---|
35
+ | Authoring surface (every host) | `@particle-academy/google-meet-ui` | `npm install @particle-academy/google-meet-ui` |
36
+ | Node | `@particle-academy/google-meet-js` | `npm install @particle-academy/google-meet-js` |
37
+ | PHP 8.4+ | `particle-academy/google-meet-php` | `composer require particle-academy/google-meet-php` |
38
+ | Python 3.11+ | `fancy-google-meet` | `pip install fancy-google-meet` |
39
+
40
+ The `ui` package is the editor surface and is React on every host — a PHP or
41
+ Python project installs it *and* its own runtime package, and never the `js` one.
42
+
43
+ ## What it costs you
44
+
45
+ One dependency: `@particle-academy/fancy-connector-core` (or
46
+ `particle-academy/fancy-connector-core` on Composer), which the `js` and `php`
47
+ packages pull in themselves. The Python package has **zero** runtime
48
+ dependencies.
49
+
50
+ **No Google Meet SDK.** Plain HTTP, deliberately: a vendor SDK is third-party code
51
+ subject to the kit's full approval bar, and one per provider is hundreds of
52
+ dependencies nobody is tracking.
53
+
54
+ ## Setting it up
55
+
56
+ Everything below is generated from `provider/manifest.json`, so it cannot disagree with what the packages do.
57
+
58
+ ### Credentials
59
+
60
+ A Google Meet connection holds 4 values.
61
+
62
+ **Two kinds of value, and mixing them up matters.** A `provider` credential is ONE value for the whole installation — an OAuth app's client secret serves every connected account. An `account` credential is one per connected account. A host that stores the second where it stores the first lets one account's credentials reach another's.
63
+
64
+ | Field | Scope | Secret | Where it comes from |
65
+ |---|---|---|---|
66
+ | **OAuth client ID** | per installation | not secret | From the Google Cloud project you registered. One value for the whole installation -- the same app serves every connected Google account. |
67
+ | **OAuth client secret** | per installation | **secret** | From the same Google Cloud project. Used to exchange the code and to refresh; never sent with an API request. |
68
+ | **Access token** | per connected account | **secret** | Obtained by the host's OAuth exchange, PER CONNECTED GOOGLE ACCOUNT. Expires after one hour -- a host that does not refresh will work for a while and then fail with no warning. |
69
+ | **Refresh token** *(optional)* | per connected account | **secret** | Also per account. Reusable -- Google does not rotate it on refresh. |
70
+
71
+ ### Authorising
72
+
73
+ Google Meet uses OAuth2 (authorization_code). The package DECLARES the exchange; the HOST performs it — a consent screen needs a browser, a redirect URI and somewhere to persist the result, and all three belong to the host.
74
+
75
+ - **Authorize URL** — https://accounts.google.com/o/oauth2/v2/auth
76
+ - **Token URL** — https://oauth2.googleapis.com/token
77
+ - **Scopes** — `https://www.googleapis.com/auth/meetings.space.created`, `https://www.googleapis.com/auth/meetings.space.readonly`
78
+ - **Access token lifetime** — 3600 seconds (1 hours). A host that never refreshes works all afternoon and is broken by morning.
79
+
80
+ The refresh tokens do **not** rotate: the same one is reusable, so a refresh may safely be retried and may run concurrently. Stated rather than assumed, because the opposite — a provider that spends the token and revokes the grant on a replay — looks identical until it happens.
81
+
82
+ ### The estate
83
+
84
+ **Nobody has checked whether Google Meet has a test estate.** Treat every call as real.
85
+
86
+ > Google Meet has no test estate distinct from a real account, as far as this review found (2026-09-16) -- but it is UNVERIFIED, not confirmed. space_create makes a real, joinable meeting space. Use fake mode while building.
87
+
88
+ ## What it can do
89
+
90
+ ### Actions
91
+
92
+ #### `conference_record_list` — List conference records
93
+
94
+ List past conferences, optionally filtered to one space.
95
+
96
+ `GET /conferenceRecords` · reads only — safe to replay
97
+
98
+ | Input | Required | What it is |
99
+ |---|---|---|
100
+ | `filter` | no | Google's filter grammar, e.g. space.name = "spaces/abc123" to see one space's history, or space.meeting_code = "abc-defg-hij". Leave blank for every conference the account can see. |
101
+ | `pageSize` | no | Records per page. Leave blank for Google's default. |
102
+ | `pageToken` | no | From a previous call's data.nextPageToken. |
103
+
104
+ #### `participant_list` — List participants
105
+
106
+ List who attended a conference.
107
+
108
+ `GET /conferenceRecords/{conferenceRecordId}/participants` · reads only — safe to replay
109
+
110
+ | Input | Required | What it is |
111
+ |---|---|---|
112
+ | `conferenceRecordId` | yes | The id from conference_record_list's data.conferenceRecords[].name (conferenceRecords/{id} -- give the id after the slash) or from space_get's data.activeConference.conferenceRecord. |
113
+ | `pageToken` | no | From a previous call's data.nextPageToken. |
114
+
115
+ #### `space_create` — Create meeting space
116
+
117
+ Create a new Google Meet space and get its join link.
118
+
119
+ `POST /spaces` · **unsafe to replay** — a retried durable run does it TWICE
120
+
121
+ | Input | Required | What it is |
122
+ |---|---|---|
123
+ | `accessType` | no | OPEN: anyone with the link, no knock. TRUSTED: anyone in your organization, no knock; others knock. RESTRICTED: only people and groups explicitly invited. Leave blank for Google's account default. |
124
+ | `entryPointAccess` | no | ALL: any Meet client (web, mobile, phone dial-in, the calling API). CREATOR_APP_ONLY: only the app that created the space, and only through the Meet REST API and SIP — no phone dial-in and no other Meet client. Leave blank for Google's default (ALL). |
125
+
126
+ #### `space_get` — Get meeting space
127
+
128
+ Read a Meet space's current state, including whether a conference is active right now.
129
+
130
+ `GET /spaces/{spaceId}` · reads only — safe to replay
131
+
132
+ | Input | Required | What it is |
133
+ |---|---|---|
134
+ | `spaceId` | yes | The id from space_create's data.name (spaces/{id} -- give the id after the slash), or the meeting code shown in Meet's own UI. NOT independently spot-checked that the meeting-code form resolves through this exact endpoint; verify with a live call before relying on it. |
135
+
136
+ #### `transcript_entry_list` — List transcript entries
137
+
138
+ Read a finished conference's transcript, one utterance per entry.
139
+
140
+ `GET /conferenceRecords/{conferenceRecordId}/transcripts/{transcriptId}/entries` · reads only — safe to replay
141
+
142
+ | Input | Required | What it is |
143
+ |---|---|---|
144
+ | `conferenceRecordId` | yes | The id from conference_record_list's data.conferenceRecords[].name (give the id after conferenceRecords/). |
145
+ | `transcriptId` | yes | The id from transcript_list's data.transcripts[].name (give the id after transcripts/). |
146
+ | `pageToken` | no | From a previous call's data.nextPageToken. |
147
+
148
+ #### `transcript_list` — List transcripts
149
+
150
+ List a finished conference's transcripts, when transcription was on.
151
+
152
+ `GET /conferenceRecords/{conferenceRecordId}/transcripts` · reads only — safe to replay
153
+
154
+ | Input | Required | What it is |
155
+ |---|---|---|
156
+ | `conferenceRecordId` | yes | The id from conference_record_list's data.conferenceRecords[].name (conferenceRecords/{id} -- give the id after the slash). |
157
+
158
+ ## Run it before you have credentials
159
+
160
+ Every operation ships a **faker**, whether or not Google Meet has a sandbox. Set a
161
+ node's mode to `fake` and it returns the shape Google Meet actually publishes — the
162
+ same field names, deterministically — so you can wire the downstream nodes before
163
+ touching an account, a key, or a network.
164
+
165
+ ## This repository is generated
166
+
167
+ `provider/` is the source. Everything under `packages/` is emitted from it and
168
+ **must not be hand-edited** — CI regenerates and diffs on every push, and the
169
+ next protocol sync destroys anything it finds. See [`AGENTS.md`](AGENTS.md).
170
+
171
+ ## Two namespaces, which do not match on purpose
172
+
173
+ The repo is `github.com/Fancy-Friends/google-meet`; the packages publish under
174
+ `particle-academy`. Nothing derives one from the other — the names come from
175
+ weaver's `friends.json` and nowhere else.
176
+
177
+ ## Licence
178
+
179
+ MIT.
@@ -0,0 +1,157 @@
1
+ # Google Meet
2
+
3
+ [![Fancified](art/fancified.svg)](https://particle.academy)
4
+
5
+ Google Meet for [fancy-flow][flow] — as **four imported, versioned packages**, one
6
+ per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
7
+ change.
8
+
9
+ [flow]: https://github.com/Particle-Academy/fancy-flow
10
+
11
+ | Runtime | Package | Install |
12
+ |---|---|---|
13
+ | Authoring surface (every host) | `@particle-academy/google-meet-ui` | `npm install @particle-academy/google-meet-ui` |
14
+ | Node | `@particle-academy/google-meet-js` | `npm install @particle-academy/google-meet-js` |
15
+ | PHP 8.4+ | `particle-academy/google-meet-php` | `composer require particle-academy/google-meet-php` |
16
+ | Python 3.11+ | `fancy-google-meet` | `pip install fancy-google-meet` |
17
+
18
+ The `ui` package is the editor surface and is React on every host — a PHP or
19
+ Python project installs it *and* its own runtime package, and never the `js` one.
20
+
21
+ ## What it costs you
22
+
23
+ One dependency: `@particle-academy/fancy-connector-core` (or
24
+ `particle-academy/fancy-connector-core` on Composer), which the `js` and `php`
25
+ packages pull in themselves. The Python package has **zero** runtime
26
+ dependencies.
27
+
28
+ **No Google Meet SDK.** Plain HTTP, deliberately: a vendor SDK is third-party code
29
+ subject to the kit's full approval bar, and one per provider is hundreds of
30
+ dependencies nobody is tracking.
31
+
32
+ ## Setting it up
33
+
34
+ Everything below is generated from `provider/manifest.json`, so it cannot disagree with what the packages do.
35
+
36
+ ### Credentials
37
+
38
+ A Google Meet connection holds 4 values.
39
+
40
+ **Two kinds of value, and mixing them up matters.** A `provider` credential is ONE value for the whole installation — an OAuth app's client secret serves every connected account. An `account` credential is one per connected account. A host that stores the second where it stores the first lets one account's credentials reach another's.
41
+
42
+ | Field | Scope | Secret | Where it comes from |
43
+ |---|---|---|---|
44
+ | **OAuth client ID** | per installation | not secret | From the Google Cloud project you registered. One value for the whole installation -- the same app serves every connected Google account. |
45
+ | **OAuth client secret** | per installation | **secret** | From the same Google Cloud project. Used to exchange the code and to refresh; never sent with an API request. |
46
+ | **Access token** | per connected account | **secret** | Obtained by the host's OAuth exchange, PER CONNECTED GOOGLE ACCOUNT. Expires after one hour -- a host that does not refresh will work for a while and then fail with no warning. |
47
+ | **Refresh token** *(optional)* | per connected account | **secret** | Also per account. Reusable -- Google does not rotate it on refresh. |
48
+
49
+ ### Authorising
50
+
51
+ Google Meet uses OAuth2 (authorization_code). The package DECLARES the exchange; the HOST performs it — a consent screen needs a browser, a redirect URI and somewhere to persist the result, and all three belong to the host.
52
+
53
+ - **Authorize URL** — https://accounts.google.com/o/oauth2/v2/auth
54
+ - **Token URL** — https://oauth2.googleapis.com/token
55
+ - **Scopes** — `https://www.googleapis.com/auth/meetings.space.created`, `https://www.googleapis.com/auth/meetings.space.readonly`
56
+ - **Access token lifetime** — 3600 seconds (1 hours). A host that never refreshes works all afternoon and is broken by morning.
57
+
58
+ The refresh tokens do **not** rotate: the same one is reusable, so a refresh may safely be retried and may run concurrently. Stated rather than assumed, because the opposite — a provider that spends the token and revokes the grant on a replay — looks identical until it happens.
59
+
60
+ ### The estate
61
+
62
+ **Nobody has checked whether Google Meet has a test estate.** Treat every call as real.
63
+
64
+ > Google Meet has no test estate distinct from a real account, as far as this review found (2026-09-16) -- but it is UNVERIFIED, not confirmed. space_create makes a real, joinable meeting space. Use fake mode while building.
65
+
66
+ ## What it can do
67
+
68
+ ### Actions
69
+
70
+ #### `conference_record_list` — List conference records
71
+
72
+ List past conferences, optionally filtered to one space.
73
+
74
+ `GET /conferenceRecords` · reads only — safe to replay
75
+
76
+ | Input | Required | What it is |
77
+ |---|---|---|
78
+ | `filter` | no | Google's filter grammar, e.g. space.name = "spaces/abc123" to see one space's history, or space.meeting_code = "abc-defg-hij". Leave blank for every conference the account can see. |
79
+ | `pageSize` | no | Records per page. Leave blank for Google's default. |
80
+ | `pageToken` | no | From a previous call's data.nextPageToken. |
81
+
82
+ #### `participant_list` — List participants
83
+
84
+ List who attended a conference.
85
+
86
+ `GET /conferenceRecords/{conferenceRecordId}/participants` · reads only — safe to replay
87
+
88
+ | Input | Required | What it is |
89
+ |---|---|---|
90
+ | `conferenceRecordId` | yes | The id from conference_record_list's data.conferenceRecords[].name (conferenceRecords/{id} -- give the id after the slash) or from space_get's data.activeConference.conferenceRecord. |
91
+ | `pageToken` | no | From a previous call's data.nextPageToken. |
92
+
93
+ #### `space_create` — Create meeting space
94
+
95
+ Create a new Google Meet space and get its join link.
96
+
97
+ `POST /spaces` · **unsafe to replay** — a retried durable run does it TWICE
98
+
99
+ | Input | Required | What it is |
100
+ |---|---|---|
101
+ | `accessType` | no | OPEN: anyone with the link, no knock. TRUSTED: anyone in your organization, no knock; others knock. RESTRICTED: only people and groups explicitly invited. Leave blank for Google's account default. |
102
+ | `entryPointAccess` | no | ALL: any Meet client (web, mobile, phone dial-in, the calling API). CREATOR_APP_ONLY: only the app that created the space, and only through the Meet REST API and SIP — no phone dial-in and no other Meet client. Leave blank for Google's default (ALL). |
103
+
104
+ #### `space_get` — Get meeting space
105
+
106
+ Read a Meet space's current state, including whether a conference is active right now.
107
+
108
+ `GET /spaces/{spaceId}` · reads only — safe to replay
109
+
110
+ | Input | Required | What it is |
111
+ |---|---|---|
112
+ | `spaceId` | yes | The id from space_create's data.name (spaces/{id} -- give the id after the slash), or the meeting code shown in Meet's own UI. NOT independently spot-checked that the meeting-code form resolves through this exact endpoint; verify with a live call before relying on it. |
113
+
114
+ #### `transcript_entry_list` — List transcript entries
115
+
116
+ Read a finished conference's transcript, one utterance per entry.
117
+
118
+ `GET /conferenceRecords/{conferenceRecordId}/transcripts/{transcriptId}/entries` · reads only — safe to replay
119
+
120
+ | Input | Required | What it is |
121
+ |---|---|---|
122
+ | `conferenceRecordId` | yes | The id from conference_record_list's data.conferenceRecords[].name (give the id after conferenceRecords/). |
123
+ | `transcriptId` | yes | The id from transcript_list's data.transcripts[].name (give the id after transcripts/). |
124
+ | `pageToken` | no | From a previous call's data.nextPageToken. |
125
+
126
+ #### `transcript_list` — List transcripts
127
+
128
+ List a finished conference's transcripts, when transcription was on.
129
+
130
+ `GET /conferenceRecords/{conferenceRecordId}/transcripts` · reads only — safe to replay
131
+
132
+ | Input | Required | What it is |
133
+ |---|---|---|
134
+ | `conferenceRecordId` | yes | The id from conference_record_list's data.conferenceRecords[].name (conferenceRecords/{id} -- give the id after the slash). |
135
+
136
+ ## Run it before you have credentials
137
+
138
+ Every operation ships a **faker**, whether or not Google Meet has a sandbox. Set a
139
+ node's mode to `fake` and it returns the shape Google Meet actually publishes — the
140
+ same field names, deterministically — so you can wire the downstream nodes before
141
+ touching an account, a key, or a network.
142
+
143
+ ## This repository is generated
144
+
145
+ `provider/` is the source. Everything under `packages/` is emitted from it and
146
+ **must not be hand-edited** — CI regenerates and diffs on every push, and the
147
+ next protocol sync destroys anything it finds. See [`AGENTS.md`](AGENTS.md).
148
+
149
+ ## Two namespaces, which do not match on purpose
150
+
151
+ The repo is `github.com/Fancy-Friends/google-meet`; the packages publish under
152
+ `particle-academy`. Nothing derives one from the other — the names come from
153
+ weaver's `friends.json` and nowhere else.
154
+
155
+ ## Licence
156
+
157
+ MIT.
@@ -0,0 +1,26 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="128" height="28" role="img" aria-label="Fancified — built with Fancy UI">
2
+ <title>Fancified · built with Fancy UI</title>
3
+ <defs>
4
+ <linearGradient id="fcdBg" x1="0" y1="0" x2="1" y2="1">
5
+ <stop offset="0" stop-color="#6d28d9"/>
6
+ <stop offset=".5" stop-color="#9333ea"/>
7
+ <stop offset="1" stop-color="#d946ef"/>
8
+ </linearGradient>
9
+ <linearGradient id="fcdGloss" x1="0" y1="0" x2="0" y2="1">
10
+ <stop offset="0" stop-color="#ffffff" stop-opacity=".30"/>
11
+ <stop offset=".55" stop-color="#ffffff" stop-opacity="0"/>
12
+ </linearGradient>
13
+ <clipPath id="fcdClip"><rect width="128" height="28" rx="7"/></clipPath>
14
+ </defs>
15
+ <g clip-path="url(#fcdClip)">
16
+ <rect width="128" height="28" fill="url(#fcdBg)"/>
17
+ <rect width="34" height="28" fill="#3b0764" fill-opacity=".5"/>
18
+ <rect width="128" height="13" fill="url(#fcdGloss)"/>
19
+ <g fill="#fff">
20
+ <path transform="translate(17 14)" d="M0 -7 C.6 -2.2 2.2 -.6 7 0 C2.2 .6 .6 2.2 0 7 C-.6 2.2 -2.2 .6 -7 0 C-2.2 -.6 -.6 -2.2 0 -7 Z"/>
21
+ <path transform="translate(25.5 7.5) scale(.34)" fill-opacity=".85" d="M0 -7 C.6 -2.2 2.2 -.6 7 0 C2.2 .6 .6 2.2 0 7 C-.6 2.2 -2.2 .6 -7 0 C-2.2 -.6 -.6 -2.2 0 -7 Z"/>
22
+ </g>
23
+ <text x="81" y="18.5" fill="#ffffff" text-anchor="middle" font-family="'Segoe UI',Verdana,'DejaVu Sans',sans-serif" font-size="12" font-weight="700" letter-spacing=".3">Fancified</text>
24
+ </g>
25
+ <rect x=".5" y=".5" width="127" height="27" rx="6.5" fill="none" stroke="#ffffff" stroke-opacity=".22"/>
26
+ </svg>
@@ -0,0 +1,87 @@
1
+ [build-system]
2
+ requires = ["hatchling>=1.27"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "fancy-google-meet"
7
+ version = "0.2.0"
8
+ description = "Google Meet for Python — the service descriptor, its faker, its webhook verification, and one function per operation. Plain HTTP; no vendor SDK."
9
+ readme = "README.md"
10
+ # 3.11 matches fancy-flow-py's floor: 3.10 reaches end of life on 2026-10-31,
11
+ # and a floor that dies before the package's second release is not a floor.
12
+ requires-python = ">=3.11"
13
+ license = "MIT"
14
+ license-files = ["LICENSE"]
15
+ authors = [{ name = "Particle Academy" }]
16
+ keywords = ["google_meet", "messaging", "connector", "api", "fancy-flow", "particle-academy"]
17
+ classifiers = [
18
+ "Development Status :: 3 - Alpha",
19
+ "Intended Audience :: Developers",
20
+ "Programming Language :: Python :: 3",
21
+ "Programming Language :: Python :: 3.11",
22
+ "Programming Language :: Python :: 3.12",
23
+ "Programming Language :: Python :: 3.13",
24
+ "Topic :: Software Development :: Libraries",
25
+ "Typing :: Typed",
26
+ ]
27
+
28
+ # ZERO runtime dependencies, and that is a design constraint rather than an
29
+ # accident. There is no Python twin of fancy-connector-core to depend on, and a
30
+ # vendor SDK is third-party code subject to the kit's full approval bar — one
31
+ # SDK per provider is hundreds of dependencies nobody is tracking. The HTTP is
32
+ # stdlib `urllib`; the HMAC is stdlib `hmac`.
33
+ dependencies = []
34
+
35
+ [project.urls]
36
+ Homepage = "https://github.com/Fancy-Friends/google-meet"
37
+ Issues = "https://github.com/Fancy-Friends/google-meet/issues"
38
+ Source = "https://github.com/Fancy-Friends/google-meet"
39
+
40
+ [dependency-groups]
41
+ # Not optional. A package with no way to run its tests reports green by doing
42
+ # nothing, which is the one defect that hides itself.
43
+ test = ["pytest>=8.0"]
44
+ lint = ["ruff>=0.16"]
45
+ typecheck = ["mypy>=1.11"]
46
+ dev = [{ include-group = "test" }, { include-group = "lint" }, { include-group = "typecheck" }]
47
+
48
+ [tool.hatch.build.targets.wheel]
49
+ packages = ["src/fancy_google_meet"]
50
+
51
+ [tool.hatch.build.targets.sdist]
52
+ include = ["/src", "/tests", "/art", "/README.md", "/CHANGELOG.md", "/LICENSE"]
53
+
54
+ [tool.pytest.ini_options]
55
+ testpaths = ["tests"]
56
+ # importlib mode pairs with src-layout: the working tree is never on sys.path,
57
+ # so the tests exercise the INSTALLED package. Under the default mode a missing
58
+ # py.typed or an unshipped file passes locally and breaks for every user.
59
+ addopts = "--import-mode=importlib -ra"
60
+
61
+ [tool.ruff]
62
+ line-length = 100
63
+ src = ["src", "tests"]
64
+ target-version = "py311"
65
+
66
+ [tool.ruff.lint]
67
+ # `S` — flake8-bandit — is ON, and it is the one addition worth arguing for: this
68
+ # package handles a credential, builds an HMAC, and opens a URL. Security lint
69
+ # belongs on exactly this code.
70
+ #
71
+ # It also makes the two `# noqa: S310` in _runtime.py MEANINGFUL. Without `S`
72
+ # selected, ruff reports them as unused directives (RUF100) and the obvious fix
73
+ # is to delete them — which quietly removes a security annotation because a
74
+ # linter was not looking for it.
75
+ select = ["E", "F", "I", "UP", "B", "SIM", "RUF", "N", "C4", "PT", "S"]
76
+
77
+ [tool.ruff.lint.per-file-ignores]
78
+ # pytest's whole idiom is bare `assert`. S101 would fail every test file.
79
+ "tests/*" = ["S101"]
80
+
81
+ [tool.mypy]
82
+ python_version = "3.11"
83
+ packages = ["fancy_google_meet"]
84
+ mypy_path = "src"
85
+ strict = true
86
+ disallow_any_expr = false
87
+ disallow_any_explicit = false
@@ -0,0 +1,47 @@
1
+ # GENERATED FILE — do not edit.
2
+ #
3
+ # Emitted from provider/manifest.json by weaver's generator.
4
+ # A hand-edit here is destroyed by the next protocol sync, which is worse than
5
+ # being rejected, because it works until it silently does not. Fix
6
+ # provider/manifest.json (or weaver's template/) and regenerate:
7
+ #
8
+ # npm run provider -- google_meet
9
+
10
+ """Google Meet for Python.
11
+
12
+ The service descriptor, its faker, its delivery contract, and one function
13
+ per operation — plain HTTP on the stdlib, no vendor SDK and no runtime
14
+ dependency.
15
+ """
16
+
17
+ from __future__ import annotations
18
+
19
+ from ._fake import FakeValues
20
+ from .actions.conference_record_list import conference_record_list
21
+ from .actions.participant_list import participant_list
22
+ from .actions.space_create import space_create
23
+ from .actions.space_get import space_get
24
+ from .actions.transcript_entry_list import transcript_entry_list
25
+ from .actions.transcript_list import transcript_list
26
+ from .faker import respond
27
+ from .service import BASE_URLS, CONNECTOR_API_VERSION, REQUIRES, SANDBOX, SERVICE, TITLE, descriptor
28
+
29
+ __version__ = "0.2.0"
30
+
31
+ __all__ = [
32
+ "BASE_URLS",
33
+ "CONNECTOR_API_VERSION",
34
+ "REQUIRES",
35
+ "SANDBOX",
36
+ "SERVICE",
37
+ "TITLE",
38
+ "FakeValues",
39
+ "conference_record_list",
40
+ "descriptor",
41
+ "participant_list",
42
+ "respond",
43
+ "space_create",
44
+ "space_get",
45
+ "transcript_entry_list",
46
+ "transcript_list",
47
+ ]