vites 0.1.1__tar.gz

vites-0.1.1/LICENSE

@@ -0,0 +1,17 @@
+MIT License
+
+Copyright (c) 2026 Nikhil Gupta
+
+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.

vites-0.1.1/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: vites
+Version: 0.1.1
+Summary: A command-line library for downloading practical text notes.
+Author: Nikhil Gupta
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# vites
+
+A small Python package that lets you download bundled practical notes from the terminal.
+
+## Install
+```bash
+python -m pip install vites
+```
+
+## List available files
+```bash
+vites list
+```
+
+## Download a file
+```bash
+vites download vdirectives
+vites download usefetch
+vites download propdrilling
+```
+
+The command saves the requested `.txt` file into your current working directory.
+
+Choose a different destination filename/path with:
+```bash
+vites download vdirectives --output my-vue-directives.txt
+```
+
+You can also run:
+```bash
+python -m vites.cli download vdirectives
+```

vites-0.1.1/README.md

@@ -0,0 +1,32 @@
+# vites
+
+A small Python package that lets you download bundled practical notes from the terminal.
+
+## Install
+```bash
+python -m pip install vites
+```
+
+## List available files
+```bash
+vites list
+```
+
+## Download a file
+```bash
+vites download vdirectives
+vites download usefetch
+vites download propdrilling
+```
+
+The command saves the requested `.txt` file into your current working directory.
+
+Choose a different destination filename/path with:
+```bash
+vites download vdirectives --output my-vue-directives.txt
+```
+
+You can also run:
+```bash
+python -m vites.cli download vdirectives
+```

