Skip to main content

Python3 module for working with clipboard. Created because pyperclip is discontinued.

Project description

✨ Clipman

License: Mozilla Public License 2.0 linting: pylint maintainer: NikitaBeloglazov

Python3 module for working with clipboard. Created because pyperclip is discontinued.

Mostly made for ✨ YTCON

📘 Features:

  • Easy use and simple architecture by KISS
  • User-friendly
  • No additional modules
  • Supports many engines
  • We use PyLint and we comment all our code
  • Active development
  • Just good dev 😇

👽 Using

import clipman
clipman.init() # Just initialize module

# Set text to clipboard
clipman.set("test")

# Get text from clipboard. So simple!:)
print(clipman.get())
Out: 'test'

Also you can use clipman.copy("ytcon") and clipman.paste() as from pyperclip!:)

Catching errors

  • If you want to catch all errors from the module, use clipman.exceptions.ClipmanBaseException:
import clipman
try:
  clipman.init()
  print(clipman.paste())
except clipman.exceptions.ClipmanBaseException as e:
  print(e)
  • And if you want to catch specific module error, use its name.

🚀 Install

Clipman is avalible on PyPI - https://pypi.org/project/clipman/

Install it as pip package

pip3 install clipman

🔌 Support

•‎ 🟩 Linux - FULL SUPPORT, native in KDE. In other cases, some additional dependencies are required

•‎ 🟩 Android - FULL SUPPORT in Termux, some additional deps needed too

•‎ 🟩 BSD Systems - Works on FreeBSD / GhostBSD and OpenBSD / FuguIta, deps same as Linux

•‎ 🟩 Windows - Works natively

•‎ 🟩 MacOS - Works on macOS HighSierra 10.13

📙 Additional deps

Unstead zypper you need to use system package manager: pkg, apt, dnf, pacman, etc

- = - = -

🐧 On Linux/BSD - ▶️ KDE (any display server)

  • Native support. No additional dependencies are needed.

It seems that all dependencies are listed below are already installed by default in all KDE distributions

The only minimum requirement is dbus, klipper (which is now built-in into KDE), and an dbus-python

🐧 On Linux/BSD - X11

  • Install xsel or xclip package

Example: sudo zypper install xsel OR sudo zypper install xclip

- = - = -

🐧 On Linux/BSD - Wayland

  • Install wl-clipboard package

Example: sudo zypper install wl-clipboard

- = - = -

🐸 On Android

Clipboard works only in Termux. And you need install additional deps in it.

  • Install Termux:API from F-Droid
  • Run pkg install termux-api
  • Check it - run termux-clipboard-get

License

This code is under Mozilla Public License Version 2.0.

Contribution / Issues

📕 [!!] If you encouter an error, please read the error text very closely. The module is specially written so that errors give you a complete answer even if you a lamer

  • 🥼 Pull requests are welcome!
  • 🌈 Feel free to write Issues! The developer can answer you in the following languages: Ukrainian, English, Russian.
  • Don't forget to attach version (pip3 show clipman) and error text with clipman.init(debug=True) :)
  • ⏩ To speed up the process write to maintainer

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clipman-3.2.0.tar.gz (17.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clipman-3.2.0-py3-none-any.whl (17.3 kB view details)

Uploaded Python 3

File details

Details for the file clipman-3.2.0.tar.gz.

File metadata

  • Download URL: clipman-3.2.0.tar.gz
  • Upload date:
  • Size: 17.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.8

File hashes

Hashes for clipman-3.2.0.tar.gz
Algorithm Hash digest
SHA256 416f8eedd51d89aa9555dba1ba775b2cddf6e956067d5a9729de872f628bcacc
MD5 1563cd7231b11e0b5f0a8937501a22dd
BLAKE2b-256 6300bf9dd0fa043174c08bf5dd2a02c3523994130d70e82a39025d96b1f7035b

See more details on using hashes here.

File details

Details for the file clipman-3.2.0-py3-none-any.whl.

File metadata

  • Download URL: clipman-3.2.0-py3-none-any.whl
  • Upload date:
  • Size: 17.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.8

File hashes

Hashes for clipman-3.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 288a63035da372c4918b2d02f0f5c39bc67f43776e4370f0cc96a1fc4d6df8bb
MD5 c29e3a08d4da4388dbede6a7712afd61
BLAKE2b-256 7f0bae1b99b7dcb440a7e0e5b27e3fad30f19067af937277041dc387fcdbac4a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page