mailyou 0.1.0__tar.gz

mailyou-0.1.0/LICENSE

@@ -0,0 +1,131 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## 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](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#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](#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.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## 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.

mailyou-0.1.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: mailyou
+Version: 0.1.0
+Summary: Send emails straight from your CLI
+License-Expression: PolyForm-Noncommercial-1.0.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-dotenv>=1.2.2
+Dynamic: license-file
+
+# MailYou
+
+Send emails straight from your CLI!
+
+## How to use
+
+Clone the repo:
+
+```bash
+git clone https://github.com/aiadam36/MailYou.git
+cd MailYou
+```
+
+Install dependencies:
+
+```bash
+pip install .
+```
+
+Configure the `.env`:
+
+```bash
+cp .env.example .env
+```
+
+And then fill your credentials and recipient addresses
+
+> We also supports **Cc**, **Bcc**, **Reply-To** and attachment! Simply fill it in `.env` file
+
+After that, run any of this command:
+
+```bash
+cp examples/email.txt email.txt # Use our plain text template
+```
+
+Or for an HTML email:
+
+```bash
+cp examples/email.html email.html # Use our HTML template
+```
+
+Or basically write your own from scratch:
+
+```bash
+touch email.txt  # plain text
+touch email.html # HTML
+```
+
+The file extension determines how the email is sent: `.txt` sends as plain text, `.html` sends as HTML. Any other extension will produce an error
+
+And then run `mailyou -t FILE` to send them
+
+`FILE` is your email file name
+
+> `mailyou --target FILE` is also valid
+
+We use `-t` or `--target` to specify the path of the email file, so it's not necessary to name them all `email.txt` or `email.html`
+
+### How to write the email (Especially if you used `touch`)
+
+The script parses email files exactly like these:
+
+- **Line 1** is the subject
+- **Line 2** is a separator (must be blank)
+- **Line 3+** is the email body
+
+> For subject and email body, you can always leave them blank if you don't want any, but **line 2** must always be blank
+
+If any of these requirements are not satisfied, the script will print an error and won't send
+
+---
+
+This structure is the same for both `.txt` and `.html` files. The only difference is that **line 3 onward is treated as raw HTML** when using a `.html` file
+
+### Example plain text email
+
+This is an example of a valid `email.txt`:
+
+```
+Sample Message
+
+Hello,
+
+Lorem ipsum style placeholder email content for testing purposes
+
+Thank you.
+```
+
+### Example HTML email
+
+This is an example of a valid `email.html`:
+
+```
+Sample Message
+
+<html>
+  <body>
+    <p>Hello</p>
+    <p>Lorem ipsum style placeholder email content for testing purposes</p>
+    <p>Thank you</p>
+  </body>
+</html>
+```
+
+#### Breakdown (applies to both formats)
+
+- **Line 1** `Sample Message` is the subject
+
+- **Line 2** (blank) is the separator
+
+- **Line 3+** is the body: plain text for `.txt`, raw HTML markup for `.html`
+
+> **FYI**, for plain text emails we handle linebreaks automatically by injecting `\n` starting from **line 3** and so on. For HTML emails, your markup controls all formatting
+
+## Contributing
+
+We're restricting PR access, sorry.

mailyou-0.1.0/README.md

@@ -0,0 +1,117 @@
+# MailYou
+
+Send emails straight from your CLI!
+
+## How to use
+
+Clone the repo:
+
+```bash
+git clone https://github.com/aiadam36/MailYou.git
+cd MailYou
+```
+
+Install dependencies:
+
+```bash
+pip install .
+```
+
+Configure the `.env`:
+
+```bash
+cp .env.example .env
+```
+
+And then fill your credentials and recipient addresses
+
+> We also supports **Cc**, **Bcc**, **Reply-To** and attachment! Simply fill it in `.env` file
+
+After that, run any of this command:
+
+```bash
+cp examples/email.txt email.txt # Use our plain text template
+```
+
+Or for an HTML email:
+
+```bash
+cp examples/email.html email.html # Use our HTML template
+```
+
+Or basically write your own from scratch:
+
+```bash
+touch email.txt  # plain text
+touch email.html # HTML
+```
+
+The file extension determines how the email is sent: `.txt` sends as plain text, `.html` sends as HTML. Any other extension will produce an error
+
+And then run `mailyou -t FILE` to send them
+
+`FILE` is your email file name
+
+> `mailyou --target FILE` is also valid
+
+We use `-t` or `--target` to specify the path of the email file, so it's not necessary to name them all `email.txt` or `email.html`
+
+### How to write the email (Especially if you used `touch`)
+
+The script parses email files exactly like these:
+
+- **Line 1** is the subject
+- **Line 2** is a separator (must be blank)
+- **Line 3+** is the email body
+
+> For subject and email body, you can always leave them blank if you don't want any, but **line 2** must always be blank
+
+If any of these requirements are not satisfied, the script will print an error and won't send
+
+---
+
+This structure is the same for both `.txt` and `.html` files. The only difference is that **line 3 onward is treated as raw HTML** when using a `.html` file
+
+### Example plain text email
+
+This is an example of a valid `email.txt`:
+
+```
+Sample Message
+
+Hello,
+
+Lorem ipsum style placeholder email content for testing purposes
+
+Thank you.
+```
+
+### Example HTML email
+
+This is an example of a valid `email.html`:
+
+```
+Sample Message
+
+<html>
+  <body>
+    <p>Hello</p>
+    <p>Lorem ipsum style placeholder email content for testing purposes</p>
+    <p>Thank you</p>
+  </body>
+</html>
+```
+
+#### Breakdown (applies to both formats)
+
+- **Line 1** `Sample Message` is the subject
+
+- **Line 2** (blank) is the separator
+
+- **Line 3+** is the body: plain text for `.txt`, raw HTML markup for `.html`
+
+> **FYI**, for plain text emails we handle linebreaks automatically by injecting `\n` starting from **line 3** and so on. For HTML emails, your markup controls all formatting
+
+## Contributing
+
+We're restricting PR access, sorry.

