mastui 0.3.0__tar.gz

mastui-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kim Schulz
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mastui-0.3.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.1
+Name: mastui
+Version: 0.3.0
+Summary: A Mastodon TUI client.
+Author: Kim Schulz
+Requires-Python: >=3.9,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: html2text (>=2024.2.26,<2025.0.0)
+Requires-Dist: mastodon-py (>=2.0.1,<3.0.0)
+Requires-Dist: pyperclip (>=1.8.2,<2.0.0)
+Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
+Requires-Dist: requests (>=2.32.4,<3.0.0)
+Requires-Dist: textual (>=0.59.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Description-Content-Type: text/markdown
+
+# Mastui - A Mastodon TUI Client Built with Python
+
+![A screenshot](mastui.png)
+
+Mastui is a Mastodon TUI client built with Python and Textual. It allows users to interact with their Mastodon instance in a terminal environment, providing a more efficient and intuitive way of managing their Mastodon experience. The UI is multi-column to get an easy overview of activities.
+
+## Features
+
+* Timeline Viewing in a multi-column layout
+* Post and Reply creation
+* "Infinite" scrolling of timelines
+* Like posts
+* View user profiles
+* Follow/Unfollow users
+* View post threads
+* Support for local Mastodon servers
+* Light/Dark mode theming
+* Content warning support
+
+### TODO
+
+* database backend
+* Bookmarking
+* Hashtag Searching
+* Unliking posts
+* Direct Messaging
+
+## Installation
+
+The recommended way to install Mastui is with `pipx`.
+
+1.  **Install pipx** (if you don't have it already):
+    ```bash
+    python3 -m pip install --user pipx
+    python3 -m pipx ensurepath
+    ```
+
+2.  **Install mastui using pipx**:
+    ```bash
+    pipx install mastui
+    ```
+
+After this, you can run the application from anywhere by simply typing `mastui`.
+
+## Technology Stack
+
+* [Python](https://www.python.org/)
+* [Poetry](https://python-poetry.org/) for dependency management
+* [Textual](https://textual.textualize.io/) for the TUI framework
+* [Mastodon.py](https://mastodonpy.readthedocs.io/) for interacting with the Mastodon API
+* [html2text](https://github.com/Alir3z4/html2text) for converting HTML to Markdown
+
+## License
+
+Mastui is licensed under the MIT license. See LICENSE for more information.
+
+## Contributing
+
+Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
+
+## Versioning
+
+We use SemVer for versioning. For the versions available, see the tags on this repository.
+
+## Authors
+
+* **Kim Schulz** - *Initial work* - [kimusan](https://github.com/kimusan)
+
+See also the list of contributors who participated in this project.
+
+## Acknowledgments
+
+* Inspiration and guidance from the Textual community and the Poetry team
+* The Mastodon community for their contributions to the development of the application and its features
+* Other projects that have inspired or influenced the design of Mastui
+
+Please feel free to reach out to me if you have any questions, comments, or concerns.
+

mastui-0.3.0/README.md

@@ -0,0 +1,77 @@
+# Mastui - A Mastodon TUI Client Built with Python
+
+![A screenshot](mastui.png)
+
+Mastui is a Mastodon TUI client built with Python and Textual. It allows users to interact with their Mastodon instance in a terminal environment, providing a more efficient and intuitive way of managing their Mastodon experience. The UI is multi-column to get an easy overview of activities.
+
+## Features
+
+* Timeline Viewing in a multi-column layout
+* Post and Reply creation
+* "Infinite" scrolling of timelines
+* Like posts
+* View user profiles
+* Follow/Unfollow users
+* View post threads
+* Support for local Mastodon servers
+* Light/Dark mode theming
+* Content warning support
+
+### TODO
+
+* database backend
+* Bookmarking
+* Hashtag Searching
+* Unliking posts
+* Direct Messaging
+
+## Installation
+
+The recommended way to install Mastui is with `pipx`.
+
+1.  **Install pipx** (if you don't have it already):
+    ```bash
+    python3 -m pip install --user pipx
+    python3 -m pipx ensurepath
+    ```
+
+2.  **Install mastui using pipx**:
+    ```bash
+    pipx install mastui
+    ```
+
+After this, you can run the application from anywhere by simply typing `mastui`.
+
+## Technology Stack
+
+* [Python](https://www.python.org/)
+* [Poetry](https://python-poetry.org/) for dependency management
+* [Textual](https://textual.textualize.io/) for the TUI framework
+* [Mastodon.py](https://mastodonpy.readthedocs.io/) for interacting with the Mastodon API
+* [html2text](https://github.com/Alir3z4/html2text) for converting HTML to Markdown
+
+## License
+
+Mastui is licensed under the MIT license. See LICENSE for more information.
+
+## Contributing
+
+Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
+
+## Versioning
+
+We use SemVer for versioning. For the versions available, see the tags on this repository.
+
+## Authors
+
+* **Kim Schulz** - *Initial work* - [kimusan](https://github.com/kimusan)
+
+See also the list of contributors who participated in this project.
+
+## Acknowledgments
+
+* Inspiration and guidance from the Textual community and the Poetry team
+* The Mastodon community for their contributions to the development of the application and its features
+* Other projects that have inspired or influenced the design of Mastui
+
+Please feel free to reach out to me if you have any questions, comments, or concerns.

mastui-0.3.0/mastui/app.css

@@ -0,0 +1,302 @@
+Screen {
+    layout: vertical;
+}
+
+Timelines {
+    layout: horizontal;
+    height: 1fr;
+}
+
+Timeline {
+    layout: vertical;
+    border: solid $accent;
+    width: 1fr;
+    height: 100%;
+    margin: 1;
+}
+
+.timeline-content {
+    /* This is now empty, as display is handled by the widget itself */
+}
+
+Timeline:focus {
+    border: double $accent-darken-2;
+}
+
+.timeline-header {
+    height: 1;
+    background: $accent;
+    color: $text;
+    dock: top;
+}
+
+.timeline_title {
+    width: 1fr;
+    height: 1;
+    text-align: center;
+    padding: 0 1;
+}
+
+.timeline-refresh-spinner {
+    dock: right;
+    width: auto;
+    height: 1;
+    display: none;
+    margin: 0 1;
+}
+
+.timeline-item {
+    height: auto;
+    margin-bottom: 1;
+}
+
+.boost-header {
+    padding: 0 1;
+    background: $primary-darken-2;
+    color: $text;
+    height: 1;
+}
+
+SplashScreen > Vertical {
+    align: center middle;
+    height: 100%;
+}
+
+
+#logo {
+    width: auto;
+    height: auto;
+}
+
+#version {
+    width: auto;
+    text-align: center;
+}
+
+#splash-status {
+    width: auto;
+    text-align: center;
+}
+
+.action-spinner {
+    display: none;
+}
+
+
+.post-footer {
+    height: 1;
+    padding: 0 1;
+    background: $surface-darken-1;
+}
+
+.post-footer > Static {
+    width: 1fr;
+    text-align: center;
+}
+
+.status-message {
+    margin-top: 1;
+    text-align: center;
+}
+
+Post.favourited {
+    background: $success 20%;
+}
+
+Post.reblogged {
+    background: $warning 20%;
+}
+
+.timeline-item.selected {
+    background: $primary 20%;
+}
+
+Post.selected {
+    background: $primary 20%;
+}
+
+Notification.selected {
+    background: $primary 20%;
+}
+
+
+#dialog {
+    grid-size: 2;
+    grid-gutter: 1;
+    align: center middle;
+    width: 80%;
+    height: auto;
+    max-height: 80%;
+    background: $surface;
+    border: thick $primary 80%;
+    padding: 1;
+}
+
+#dialog > .hidden {
+    display: none;
+}
+
+#auth_link_container {
+    column-span: 2;
+    margin-top: 1;
+    border: round $primary;
+    padding: 1;
+}
+
+#auth_link_container > TextArea {
+    height: 5;
+}
+
+#auth_link_container.hidden {
+    display: none;
+}
+
+#status {
+    column-span: 2;
+    text-align: center;
+    color: $error;
+    height: auto;
+}
+
+#status.hidden {
+    display: none;
+}
+
+#post_dialog {
+    grid-size: 1;
+    grid-gutter: 1;
+    align: center middle;
+    width: 80%;
+    height: auto;
+    max-height: 80%;
+    background: $surface;
+    border: thick $primary 80%;
+    padding: 1;
+}
+
+#post_title {
+    width: 100%;
+    text-align: center;
+    background: $primary;
+    color: $text;
+    padding: 0 1;
+}
+
+#post_content {
+    height: 10;
+}
+
+#post_options {
+    height: auto;
+}
+
+#post_language_container {
+    height: auto;
+}
+
+.post_option_label {
+    width: auto;
+    height: 100%;
+    content-align: left middle;
+}
+
+#cw_input {
+    width: 1fr;
+}
+
+#language_select {
+    width: 1fr;
+}
+
+#post_buttons {
+    width: 100%;
+    align-horizontal: right;
+    height: auto;
+}
+
+#post_buttons > Button {
+    margin-left: 1;
+}
+
+#reply_dialog {
+    grid-size: 1;
+    grid-gutter: 1;
+    align: center middle;
+    width: 80%;
+    height: auto;
+    max-height: 90%;
+    background: $surface;
+    border: thick $primary 80%;
+    padding: 1;
+}
+
+#reply_title {
+    width: 100%;
+    text-align: center;
+    background: $primary;
+    color: $text;
+    padding: 0 1;
+}
+
+#original_post_preview {
+    height: auto;
+    max-height: 10;
+    overflow: auto;
+    margin-bottom: 1;
+}
+
+#reply_content {
+    height: 10;
+}
+
+#reply_options {
+    height: auto;
+}
+
+#reply_language_container {
+    height: auto;
+}
+
+.reply_option_label {
+    width: auto;
+    height: 100%;
+    content-align: left middle;
+}
+
+#cw_input {
+    width: 1fr;
+}
+
+#language_select {
+    width: 1fr;
+}
+
+#reply_buttons {
+    width: 100%;
+    align-horizontal: right;
+    height: auto;
+}
+
+#reply_buttons > Button {
+    margin-left: 1;
+}
+#thread-dialog {
+    width: 80%;
+    height: 80%;
+    background: $surface;
+    border: thick $primary 80%;
+    padding: 1;
+}
+
+#thread-container {
+    padding: 1;
+}
+
+.main-post {
+    border: round $accent;
+}
+
+.reply-post {
+    margin-left: 4;
+}
+