Skip to content

adalfarus/aplustools

Repository files navigation

Active Development CI Test Status License: LGPL-2.1

aplustools2

aplustools2 is a simple, user-friendly Python library for performing amazing tasks. It simplifies complex processes, allowing you to achieve more with less code. Developed with a focus on ease of use and efficiency, aplustools is the go-to solution for Python developers looking to enhance their projects.

Compatibility

🟩 (Works perfectly); 🟨 (Untested); 🟧 (Some Issues); 🟥 (Unusable)

OS UX & README instructions Tests More Complex Functionalities
Windows 🟩 🟩 🟩
MacOS 🟨 🟩 🟨
Linux (Ubuntu 22.04 LTS) 🟩 🟩 🟨

Features

  • Easy to use for beginners, but not lacking for experts
  • Pretty efficient
  • Supports the three main platforms
  • Regular updates and support
  • Comprehensive documentation

Installation

You can install aplustools2 via pip:

pip install aplustools[all]>=2.0.0.0 --upgrade

Or clone the repository and install manually:

git clone https://github.com/Adalfarus/aplustools.git
cd aplustools
python -m build

Usage

Here are a few quick examples of how to use aplustools:

  • Examples will be added in the full release.

(If you have problems with the package please use py -3.12 -m pip install aplustools[all]>=2.0.0.0 --upgrade --user) (The standard shortform for aplustools is aps, so please use import aplustools as aps for consistency)

aps cli

Can currently run tests with aps tests run tests/ -minimal and show a basic help using aps help.

For more detailed usage and examples, check out our documentation.

Naming convention, dependencies and library information

PEP 8 -- Style Guide for Python Code

For modules I use 'lowercase', classes are 'CapitalizedWords' and functions and methods are 'lower_case_with_underscores'.

Information

  • Additional information will be added in the full release.

Contributing

We welcome contributions! Please see our contributing guidelines for more details on how you can contribute to aplustools.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a pull request

Aps Build master

You can use the aps_build_master script for your os to make your like a lot easier. It supports running tests, installing, building and much more as well as chaining together as many commands as you like.

This example runs test, build the project and then installs it

call .\aps_build_master.bat 234
sudo apt install python3-pip
sudo apt install python3-venv
chmod +x ./aps_build_master.sh
./aps_build_master.sh 234

License

aplustools is licensed under the LGPL-2.1 License - see the LICENSE file for details.