mailyou-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mailyou"
+version = "0.1.0"
+description = "Send emails straight from your CLI"
+readme = "README.md"
+license = "PolyForm-Noncommercial-1.0.0"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+dependencies = [
+    "python-dotenv>=1.2.2",
+]
+
+[project.scripts]
+mailyou = "mailyou.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

mailyou-0.1.0/setup.cfg

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

mailyou-0.1.0/src/mailyou/__init__.py

@@ -0,0 +1,12 @@
+from .attachment import attach_files, parse_attachments
+from .config import Config
+from .parser import parse_email_file
+from .sender import send
+
+__all__ = [
+    "Config",
+    "parse_email_file",
+    "parse_attachments",
+    "attach_files",
+    "send",
+]

mailyou-0.1.0/src/mailyou/__main__.py

@@ -0,0 +1,4 @@
+import sys
+from .cli import main
+
+sys.exit(main())

mailyou-0.1.0/src/mailyou/attachment.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+import mimetypes
+import os
+from email.message import EmailMessage
+
+
+def parse_attachments(paths: list[str]) -> list[str]:
+    for path in paths:
+        if not os.path.exists(path):
+            raise FileNotFoundError(f"Attachment not found: {path!r}")
+        if not os.path.isfile(path):
+            raise ValueError(f"Attachment path is not a file: {path!r}")
+    return paths
+
+
+def attach_files(msg: EmailMessage, paths: list[str]) -> None:
+    for path in paths:
+        mime_type, _ = mimetypes.guess_type(path)
+        if mime_type is None:
+            mime_type = "application/octet-stream"
+        maintype, subtype = mime_type.split("/", 1)
+        filename = os.path.basename(path)
+        with open(path, "rb") as fh:
+            msg.add_attachment(
+                fh.read(),
+                maintype=maintype,
+                subtype=subtype,
+                filename=filename,
+            )
+        print(f"Attached: {filename} ({mime_type})")

mailyou-0.1.0/src/mailyou/cli.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+import argparse
+import sys
+
+from .config import Config
+from .parser import parse_email_file
+from .sender import send
+
+
+def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        prog="mailyou",
+        description="Send an email from the CLI",
+    )
+    parser.add_argument(
+        "-t", "--target",
+        required=True,
+        metavar="FILE",
+        help="Path to the email file (.txt or .html)",
+    )
+    return parser.parse_args(argv)
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = parse_args(argv)
+
+    try:
+        config = Config.from_env()
+    except (EnvironmentError, ValueError) as exc:
+        print(f"Configuration error: {exc}", file=sys.stderr)
+        return 1
+
+    try:
+        subject, body, content_type = parse_email_file(args.target)
+    except (FileNotFoundError, ValueError) as exc:
+        print(f"Error reading {args.target!r}: {exc}", file=sys.stderr)
+        return 1
+
+    try:
+        send(subject, body, content_type, config)
+    except (FileNotFoundError, ValueError) as exc:
+        print(f"Attachment error: {exc}", file=sys.stderr)
+        return 1
+    except Exception as exc:
+        print(f"Failed to send email: {exc}", file=sys.stderr)
+        return 1
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

mailyou-0.1.0/src/mailyou/config.py

