kunyi 0.1.0__tar.gz

kunyi-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+# Data
+Calc2
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+*.apkg.DS_Store

kunyi-0.1.0/Exam2prep.json

@@ -0,0 +1,260 @@
+{
+  "deck_name": "Cloud Computing - Quiz 5",
+  "cards": [
+    {
+      "question": "What is the primary role of the client in a client-server architecture?",
+      "choices": [
+        "security",
+        "business logic",
+        "user interaction",
+        "data modeling"
+      ],
+      "correct_answer": "user interaction",
+      "explanation": "In a client-server model, the client is mainly responsible for user-facing interactions, such as input and display."
+    },
+    {
+      "question": "Which term refers to dividing an application into multiple layers or tiers?",
+      "choices": [
+        "standalone",
+        "client-server",
+        "load balancing",
+        "n-tier layered"
+      ],
+      "correct_answer": "n-tier layered",
+      "explanation": "N-tier layering separates an application into distinct layers (presentation, business logic, data access, etc.), improving maintainability and scalability."
+    },
+    {
+      "question": "What does MTTF stand for in the context of availability?",
+      "choices": [
+        "Mean Time To Failure",
+        "Mean Time To Fix",
+        "Mean Time To Function",
+        "Mean Time To Finish"
+      ],
+      "correct_answer": "Mean Time To Failure",
+      "explanation": "MTTF (Mean Time To Failure) is the average time a system operates before failing, often used as a measure of reliability."
+    },
+    {
+      "question": "What is the process of distributing tasks over resources according to a set of criteria called?",
+      "choices": ["scaling", "load balancing", "elasticity", "auto scaling"],
+      "correct_answer": "load balancing",
+      "explanation": "Load balancing is the technique of efficiently distributing network or application traffic across multiple servers."
+    },
+    {
+      "question": "Which load balancing algorithm distributes tasks equally among resources?",
+      "choices": [
+        "least connections",
+        "source IP hash",
+        "round robin",
+        "least response time"
+      ],
+      "correct_answer": "round robin",
+      "explanation": "Round robin cycles through each resource in order, effectively distributing tasks evenly in turn."
+    },
+    {
+      "question": "Which load balancing algorithm distributes tasks based on the client's IP address?",
+      "choices": [
+        "least connections",
+        "source IP hash",
+        "round robin",
+        "least response time"
+      ],
+      "correct_answer": "source IP hash",
+      "explanation": "Source IP hash creates a unique hash of the client's IP and maps it to a specific server for consistent routing."
+    },
+    {
+      "question": "Which load balancing algorithm prioritizes tasks based on the time taken to respond to requests?",
+      "choices": [
+        "least connections",
+        "source IP hash",
+        "round robin",
+        "least response time"
+      ],
+      "correct_answer": "least response time",
+      "explanation": "Least response time forwards requests to the server with the fastest response measurement, helping to reduce latency."
+    },
+    {
+      "question": "Which load balancing algorithm distributes tasks based on the number of active connections each resource has?",
+      "choices": [
+        "least connections",
+        "source IP hash",
+        "round robin",
+        "least response time"
+      ],
+      "correct_answer": "least connections",
+      "explanation": "Least connections sends new requests to the resource currently handling the fewest active connections."
+    },
+    {
+      "question": "What is the ability of a system to change in order to meet application demands called?",
+      "choices": [
+        "elasticity",
+        "scalability",
+        "load balancing",
+        "availability"
+      ],
+      "correct_answer": "scalability",
+      "explanation": "Scalability is the system's capacity to handle increasing workloads by adding resources, without impact to performance."
+    },
+    {
+      "question": "Which type of auto scaling uses machine learning to predict demand?",
+      "choices": ["scheduled", "dynamic", "predictive", "manual"],
+      "correct_answer": "predictive",
+      "explanation": "Predictive auto scaling anticipates future resource needs using historical data or ML models."
+    },
+    {
+      "question": "Which type of auto scaling changes based on a pre-defined date/time setting?",
+      "choices": ["scheduled", "dynamic", "predictive", "manual"],
+      "correct_answer": "scheduled",
+      "explanation": "Scheduled auto scaling uses specific date/time triggers to scale out or in, perfect for known peak/off-peak times."
+    },
+    {
+      "question": "In the context of auto scaling, what does the parameter scale_in_cooldown set?",
+      "choices": [
+        "The target metric level",
+        "A cooldown period after a scale-in activity",
+        "A cooldown period after a scale-out activity",
+        "The desired capacity"
+      ],
+      "correct_answer": "A cooldown period after a scale-in activity",
+      "explanation": "scale_in_cooldown prevents immediate subsequent scaling actions, giving the system time to stabilize after shrinking capacity."
+    },
+    {
+      "question": "Which type of load balancer can request new resources when sensing a demand increase?",
+      "choices": [
+        "Static load balancer",
+        "Network load balancer",
+        "Elastic load balancer",
+        "DNS-based load balancer"
+      ],
+      "correct_answer": "Elastic load balancer",
+      "explanation": "An elastic load balancer integrates with auto scaling to dynamically provision or decommission resources based on current demand."
+    },
+    {
+      "question": "Which type of load balancer can be configured to perform name translations to targets based on a set of criteria?",
+      "choices": [
+        "Static load balancer",
+        "Network load balancer",
+        "Elastic load balancer",
+        "DNS-based load balancer"
+      ],
+      "correct_answer": "DNS-based load balancer",
+      "explanation": "DNS-based load balancers (e.g., AWS Route 53) use DNS responses to send clients to the appropriate server based on criteria like geo-location."
+    },
+    {
+      "question": "What is the primary goal of dynamic load balancers?",
+      "choices": [
+        "To distribute tasks equally among resources",
+        "To have real-time knowledge of the current load of each resource",
+        "To operate at the transport level",
+        "To perform name translations based on criteria"
+      ],
+      "correct_answer": "To have real-time knowledge of the current load of each resource",
+      "explanation": "Dynamic load balancers continually monitor server loads, connections, or response times to make smarter routing decisions."
+    },
+    {
+      "question": "What is serverless computing?",
+      "choices": [
+        "Computing without servers",
+        "A model of computation where resources are automatically allocated by the cloud provider",
+        "A type of physical server",
+        "A local computing model"
+      ],
+      "correct_answer": "A model of computation where resources are automatically allocated by the cloud provider",
+      "explanation": "Serverless computing abstracts away server management—resources are provisioned on demand by the cloud provider, so developers focus only on code."
+    },
+    {
+      "question": "What is another term for serverless computing?",
+      "choices": [
+        "Infrastructure as a Service (IaaS)",
+        "Platform as a Service (PaaS)",
+        "Software as a Service (SaaS)",
+        "Function as a Service (FaaS)"
+      ],
+      "correct_answer": "Function as a Service (FaaS)",
+      "explanation": "Serverless architectures are often called FaaS because individual functions are deployed and run without managing servers."
+    },
+    {
+      "question": "Which of the following is NOT an advantage of serverless computing?",
+      "choices": [
+        "No servers to manage",
+        "Easy pricing based on executions and CPU time",
+        "Maximum execution time limitations",
+        "Automatic scaling"
+      ],
+      "correct_answer": "Maximum execution time limitations",
+      "explanation": "Execution time limits (e.g., 15 minutes in AWS Lambda) are constraints, not benefits, making them a disadvantage."
+    },
+    {
+      "question": "How are customers (normally) billed in serverless computing?",
+      "choices": [
+        "Monthly subscription",
+        "During the time their code is executed",
+        "Number of servers used",
+        "Flat rate per function"
+      ],
+      "correct_answer": "During the time their code is executed",
+      "explanation": "Billing is usage‑based—seconds of execution and resources consumed—rather than fixed server counts or flat subscriptions."
+    },
+    {
+      "question": "What is a Lambda function?",
+      "choices": [
+        "A tiny function deployed in serverless computing",
+        "A type of server",
+        "A program language",
+        "A cloud storage service"
+      ],
+      "correct_answer": "A tiny function deployed in serverless computing",
+      "explanation": "AWS Lambda lets you run small, event‑driven functions without provisioning or managing servers."
+    },
+    {
+      "question": "Which of the following is a disadvantage of serverless computing?",
+      "choices": [
+        "No servers to manage",
+        "Easy pricing",
+        "Automatic scaling",
+        "Harder to test/debug"
+      ],
+      "correct_answer": "Harder to test/debug",
+      "explanation": "Because infrastructure is abstracted away and functions are event‑driven, replicating the environment locally can be challenging for testing and debugging."
+    },
+    {
+      "question": "What does synchronous invocation mean?",
+      "choices": [
+        "The callee waits for the response",
+        "The callee doesn’t wait for the response",
+        "The function is triggered by an event",
+        "The function runs indefinitely"
+      ],
+      "correct_answer": "The callee waits for the response",
+      "explanation": "With synchronous invocation, the caller blocks until the function finishes and returns a result."
+    },
+    {
+      "question": "Which of the following is an example of a trigger for a Lambda function?",
+      "choices": [
+        "A scheduled event",
+        "A new object uploaded to an S3 bucket",
+        "An HTTP request from an API",
+        "All of the above"
+      ],
+      "correct_answer": "All of the above",
+      "explanation": "Lambda can be triggered by many sources, including scheduled events (CloudWatch), S3 object uploads, or API Gateway HTTP requests."
+    },
+    {
+      "question": "What is the event object in serverless computing (in AWS)?",
+      "choices": [
+        "A JSON-formatted document containing data for a lambda function",
+        "A physical server",
+        "A programming language",
+        "A cloud storage service"
+      ],
+      "correct_answer": "A JSON-formatted document containing data for a lambda function",
+      "explanation": "When Lambda is invoked, AWS passes the triggering data as a JSON event object to the function handler."
+    },
+    {
+      "question": "What is the current maximum execution time set by AWS for Lambda functions in minutes?",
+      "choices": ["5", "10", "15", "30"],
+      "correct_answer": "15",
+      "explanation": "As of 2024, AWS Lambda allows a maximum execution timeout of 900 seconds (15 minutes) per invocation."
+    }
+  ]
+}

