asqueel 0.1.0__tar.gz

asqueel-0.1.0/.gitignore

@@ -0,0 +1,51 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Virtual environments
+venv/
+env/
+ENV/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Temporary files
+temp/
+tmp/
+*.tmp
+
+# Sphinx documentation
+docs/_build/
+
+# macOS filesystem metadata
+.DS_Store

asqueel-0.1.0/.readthedocs.yaml

@@ -0,0 +1,20 @@
+# Read the Docs configuration for asqueel.
+# https://docs.readthedocs.io/en/stable/config-file/v2.html
+
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+
+sphinx:
+  configuration: docs/conf.py
+  fail_on_warning: true
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

asqueel-0.1.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Support. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 Softwell Srl, Milano, Italy
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

asqueel-0.1.0/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.5
+Name: asqueel
+Version: 0.1.0
+Summary: SQL model, PostgreSQL compiler and synchronous runtime
+Project-URL: Documentation, https://github.com/asqueel-org/asqueel/tree/main/docs
+Project-URL: Homepage, https://github.com/asqueel-org/asqueel
+Project-URL: Repository, https://github.com/asqueel-org/asqueel
+Project-URL: Issues, https://github.com/asqueel-org/asqueel/issues
+Author: Genropy Team
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: builder,database,ddl,genro,genropy,schema,sql
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: genro-bag>=0.27.0
+Requires-Dist: genro-builders>=0.27.0
+Provides-Extra: dev
+Requires-Dist: asqueel-migration[postgresql,validation]>=0.1.2; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: psycopg[binary]>=3.3.6; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=8.4; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: myst-parser>=2.0; extra == 'docs'
+Requires-Dist: sphinx-autodoc-typehints>=2.0; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=2.0; extra == 'docs'
+Requires-Dist: sphinx>=7.0; extra == 'docs'
+Requires-Dist: sphinxcontrib-mermaid>=1.0; extra == 'docs'
+Provides-Extra: migration
+Requires-Dist: asqueel-migration>=0.1.2; extra == 'migration'
+Provides-Extra: postgresql
+Requires-Dist: psycopg[binary]>=3.3.6; extra == 'postgresql'
+Description-Content-Type: text/markdown
+
+# Asqueel
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/asqueel-org/asqueel/main/assets/asqueel/svg/asqueel-wordmark-inverse.svg">
+  <img src="https://raw.githubusercontent.com/asqueel-org/asqueel/main/assets/asqueel/svg/asqueel-wordmark-primary.svg" alt="Asqueel" width="360">
+</picture>
+
+Define SQL models in Python, compile parameterized queries, and work with
+PostgreSQL through a synchronous API. Asqueel keeps logical names, physical
+database names, relationships, and column UI metadata in a shared model.
+
+The developer manual describes the intended delivery contract, including designed
+features. See [Current status](docs/guide/limitations.md) for implementation
+availability and open decisions.
+
+## Install
+
+```sh
+python -m pip install "asqueel[postgresql]"
+```
+
+Use `asqueel` for model building and offline compilation only. Add the
+`migration` extra to use the separate schema migration integration. From a
+checkout, run `python -m pip install -e ".[postgresql]"` in the repository root.
+
+## Build an application database
+
+Declare the model and connection configuration in one recipe:
+
+```python
+from asqueel import SqlDatabaseConfig, build_database
+
+
+class Shop(SqlDatabaseConfig):
+    def main(self, root):
+        db = root.db("shop", conninfo="dbname=shop")
+        customer = db.schemas().schema("sales").tables().table("customer", pkey="id")
+        columns = customer.columns()
+        columns.column("id", dtype="L")
+        columns.column("name", dtype="T", x_ui={"label": "Customer name"})
+
+
+with build_database(Shop) as db:
+    customer = db.table("sales.customer")
+    query = customer.query(
+        columns="$id, $name", where="$id >= :minimum_id",
+        params={"minimum_id": 1}, order_by="$id",
+    )
+    print(query.sqltext)  # Compiles without opening a connection.
+```
+
+Against an existing `sales.customer` table, call `query.fetch()` to get a list
+of dictionaries. Table writes and reads share a lazy session. Use `db.commit()`
+and `db.rollback()`, or group operations with `with db.transaction():`.
+Closing the database rolls back pending work; `with db:` does not commit it.
+
+Construction does not connect or create tables. The
+[runnable quickstart](docs/guide/quickstart.md) includes explicit disposable
+schema setup and cleanup. [Configuration](docs/guide/configuration.md) explains
+layered recipes and live table objects. The separate compiler and low-level
+runtime remain available for advanced integrations.
+
+Query expressions are application code; pass external values through parameters
+rather than SQL interpolation.
+
+## Learn and use Asqueel
+
+Start with [What is Asqueel?](docs/guide/overview.md) and
+[the object model](docs/guide/concepts.md), run the
+[quickstart](docs/guide/quickstart.md), then follow the
+[customers and invoices tutorial](docs/guide/tutorial.md). The tutorial includes a
+[complete runnable script](docs/guide/_examples/shop_tutorial.py) with assertions,
+transaction examples and disposable-schema cleanup.
+
+| You want to… | Read |
+|---|---|
+| Configure an application and render live objects | [Configuration](docs/guide/configuration.md) |
+| Declare names, relations, aliases and UI metadata | [Models](docs/guide/models.md) |
+| Read data or load exactly one record | [Queries](docs/guide/queries.md) |
+| Insert, update or delete | [Writes](docs/guide/writes.md) and [transactions](docs/guide/transactions.md) |
+| Add business behavior | [Table hooks](docs/guide/hooks.md) |
+| Define computed values and correlated subqueries | [Formulas](docs/guide/formulas.md) |
+| Scope data by organization, draft or deletion state | [Environment](docs/guide/environment.md) and [row policies](docs/guide/row-policies.md) |
+| Start from an existing database or manage its schema | [Importing](docs/guide/importing.md) and [migrations](docs/guide/migrations.md) |
+| Come from Genropy | [For Genropy users](docs/guide/legacy.md), including agreed differences |
+| Come from SQLAlchemy | [For SQLAlchemy users](docs/guide/for-sqlalchemy.md) |
+| Come from Django | [For Django users](docs/guide/for-django.md) |
+| Come from Peewee | [For Peewee users](docs/guide/for-peewee.md) |
+| Look up a call or diagnose a problem | [API cheat sheet](docs/guide/cheatsheet.md) and [troubleshooting](docs/guide/troubleshooting.md) |
+
+For advanced integration, see [cascading grammars](docs/guide/configuration-grammars.md),
+[the compiler](docs/guide/compiler.md), [low-level execution](docs/guide/low-level-runtime.md)
+and [adapters](docs/guide/adapters.md).
+
+The public Sphinx site contains these English guides and the API reference.
+To build it locally:
+
+```sh
+python -m pip install -e ".[docs]"
+python -m sphinx -W --keep-going -b html docs docs/_build/html
+```
+
+Open `docs/_build/html/index.html`. Internal design notes remain in the repository
+and are excluded from the public documentation build.
+
+## Development checkout
+
+For development with the migration integration, install its checkout and Asqueel
+with the development dependencies (replace the example path with your checkout):
+
+```sh
+pip install -e "../asqueel-migration[postgresql,validation]" -e ".[dev]"
+```
+
+## License
+
+Apache License 2.0 — Copyright Softwell S.r.l.