@@ -0,0 +1,73 @@
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass, field
+
+from dotenv import load_dotenv
+
+
+def _load_addresses(key: str) -> list[str]:
+    raw = os.getenv(key, "")
+    return [addr.strip() for addr in raw.split(",") if addr.strip()]
+
+
+def _load_port() -> int:
+    raw = os.getenv("SMTP_PORT", "587")
+    try:
+        return int(raw)
+    except ValueError:
+        raise ValueError(f"SMTP_PORT must be an integer, got: {raw!r}")
+
+
+@dataclass(frozen=True)
+class Config:
+    smtp_server: str
+    smtp_port: int
+    smtp_user: str
+    smtp_pass: str
+    mail_from: str
+    mail_to: list[str]
+    mail_cc: list[str] = field(default_factory=list)
+    mail_bcc: list[str] = field(default_factory=list)
+    mail_reply_to: list[str] = field(default_factory=list)
+    mail_attachments: list[str] = field(default_factory=list)
+
+    @classmethod
+    def from_env(cls, dotenv_path: str | None = None) -> "Config":
+        load_dotenv(dotenv_path)
+
+        smtp_server = os.getenv("SMTP_SERVER", "")
+        smtp_user = os.getenv("SMTP_USER", "")
+        smtp_pass = os.getenv("SMTP_PASS", "")
+        mail_to = _load_addresses("MAIL_TO")
+
+        missing = [
+            name
+            for name, val in [
+                ("SMTP_SERVER", smtp_server),
+                ("SMTP_USER", smtp_user),
+                ("SMTP_PASS", smtp_pass),
+            ]
+            if not val
+        ] + ([] if mail_to else ["MAIL_TO"])
+
+        if missing:
+            raise EnvironmentError(
+                f"Missing required .env variable(s): {', '.join(missing)}"
+            )
+
+        raw_attachments = os.getenv("MAIL_ATTACHMENTS", "")
+        attachment_paths = [p.strip() for p in raw_attachments.split(",") if p.strip()]
+
+        return cls(
+            smtp_server=smtp_server,
+            smtp_port=_load_port(),
+            smtp_user=smtp_user,
+            smtp_pass=smtp_pass,
+            mail_from=os.getenv("MAIL_FROM", smtp_user),
+            mail_to=mail_to,
+            mail_cc=_load_addresses("MAIL_CC"),
+            mail_bcc=_load_addresses("MAIL_BCC"),
+            mail_reply_to=_load_addresses("MAIL_REPLY_TO"),
+            mail_attachments=attachment_paths,
+        )

mailyou-0.1.0/src/mailyou/parser.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+import os
+
+_SUPPORTED_EXTENSIONS: dict[str, str] = {
+    ".txt": "plain",
+    ".html": "html",
+}
+
+
+def parse_email_file(path: str) -> tuple[str, str, str]:
+    if not os.path.exists(path):
+        raise FileNotFoundError(f"Email file not found: {path!r}")
+
+    ext = os.path.splitext(path)[1].lower()
+    content_type = _SUPPORTED_EXTENSIONS.get(ext)
+    if content_type is None:
+        supported = ", ".join(_SUPPORTED_EXTENSIONS)
+        raise ValueError(
+            f"Unsupported file extension {ext!r}. Supported: {supported}"
+        )
+
+    with open(path, "r", encoding="utf-8") as fh:
+        lines = fh.read().splitlines()
+
+    if not lines:
+        raise ValueError("Email file is completely empty")
+
+    subject = lines[0].strip()
+
+    if len(lines) == 1:
+        return subject, "", content_type
+
+    if lines[1].strip() != "":
+        raise ValueError(
+            "Line 2 must be completely blank"
+        )
+
+    body = "\n".join(lines[2:])
+
+    return subject, body, content_type

mailyou-0.1.0/src/mailyou/sender.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+import smtplib
+from email.message import EmailMessage
+
+from .attachment import attach_files, parse_attachments
+from .config import Config
+
+
+def send(subject: str, body: str, content_type: str, config: Config) -> None:
+    attachment_paths = parse_attachments(config.mail_attachments)
+
+    msg = EmailMessage()
+    msg["From"] = config.mail_from
+    msg["To"] = ", ".join(config.mail_to)
+    msg["Subject"] = subject
+
+    if config.mail_cc:
+        msg["Cc"] = ", ".join(config.mail_cc)
+
+    if config.mail_reply_to:
+        msg["Reply-To"] = ", ".join(config.mail_reply_to)
+
+    msg.set_content(body, subtype=content_type)
+
+    if attachment_paths:
+        attach_files(msg, attachment_paths)
+
+    all_recipients = config.mail_to + config.mail_cc + config.mail_bcc
+
+    print(f"Connecting to {config.smtp_server}:{config.smtp_port}...")
+    with smtplib.SMTP(config.smtp_server, config.smtp_port) as smtp:
+        smtp.starttls()
+        print("TLS enabled")
+
+        smtp.login(config.smtp_user, config.smtp_pass)
+        print("Authenticated")
+
+        smtp.sendmail(config.mail_from, all_recipients, msg.as_string())
+
+    _print_summary(config, attachment_paths)
+
+
+def _print_summary(config: Config, attachment_paths: list[str]) -> None:
+    parts = [f"To: {', '.join(config.mail_to)}"]
+    if config.mail_cc:
+        parts.append(f"CC: {', '.join(config.mail_cc)}")
+    if config.mail_bcc:
+        parts.append(f"BCC: {', '.join(config.mail_bcc)}")
+    if config.mail_reply_to:
+        parts.append(f"Reply-To: {', '.join(config.mail_reply_to)}")
+    if attachment_paths:
+        parts.append(f"Attachments: {len(attachment_paths)}")
+    print(f"Email sent successfully! ({' | '.join(parts)})")