kunyi-0.1.0/LICENSE

@@ -0,0 +1,129 @@
+PolyForm Noncommercial License 1.0.0
+
+https://polyformproject.org/licenses/noncommercial/1.0.0
+
+Required Notice: Copyright Ta'taang (Ling Thang) (https://github.com/LingT03)
+
+Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose. However, you may
+only distribute the software according to Distribution License
+and make changes or new works based on the software according
+to Changes and New Works License.
+
+Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software. Your license
+to distribute covers distributing the software with
+changes and new works permitted by Changes and New Works License.
+
+Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with "Required Notice:" that the licensor provided
+with the software.
+
+Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else. These terms do not imply
+any other licenses.
+
+Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice. Otherwise, all your licenses
+end immediately.
+
+No Liability
+
+AS FAR AS THE LAW ALLOWS, THE SOFTWARE COMES AS IS, WITHOUT
+ANY WARRANTY OR CONDITION, AND THE LICENSOR WILL NOT BE LIABLE
+TO YOU FOR ANY DAMAGES ARISING OUT OF THESE TERMS OR THE USE
+OR NATURE OF THE SOFTWARE, UNDER ANY KIND OF LEGAL CLAIM.
+
+Definitions
+
+The "licensor" is the individual or entity offering these
+terms, and the "software" is the software the licensor makes
+available under these terms.
+
+"You" refers to the individual or entity agreeing to these
+terms.
+
+"Your company" is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization. "Control"
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise. Control can be direct or indirect.
+
+"Your licenses" are all the licenses granted to you for the
+software under these terms.
+
+"Use" means anything you do with the software requiring one
+of your licenses.