asqueel-0.1.0/README.md

@@ -0,0 +1,117 @@
+# Asqueel
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/asqueel-org/asqueel/main/assets/asqueel/svg/asqueel-wordmark-inverse.svg">
+  <img src="https://raw.githubusercontent.com/asqueel-org/asqueel/main/assets/asqueel/svg/asqueel-wordmark-primary.svg" alt="Asqueel" width="360">
+</picture>
+
+Define SQL models in Python, compile parameterized queries, and work with
+PostgreSQL through a synchronous API. Asqueel keeps logical names, physical
+database names, relationships, and column UI metadata in a shared model.
+
+The developer manual describes the intended delivery contract, including designed
+features. See [Current status](docs/guide/limitations.md) for implementation
+availability and open decisions.
+
+## Install
+
+```sh
+python -m pip install "asqueel[postgresql]"
+```
+
+Use `asqueel` for model building and offline compilation only. Add the
+`migration` extra to use the separate schema migration integration. From a
+checkout, run `python -m pip install -e ".[postgresql]"` in the repository root.
+
+## Build an application database
+
+Declare the model and connection configuration in one recipe:
+
+```python
+from asqueel import SqlDatabaseConfig, build_database
+
+
+class Shop(SqlDatabaseConfig):
+    def main(self, root):
+        db = root.db("shop", conninfo="dbname=shop")
+        customer = db.schemas().schema("sales").tables().table("customer", pkey="id")
+        columns = customer.columns()
+        columns.column("id", dtype="L")
+        columns.column("name", dtype="T", x_ui={"label": "Customer name"})
+
+
+with build_database(Shop) as db:
+    customer = db.table("sales.customer")
+    query = customer.query(
+        columns="$id, $name", where="$id >= :minimum_id",
+        params={"minimum_id": 1}, order_by="$id",
+    )
+    print(query.sqltext)  # Compiles without opening a connection.
+```
+
+Against an existing `sales.customer` table, call `query.fetch()` to get a list
+of dictionaries. Table writes and reads share a lazy session. Use `db.commit()`
+and `db.rollback()`, or group operations with `with db.transaction():`.
+Closing the database rolls back pending work; `with db:` does not commit it.
+
+Construction does not connect or create tables. The
+[runnable quickstart](docs/guide/quickstart.md) includes explicit disposable
+schema setup and cleanup. [Configuration](docs/guide/configuration.md) explains
+layered recipes and live table objects. The separate compiler and low-level
+runtime remain available for advanced integrations.
+
+Query expressions are application code; pass external values through parameters
+rather than SQL interpolation.
+
+## Learn and use Asqueel
+
+Start with [What is Asqueel?](docs/guide/overview.md) and
+[the object model](docs/guide/concepts.md), run the
+[quickstart](docs/guide/quickstart.md), then follow the
+[customers and invoices tutorial](docs/guide/tutorial.md). The tutorial includes a
+[complete runnable script](docs/guide/_examples/shop_tutorial.py) with assertions,
+transaction examples and disposable-schema cleanup.
+
+| You want to… | Read |
+|---|---|
+| Configure an application and render live objects | [Configuration](docs/guide/configuration.md) |
+| Declare names, relations, aliases and UI metadata | [Models](docs/guide/models.md) |
+| Read data or load exactly one record | [Queries](docs/guide/queries.md) |
+| Insert, update or delete | [Writes](docs/guide/writes.md) and [transactions](docs/guide/transactions.md) |
+| Add business behavior | [Table hooks](docs/guide/hooks.md) |
+| Define computed values and correlated subqueries | [Formulas](docs/guide/formulas.md) |
+| Scope data by organization, draft or deletion state | [Environment](docs/guide/environment.md) and [row policies](docs/guide/row-policies.md) |
+| Start from an existing database or manage its schema | [Importing](docs/guide/importing.md) and [migrations](docs/guide/migrations.md) |
+| Come from Genropy | [For Genropy users](docs/guide/legacy.md), including agreed differences |
+| Come from SQLAlchemy | [For SQLAlchemy users](docs/guide/for-sqlalchemy.md) |
+| Come from Django | [For Django users](docs/guide/for-django.md) |
+| Come from Peewee | [For Peewee users](docs/guide/for-peewee.md) |
+| Look up a call or diagnose a problem | [API cheat sheet](docs/guide/cheatsheet.md) and [troubleshooting](docs/guide/troubleshooting.md) |
+
+For advanced integration, see [cascading grammars](docs/guide/configuration-grammars.md),
+[the compiler](docs/guide/compiler.md), [low-level execution](docs/guide/low-level-runtime.md)
+and [adapters](docs/guide/adapters.md).
+
+The public Sphinx site contains these English guides and the API reference.
+To build it locally:
+
+```sh
+python -m pip install -e ".[docs]"
+python -m sphinx -W --keep-going -b html docs docs/_build/html
+```
+
+Open `docs/_build/html/index.html`. Internal design notes remain in the repository
+and are excluded from the public documentation build.
+
+## Development checkout
+
+For development with the migration integration, install its checkout and Asqueel
+with the development dependencies (replace the example path with your checkout):
+
+```sh
+pip install -e "../asqueel-migration[postgresql,validation]" -e ".[dev]"
+```
+
+## License
+
+Apache License 2.0 — Copyright Softwell S.r.l.

