tmscli 0.2.9__tar.gz → 0.3.1__tar.gz

{tmscli-0.2.9 → tmscli-0.3.1}/PKG-INFO

@@ -1,4 +1,4 @@
 Metadata-Version: 2.5
 Name: tmscli
-Version: 0.2.9
+Version: 0.3.1
 Summary: runs minesweeper in your terminal, type rules for how to play

tmscli-0.3.1/README.md

@@ -0,0 +1,11 @@
+# minesweeper
+## installation
+```pip install tmscli```
+## Running
+```tms```
+### For rules
+```tms -r```
+### For size
+```tms -s SIZE```
+### For number of mines
+```tms -m NUM```

{tmscli-0.2.9 → tmscli-0.3.1}/pyproject.toml

@@ -4,11 +4,9 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tmscli"
-version = "0.2.9"
+version = "0.3.1"
 description = "runs minesweeper in your terminal, type rules for how to play"
 dependencies = []
 
 [project.scripts]
 tms = "tmscli.main:run"
-rules = "tmscli.main:print_rules"
-

tmscli-0.3.1/src/tmscli/about.html

@@ -0,0 +1,76 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>about · tmscli</title>
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+  <header>
+    <div class="header-inner">
+      <div class="logo">tmscli</div>
+      <nav>
+        <a href="index.html">main</a>
+        <a href="about.html" class="active">about</a>
+        <a href="install.html">installation + usage</a>
+      </nav>
+    </div>
+  </header>
+
+  <main class="container">
+    <h1>about tmscli</h1>
+    <p class="subhead">A fun little project from 2024 to see who could code faster</p>
+
+    <div class="about-section">
+      <h2>Philosophy</h2>
+      <p>tmscli started as a fun competition to see whether python or C++ could make minesweeper faster and run smoother, now the python version has been uploaded to PyPi and can be downloaded using pip.</p>
+      <p>It is inteded to engage people into what coding can get you and should not be used to personal advantage (not sure how, but it's a must say)</p>
+    </div>
+
+    <div class="about-section">
+      <h2>Behind the scenes</h2>
+      <p>tmscli is fully python and relies on random to build the minefield</p>
+      <p>lets take a look at some code</p>
+      <pre><code>    while True:
+        terminal_minesweeper.print_board(board)
+        cmd=input()
+        cmds=cmd.split()
+        if int(cmds[1])>terminal_minesweeper.size or int(cmds[1])<0 or int(cmds[2])>terminal_minesweeper.size or int(cmds[2])<0:
+            print('coordinate out of range, please try again')
+        if cmds[0]=='uc':
+            if (not board[int(cmds[1])-1][int(cmds[2])-1][0]) and (not board[int(cmds[1])-1][int(cmds[2])-1][1]):
+                board[int(cmds[1])-1][int(cmds[2])-1][0]=True
+                if board[int(cmds[1])-1][int(cmds[2])-1][2]==0:
+                    board=terminal_minesweeper.richochet(board,(int(cmds[1])-1,int(cmds[2])-1))
+            else:
+                print('already uncovered')
+        elif cmds[0]=='fl':
+            if not board[int(cmds[1])-1][int(cmds[2])-1][1]:
+                board[int(cmds[1])-1][int(cmds[2])-1][1]=True
+            else:
+                print('already flagged')
+        elif cmds[0]=='uf':
+            if board[int(cmds[1])-1][int(cmds[2])-1][2]:
+                board[int(cmds[1])-1][int(cmds[2])-1][0]=False
+            else:
+                print('already not flagged')
+        else:
+            print('unrecognised command, please try again')
+        terminal_minesweeper.check(board)</code></pre>
+        <p>This is a rather large chunk of code, and is what the main loop does</p>
+        <p>as you can see it has three commands, uc, fl, and uf. Each doing something different. If it does not think the input is valid, it will output what it thinks the error is. (May be inaccurate)</p>
+    </div>
+
+    <div class="about-section">
+      <h2>Github Repository</h2>
+      <p>tmscli is 100% owned by a-humanly-human.</p>
+      <p>Link to Repository: <a href="https://github.com/a-humanly-human/terminal-minesweeper/">https://github.com/a-humanly-human/terminal-minesweeper/</a></p>
+    </div>
+  </main>
+
+  <footer>
+    <p>tmscli · PyPI module · lorem ipsum placeholder</p>
+  </footer>
+</body>
+</html>

tmscli-0.3.1/src/tmscli/index.html

@@ -0,0 +1,51 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>tmscli · PyPI module</title>
+
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+  <header>
+    <div class="header-inner">
+      <div class="logo">tmscli</div>
+      <nav>
+        <a href="index.html" class="active">main</a>
+        <a href="about.html">about</a>
+        <a href="install.html">installation + usage</a>
+      </nav>
+    </div>
+  </header>
+
+  <main class="container">
+    <h1>tmscli</h1>
+    <p class="subhead">minesweeper, in your terminal, all at once</p>
+
+    <div class="card-grid">
+      <div class="card">
+        <h2>Quick start</h2>
+        <p>Visit the install page for installation, and see about for info</p>
+        <p></p>
+      </div>
+      <div class="card">
+        <h2>Why tmscli?</h2>
+        <p>Bored of sitting there, with all your work done, but unable to do anything?</p>
+        <p>tmscli brings in minesweeper to the terminal and is customisable to make it suitable for you</p>
+      </div>
+    </div>
+
+    <div class="lorem-block">
+      <h2>Latest updates</h2>
+      <p>v0.3.0 added border to the minesweeper format and minor bug fixes</p>
+    </div>
+  </main>
+
+  <footer>
+    <p>tmscli · PyPI module</p>
+  </footer>
+
+
+</body>
+</html>

tmscli-0.3.1/src/tmscli/install.html

@@ -0,0 +1,77 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>installation + usage · tmscli</title>
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+  <header>
+    <div class="header-inner">
+      <div class="logo">tmscli</div>
+      <nav>
+        <a href="index.html">main</a>
+        <a href="about.html">about</a>
+        <a href="install.html" class="active">installation + usage</a>
+      </nav>
+    </div>
+  </header>
+
+  <main class="container">
+    <h1>installation &amp; usage</h1>
+    <p class="subhead">A guide on how to install tmscli from pypi to how to customise number of mines and the size of the board.</p>
+
+    <div class="install-card">
+      <h2>Install from PyPI</h2>
+      <pre><code>pip install tmscli</code></pre>
+    </div>
+
+    <div class="usage-section">
+      <h2>Basic usage</h2>
+      <pre><code>tms</code></pre>
+      <p>Launches the basic 9x9 board with 10 mines</p>
+      
+      <h2>Size</h2>
+      <pre><code>tms -s SIZE</code></pre>
+      <p>customises the boards size</p>
+
+      <h2>Number of mines</h2>
+      <pre><code>tms -m NUM</code></pre>
+      <p>customises number of mines</p>
+
+      <h2>Rules</h2>
+      <pre><code>tms -r</code></pre>
+      <p>prints the rules</p>
+      <h2>In-game commands</h2>
+      <pre><code>uc x y</code></pre>
+      <p>uncovers square (x,y)</p>
+      <pre><code>fl x y</code></pre>
+      <p>flags square (x,y)</p>
+      <pre><code>uf x y</code></pre>
+      <p>unflags square (x,y)</p>
+      <p>Note:</p>
+      <p>&ensp;y-------&gt;
+        <br>
+         x
+        <br>
+         |
+        <br>
+         |
+        <br>
+         |
+        <br>
+         |
+        <br>
+         V
+      </p>
+      <p>use <pre><code>tms -r</code></pre> for a full guide</p>
+      
+    </div>
+
+
+  <footer>
+    <p>tmscli · PyPI module</p>
+  </footer>
+</body>
+</html>

{tmscli-0.2.9 → tmscli-0.3.1}/src/tmscli/main.py

@@ -6,15 +6,10 @@ class minesweeper():
         self.num=num
     ['uncovered?','flagged?','display']
     def print_board(self,board):
-        top=(len(str(self.size))+2)*' '
+        top=' '+(self.size*2)*'_'
+        print(top)
         for i in range(self.size):
-            top+=str(i+1)+' '
-        print(top[:-1])
-        for i in range(self.size):
-            if 100>i>9:
-                buffer=str(i+1)+' '
-            else:
-                buffer=str(i+1)+'  '
+            buffer='| '
             for j in board[i]:
                 if j[0]==True:
                     buffer+=str(j[2])+' '
@@ -22,7 +17,9 @@ class minesweeper():
                     buffer+='F'+' '
                 else:
                     buffer+=' '+' '
-            print(buffer[:-1])
+            print(buffer[:-1]+'|')
+        bottom=' '+(len(top)-1)*'-'
+        print(bottom)
     def get_mines(self):
         mines=[]
         while len(mines)<self.num:
@@ -107,32 +104,37 @@ class minesweeper():
 terminal_minesweeper=minesweeper(9,5)
 # terminal_minesweeper.print_board(board)
 def main_loop(board):
-    while True:
-        terminal_minesweeper.print_board(board)
-        cmd=input()
-        cmds=cmd.split()
-        if int(cmds[1])>terminal_minesweeper.size or int(cmds[1])<0 or int(cmds[2])>terminal_minesweeper.size or int(cmds[2])<0:
-            print('coordinate out of range, please try again')
-        if cmds[0]=='uc':
-            if (not board[int(cmds[1])-1][int(cmds[2])-1][0]) and (not board[int(cmds[1])-1][int(cmds[2])-1][1]):
-                board[int(cmds[1])-1][int(cmds[2])-1][0]=True
-                if board[int(cmds[1])-1][int(cmds[2])-1][2]==0:
-                    board=terminal_minesweeper.richochet(board,(int(cmds[1])-1,int(cmds[2])-1))
-            else:
-                print('already uncovered')
-        elif cmds[0]=='fl':
-            if not board[int(cmds[1])-1][int(cmds[2])-1][1]:
-                board[int(cmds[1])-1][int(cmds[2])-1][1]=True
-            else:
-                print('already flagged')
-        elif cmds[0]=='uf':
-            if board[int(cmds[1])-1][int(cmds[2])-1][2]:
-                board[int(cmds[1])-1][int(cmds[2])-1][0]=False
+    try:
+        while True:
+            terminal_minesweeper.print_board(board)
+            cmd=input()
+            cmds=cmd.split()
+            if int(cmds[1])>terminal_minesweeper.size or int(cmds[1])<0 or int(cmds[2])>terminal_minesweeper.size or int(cmds[2])<0:
+                print('coordinate out of range, please try again')
+            if cmds[0]=='uc':
+                if (not board[int(cmds[1])-1][int(cmds[2])-1][0]) and (not board[int(cmds[1])-1][int(cmds[2])-1][1]):
+                    board[int(cmds[1])-1][int(cmds[2])-1][0]=True
+                    if board[int(cmds[1])-1][int(cmds[2])-1][2]==0:
+                        board=terminal_minesweeper.richochet(board,(int(cmds[1])-1,int(cmds[2])-1))
+                else:
+                    print('already uncovered')
+            elif cmds[0]=='fl':
+                if not board[int(cmds[1])-1][int(cmds[2])-1][1]:
+                    board[int(cmds[1])-1][int(cmds[2])-1][1]=True
+                else:
+                    print('already flagged')
+            elif cmds[0]=='uf':
+                if board[int(cmds[1])-1][int(cmds[2])-1][2]:
+                    board[int(cmds[1])-1][int(cmds[2])-1][0]=False
+                else:
+                    print('already not flagged')
             else:
-                print('already not flagged')
-        else:
-            print('unrecognised command, please try again')
-        terminal_minesweeper.check(board)
+                print('unrecognised command, please try again')
+            terminal_minesweeper.check(board)
+    except KeyboardInterrupt:
+        print('Interrupted')
+    except:
+        print('ERROR')
 def run():
     p=argparse.ArgumentParser(description='Minesweeper CLI')
     p.add_argument(
@@ -178,8 +180,8 @@ x
 |
 V
 Aim:
-uncover every square without a mine on it
+uncover every square without a mine on it.
 
 If you step on a mine you lose, the number on the square is how many mines are around it (3 x 3 radius)
 ''')
-run()
+# run()

tmscli-0.3.1/src/tmscli/style.css

@@ -0,0 +1,306 @@
+/* style.css — shared across all pages */
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  font-family: system-ui, -apple-system, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif;
+  background: #f8fafc;
+  color: #0b1e2e;
+  line-height: 1.6;
+  display: flex;
+  flex-direction: column;
+  min-height: 100vh;
+}
+
+/* header & navigation */
+header {
+  background: #0f2b3d;
+  color: #e2e8f0;
+  border-bottom: 3px solid #2d7a9b;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.05);
+}
+
+.header-inner {
+  max-width: 1100px;
+  margin: 0 auto;
+  padding: 1rem 2rem;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+}
+
+.logo {
+  font-size: 1.8rem;
+  font-weight: 600;
+  letter-spacing: -0.5px;
+  color: #ffffff;
+  background: linear-gradient(135deg, #b4e6ff, #8ecae6);
+  -webkit-background-clip: text;
+  background-clip: text;
+  -webkit-text-fill-color: transparent;
+  text-shadow: 0 0 6px rgba(142, 202, 230, 0.3);
+}
+
+nav {
+  display: flex;
+  gap: 1.8rem;
+  flex-wrap: wrap;
+}
+
+nav a {
+  color: #cbd5e1;
+  text-decoration: none;
+  font-weight: 500;
+  font-size: 1rem;
+  padding: 0.25rem 0;
+  border-bottom: 2px solid transparent;
+  transition: border-color 0.15s, color 0.15s;
+}
+
+nav a:hover {
+  color: #ffffff;
+  border-bottom-color: #8ecae6;
+}
+
+nav a.active {
+  color: #ffffff;
+  border-bottom-color: #8ecae6;
+  font-weight: 600;
+}
+
+/* main container */
+.container {
+  max-width: 1100px;
+  margin: 2rem auto 3rem;
+  padding: 0 2rem;
+  flex: 1;
+}
+
+h1 {
+  font-size: 2.6rem;
+  font-weight: 600;
+  letter-spacing: -0.02em;
+  color: #0b1e2e;
+  margin-bottom: 0.25rem;
+}
+
+.subhead {
+  font-size: 1.2rem;
+  color: #2c3e50;
+  margin-bottom: 2.5rem;
+  border-left: 5px solid #2d7a9b;
+  padding-left: 1.2rem;
+  font-weight: 350;
+}
+
+h2 {
+  font-size: 1.7rem;
+  font-weight: 600;
+  margin: 1.8rem 0 1rem;
+  color: #0f2b3d;
+  letter-spacing: -0.01em;
+}
+
+h3 {
+  font-size: 1.25rem;
+  font-weight: 600;
+  margin: 1.5rem 0 0.5rem;
+  color: #1e4b63;
+}
+
+p {
+  margin-bottom: 1.2rem;
+  color: #1e2f3f;
+}
+
+/* cards on main page */
+.card-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 2rem;
+  margin: 2rem 0 1.5rem;
+}
+
+.card {
+  background: #ffffff;
+  padding: 1.8rem 1.8rem 1.2rem;
+  border-radius: 18px;
+  box-shadow: 0 6px 18px rgba(0, 20, 30, 0.06);
+  border: 1px solid #e1eef5;
+  transition: transform 0.1s ease, box-shadow 0.15s;
+}
+
+.card:hover {
+  box-shadow: 0 12px 24px rgba(15, 43, 61, 0.08);
+  transform: translateY(-2px);
+}
+
+.card h2 {
+  margin-top: 0;
+  font-size: 1.5rem;
+  border-bottom: 2px solid #e1eef5;
+  padding-bottom: 0.5rem;
+}
+
+/* lorem block */
+.lorem-block {
+  background: #eef6fb;
+  padding: 2rem 2rem 1.2rem;
+  border-radius: 18px;
+  margin: 2rem 0;
+  border-left: 6px solid #2d7a9b;
+}
+
+.lorem-block h2 {
+  margin-top: 0;
+}
+
+/* about page */
+.about-section {
+  background: #ffffff;
+  padding: 1.8rem 2rem 1rem;
+  border-radius: 18px;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.02);
+  border: 1px solid #e1eef5;
+  margin-bottom: 2rem;
+}
+
+.about-section h2 {
+  margin-top: 0;
+}
+
+/* installation + usage */
+.install-card {
+  background: #0f2b3d;
+  color: #e2e8f0;
+  padding: 2rem 2rem 1.2rem;
+  border-radius: 18px;
+  margin: 1.8rem 0 2rem;
+  box-shadow: 0 12px 20px -10px rgba(0, 0, 0, 0.2);
+}
+
+.install-card h2 {
+  color: #ffffff;
+  margin-top: 0;
+  border-bottom: 2px solid #2d7a9b;
+  padding-bottom: 0.5rem;
+}
+
+.install-card p {
+  color: #cbd5e1;
+}
+
+pre {
+  background: #0b1e2e;
+  color: #b4e6ff;
+  padding: 1rem 1.5rem;
+  border-radius: 12px;
+  overflow-x: auto;
+  font-size: 0.95rem;
+  font-family: 'JetBrains Mono', 'Fira Code', 'SF Mono', monospace;
+  border: 1px solid #1e4b63;
+  margin: 1rem 0 1.2rem;
+  box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.02);
+}
+
+code {
+  font-family: 'JetBrains Mono', 'Fira Code', 'SF Mono', monospace;
+  background: #e1eef5;
+  padding: 0.2rem 0.4rem;
+  border-radius: 6px;
+  font-size: 0.9em;
+  color: #0f2b3d;
+}
+
+pre code {
+  background: transparent;
+  padding: 0;
+  color: inherit;
+  font-size: 0.95rem;
+}
+
+.usage-section {
+  background: #ffffff;
+  padding: 1rem 2rem 1.8rem;
+  border-radius: 18px;
+  border: 1px solid #e1eef5;
+  margin-bottom: 2rem;
+}
+
+.usage-section h2 {
+  margin-top: 1.8rem;
+}
+
+.usage-section h2:first-of-type {
+  margin-top: 0.5rem;
+}
+
+.lorem-note {
+  background: #f1f9ff;
+  padding: 1.8rem 2rem 1rem;
+  border-radius: 18px;
+  border: 1px dashed #b4d9ec;
+  margin: 2rem 0 0;
+}
+
+/* footer */
+footer {
+  text-align: center;
+  padding: 1.8rem 2rem;
+  font-size: 0.9rem;
+  color: #5c7a8c;
+  border-top: 1px solid #d9e6ef;
+  background: #ffffff;
+  margin-top: 1rem;
+}
+
+/* responsive */
+@media (max-width: 700px) {
+  .header-inner {
+    flex-direction: column;
+    gap: 0.8rem;
+    align-items: flex-start;
+    padding: 1rem 1.5rem;
+  }
+
+  nav {
+    gap: 1.2rem;
+    width: 100%;
+  }
+
+  .container {
+    padding: 0 1.5rem;
+    margin-top: 1.5rem;
+  }
+
+  h1 {
+    font-size: 2rem;
+  }
+
+  .subhead {
+    font-size: 1rem;
+    padding-left: 0.8rem;
+  }
+
+  .card-grid {
+    grid-template-columns: 1fr;
+    gap: 1.2rem;
+  }
+
+  .install-card,
+  .about-section,
+  .usage-section,
+  .lorem-block {
+    padding: 1.5rem 1.2rem 0.8rem;
+  }
+
+  pre {
+    padding: 0.8rem 1rem;
+    font-size: 0.85rem;
+  }
+}

tmscli-0.3.1/update.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+# Exit immediately if any command fails
+set -e
+
+echo "Building the package with Hatch..."
+hatch build
+
+echo "Publishing the package to PyPI..."
+hatch publish
+
+echo "Pulling latest changes from remote Git repository..."
+# Use || true so the script continues even if there is no tracking upstream configured yet
+git pull || echo "Pull skipped or failed, continuing..."
+
+echo "Staging changes..."
+git add .
+
+echo "Committing changes..."
+git commit -m "New version"
+
+echo "Pushing changes to remote..."
+git push
+
+echo "All steps completed successfully!"

tmscli-0.2.9/README.md

@@ -1,2 +0,0 @@
-# minesweeper
-but in your terminal

tmscli-0.2.9/update.sh

@@ -1,19 +0,0 @@
-#!/bin/bash
-
-# 1. Start all three processes in the background simultaneously
-echo "Starting tasks in parallel..."
-
-hatch build &
-PID_BUILD=$!
-
-hatch publish &
-PID_PASS=$!
-
-# Replace 'pip install --upgrade ...' with your actual upgrade command if different
-pip install --upgrade tmscli&
-PID_PUBLISH=$!
-
-# 2. Wait for all background processes to complete
-wait $PID_BUILD $PID_PUBLISH $PID_UPGRADE
-
-echo "All tasks finished!"