fnschool 20250109.80531.837__tar.gz → 20251011.81638.854__tar.gz

fnschool-20251011.81638.854/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: fnschool
+Version: 20251011.81638.854
+Summary: Just some school related scripts, without any ambition.
+Author-email: larryw3i <larryw3i@163.com>, Larry Wei <larryw3i@126.com>, Larry W3i <larryw3i@yeah.net>
+Maintainer-email: larryw3i <larryw3i@163.com>, Larry Wei <larryw3i@126.com>
+Project-URL: Homepage, https://github.com/larryw3i/funingschool
+Project-URL: Documentation, https://github.com/larryw3i/funingschool/docs
+Project-URL: Repository, https://github.com/larryw3i/funingschool.git
+Project-URL: Issues, https://github.com/larryw3i/funingschool/issues
+Project-URL: Changelog, https://github.com/larryw3i/funingschool/CHANGELOG.md
+Classifier: Topic :: Education
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: django
+Requires-Dist: pandas
+Requires-Dist: matplotlib
+Requires-Dist: numpy
+Requires-Dist: openpyxl
+Requires-Dist: platformdirs
+Requires-Dist: tomlkit
+Requires-Dist: django-crispy-forms
+Requires-Dist: crispy-bootstrap5
+Provides-Extra: gui
+Provides-Extra: cli
+Dynamic: license-file
+
+
+<hr/>
+<div align="center">
+    <pre>
+ _____ _   _ ____   ____ _   _  ___   ___  _     
+|  ___| \ | / ___| / ___| | | |/ _ \ / _ \| |    
+| |_  |  \| \___ \| |   | |_| | | | | | | | |    
+|  _| | |\  |___) | |___|  _  | |_| | |_| | |___ 
+|_|   |_| \_|____/ \____|_| |_|\___/ \___/|_____|
+    </pre>
+</div>
+<p align="center">
+    funingschool
+</p>
+<h4 align="center">
+    NO Just some simple scripts for warehousing and consuming.
+</h4>
+<hr/>
+<p align="center">
+    <a href="https://gitee.com/larryw3i/funingschool/blob/master/Documentation/README/zh_CN.md">简体中文</a> •
+    <a href="https://github.com/larryw3i/funingschool/blob/master/README.md">English</a>
+</p>
+
+<p align="center">
+    <a href="#key-features">
+        Key Features
+    </a>
+    •
+    <a href="#how-to-use">
+        How To Use
+    </a>
+    •
+    <a href="#credits">
+        Credits
+    </a>
+    •
+    <a href="#support">
+        Support
+    </a>
+    •
+    <a href="#license">
+        License
+    </a>
+</p>
+
+![Screenshot](https://raw.githubusercontent.com/larryw3i/funingschool/master/Documentation/images/9432e132-f8cd-11ee-8ee6-f37309efa64b.png)
+
+<h2 id="key-features">
+    Key Features
+</h2>
+
+<h3>
+    warehousing and consuming
+</h3>
+
+* Read food spreadsheets automatically.
+* The simplest and most straightforward `consuming sheets`.
+* Update sheets (warehousing, consuming, summing, etc) automatically.
+* Reduce calculation errors.
+* Effectively eliminate unit prices containing infinite decimals.
+* Merge food sheets between spreadsheets.  
+* Easy to use.
+
+<h3>
+    Test statistics
+</h3>
+
+* An easy-to-use "test score entry form".
+* Clear test results at a glance, converting table data into Intuitive images.
+* Display comments.
+* Effectively assist testers, especially teachers and students.
+
+<h2 id="how-to-use">
+    How To Use
+</h2>
+
+<h3>
+    Install Python3
+</h3>
+<p>
+
+on `Ubuntu`:
+
+```bash
+sudo apt-get install python3 python3-pip python3-tk
+```  
+For `Windows 10` and `Windows 11`, you can install Python3 from https://www.python.org/getit/ . (`fnschool` requires Python 3.12 or later)
+</p>
+
+<h3>
+    Install fnschool and run it
+</h3>
+
+<p>
+
+Run the command line application:
+* `Ubuntu`: `Ctrl+Alt+T`.  
+* `Windows`: "`Win+R, powershell, Enter`".  
+
+Enter the following commands:
+
+</p>
+
+```bash
+# install fnschool.
+pip install -U fnschool
+
+# Making bill of "canteen" module.
+fnschool-cli canteen mk_bill
+# Merging food sheets of "canteen" module.
+fnschool-cli canteen merge_foodsheets
+
+# run `test statistics` module.
+fnschool-cli exam enter
+```
+
+>Note: Read the information it prompts carefully, which is the key to using it well.
+
+<h2 id="credits">
+    Credits
+</h2>
+<p>
+    This software uses the following open source packages:
+    <ul>
+        <li><a href="https://github.com/tartley/colorama">colorama</a></li>
+        <li><a href="https://pandas.pydata.org/">pandas</a></li>
+        <li><a href="https://numpy.org/">numpy</a></li>
+        <li><a href="https://openpyxl.readthedocs.io/">openpyxl</a></li>
+        <li><a href="http://github.com/ActiveState/appdirs">appdirs</a></li>
+        <li><a href="https://matplotlib.org/">matplotlib</a></li>
+        <li><a href="https://github.com/Miksus/red-mail">redmail</a></li>
+    </ul>
+</p>
+
+<h2 id="support">
+    Support
+</h2>
+<h3>
+    Buy me a `coffee`:
+</h3>  
+
+![Buy me a "coffee".](https://raw.githubusercontent.com/larryw3i/funingschool/master/Documentation/images/9237879a-f8d5-11ee-8411-23057db0a773.jpeg)
+
+<h2 id="license">
+    License
+</h2>
+
+<a href="https://github.com/larryw3i/funingschool/blob/master/LICENSE">
+    GNU LESSER GENERAL PUBLIC LICENSE Version 3
+</a>

{fnschool-20250109.80531.837 → fnschool-20251011.81638.854}/pyproject.toml

@@ -1,15 +1,18 @@
 [project]
 name = "fnschool"
 dynamic = ["version"]
+license-files = ["LICENSE"]
 requires-python = ">= 3.9"
 dependencies = [
-    "colorama",
+    "django",
     "pandas",
     "matplotlib",
     "numpy",
     "openpyxl",
-    "appdirs",
-    "redmail",
+    "platformdirs",
+    "tomlkit",
+    "django-crispy-forms",
+    "crispy-bootstrap5",
 ]
 authors = [
   {name = "larryw3i", email = "larryw3i@163.com"},
@@ -22,7 +25,6 @@ maintainers = [
 ]
 description = "Just some school related scripts, without any ambition."
 readme = "README.md"
-license = {file = "LICENSE"}
 classifiers = [
   "Topic :: Education",
   "Programming Language :: Python :: 3.10",
@@ -39,10 +41,7 @@ gui=[]
 cli=[]
 
 [project.scripts]
-fnschool-cli = "fnschool:read_cli"
-
-[project.gui-scripts]
-fnschool-gui = "fnschool:show_gui"
+fnschool-cli = "fnschoo1:main"
 
 [build-system]
 requires = [
@@ -53,15 +52,18 @@ requires = [
 line-length = 80
 
 [tool.setuptools.dynamic]
-version = {attr = "fnschool.__version__"}
+version = {attr = "fnschoo1.__version__"}
 
 [tool.setuptools.packages.find]
 where = ["src"]
 
 [tool.setuptools.package-data]
-"*" = ["*.mo","*.xlsx","*.toml"]
+"*" = ["*.mo","*.xlsx","*.toml","*.html","*.js", "*.css", "db.sqlite3", "*.ico"]
 
 [tool.setuptools.exclude-package-data]
 "*" = ["*.po"]
 
+[tool.djlint]
+profile="django"
+
 # The end.

fnschool-20251011.81638.854/src/fnschoo1/__init__.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+"""Django's command-line utility for administrative tasks."""
+import os
+import platform
+import random
+import sys
+from pathlib import Path
+
+__version__ = "20251011.81638.854"
+
+FNSCHOOL_PATH = Path(__file__).parent
+if FNSCHOOL_PATH.as_posix() not in sys.path:
+    sys.path.insert(0, FNSCHOOL_PATH.as_posix())
+
+system_name = platform.system()
+is_linux = False
+is_windows = False
+is_macos = False
+
+if system_name == "Linux":
+    is_linux = True
+elif system_name == "Windows":
+    is_windows = True
+elif system_name == "Darwin":
+    is_macos = True
+
+
+def main():
+    """Run administrative tasks."""
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "fnschool.settings")
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+
+    if not "runserver" in sys.argv:
+        local_port = str(random.randint(8080, 65530))
+        local_url = "http://127.0.0.1:" + local_port
+        sys.argv.append("runserver")
+        sys.argv.append(str(local_port))
+        try:
+            if is_windows:
+                os.startfile(local_url)
+            else:
+                os.system("open " + local_url)
+        except Exception as e:
+            print(e)
+
+    execute_from_command_line(sys.argv)

fnschool-20251011.81638.854/src/fnschoo1/canteen/admin.py

@@ -0,0 +1,3 @@
+from django.contrib import admin
+
+# Register your models here.

fnschool-20251011.81638.854/src/fnschoo1/canteen/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class CanteenConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "canteen"

fnschool-20251011.81638.854/src/fnschoo1/canteen/forms.py

@@ -0,0 +1,84 @@
+from datetime import date, datetime
+
+from django import forms
+from fnschool import _
+
+from .models import Category, Consumption, Ingredient, MealType
+
+
+class PurchasedIngredientsWorkBookForm(forms.Form):
+    workbook_file = forms.FileField(
+        label=_("Select a Spreadsheet File"),
+        help_text=_("Office Open XML Spreadsheet only. (*.xlsx)"),
+        widget=forms.ClearableFileInput(attrs={"accept": ".xlsx"}),
+    )
+
+
+class IngredientForm(forms.ModelForm):
+    class Meta:
+        model = Ingredient
+        fields = [
+            f.name
+            for f in Ingredient._meta.fields
+            if f.name not in ["id", "user"]
+        ]
+
+        current_year = date.today().year
+        year_range = list(range(current_year - 100, current_year + 1))
+        widgets = {
+            "storage_date": forms.SelectDateWidget(
+                years=year_range,
+                attrs={
+                    "style": "width: 33.33%; display: inline-block;",
+                },
+            ),
+        }
+
+
+class ConsumptionForm(forms.ModelForm):
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        for name in self.fields:
+            self.fields[name].label = ""
+            self.fields[name].widget.attrs.update(
+                {
+                    "id": f"id_{name}_{self.instance.ingredient.id}",
+                    "class": "form-control",
+                }
+            )
+            self.fields[name].disabled = self.instance.is_disabled
+
+    class Meta:
+        model = Consumption
+        fields = "__all__"
+        widgets = {
+            "amount_used": forms.NumberInput(
+                attrs={
+                    "style": "width: 109px; text-align: center; font-family: Mono;"
+                }
+            ),
+            "date_of_using": forms.HiddenInput(),
+            "ingredient": forms.HiddenInput(),
+            "is_disabled": forms.HiddenInput(),
+        }
+
+
+class CategoryForm(forms.ModelForm):
+    class Meta:
+        model = Category
+        fields = [
+            "name",
+            "abbreviation",
+            "pin_to_consumptions_top",
+            "is_disabled",
+        ]
+
+
+class MealTypeForm(forms.ModelForm):
+    class Meta:
+        model = MealType
+        fields = ["name", "abbreviation", "is_disabled"]
+
+
+# The end.

fnschool-20251011.81638.854/src/fnschoo1/canteen/migrations/0001_initial.py

@@ -0,0 +1,119 @@
+# Generated by Django 4.2.24 on 2025-09-25 19:43
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="Ingredient",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("storage_date", models.DateField(verbose_name="入库日期")),
+                (
+                    "name",
+                    models.CharField(max_length=100, verbose_name="食材名"),
+                ),
+                (
+                    "meal_type",
+                    models.CharField(max_length=50, verbose_name="餐类"),
+                ),
+                (
+                    "category",
+                    models.CharField(max_length=50, verbose_name="食材大类"),
+                ),
+                (
+                    "quantity",
+                    models.DecimalField(
+                        decimal_places=2, max_digits=10, verbose_name="数量"
+                    ),
+                ),
+                (
+                    "total_price",
+                    models.DecimalField(
+                        decimal_places=2, max_digits=10, verbose_name="总价"
+                    ),
+                ),
+                (
+                    "quantity_unit_name",
+                    models.CharField(
+                        blank=True,
+                        max_length=20,
+                        null=True,
+                        verbose_name="数量单位",
+                    ),
+                ),
+                (
+                    "is_ignorable",
+                    models.BooleanField(
+                        default=False, verbose_name="是不用入库的"
+                    ),
+                ),
+                (
+                    "user",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="ingredients",
+                        to=settings.AUTH_USER_MODEL,
+                        verbose_name="用户",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Ingredient",
+                "verbose_name_plural": "食材列表",
+            },
+        ),
+        migrations.CreateModel(
+            name="Consumption",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("date_of_using", models.DateField(verbose_name="日期")),
+                (
+                    "amount_used",
+                    models.DecimalField(
+                        decimal_places=2, max_digits=10, verbose_name="消耗数量"
+                    ),
+                ),
+                (
+                    "ingredient",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="consumptions",
+                        to="canteen.ingredient",
+                        verbose_name="食材",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "消耗记录",
+                "verbose_name_plural": "消耗记录列表",
+                "ordering": ["-date_of_using"],
+            },
+        ),
+    ]

fnschool-20251011.81638.854/src/fnschoo1/canteen/migrations/0002_ingredient_is_disabled.py

@@ -0,0 +1,20 @@
+# Generated by Django 4.2.24 on 2025-09-27 09:37
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("canteen", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="ingredient",
+            name="is_disabled",
+            field=models.BooleanField(
+                default=False, verbose_name="Is disabled"
+            ),
+        ),
+    ]

fnschool-20251011.81638.854/src/fnschoo1/canteen/migrations/0003_consumption_is_disabled_alter_ingredient_is_disabled.py

@@ -0,0 +1,23 @@
+# Generated by Django 4.2.24 on 2025-09-27 15:48
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("canteen", "0002_ingredient_is_disabled"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="consumption",
+            name="is_disabled",
+            field=models.BooleanField(default=False, verbose_name="已禁用"),
+        ),
+        migrations.AlterField(
+            model_name="ingredient",
+            name="is_disabled",
+            field=models.BooleanField(default=False, verbose_name="已禁用"),
+        ),
+    ]

fnschool-20251011.81638.854/src/fnschoo1/canteen/migrations/0004_alter_ingredient_name_category_and_more.py

@@ -0,0 +1,66 @@
+# Generated by Django 4.2.25 on 2025-10-04 01:43
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+        (
+            "canteen",
+            "0003_consumption_is_disabled_alter_ingredient_is_disabled",
+        ),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="ingredient",
+            name="name",
+            field=models.CharField(
+                max_length=100, verbose_name="ingredient name"
+            ),
+        ),
+        migrations.CreateModel(
+            name="Category",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "name",
+                    models.CharField(
+                        max_length=100, verbose_name="Category name"
+                    ),
+                ),
+                ("created_at", models.DateField(verbose_name="Creating Date")),
+                (
+                    "user",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="Categories",
+                        to=settings.AUTH_USER_MODEL,
+                        verbose_name="Ingredient category",
+                    ),
+                ),
+            ],
+        ),
+        migrations.AlterField(
+            model_name="ingredient",
+            name="category",
+            field=models.ForeignKey(
+                on_delete=django.db.models.deletion.PROTECT,
+                related_name="ingredients",
+                to="canteen.category",
+                verbose_name="食材大类",
+            ),
+        ),
+    ]

fnschool-20251011.81638.854/src/fnschoo1/canteen/migrations/0005_alter_category_created_at_alter_category_name_and_more.py

@@ -0,0 +1,41 @@
+# Generated by Django 4.2.25 on 2025-10-04 05:08
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+        ("canteen", "0004_alter_ingredient_name_category_and_more"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="category",
+            name="created_at",
+            field=models.DateField(verbose_name="创建日期"),
+        ),
+        migrations.AlterField(
+            model_name="category",
+            name="name",
+            field=models.CharField(max_length=100, verbose_name="食材大类名"),
+        ),
+        migrations.AlterField(
+            model_name="category",
+            name="user",
+            field=models.ForeignKey(
+                on_delete=django.db.models.deletion.CASCADE,
+                related_name="Categories",
+                to=settings.AUTH_USER_MODEL,
+                verbose_name="食材大类",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="ingredient",
+            name="name",
+            field=models.CharField(max_length=100, verbose_name="食材名"),
+        ),
+    ]