No project description provided
Project description
ManageCor
A command-line tool for managing and using a customized Docker development environment based on Texlive. It includes Python, Pandoc, along with LaTeX packages and Pandoc templates, including eisvogel.latex.
Features
- 🐳 Docker-based isolated environment
- 📦 Pre-configured TeXLive installation
- 🐍 Python with essential development tools
- 📄 Pandoc with custom templates
- 🎨 ImageMagick support
- 🔄 Automatic updates and configuration
- ⚡ Convenient command aliases
Prerequisites
- Docker installed on your system
- Python 3.8 or higher
- pip package manager
Installation
Install managecor
using pip:
pip install managecor
Quick Start
- Initialize the environment:
managecor init
This will:
- Update configuration from GitHub
- Pull required Docker images
- Set up command aliases
- Use the provided aliases:
pythoncor script.py # Run Python
pandoccor input.md -o output.pdf # Convert documents
Commands
Command | Description |
---|---|
managecor init |
Initialize the environment |
managecor update |
Force update Docker images to latest version |
managecor update-config |
Update configuration from GitHub |
managecor run -- <command> |
Run a command in the Docker container |
Available Aliases
After initialization, the following aliases will be available in your shell:
Alias | Description |
---|---|
pythoncor |
Python environment |
xelatexcor |
XeLaTeX compiler |
pandoccor |
Pandoc document converter |
latexcor |
Custom LaTeX environment |
latextomd |
Convert LaTeX to Markdown |
pdfcor |
PDF manipulation tools |
jupytercor |
Custom Jupyter environment |
black |
Python code formatter |
magick |
ImageMagick |
Usage Examples
Run Python script:
pythoncor script.py
Convert Markdown to PDF:
pandoccor input.md -o output.pdf
Format Python code:
black script.py
Configuration
The configuration file is stored at ~/.managecor_config.yaml
. It's automatically updated during initialization or via the update-config
command.
Docker Images
ManageCor uses two Docker images:
- Base image (
infocornouaille/tools:base
): Contains core tools and dependencies - Custom image (
infocornouaille/tools:perso
): Includes additional templates and configurations
To force update the Docker images to their latest versions:
managecor update
Development
To contribute to ManageCor:
- Fork the repository
- Create a feature branch
- Submit a Pull Request
Troubleshooting
Common issues and solutions:
- If aliases aren't working, try restarting your terminal or running:
source ~/.bashrc # for bash source ~/.zshrc # for zsh
- For Docker-related issues, ensure Docker daemon is running
- For permission issues on Linux, ensure your user is in the docker group
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgements
- TeXLive team for the base Docker image
- Pandoc team for document conversion tools
- All contributors to the project
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for managecor-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f7a52c4c6710a2ff17174769a51a56aa19cfbbacd864d1bf93e0df89b2e6458c |
|
MD5 | 6a4968769e0630eee0b494b53388fd1c |
|
BLAKE2b-256 | d42bfbd33cf810130a9e636a551a0ba48570cdb094f3afebc5e99f144b6f1283 |