generated from PlexSheep/baserepo
Compare commits
No commits in common. "2564eee9919df11f62fc66a8339bb3ca9da0e295" and "ad65b87cdf4441b178c772d9624706a81c642b41" have entirely different histories.
2564eee991
...
ad65b87cdf
11 changed files with 1 additions and 429 deletions
120
.github/workflows/CI.yml
vendored
120
.github/workflows/CI.yml
vendored
|
@ -1,120 +0,0 @@
|
||||||
# This file is autogenerated by maturin v0.14.17
|
|
||||||
# To update, run
|
|
||||||
#
|
|
||||||
# maturin generate-ci github
|
|
||||||
#
|
|
||||||
name: CI
|
|
||||||
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches:
|
|
||||||
- main
|
|
||||||
- master
|
|
||||||
tags:
|
|
||||||
- '*'
|
|
||||||
pull_request:
|
|
||||||
workflow_dispatch:
|
|
||||||
|
|
||||||
permissions:
|
|
||||||
contents: read
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
linux:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
strategy:
|
|
||||||
matrix:
|
|
||||||
target: [x86_64, x86, aarch64, armv7, s390x, ppc64le]
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v3
|
|
||||||
- uses: actions/setup-python@v4
|
|
||||||
with:
|
|
||||||
python-version: '3.10'
|
|
||||||
- name: Build wheels
|
|
||||||
uses: PyO3/maturin-action@v1
|
|
||||||
with:
|
|
||||||
target: ${{ matrix.target }}
|
|
||||||
args: --release --out dist --find-interpreter
|
|
||||||
sccache: 'true'
|
|
||||||
manylinux: auto
|
|
||||||
- name: Upload wheels
|
|
||||||
uses: actions/upload-artifact@v3
|
|
||||||
with:
|
|
||||||
name: wheels
|
|
||||||
path: dist
|
|
||||||
|
|
||||||
windows:
|
|
||||||
runs-on: windows-latest
|
|
||||||
strategy:
|
|
||||||
matrix:
|
|
||||||
target: [x64, x86]
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v3
|
|
||||||
- uses: actions/setup-python@v4
|
|
||||||
with:
|
|
||||||
python-version: '3.10'
|
|
||||||
architecture: ${{ matrix.target }}
|
|
||||||
- name: Build wheels
|
|
||||||
uses: PyO3/maturin-action@v1
|
|
||||||
with:
|
|
||||||
target: ${{ matrix.target }}
|
|
||||||
args: --release --out dist --find-interpreter
|
|
||||||
sccache: 'true'
|
|
||||||
- name: Upload wheels
|
|
||||||
uses: actions/upload-artifact@v3
|
|
||||||
with:
|
|
||||||
name: wheels
|
|
||||||
path: dist
|
|
||||||
|
|
||||||
macos:
|
|
||||||
runs-on: macos-latest
|
|
||||||
strategy:
|
|
||||||
matrix:
|
|
||||||
target: [x86_64, aarch64]
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v3
|
|
||||||
- uses: actions/setup-python@v4
|
|
||||||
with:
|
|
||||||
python-version: '3.10'
|
|
||||||
- name: Build wheels
|
|
||||||
uses: PyO3/maturin-action@v1
|
|
||||||
with:
|
|
||||||
target: ${{ matrix.target }}
|
|
||||||
args: --release --out dist --find-interpreter
|
|
||||||
sccache: 'true'
|
|
||||||
- name: Upload wheels
|
|
||||||
uses: actions/upload-artifact@v3
|
|
||||||
with:
|
|
||||||
name: wheels
|
|
||||||
path: dist
|
|
||||||
|
|
||||||
sdist:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v3
|
|
||||||
- name: Build sdist
|
|
||||||
uses: PyO3/maturin-action@v1
|
|
||||||
with:
|
|
||||||
command: sdist
|
|
||||||
args: --out dist
|
|
||||||
- name: Upload sdist
|
|
||||||
uses: actions/upload-artifact@v3
|
|
||||||
with:
|
|
||||||
name: wheels
|
|
||||||
path: dist
|
|
||||||
|
|
||||||
release:
|
|
||||||
name: Release
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
if: "startsWith(github.ref, 'refs/tags/')"
|
|
||||||
needs: [linux, windows, macos, sdist]
|
|
||||||
steps:
|
|
||||||
- uses: actions/download-artifact@v3
|
|
||||||
with:
|
|
||||||
name: wheels
|
|
||||||
- name: Publish to PyPI
|
|
||||||
uses: PyO3/maturin-action@v1
|
|
||||||
env:
|
|
||||||
MATURIN_PYPI_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
|
|
||||||
with:
|
|
||||||
command: upload
|
|
||||||
args: --skip-existing *
|
|
28
Cargo.toml
28
Cargo.toml
|
@ -1,28 +0,0 @@
|
||||||
[package]
|
|
||||||
name = "libpt"
|
|
||||||
version = "0.1.0"
|
|
||||||
edition = "2021"
|
|
||||||
authors = ["Christoph J. Scherr <software@cscherr.de>"]
|
|
||||||
license = "GPL3"
|
|
||||||
description = "my personal multitool"
|
|
||||||
readme = "README.md"
|
|
||||||
homepage = "https://git.cscherr.de/PlexSheep/pt"
|
|
||||||
repository = "https://git.cscherr.de/PlexSheep/pt"
|
|
||||||
keywords = ["cli", "python", "scriptable", "pyo3", "library"]
|
|
||||||
categories = ["command-line-utilities"]
|
|
||||||
|
|
||||||
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
|
|
||||||
|
|
||||||
[lib]
|
|
||||||
name = "libpt"
|
|
||||||
crate-type = ["cdylib", "rlib"]
|
|
||||||
|
|
||||||
[[bin]]
|
|
||||||
name = "pt"
|
|
||||||
path = "src/bin/mod.rs"
|
|
||||||
|
|
||||||
[dependencies]
|
|
||||||
clap = "4.3.11"
|
|
||||||
env_logger = "0.10.0"
|
|
||||||
log = { version = "0.4.19", features = ["max_level_debug", "release_max_level_info"] }
|
|
||||||
pyo3 = "0.18.1"
|
|
28
README.md
28
README.md
|
@ -1,28 +1,2 @@
|
||||||
# pt / libpt
|
# baserepo
|
||||||
|
|
||||||
`pt` stands for either one of "personal tool", "plex tool", "pete" or something among those lines.
|
|
||||||
It is a collection of tools that i might or might not use. The intended purpose of this repo is that
|
|
||||||
I program whatever i feel is worth having in a personal thing into it, then use it as either a lib,
|
|
||||||
crate, python module or executable.
|
|
||||||
|
|
||||||
Let's see if I make it a bloated mess or stop committing after 30 hello worlds.
|
|
||||||
|
|
||||||
#### But the name `pt` / `libpt` already exists!
|
|
||||||
So what? I don't care. Besides, there is not enough names to name everything unique.
|
|
||||||
|
|
||||||
# compiling
|
|
||||||
TBD
|
|
||||||
|
|
||||||
# Documentation
|
|
||||||
TBD
|
|
||||||
|
|
||||||
# Mirrored
|
|
||||||
The origin of this repository is [git.cscherr.de](https://git.cscherr.de/PlexSheep/pt)
|
|
||||||
|
|
||||||
It is mirrored to:
|
|
||||||
- [GitHub](https://github.com/PlexSheep/pt)
|
|
||||||
- [Codeberg](https://codeberg.org/PlexSheep/pt)
|
|
||||||
|
|
||||||
|
|
||||||
# License
|
|
||||||
GPL-3 or newer.
|
|
||||||
|
|
|
@ -1,16 +0,0 @@
|
||||||
[build-system]
|
|
||||||
requires = ["maturin>=0.14,<0.15"]
|
|
||||||
build-backend = "maturin"
|
|
||||||
|
|
||||||
[project]
|
|
||||||
name = "libtp"
|
|
||||||
requires-python = ">=3.7"
|
|
||||||
classifiers = [
|
|
||||||
"Programming Language :: Rust",
|
|
||||||
"Programming Language :: Python :: Implementation :: CPython",
|
|
||||||
"Programming Language :: Python :: Implementation :: PyPy",
|
|
||||||
]
|
|
||||||
|
|
||||||
|
|
||||||
[tool.maturin]
|
|
||||||
features = ["pyo3/extension-module"]
|
|
|
@ -1,4 +0,0 @@
|
||||||
//! # args module
|
|
||||||
//!
|
|
||||||
//! The args module of pt is used to parse commandline arguments. Fot this, it makes use of
|
|
||||||
//! [`clap`].
|
|
|
@ -1,9 +0,0 @@
|
||||||
//! # Main executable of pt
|
|
||||||
//!
|
|
||||||
//! This module contains all code specific to the executable version of `libpt`: `pt`.
|
|
||||||
mod args;
|
|
||||||
|
|
||||||
/// ## Main function of the `pt` binary
|
|
||||||
pub fn main() {
|
|
||||||
println!("hello world");
|
|
||||||
}
|
|
63
src/lib.rs
63
src/lib.rs
|
@ -1,63 +0,0 @@
|
||||||
//! # root module of `libpt`
|
|
||||||
//!
|
|
||||||
//! [`libpt`](crate) contains my personal code. It is compiled as all of the following:
|
|
||||||
//!
|
|
||||||
//! - dynamic library (`cdylib`, `.so` file on Linux)
|
|
||||||
//! - rust library crate (`rlib`, usable as )
|
|
||||||
//! - python module (with [`PyO3`](pyo3))
|
|
||||||
//! - executable (as `pt`)
|
|
||||||
//!
|
|
||||||
//! For more info on the linkage types, please refer to the
|
|
||||||
//! [rust reference](https://doc.rust-lang.org/reference/linkage.html).
|
|
||||||
|
|
||||||
//// ATTRIBUTES ////////////////////////////////////////////////////////////////////////////////////
|
|
||||||
// we want docs
|
|
||||||
#![warn(missing_docs)]
|
|
||||||
#![warn(rustdoc::missing_crate_level_docs)]
|
|
||||||
|
|
||||||
// we want Debug everywhere. This is a library and there will be many bugs.
|
|
||||||
#![warn(missing_debug_implementations)]
|
|
||||||
|
|
||||||
// enable clippy's extra lints, the pedantic version
|
|
||||||
#![warn(clippy::pedantic)]
|
|
||||||
|
|
||||||
//// IMPORTS ///////////////////////////////////////////////////////////////////////////////////////
|
|
||||||
/// contains code specific to the executable
|
|
||||||
pub mod bin;
|
|
||||||
/// logger used by libpt
|
|
||||||
pub mod logger;
|
|
||||||
use crate::logger::Logger;
|
|
||||||
|
|
||||||
use pyo3::prelude::*;
|
|
||||||
|
|
||||||
//// PUBLIC FUNCTIONS //////////////////////////////////////////////////////////////////////////////
|
|
||||||
/// ## Check if [`libpt`](crate) has been loaded
|
|
||||||
///
|
|
||||||
/// Always returns `true` if you can execute it.
|
|
||||||
#[pyfunction]
|
|
||||||
pub fn libpt_loaded() -> bool {
|
|
||||||
true
|
|
||||||
}
|
|
||||||
|
|
||||||
//// PRIVATE FUNCTIONS /////////////////////////////////////////////////////////////////////////////
|
|
||||||
/// ## Python module: logger
|
|
||||||
#[pymodule]
|
|
||||||
fn py_logger(py: Python, m: &PyModule) -> PyResult<()> {
|
|
||||||
let logger_module = PyModule::new(py, "logger")?;
|
|
||||||
logger_module.add_class::<Logger>()?;
|
|
||||||
|
|
||||||
m.add_submodule(logger_module)?;
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
/// ## Python module: root
|
|
||||||
///
|
|
||||||
/// This function is the entry point of [`PyO3`](pyo3). This is where the main module is built.
|
|
||||||
#[pymodule]
|
|
||||||
fn libpt(py: Python, m: &PyModule) -> PyResult<()> {
|
|
||||||
m.add_function(wrap_pyfunction!(libpt_loaded, m)?)?;
|
|
||||||
|
|
||||||
// load logger module
|
|
||||||
py_logger(py, m)?;
|
|
||||||
Ok(())
|
|
||||||
}
|
|
|
@ -1,151 +0,0 @@
|
||||||
//! # A specialized Logger for [`libpt`](crate)
|
|
||||||
//!
|
|
||||||
//! For the library version, only the basic [`log`](crate::log) is used, so that it is possible for
|
|
||||||
//! the end user to use the [`log`](crate::log) frontend they desire.
|
|
||||||
//!
|
|
||||||
//! I did however decide to create a [`Logger`] struct. This struct is mainly intended to be used
|
|
||||||
//! with the python module of [`libpt`], but is still just as usable in other contexts.
|
|
||||||
//!
|
|
||||||
//! ## Technologies used for logging:
|
|
||||||
//! - [`log`](crate::log): base logging crate
|
|
||||||
//! - [`env_logger`](crate::env_logger): used for the executable
|
|
||||||
|
|
||||||
//// ATTRIBUTES ////////////////////////////////////////////////////////////////////////////////////
|
|
||||||
|
|
||||||
//// IMPORTS ///////////////////////////////////////////////////////////////////////////////////////
|
|
||||||
use std::{fmt, str::FromStr};
|
|
||||||
|
|
||||||
use log::{debug, error, info, trace, warn};
|
|
||||||
|
|
||||||
use env_logger;
|
|
||||||
|
|
||||||
use pyo3::prelude::*;
|
|
||||||
//// CONSTANTS ///////////////////////////////////////////////////////////////////////////////////////
|
|
||||||
/// The log level used when none is specified
|
|
||||||
const DEFAULT_LOG_LEVEL: log::Level = log::Level::Info;
|
|
||||||
|
|
||||||
//// STRUCTS ///////////////////////////////////////////////////////////////////////////////////////
|
|
||||||
/// ## Logger for [`libpt`](crate::libpt)
|
|
||||||
///
|
|
||||||
/// This struct exists mainly for the python module, so that we can use the same logger with both
|
|
||||||
/// python and rust.
|
|
||||||
#[pyclass]
|
|
||||||
pub struct Logger {
|
|
||||||
/// keeps track of if the logger was initialized
|
|
||||||
pub initialized: bool,
|
|
||||||
}
|
|
||||||
|
|
||||||
//// IMPLEMENTATION ////////////////////////////////////////////////////////////////////////////////
|
|
||||||
impl Logger {
|
|
||||||
/// ## create a `Logger`
|
|
||||||
pub fn new(level: log::Level) -> Self {
|
|
||||||
let mut l = Logger { initialized: false };
|
|
||||||
l.init(level);
|
|
||||||
l
|
|
||||||
}
|
|
||||||
pub fn init(&mut self, level: log::Level) {
|
|
||||||
// only init if no init has been performed yet
|
|
||||||
if self.initialized {
|
|
||||||
self.warn("trying to reinitialize the logger, ignoring");
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
#[allow(unused_imports)]
|
|
||||||
use log::log_enabled;
|
|
||||||
// TODO check if level is valid!
|
|
||||||
std::env::set_var("RUST_LOG", level.as_str());
|
|
||||||
env_logger::init();
|
|
||||||
self.initialized = true;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// ## logging at [`Level::Error`]
|
|
||||||
pub fn error<T>(&self, printable: T)
|
|
||||||
where
|
|
||||||
T: fmt::Display,
|
|
||||||
{
|
|
||||||
error!("{}", printable)
|
|
||||||
}
|
|
||||||
/// ## logging at [`Level::Warn`]
|
|
||||||
pub fn warn<T>(&self, printable: T)
|
|
||||||
where
|
|
||||||
T: fmt::Display,
|
|
||||||
{
|
|
||||||
warn!("{}", printable)
|
|
||||||
}
|
|
||||||
/// ## logging at [`Level::Info`]
|
|
||||||
pub fn info<T>(&self, printable: T)
|
|
||||||
where
|
|
||||||
T: fmt::Display,
|
|
||||||
{
|
|
||||||
info!("{}", printable)
|
|
||||||
}
|
|
||||||
/// ## logging at [`Level::Debug`]
|
|
||||||
pub fn debug<T>(&self, printable: T)
|
|
||||||
where
|
|
||||||
T: fmt::Display,
|
|
||||||
{
|
|
||||||
debug!("{}", printable)
|
|
||||||
}
|
|
||||||
/// ## logging at [`Level::Trace`]
|
|
||||||
pub fn trace<T>(&self, printable: T)
|
|
||||||
where
|
|
||||||
T: fmt::Display,
|
|
||||||
{
|
|
||||||
trace!("{}", printable)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
||||||
#[pymethods]
|
|
||||||
impl Logger {
|
|
||||||
/// ## Python version of [`new()`](Logger::new)
|
|
||||||
#[new]
|
|
||||||
pub fn py_new(level: String) -> PyResult<Self> {
|
|
||||||
Ok(Self::new(log::Level::from_str(level.as_str()).expect(
|
|
||||||
format!("could not get log level for '{}'", level).as_str(),
|
|
||||||
)))
|
|
||||||
}
|
|
||||||
/// ## Python version of [`init()`](Logger::init)
|
|
||||||
#[pyo3(name = "init")]
|
|
||||||
pub fn py_init(&mut self, level: String) {
|
|
||||||
Self::init(self, log::Level::from_str(level.as_str()).expect(
|
|
||||||
format!("could not get log level for '{}'", level).as_str(),
|
|
||||||
))
|
|
||||||
}
|
|
||||||
/// ## Python version of [`error()`](Logger::error)
|
|
||||||
#[pyo3(name = "error")]
|
|
||||||
pub fn py_error(&self, printable: String) {
|
|
||||||
self.error(printable)
|
|
||||||
}
|
|
||||||
/// ## Python version of [`warn()`](Logger::warn)
|
|
||||||
#[pyo3(name = "warn")]
|
|
||||||
pub fn py_warn(&self, printable: String) {
|
|
||||||
self.warn(printable)
|
|
||||||
}
|
|
||||||
/// ## Python version of [`info()`](Logger::info)
|
|
||||||
#[pyo3(name = "info")]
|
|
||||||
pub fn py_info(&self, printable: String) {
|
|
||||||
self.info(printable)
|
|
||||||
}
|
|
||||||
/// ## Python version of [`debug()`](Logger::debug)
|
|
||||||
#[pyo3(name = "debug")]
|
|
||||||
pub fn py_debug(&self, printable: String) {
|
|
||||||
self.debug(printable)
|
|
||||||
}
|
|
||||||
/// ## Python version of [`trace()`](Logger::trace)
|
|
||||||
#[pyo3(name = "trace")]
|
|
||||||
pub fn py_trace(&self, printable: String) {
|
|
||||||
self.trace(printable)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
////////////////////////////////////////////////////////////////////////////////////////////////////
|
|
||||||
impl fmt::Debug for Logger {
|
|
||||||
/// ## Debug representation for [`Logger`]
|
|
||||||
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
||||||
write!(f, "Logger")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//// PUBLIC FUNCTIONS //////////////////////////////////////////////////////////////////////////////
|
|
||||||
|
|
||||||
//// PRIVATE FUNCTIONS /////////////////////////////////////////////////////////////////////////////
|
|
11
tests/lib.rs
11
tests/lib.rs
|
@ -1,11 +0,0 @@
|
||||||
/// # tests for the general behaviour of the libraries availability
|
|
||||||
///
|
|
||||||
/// These tests will not go very in depth
|
|
||||||
|
|
||||||
// IMPORTS /////////////////////////////////////////////////////////////////////////////////////////
|
|
||||||
use libpt;
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn loaded_libpt() {
|
|
||||||
assert!(libpt::libpt_loaded())
|
|
||||||
}
|
|
Reference in a new issue