vites-0.1.1/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vites"
+version = "0.1.1"
+description = "A command-line library for downloading practical text notes."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Nikhil Gupta" }]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.scripts]
+vites = "mathpotlib.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+mathpotlib = ["texts/*.txt"]

vites-0.1.1/setup.cfg

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

vites-0.1.1/src/mathpotlib/__init__.py

@@ -0,0 +1,3 @@
+"""Downloadable practical notes bundled with mathpotlib."""
+
+__version__ = "0.1.0"

vites-0.1.1/src/mathpotlib/cli.py

@@ -0,0 +1,56 @@
+"""Command-line interface for listing and downloading bundled text files."""
+
+import argparse
+import shutil
+from importlib.resources import files
+from pathlib import Path
+
+FILES = {
+    "nrouting": "nrouting.txt",
+    "usefetch": "usefetch.txt",
+    "apiroutes": "apiroutes.txt",
+    "mongocrud": "mongocrud.txt",
+    "pinia": "pinia.txt",
+    "formvalidate": "formvalidate.txt",
+    "piniaapp": "piniaapp.txt",
+    "vuemep": "vuemep.txt",
+    "vdirectives": "vdirectives.txt",
+    "propdrilling": "propdrilling.txt",
+    "directiveslogin": "directiveslogin.txt",
+}
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="vites",
+        description="Download practical text files from the mathpotlib package."
+    )
+    subparsers = parser.add_subparsers(dest="command", required=True)
+    subparsers.add_parser("list", help="Show all available text-file names.")
+
+    download_parser = subparsers.add_parser(
+        "download", help="Copy one text file into the current directory."
+    )
+    download_parser.add_argument("name", help="Short file name, e.g. vdirectives")
+    download_parser.add_argument("-o", "--output", help="Optional output filename or path.")
+
+    args = parser.parse_args()
+    if args.command == "list":
+        print("Available vites text files:")
+        for name in FILES:
+            print(f"  {name}")
+        return
+
+    name = args.name.lower()
+    if name not in FILES:
+        print(f"Unknown file: {args.name}")
+        print("Run 'vites list' to see available names.")
+        raise SystemExit(2)
+
+    resource = files("mathpotlib").joinpath("texts", FILES[name])
+    destination = Path(args.output) if args.output else Path(FILES[name])
+    with resource.open("rb") as source, destination.open("wb") as target:
+        shutil.copyfileobj(source, target)
+    print(f"Downloaded: {destination.resolve()}")
+
+if __name__ == "__main__":
+    main()

vites-0.1.1/src/mathpotlib/texts/apiroutes.txt

@@ -0,0 +1,81 @@
+NUXT PRACTICAL 3: NUXT API ROUTES
+=================================================================
+
+================================================
+
+AIM:
+Create a simple API inside Nuxt using server/api routes.
+The example returns a list of products.
+
+PROJECT STRUCTURE:
+nuxt-api/
+|
+|-- app.vue
+|-- pages/
+|   |-- index.vue
+|-- server/
+    |-- api/
+        |-- products.get.js
+
+STEP 1: Create the project
+--------------------------
+npx nuxi@latest init nuxt-api
+cd nuxt-api
+npm install
+
+STEP 2: app.vue
+---------------
+<template>
+  <NuxtPage />
+</template>
+
+STEP 3: server/api/products.get.js
+----------------------------------
+export default defineEventHandler(() => {
+  return [
+    { id: 1, name: 'Laptop', price: 50000 },
+    { id: 2, name: 'Mobile', price: 20000 },
+    { id: 3, name: 'Headphones', price: 2000 }
+  ]
+})
+
+STEP 4: pages/index.vue
+-----------------------
+<script setup>
+const { data: products, pending, error } = await useFetch('/api/products')
+</script>
+
+<template>
+  <div>
+    <h1>Products</h1>
+
+    <p v-if="pending">Loading...</p>
+    <p v-else-if="error">Could not load products.</p>
+
+    <div v-else>
+      <div v-for="product in products" :key="product.id">
+        <h3>{{ product.name }}</h3>
+        <p>Price: Rs. {{ product.price }}</p>
+      </div>
+    </div>
+  </div>
+</template>
+
+RUN:
+npm run dev
+
+Open:
+http://localhost:3000
+
+API endpoint:
+http://localhost:3000/api/products
+
+CONCEPT:
+- Files inside server/api create API endpoints.
+- products.get.js handles GET requests.
+- /api/products is the endpoint URL.
+- useFetch('/api/products') calls the Nuxt API route.
+- This example uses a simple array, not a database.
+
+
+================================================

vites-0.1.1/src/mathpotlib/texts/directiveslogin.txt

@@ -0,0 +1,263 @@
+Practical 1 – Vue.js Directives: Role-Based Login System
+======================================================
+
+Demonstrates: v-if, v-else-if, v-else, v-show, v-for, v-on (@click), and v-model.
+
+1. PROJECT STRUCTURE
+--------------------
+Create the project:
+    npm create vue@latest
+
+Project name: vue-project
+
+    vue-project/
+    ├── public/
+    ├── src/
+    │   ├── assets/
+    │   │   └── main.css
+    │   ├── App.vue
+    │   ├── main.js
+    │   └── users.json
+    ├── index.html
+    ├── package.json
+    └── vite.config.js
+
+Store users.json inside src so Vue can import it.
+
+2. FILE 1 – src/users.json
+--------------------------
+[
+  {
+    "id": 1,
+    "username": "admin",
+    "password": "admin",
+    "role": "Admin"
+  },
+  {
+    "id": 2,
+    "username": "Pratik",
+    "password": "12345",
+    "role": "Teacher"
+  },
+  {
+    "id": 3,
+    "username": "Kartik",
+    "password": "67890",
+    "role": "Student"
+  }
+]
+
+3. FILE 2 – src/App.vue
+-----------------------
+<template>
+  <div class="container">
+    <h2>Role Based Login</h2>
+
+    <!-- v-model -->
+    <input type="text" v-model="username" placeholder="Enter Username" />
+    <input type="password" v-model="password" placeholder="Enter Password" />
+
+    <!-- v-on -->
+    <button @click="login">Login</button>
+    <hr />
+
+    <!-- v-if -->
+    <div v-if="loggedIn">
+      <!-- Admin Component -->
+      <div v-if="currentUser.role === 'Admin'" class="admin">
+        <h3>Admin Login</h3>
+        <p>ID: {{ currentUser.id }}</p>
+        <p>Username: {{ currentUser.username }}</p>
+        <p>Role: {{ currentUser.role }}</p>
+        <!-- v-show -->
+        <p v-show="true">You have Full Access</p>
+      </div>
+
+      <!-- Teacher Component -->
+      <div v-else-if="currentUser.role === 'Teacher'" class="teacher">
+        <h3>Teacher Login</h3>
+        <p>ID: {{ currentUser.id }}</p>
+        <p>Username: {{ currentUser.username }}</p>
+        <p>Role: {{ currentUser.role }}</p>
+        <p v-show="true">Manage Student Records</p>
+      </div>
+
+      <!-- Student Component -->
+      <div v-else class="student">
+        <h3>Student Login</h3>
+        <p>ID: {{ currentUser.id }}</p>
+        <p>Username: {{ currentUser.username }}</p>
+        <p>Role: {{ currentUser.role }}</p>
+        <p v-show="true">View Courses</p>
+      </div>
+    </div>
+
+    <!-- v-else -->
+    <div v-else>
+      <p>Please Login...</p>
+    </div>
+
+    <hr />
+    <h3>Available Users</h3>
+    <!-- v-for -->
+    <ul>
+      <li v-for="user in users" :key="user.id">
+        {{ user.id }} - {{ user.username }} ({{ user.role }})
+      </li>
+    </ul>
+  </div>
+</template>
+
+<script setup>
+import { ref } from "vue";
+import users from "./users.json";
+
+const username = ref("");
+const password = ref("");
+const loggedIn = ref(false);
+const currentUser = ref({});
+
+function login() {
+  const user = users.find(
+    u => u.username === username.value && u.password === password.value
+  );
+
+  if (user) {
+    currentUser.value = user;
+    loggedIn.value = true;
+  } else {
+    alert("Invalid Username or Password");
+    loggedIn.value = false;
+    currentUser.value = {};
+  }
+}
+</script>
+
+<style scoped>
+.container {
+  width: 400px;
+  margin: 30px auto;
+  padding: 20px;
+  text-align: center;
+  border: 2px solid #ccc;
+  border-radius: 10px;
+  background: #f4f4f4;
+  color: #222;
+}
+input {
+  width: 90%;
+  padding: 10px;
+  margin: 8px 0;
+  box-sizing: border-box;
+}
+button {
+  padding: 10px 20px;
+  background: royalblue;
+  color: white;
+  border: none;
+  cursor: pointer;
+  margin-top: 10px;
+}
+button:hover { background: blue; }
+.admin {
+  background: #ffe5e5;
+  border: 2px solid red;
+  padding: 15px;
+  margin-top: 15px;
+  border-radius: 8px;
+}
+.teacher {
+  background: #e8ffe8;
+  border: 2px solid green;
+  padding: 15px;
+  margin-top: 15px;
+  border-radius: 8px;
+}
+.student {
+  background: #e6f0ff;
+  border: 2px solid blue;
+  padding: 15px;
+  margin-top: 15px;
+  border-radius: 8px;
+}
+ul { list-style: none; padding: 0; }
+li {
+  background: white;
+  margin: 5px;
+  padding: 8px;
+  border-radius: 5px;
+}
+</style>
+
+4. FILE 3 – src/main.js
+-----------------------
+import './assets/main.css'
+
+import { createApp } from 'vue'
+import App from './App.vue'
+
+createApp(App).mount('#app')
+
+5. FILE 4 – src/assets/main.css
+-------------------------------
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  padding: 0;
+  font-family: Arial, sans-serif;
+  background: #ffffff;
+}
+
+6. RUN THE PROJECT
+------------------
+In the VS Code terminal inside vue-project:
+    npm install
+    npm run dev
+
+Open the local URL Vite prints, usually:
+    http://localhost:5173/
+
+7. LOGIN CREDENTIALS
+--------------------
+Role       Username    Password
+Admin      admin       admin
+Teacher    Pratik      12345
+Student    Kartik      67890
+
+8. EXPECTED OUTPUT
+------------------
+Admin Login: ID, username, Admin role, and Full Access.
+Teacher Login: ID, username, Teacher role, and Manage Student Records.
+Student Login: ID, username, Student role, and View Courses.
+
+9. VUE DIRECTIVES DEMONSTRATED
+------------------------------
+v-model    : Username and password inputs
+v-on       : @click="login"
+v-if       : Checks login status
+v-else-if  : Checks Teacher role
+v-else     : Displays Student or Please Login
+v-show     : Displays role-specific permissions
+v-for      : Displays available users
+
+10. FINAL PROJECT STRUCTURE
+---------------------------
+    vue-project/
+    ├── src/
+    │   ├── assets/
+    │   │   └── main.css
+    │   ├── App.vue
+    │   ├── main.js
+    │   └── users.json
+    ├── public/
+    ├── index.html
+    ├── package.json
+    └── vite.config.js
+
+IMPLEMENTATION COMPLETE
+
+Note: This is a practical demonstration, not production authentication.
+Credentials are stored in a JSON file and should not be used for a real login system.

vites-0.1.1/src/mathpotlib/texts/formvalidate.txt

@@ -0,0 +1,149 @@
+NUXT PRACTICAL 6: ERROR HANDLING AND VALIDATION IN NUXT FORMS
+=================================================================
+
+================================================
+
+AIM:
+Create a simple registration form with required-field checks,
+email validation, password validation and error messages.
+
+PROJECT STRUCTURE:
+nuxt-form-validation/
+|
+|-- app.vue
+|-- pages/
+    |-- index.vue
+
+STEP 1: Create project
+----------------------
+npx nuxi@latest init nuxt-form-validation
+cd nuxt-form-validation
+npm install
+
+STEP 2: app.vue
+---------------
+<template>
+  <NuxtPage />
+</template>
+
+STEP 3: pages/index.vue
+-----------------------
+<script setup>
+const name = ref('')
+const email = ref('')
+const password = ref('')
+
+const errors = ref({})
+const successMessage = ref('')
+
+function validateForm() {
+  errors.value = {}
+  successMessage.value = ''
+
+  if (!name.value.trim()) {
+    errors.value.name = 'Name is required'
+  }
+
+  const emailPattern = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/
+
+  if (!email.value.trim()) {
+    errors.value.email = 'Email is required'
+  } else if (!emailPattern.test(email.value)) {
+    errors.value.email = 'Enter a valid email address'
+  }
+
+  if (!password.value) {
+    errors.value.password = 'Password is required'
+  } else if (password.value.length < 6) {
+    errors.value.password = 'Password must have at least 6 characters'
+  }
+
+  return Object.keys(errors.value).length === 0
+}
+
+function submitForm() {
+  if (!validateForm()) {
+    return
+  }
+
+  successMessage.value = 'Registration successful!'
+
+  name.value = ''
+  email.value = ''
+  password.value = ''
+  errors.value = {}
+}
+</script>
+
+<template>
+  <div>
+    <h1>Registration Form</h1>
+
+    <form @submit.prevent="submitForm">
+      <div>
+        <label>Name</label>
+        <input v-model="name" type="text" placeholder="Enter name" />
+        <p v-if="errors.name" class="error">{{ errors.name }}</p>
+      </div>
+
+      <div>
+        <label>Email</label>
+        <input v-model="email" type="email" placeholder="Enter email" />
+        <p v-if="errors.email" class="error">{{ errors.email }}</p>
+      </div>
+
+      <div>
+        <label>Password</label>
+        <input v-model="password" type="password" placeholder="Enter password" />
+        <p v-if="errors.password" class="error">{{ errors.password }}</p>
+      </div>
+
+      <button type="submit">Register</button>
+    </form>
+
+    <p v-if="successMessage" class="success">
+      {{ successMessage }}
+    </p>
+  </div>
+</template>
+
+<style scoped>
+div {
+  margin-bottom: 12px;
+}
+
+input {
+  display: block;
+  margin-top: 5px;
+  padding: 8px;
+}
+
+.error {
+  color: red;
+}
+
+.success {
+  color: green;
+}
+</style>
+
+RUN:
+npm run dev
+
+Open:
+http://localhost:3000
+
+CONCEPT:
+- v-model connects form inputs to Vue state.
+- validateForm() checks the entered values.
+- errors stores validation messages.
+- v-if displays errors only when they exist.
+- @submit.prevent stops the browser's normal form submission.
+- The success message appears only when validation passes.
+
+IMPORTANT:
+This is basic client-side validation for a classroom practical.
+Real applications must also validate data on the server.
+
+
+================================================