asqueel-0.1.0/assets/asqueel/icons/app-icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><title>Asqueel</title><rect width="512" height="512" rx="0" fill="#F5EBDD"/><g transform="translate(49 63) scale(4.7)"><title>Asqueel — monogramma a anguilla</title><g transform="translate(8 10)"><defs><mask id="eye-symbol-light" maskUnits="userSpaceOnUse" x="-10" y="-10" width="100" height="90"><rect x="-10" y="-10" width="100" height="90" fill="white"/><circle cx="13.7" cy="11.4" r="1.5" fill="black"/></mask></defs>
+ <g mask="url(#eye-symbol-light)">
+ <path d="M49 25 C32 28 7 29 6 46 C4 65 31 69 49 51 L49 43 C37 61 17 60 17 47 C17 36 32 32 49 30Z" fill="#571F2B"/>
+ <path d="M13 8 C20 -2 43 -5 54 7 C61 15 58 35 58 48 L48 49 L48 19 C48 6 41 3 32 3 C23 3 22 9 20 14Z" fill="#571F2B"/>
+ <path d="M48 46 L58 46 C57 56 64 58 72 53 L73 56 C63 66 48 63 48 51Z" fill="#C78249"/>
+ <path d="M14 5 C21 3 25 10 21 16 C18 22 10 24 9 17 C8 13 10 7 14 5Z" fill="#571F2B"/>
+ </g></g></g></svg>