kunyi-0.1.0/PKG-INFO

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: kunyi
+Version: 0.1.0
+Summary: Generate Anki .apkg decks from JSON (MCQ) or TSV (basic) card data.
+Project-URL: Homepage, https://github.com/LingT03/Kunyi
+Project-URL: Bug Tracker, https://github.com/LingT03/Kunyi/issues
+Project-URL: Changelog, https://github.com/LingT03/Kunyi/releases
+License: PolyForm Noncommercial License 1.0.0
+        
+        https://polyformproject.org/licenses/noncommercial/1.0.0
+        
+        Required Notice: Copyright Ta'taang (Ling Thang) (https://github.com/LingT03)
+        
+        Acceptance
+        
+        In order to get any license under these terms, you must agree
+        to them as both strict obligations and conditions to all
+        your licenses.
+        
+        Copyright License
+        
+        The licensor grants you a copyright license for the
+        software to do everything you might do with the software
+        that would otherwise infringe the licensor's copyright
+        in it for any permitted purpose. However, you may
+        only distribute the software according to Distribution License
+        and make changes or new works based on the software according
+        to Changes and New Works License.
+        
+        Distribution License
+        
+        The licensor grants you an additional copyright license
+        to distribute copies of the software. Your license
+        to distribute covers distributing the software with
+        changes and new works permitted by Changes and New Works License.
+        
+        Notices
+        
+        You must ensure that anyone who gets a copy of any part of
+        the software from you also gets a copy of these terms or the
+        URL for them above, as well as copies of any plain-text lines
+        beginning with "Required Notice:" that the licensor provided
+        with the software.
+        
+        Changes and New Works License
+        
+        The licensor grants you an additional copyright license to
+        make changes and new works based on the software for any
+        permitted purpose.
+        
+        Patent License
+        
+        The licensor grants you a patent license for the software that
+        covers patent claims the licensor can license, or becomes able
+        to license, that you would infringe by using the software.
+        
+        Noncommercial Purposes
+        
+        Any noncommercial purpose is a permitted purpose.
+        
+        Personal Uses
+        
+        Personal use for research, experiment, and testing for
+        the benefit of public knowledge, personal study, private
+        entertainment, hobby projects, amateur pursuits, or religious
+        observance, without any anticipated commercial application,
+        is use for a permitted purpose.
+        
+        Noncommercial Organizations
+        
+        Use by any charitable organization, educational institution,
+        public research organization, public safety or health
+        organization, environmental protection organization,
+        or government institution is use for a permitted purpose
+        regardless of the source of funding or obligations resulting
+        from the funding.
+        
+        Fair Use
+        
+        You may have "fair use" rights for the software under the
+        law. These terms do not limit them.
+        
+        No Other Rights
+        
+        These terms do not allow you to sublicense or transfer any of
+        your licenses to anyone else, or prevent the licensor from
+        granting licenses to anyone else. These terms do not imply
+        any other licenses.
+        
+        Patent Defense
+        
+        If you make any written claim that the software infringes or
+        contributes to infringement of any patent, your patent license
+        for the software granted under these terms ends immediately. If
+        your company makes such a claim, your patent license ends
+        immediately for work on behalf of your company.
+        
+        Violations
+        
+        The first time you are notified in writing that you have
+        violated any of these terms, or done anything with the software
+        not covered by your licenses, your licenses can nonetheless
+        continue if you come into full compliance with these terms,
+        and take practical steps to correct past violations, within
+        32 days of receiving notice. Otherwise, all your licenses
+        end immediately.
+        
+        No Liability
+        
+        AS FAR AS THE LAW ALLOWS, THE SOFTWARE COMES AS IS, WITHOUT
+        ANY WARRANTY OR CONDITION, AND THE LICENSOR WILL NOT BE LIABLE
+        TO YOU FOR ANY DAMAGES ARISING OUT OF THESE TERMS OR THE USE
+        OR NATURE OF THE SOFTWARE, UNDER ANY KIND OF LEGAL CLAIM.
+        
+        Definitions
+        
+        The "licensor" is the individual or entity offering these
+        terms, and the "software" is the software the licensor makes
+        available under these terms.
+        
+        "You" refers to the individual or entity agreeing to these
+        terms.
+        
+        "Your company" is any legal entity, sole proprietorship,
+        or other kind of organization that you work for, plus all
+        organizations that have control over, are under the control of,
+        or are under common control with that organization. "Control"
+        means ownership of substantially all the assets of an entity,
+        or the power to direct its management and policies by vote,
+        contract, or otherwise. Control can be direct or indirect.
+        
+        "Your licenses" are all the licenses granted to you for the
+        software under these terms.
+        
+        "Use" means anything you do with the software requiring one
+        of your licenses.
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: genanki>=0.13
+Description-Content-Type: text/markdown
+
+# kunyi
+
+Generate Anki `.apkg` decks from JSON (MCQ) or TSV (basic) card data.
+
+_Part of the [Seya](https://github.com/LingT03/Seya) study ecosystem._
+
+---
+
+## Installation
+
+```bash
+pip install kunyi
+```
+
+Or for local development:
+
+```bash
+git clone https://github.com/LingT03/Kunyi.git
+cd Kunyi
+pip install -e .
+```
+
+---
+
+## CLI usage
+
+```bash
+# JSON — multiple-choice question cards
+kunyi "Cloud Computing" cards.json
+
+# TSV — basic front/back cards
+kunyi "Calc 2 Formulas" formulas.tsv
+
+# Explicit output path (recommended for subprocess callers)
+kunyi "Cloud Computing" cards.json --output /path/to/deck.apkg
+
+# Override format detection
+kunyi "My Deck" cards.data --format tsv
+```
+
+On success the resolved `.apkg` path is printed to stdout (exit 0).  
+On failure a human-readable message is printed to stderr (exit 1).
+
+---
+
+## Input formats
+
+### JSON — MCQ cards
+
+```json
+{
+  "cards": [
+    {
+      "question": "What does CPU stand for?",
+      "choices": ["Central Processing Unit", "Core Power Unit", "Control Processing Unit"],
+      "correct_answer": "Central Processing Unit",
+      "explanation": "CPU stands for Central Processing Unit.",
+      "tags": ["chapter-1"]
+    }
+  ]
+}
+```
+
+`correct_answer` must be an element of `choices` — validated on parse.  
+`tags` is optional.
+
+### TSV — basic cards
+
+Tab-delimited UTF-8. Optional header row (`front\tback`) is auto-detected and skipped.
+
+```
+front	back
+What is spaced repetition?	A technique that spaces reviews over time.
+What is active recall?	Actively retrieving information from memory.
+```
+
+---
+
+## Library usage
+
+```python
+from pathlib import Path
+from kunyi import AnkiCardDeck, MCQCard, BasicCard
+
+deck = AnkiCardDeck(deck_name="My Deck")
+
+deck.add_card(MCQCard(
+    question="What does RAM stand for?",
+    choices=["Random Access Memory", "Read Access Module"],
+    correct_answer="Random Access Memory",
+    explanation="RAM is the primary short-term memory of a computer.",
+    tags=["hardware"],
+))
+
+deck.add_card(BasicCard(
+    front="What is a CPU?",
+    back="The central processing unit — the brain of a computer.",
+))
+
+deck.save_deck(Path("output/my_deck.apkg"))
+```
+
+---
+
+## Running tests
+
+```bash
+pip install pytest
+pytest tests/
+```
+
+---
+
+## What is Anki?
+
+[Anki](https://apps.ankiweb.net/) is a free flashcard program that uses spaced repetition and active recall to maximise long-term retention. `kunyi` generates `.apkg` files that can be imported directly into Anki.