sigil-creator 0.1.0__tar.gz

sigil_creator-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sigil Creator Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sigil_creator-0.1.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: sigil-creator
+Version: 0.1.0
+Summary: CLI tools for creating personal magical sigils using classical and chaos magic methods (Spare letter reduction, Agrippa planetary kameas, Rose Cross, and grimoire-style seals).
+Author: Sigil Creator Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/CraftingBuilds/sigil-creator-cli
+Project-URL: Documentation, https://github.com/CraftingBuilds/sigil-creator-cli#readme
+Keywords: sigil,chaos-magic,occult,grimoire,kamea,cli,magic
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Religion
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# sigil-creator
+
+**CLI tools for creating personal magical sigils** grounded in classical Western occult traditions and modern chaos magic.
+
+Implements the deterministic helper steps used by the [sigil-creator](https://github.com/example/sigil-creator) skill:
+
+- Austin Osman Spare / chaos-magic letter reduction
+- Letter → number conversion for Agrippa planetary kameas
+- Visual **Sigil Profiles** (YAML) for consistent aesthetic rendering
+- Method and kamea reference documents
+
+The actual artistic construction of the glyph (overlapping strokes, path drawing on a magic square, image generation) is left to the practitioner or an external image model. This package supplies the reduction, numbering, style definitions, and documentation.
+
+## Installation (Linux / macOS)
+
+### From source (recommended while developing)
+
+```bash
+cd sigil-creator-cli
+python3 -m pip install --user -e .
+```
+
+### Or build a wheel / sdist
+
+```bash
+python3 -m pip install build
+python3 -m build
+python3 -m pip install dist/sigil_creator-*.whl
+```
+
+After installation the following commands are available:
+
+| Command            | Purpose                                      |
+|--------------------|----------------------------------------------|
+| `sigil`            | Main multi-command entry point               |
+| `sigil-reduce`     | Stand-alone letter reducer                   |
+| `sigil-numbers`    | Stand-alone letter→number converter          |
+
+## Quick start
+
+```bash
+# 1. Reduce a Statement of Intent (Spare method)
+sigil reduce "I am financially secure"
+# → MFNCLYSR
+
+# Keep vowels
+sigil reduce --keep-vowels "I am financially secure"
+
+# 2. Convert to kamea path numbers
+sigil numbers MFNCLYSR
+sigil numbers --max 7 "I am financially secure"
+
+# 3. List / inspect visual profiles
+sigil profiles
+sigil show-profile antiquarian_calligraphic
+sigil show-profile chaos_minimal
+
+# 4. Read the full method reference
+sigil methods
+sigil methods --section Spare
+sigil methods --section Kamea
+sigil kameas
+
+# 5. Concise workflow reminder
+sigil guide
+```
+
+You can also pipe:
+
+```bash
+echo "It is my will to write every day" | sigil reduce
+```
+
+## Available Sigil Profiles
+
+| ID                        | Character                                      |
+|---------------------------|------------------------------------------------|
+| `antiquarian_calligraphic`| Bold, archaic, interwoven, calligraphic        |
+| `grimoire_engraved`       | Severe, angular, authoritative, plate-like     |
+| `chaos_minimal`           | Clean, abstract, psychological, decisive       |
+| `alchemical_manuscript`   | Ornate yet restrained, symbolic, manuscript    |
+
+Profiles live in `sigil_creator/data/profiles/` and can be extended by dropping additional YAML files.
+
+## Planetary Kameas (summary)
+
+| Planet  | Square | Typical use                          |
+|---------|--------|--------------------------------------|
+| Saturn  | 3×3    | Protection, boundaries, endings      |
+| Jupiter | 4×4    | Wealth, expansion, success           |
+| Mars    | 5×5    | Energy, courage, conflict            |
+| Sun     | 6×6    | Vitality, recognition, leadership    |
+| Venus   | 7×7    | Love, beauty, harmony                |
+| Mercury | 8×8    | Communication, intellect, commerce   |
+| Moon    | 9×9    | Intuition, cycles, the subconscious  |
+
+Full squares and reduction rules: `sigil kameas`.
+
+## Charging & release (reminder)
+
+1. Formulate a clear, present-tense, positive Statement of Intent.
+2. Reduce / map it into an abstract mark.
+3. Enter a state of gnosis (meditation, breath work, movement, etc.) while focusing on the sigil.
+4. Deliberately forget the original desire so the unconscious can work.
+5. Destroy, bury, or hide the physical sigil.
+
+This package treats the practice as psychological technology, artistic craft, or sincere occult work according to the user’s own framework. It makes no claims about results.
+
+## Development layout
+
+```
+sigil-creator-cli/
+├── pyproject.toml
+├── README.md
+├── src/sigil_creator/
+│   ├── __init__.py
+│   ├── cli.py                 # main `sigil` command
+│   ├── reduce_letters.py
+│   ├── letters_to_numbers.py
+│   └── data/
+│       ├── profiles/          # YAML style definitions
+│       └── references/        # methods.md, kameas.md
+```
+
+## License
+
+MIT

sigil_creator-0.1.0/README.md

@@ -0,0 +1,127 @@
+# sigil-creator
+
+**CLI tools for creating personal magical sigils** grounded in classical Western occult traditions and modern chaos magic.
+
+Implements the deterministic helper steps used by the [sigil-creator](https://github.com/example/sigil-creator) skill:
+
+- Austin Osman Spare / chaos-magic letter reduction
+- Letter → number conversion for Agrippa planetary kameas
+- Visual **Sigil Profiles** (YAML) for consistent aesthetic rendering
+- Method and kamea reference documents
+
+The actual artistic construction of the glyph (overlapping strokes, path drawing on a magic square, image generation) is left to the practitioner or an external image model. This package supplies the reduction, numbering, style definitions, and documentation.
+
+## Installation (Linux / macOS)
+
+### From source (recommended while developing)
+
+```bash
+cd sigil-creator-cli
+python3 -m pip install --user -e .
+```
+
+### Or build a wheel / sdist
+
+```bash
+python3 -m pip install build
+python3 -m build
+python3 -m pip install dist/sigil_creator-*.whl
+```
+
+After installation the following commands are available:
+
+| Command            | Purpose                                      |
+|--------------------|----------------------------------------------|
+| `sigil`            | Main multi-command entry point               |
+| `sigil-reduce`     | Stand-alone letter reducer                   |
+| `sigil-numbers`    | Stand-alone letter→number converter          |
+
+## Quick start
+
+```bash
+# 1. Reduce a Statement of Intent (Spare method)
+sigil reduce "I am financially secure"
+# → MFNCLYSR
+
+# Keep vowels
+sigil reduce --keep-vowels "I am financially secure"
+
+# 2. Convert to kamea path numbers
+sigil numbers MFNCLYSR
+sigil numbers --max 7 "I am financially secure"
+
+# 3. List / inspect visual profiles
+sigil profiles
+sigil show-profile antiquarian_calligraphic
+sigil show-profile chaos_minimal
+
+# 4. Read the full method reference
+sigil methods
+sigil methods --section Spare
+sigil methods --section Kamea
+sigil kameas
+
+# 5. Concise workflow reminder
+sigil guide
+```
+
+You can also pipe:
+
+```bash
+echo "It is my will to write every day" | sigil reduce
+```
+
+## Available Sigil Profiles
+
+| ID                        | Character                                      |
+|---------------------------|------------------------------------------------|
+| `antiquarian_calligraphic`| Bold, archaic, interwoven, calligraphic        |
+| `grimoire_engraved`       | Severe, angular, authoritative, plate-like     |
+| `chaos_minimal`           | Clean, abstract, psychological, decisive       |
+| `alchemical_manuscript`   | Ornate yet restrained, symbolic, manuscript    |
+
+Profiles live in `sigil_creator/data/profiles/` and can be extended by dropping additional YAML files.
+
+## Planetary Kameas (summary)
+
+| Planet  | Square | Typical use                          |
+|---------|--------|--------------------------------------|
+| Saturn  | 3×3    | Protection, boundaries, endings      |
+| Jupiter | 4×4    | Wealth, expansion, success           |
+| Mars    | 5×5    | Energy, courage, conflict            |
+| Sun     | 6×6    | Vitality, recognition, leadership    |
+| Venus   | 7×7    | Love, beauty, harmony                |
+| Mercury | 8×8    | Communication, intellect, commerce   |
+| Moon    | 9×9    | Intuition, cycles, the subconscious  |
+
+Full squares and reduction rules: `sigil kameas`.
+
+## Charging & release (reminder)
+
+1. Formulate a clear, present-tense, positive Statement of Intent.
+2. Reduce / map it into an abstract mark.
+3. Enter a state of gnosis (meditation, breath work, movement, etc.) while focusing on the sigil.
+4. Deliberately forget the original desire so the unconscious can work.
+5. Destroy, bury, or hide the physical sigil.
+
+This package treats the practice as psychological technology, artistic craft, or sincere occult work according to the user’s own framework. It makes no claims about results.
+
+## Development layout
+
+```
+sigil-creator-cli/
+├── pyproject.toml
+├── README.md
+├── src/sigil_creator/
+│   ├── __init__.py
+│   ├── cli.py                 # main `sigil` command
+│   ├── reduce_letters.py
+│   ├── letters_to_numbers.py
+│   └── data/
+│       ├── profiles/          # YAML style definitions
+│       └── references/        # methods.md, kameas.md
+```
+
+## License
+
+MIT

sigil_creator-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sigil-creator"
+version = "0.1.0"
+description = "CLI tools for creating personal magical sigils using classical and chaos magic methods (Spare letter reduction, Agrippa planetary kameas, Rose Cross, and grimoire-style seals)."
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Sigil Creator Contributors"}
+]
+keywords = ["sigil", "chaos-magic", "occult", "grimoire", "kamea", "cli", "magic"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Topic :: Religion",
+    "Topic :: Utilities",
+]
+
+[project.scripts]
+sigil = "sigil_creator.cli:main"
+sigil-reduce = "sigil_creator.reduce_letters:main"
+sigil-numbers = "sigil_creator.letters_to_numbers:main"
+
+[project.urls]
+Homepage = "https://github.com/CraftingBuilds/sigil-creator-cli"
+Documentation = "https://github.com/CraftingBuilds/sigil-creator-cli#readme"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"sigil_creator" = ["data/profiles/*.yaml", "data/references/*.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]

sigil_creator-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sigil_creator-0.1.0/src/sigil_creator/__init__.py

@@ -0,0 +1,4 @@
+"""Sigil Creator — CLI tools for personal magical sigil construction."""
+
+__version__ = "0.1.0"
+__all__ = ["reduce_letters", "letters_to_numbers", "cli"]

sigil_creator-0.1.0/src/sigil_creator/cli.py

@@ -0,0 +1,233 @@
+#!/usr/bin/env python3
+"""Main entry point for the sigil-creator CLI."""
+
+from __future__ import annotations
+
+import argparse
+import importlib.resources as resources
+import sys
+from pathlib import Path
+from typing import Optional
+
+from . import __version__
+from .reduce_letters import reduce_intent
+from .letters_to_numbers import convert
+
+
+def get_data_path(relative: str) -> Path:
+    """Locate package data files (profiles, references)."""
+    try:
+        # Python 3.9+
+        base = resources.files("sigil_creator")
+        return Path(str(base.joinpath("data", relative)))
+    except Exception:
+        # Fallback for development / editable installs
+        here = Path(__file__).resolve().parent
+        return here / "data" / relative
+
+
+def cmd_reduce(args: argparse.Namespace) -> int:
+    text = args.intent or sys.stdin.read()
+    if not text.strip():
+        print("Error: provide a statement of intent as argument or on stdin.", file=sys.stderr)
+        return 1
+    result = reduce_intent(
+        text.strip(),
+        remove_vowels=not args.keep_vowels,
+        keep_case=args.keep_case,
+    )
+    print(result)
+    return 0
+
+
+def cmd_numbers(args: argparse.Namespace) -> int:
+    text = args.text or sys.stdin.read()
+    if not text.strip():
+        print("Error: provide letters or intent as argument or on stdin.", file=sys.stderr)
+        return 1
+    numbers = convert(text, reduce=not args.no_reduce, max_val=args.max)
+    print(" ".join(map(str, numbers)))
+    if args.verbose:
+        print(f"Sequence: {numbers}", file=sys.stderr)
+    return 0
+
+
+def cmd_profiles(args: argparse.Namespace) -> int:
+    profiles_dir = get_data_path("profiles")
+    if not profiles_dir.is_dir():
+        print(f"Profiles directory not found: {profiles_dir}", file=sys.stderr)
+        return 1
+    files = sorted(profiles_dir.glob("*.yaml"))
+    if not files:
+        print("No profiles found.")
+        return 0
+    for f in files:
+        print(f.stem)
+        if args.verbose:
+            print(f"  → {f}")
+    return 0
+
+
+def cmd_show_profile(args: argparse.Namespace) -> int:
+    path = get_data_path(f"profiles/{args.name}.yaml")
+    if not path.is_file():
+        # try without extension / fuzzy
+        candidates = list(get_data_path("profiles").glob(f"*{args.name}*.yaml"))
+        if len(candidates) == 1:
+            path = candidates[0]
+        else:
+            print(f"Profile not found: {args.name}", file=sys.stderr)
+            print("Available:", file=sys.stderr)
+            for p in sorted(get_data_path("profiles").glob("*.yaml")):
+                print(f"  {p.stem}", file=sys.stderr)
+            return 1
+    print(path.read_text(encoding="utf-8"))
+    return 0
+
+
+def cmd_methods(args: argparse.Namespace) -> int:
+    path = get_data_path("references/methods.md")
+    if not path.is_file():
+        print(f"Reference not found: {path}", file=sys.stderr)
+        return 1
+    text = path.read_text(encoding="utf-8")
+    if args.section:
+        # Simple section filter
+        lines = text.splitlines()
+        out = []
+        capturing = False
+        for line in lines:
+            if line.startswith("## ") and args.section.lower() in line.lower():
+                capturing = True
+            elif line.startswith("## ") and capturing:
+                break
+            if capturing:
+                out.append(line)
+        print("\n".join(out) if out else text)
+    else:
+        print(text)
+    return 0
+
+
+def cmd_kameas(args: argparse.Namespace) -> int:
+    path = get_data_path("references/kameas.md")
+    if not path.is_file():
+        print(f"Reference not found: {path}", file=sys.stderr)
+        return 1
+    print(path.read_text(encoding="utf-8"))
+    return 0
+
+
+def cmd_guide(args: argparse.Namespace) -> int:
+    """Print a concise practical guide for creating a sigil from the CLI."""
+    guide = f"""
+sigil-creator {__version__} — Quick Guide
+========================================
+
+1. Formulate a Statement of Intent (SoI)
+   Present tense, positive, specific, already-true:
+     "I am financially secure"
+     "It is my will to find steady creative work I enjoy"
+
+2. Reduce the letters (Spare / chaos method — default)
+   $ sigil reduce "I am financially secure"
+   → MFNCLYSR   (vowels removed, unique letters)
+
+   Keep vowels:
+   $ sigil reduce --keep-vowels "I am financially secure"
+
+3. Convert to numbers for a planetary kamea
+   $ sigil numbers MFNCLYSR
+   $ sigil numbers --max 9 "I am financially secure"
+
+4. Choose a visual profile
+   $ sigil profiles
+   $ sigil show-profile antiquarian_calligraphic
+
+5. Read method details
+   $ sigil methods
+   $ sigil methods --section Spare
+   $ sigil kameas
+
+6. Construct the glyph yourself (or with an image model)
+   - Overlap / rotate / share strokes of the reduced letters
+   - For kamea: plot the number sequence as a path on the chosen square
+     (start with open circle, end with a bar)
+   - Apply the stroke, geometry and composition rules from the chosen profile
+
+7. Charge & release
+   Enter gnosis (meditation, breath, movement, etc.), gaze, then deliberately
+   forget the original desire. Destroy or hide the physical mark.
+
+Full references are shipped with the package under the data/ tree.
+"""
+    print(guide.strip())
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="sigil",
+        description="Create personal magical sigils — letter reduction, kamea numbers, profiles & references.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="Examples:\n"
+               "  sigil reduce \"I am calm and focused\"\n"
+               "  sigil numbers --max 7 ABCDEF\n"
+               "  sigil profiles\n"
+               "  sigil show-profile chaos_minimal\n"
+               "  sigil methods --section Kamea\n"
+               "  sigil guide\n",
+    )
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    # reduce
+    p_reduce = sub.add_parser("reduce", help="Reduce a statement of intent to unique letters (Spare method)")
+    p_reduce.add_argument("intent", nargs="?", help="Statement of intent (or read from stdin)")
+    p_reduce.add_argument("--keep-vowels", action="store_true", help="Do not strip vowels")
+    p_reduce.add_argument("--keep-case", action="store_true", help="Preserve original case")
+    p_reduce.set_defaults(func=cmd_reduce)
+
+    # numbers
+    p_num = sub.add_parser("numbers", help="Convert letters to numbers for kamea paths")
+    p_num.add_argument("text", nargs="?", help="Letters or full intent (or stdin)")
+    p_num.add_argument("--no-reduce", action="store_true", help="Do not digital-root reduce")
+    p_num.add_argument("--max", type=int, default=9, help="Maximum value after reduction (default 9)")
+    p_num.add_argument("-v", "--verbose", action="store_true")
+    p_num.set_defaults(func=cmd_numbers)
+
+    # profiles
+    p_prof = sub.add_parser("profiles", help="List available visual Sigil Profiles")
+    p_prof.add_argument("-v", "--verbose", action="store_true")
+    p_prof.set_defaults(func=cmd_profiles)
+
+    # show-profile
+    p_show = sub.add_parser("show-profile", help="Print a profile YAML definition")
+    p_show.add_argument("name", help="Profile id (e.g. antiquarian_calligraphic)")
+    p_show.set_defaults(func=cmd_show_profile)
+
+    # methods
+    p_meth = sub.add_parser("methods", help="Show detailed method reference")
+    p_meth.add_argument("--section", "-s", help="Filter to a section title (Spare, Kamea, Rose, Grimoire…)")
+    p_meth.set_defaults(func=cmd_methods)
+
+    # kameas
+    p_kam = sub.add_parser("kameas", help="Show Agrippa planetary magic squares reference")
+    p_kam.set_defaults(func=cmd_kameas)
+
+    # guide
+    p_guide = sub.add_parser("guide", help="Print a short practical workflow guide")
+    p_guide.set_defaults(func=cmd_guide)
+
+    return parser
+
+
+def main(argv: Optional[list[str]] = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    return args.func(args)
+
+
+if __name__ == "__main__":
+    sys.exit(main())