asqueel-0.1.0/assets/asqueel/icons/favicon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><title>Asqueel</title><rect width="512" height="512" rx="100" fill="#F5EBDD"/><g transform="translate(49 63) scale(4.7)"><title>Asqueel — monogramma a anguilla</title><g transform="translate(8 10)"><defs><mask id="eye-symbol-light" maskUnits="userSpaceOnUse" x="-10" y="-10" width="100" height="90"><rect x="-10" y="-10" width="100" height="90" fill="white"/><circle cx="13.7" cy="11.4" r="1.5" fill="black"/></mask></defs>
+ <g mask="url(#eye-symbol-light)">
+ <path d="M49 25 C32 28 7 29 6 46 C4 65 31 69 49 51 L49 43 C37 61 17 60 17 47 C17 36 32 32 49 30Z" fill="#571F2B"/>
+ <path d="M13 8 C20 -2 43 -5 54 7 C61 15 58 35 58 48 L48 49 L48 19 C48 6 41 3 32 3 C23 3 22 9 20 14Z" fill="#571F2B"/>
+ <path d="M48 46 L58 46 C57 56 64 58 72 53 L73 56 C63 66 48 63 48 51Z" fill="#C78249"/>
+ <path d="M14 5 C21 3 25 10 21 16 C18 22 10 24 9 17 C8 13 10 7 14 5Z" fill="#571F2B"/>
+ </g></g></g></svg>

asqueel-0.1.0/assets/asqueel/icons/site.webmanifest

@@ -0,0 +1,21 @@
+{
+  "name": "Asqueel",
+  "short_name": "Asqueel",
+  "icons": [
+    {
+      "src": "android-chrome-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "android-chrome-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any"
+    }
+  ],
+  "theme_color": "#571F2B",
+  "background_color": "#F5EBDD",
+  "display": "standalone"
+}

asqueel-0.1.0/assets/asqueel/index.html