mailyou-0.1.0/src/mailyou.egg-info/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: mailyou
+Version: 0.1.0
+Summary: Send emails straight from your CLI
+License-Expression: PolyForm-Noncommercial-1.0.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-dotenv>=1.2.2
+Dynamic: license-file
+
+# MailYou
+
+Send emails straight from your CLI!
+
+## How to use
+
+Clone the repo:
+
+```bash
+git clone https://github.com/aiadam36/MailYou.git
+cd MailYou
+```
+
+Install dependencies:
+
+```bash
+pip install .
+```
+
+Configure the `.env`:
+
+```bash
+cp .env.example .env
+```
+
+And then fill your credentials and recipient addresses
+
+> We also supports **Cc**, **Bcc**, **Reply-To** and attachment! Simply fill it in `.env` file
+
+After that, run any of this command:
+
+```bash
+cp examples/email.txt email.txt # Use our plain text template
+```
+
+Or for an HTML email:
+
+```bash
+cp examples/email.html email.html # Use our HTML template
+```
+
+Or basically write your own from scratch:
+
+```bash
+touch email.txt  # plain text
+touch email.html # HTML
+```
+
+The file extension determines how the email is sent: `.txt` sends as plain text, `.html` sends as HTML. Any other extension will produce an error
+
+And then run `mailyou -t FILE` to send them
+
+`FILE` is your email file name
+
+> `mailyou --target FILE` is also valid
+
+We use `-t` or `--target` to specify the path of the email file, so it's not necessary to name them all `email.txt` or `email.html`
+
+### How to write the email (Especially if you used `touch`)
+
+The script parses email files exactly like these:
+
+- **Line 1** is the subject
+- **Line 2** is a separator (must be blank)
+- **Line 3+** is the email body
+
+> For subject and email body, you can always leave them blank if you don't want any, but **line 2** must always be blank
+
+If any of these requirements are not satisfied, the script will print an error and won't send
+
+---
+
+This structure is the same for both `.txt` and `.html` files. The only difference is that **line 3 onward is treated as raw HTML** when using a `.html` file
+
+### Example plain text email
+
+This is an example of a valid `email.txt`:
+
+```
+Sample Message
+
+Hello,
+
+Lorem ipsum style placeholder email content for testing purposes
+
+Thank you.
+```
+
+### Example HTML email
+
+This is an example of a valid `email.html`:
+
+```
+Sample Message
+
+<html>
+  <body>
+    <p>Hello</p>
+    <p>Lorem ipsum style placeholder email content for testing purposes</p>
+    <p>Thank you</p>
+  </body>
+</html>
+```
+
+#### Breakdown (applies to both formats)
+
+- **Line 1** `Sample Message` is the subject
+
+- **Line 2** (blank) is the separator
+
+- **Line 3+** is the body: plain text for `.txt`, raw HTML markup for `.html`
+
+> **FYI**, for plain text emails we handle linebreaks automatically by injecting `\n` starting from **line 3** and so on. For HTML emails, your markup controls all formatting
+
+## Contributing
+
+We're restricting PR access, sorry.

mailyou-0.1.0/src/mailyou.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+src/mailyou/__init__.py
+src/mailyou/__main__.py
+src/mailyou/attachment.py
+src/mailyou/cli.py
+src/mailyou/config.py
+src/mailyou/parser.py
+src/mailyou/sender.py
+src/mailyou.egg-info/PKG-INFO
+src/mailyou.egg-info/SOURCES.txt
+src/mailyou.egg-info/dependency_links.txt
+src/mailyou.egg-info/entry_points.txt
+src/mailyou.egg-info/requires.txt
+src/mailyou.egg-info/top_level.txt

mailyou-0.1.0/src/mailyou.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mailyou-0.1.0/src/mailyou.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mailyou = mailyou.cli:main

mailyou-0.1.0/src/mailyou.egg-info/requires.txt

@@ -0,0 +1 @@
+python-dotenv>=1.2.2

mailyou-0.1.0/src/mailyou.egg-info/top_level.txt

@@ -0,0 +1 @@
+mailyou