@@ -0,0 +1,7 @@
+<!doctype html><html lang="it"><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Asqueel — Asset approvati</title><link rel="stylesheet" href="palette/asqueel-palette.css"><style>*{box-sizing:border-box}body{margin:0;background:#F5EBDD;color:#2C2223;font:16px/1.6 Arial,sans-serif}main{max-width:1100px;margin:auto;padding:48px 28px}h1,h2{font-family:Georgia,serif;font-weight:normal}h1{font-size:40px}h2{margin-top:45px}a{color:#79323D}img{max-width:100%;display:block}.grid{display:grid;grid-template-columns:1fr 1fr;gap:20px}.card{padding:32px;border-radius:12px;background:#fffaf3;border:1px solid #571F2B20}.dark{background:#2C2223;color:#F5EBDD}.dark a{color:#D5AE65}.symbol{width:150px;margin:10px auto 25px}.swatches{display:grid;grid-template-columns:repeat(7,1fr);gap:10px}.color{height:90px;border:1px solid #0001;border-radius:8px}.small{font-size:13px}code,pre{font:13px/1.7 monospace}pre{overflow:auto;padding:20px;background:#fffaf3;border-radius:10px}table{border-collapse:collapse;width:100%}td,th{text-align:left;padding:10px;border-bottom:1px solid #571F2B20}@media(max-width:650px){.grid{grid-template-columns:1fr}.swatches{grid-template-columns:repeat(3,1fr)}} </style><main><p class="small">ASQUEEL / ASSET APPROVATI</p><h1>La scritta e la sua iniziale.</h1><p>La scritta è <strong>asqueel</strong>, tutta minuscola e compatta. Il logo autonomo è la stessa a-anguilla ingrandita: anellino a sinistra, testa sopra, corpo a destra e grazia rame.</p><p><a href="../asqueel-assets.zip">Scarica il pacchetto ZIP</a> · <a href="manifest.json">Elenco completo dei file</a></p><div class="grid"><div class="card"><img src="svg/asqueel-wordmark-primary.svg" alt="Scritta asqueel"><img class="symbol" src="svg/asqueel-monogram-primary.svg" alt="Logo a anguilla"><a href="svg/asqueel-wordmark-primary.svg">Scritta SVG</a> · <a href="svg/asqueel-monogram-primary.svg">Logo SVG</a></div><div class="card dark"><img src="svg/asqueel-wordmark-inverse.svg" alt="Scritta su fondo scuro"><img class="symbol" src="svg/asqueel-monogram-inverse.svg" alt="Logo su fondo scuro"><a href="svg/asqueel-wordmark-inverse.svg">Scritta inversa</a> · <a href="svg/asqueel-monogram-inverse.svg">Logo inverso</a></div></div><h2>File e formati</h2><table><tr><th>Cartella</th><th>Contenuto</th></tr><tr><td>svg/</td><td>Scritta e monogramma: primary, inverse, burgundy, black, white. Sfondo trasparente; lettering in tracciati.</td></tr><tr><td>png/</td><td>Scritta a 512, 1024 e 2048 px di larghezza. Logo su tela quadrata a 64, 128, 256, 512 e 1024 px. Cinque varianti, tutte trasparenti.</td></tr><tr><td>icons/</td><td>Favicon SVG e ICO (16, 32, 48 px), PNG 16/32/48, Apple Touch 180, icone 192 e 512, webmanifest. Fondo pergamena.</td></tr><tr><td>social/</td><td>Immagine 1200 × 630, SVG e PNG.</td></tr><tr><td>palette/</td><td>Cartella colori SVG, CSS, JSON e GIMP GPL.</td></tr><tr><td>preview/</td><td>Presentazione PNG e SVG.</td></tr></table><h2>Palette</h2><div class="swatches"><div><div class="color" style="background:#571F2B"></div><div class="small">oxblood<br><code>#571F2B</code></div></div><div><div class="color" style="background:#79323D"></div><div class="small">wine<br><code>#79323D</code></div></div><div><div class="color" style="background:#AD5036"></div><div class="small">rust<br><code>#AD5036</code></div></div><div><div class="color" style="background:#C78249"></div><div class="small">copper<br><code>#C78249</code></div></div><div><div class="color" style="background:#D5AE65"></div><div class="small">ochre<br><code>#D5AE65</code></div></div><div><div class="color" style="background:#F5EBDD"></div><div class="small">parchment<br><code>#F5EBDD</code></div></div><div><div class="color" style="background:#2C2223"></div><div class="small">ink<br><code>#2C2223</code></div></div></div><h2>Uso</h2><p>Usa <strong>primary</strong> su fondi chiari e <strong>inverse</strong> su fondi scuri. Le versioni burgundy, black e white servono per riproduzioni a un solo colore. La scritta e il monogramma sono due applicazioni della stessa forma: non aggiungere un secondo simbolo davanti alla scritta.</p><p>Mantieni le proporzioni e uno spazio libero intorno al marchio pari almeno all’altezza dell’anellino della a. Come punto di partenza usa la scritta da 160 px di larghezza e il monogramma da 32 px; a 16 px il piccolo occhio può perdere definizione.</p><p>Rosso cupo e rame identificano il marchio; pergamena è il fondo principale. Ruggine e ocra sono colori di supporto. Non usare gli accenti chiari per testo minuto su fondo pergamena.</p><h2>Integrazione web</h2><p>Adatta i percorsi alla posizione degli asset nel sito.</p><pre>&lt;img src="/assets/asqueel/svg/asqueel-wordmark-primary.svg"
+     alt="Asqueel" width="280"&gt;
+
+&lt;link rel="icon" href="/assets/asqueel/icons/favicon.svg" type="image/svg+xml"&gt;
+&lt;link rel="icon" href="/assets/asqueel/icons/favicon.ico" sizes="16x16 32x32 48x48"&gt;
+&lt;link rel="apple-touch-icon" href="/assets/asqueel/icons/apple-touch-icon.png"&gt;
+&lt;link rel="manifest" href="/assets/asqueel/icons/site.webmanifest"&gt;</pre><p class="small">Gli SVG della scritta e del monogramma non richiedono font. La tavola social contiene un sottotitolo in Arial/sans-serif; usa il PNG per una resa fissa. Se inserisci più copie di uno stesso SVG direttamente nell’HTML, rendi univoci gli identificatori delle maschere; con &lt;img&gt; non è necessario.</p></main></html>