6 releases
new 0.2.2 | Nov 4, 2024 |
---|---|
0.2.1 | Nov 3, 2024 |
0.1.2 | Nov 3, 2024 |
#581 in Database interfaces
251 downloads per month
Used in learnerd
85KB
1K
SLoC
Features
-
📚 Academic Paper Management
- Extract metadata from multiple sources (arXiv, IACR, DOI)
- Support for both URLs and direct identifiers
- Automatic source detection
- Full paper metadata including authors, abstracts, and publication dates
-
🔍 Local Database Management
- SQLite-based storage for offline access
- Full-text search capabilities
- Case-insensitive title search
- Duplicate detection and handling
- Platform-specific default locations
-
🚀 Command Line Interface (
learnerd
)- Interactive database management
- Paper addition and retrieval
- Search functionality
- Beautiful, colored output
- Detailed logging options
Installation
Library
Add this to your Cargo.toml
:
[dependencies]
learner = "0.1"
CLI Tool
cargo install learnerd
Usage
Library Usage
use learner::{Paper, Database};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
// Initialize database
let db = Database::open("papers.db").await?;
// Add papers from various sources
let paper = Paper::new("https://arxiv.org/abs/2301.07041").await?;
paper.save(&db).await?;
let paper = Paper::new("10.1145/1327452.1327492").await?; // From DOI
paper.save(&db).await?;
let paper = Paper::new("2023/123").await?; // From IACR
paper.save(&db).await?;
Ok(())
}
CLI Usage
# Initialize a new database
learnerd init
# Add a paper (auto-detects source)
learnerd add 2301.07041
learnerd add "https://arxiv.org/abs/2301.07041"
learnerd add "10.1145/1327452.1327492"
# Retrieve a paper
learnerd get arxiv 2301.07041
# Search papers
learnerd search "neural networks"
# Verbose output for debugging
learnerd -v add 2301.07041
# Clean up database (with confirmation)
learnerd clean
Project Structure
The project consists of two main components:
-
learner
- Core library providing:- Paper metadata extraction
- Database management
- Source-specific clients (arXiv, IACR, DOI)
- Error handling
-
learnerd
- CLI application offering:- User-friendly interface
- Interactive confirmations
- Colored output
- Logging and debugging capabilities
Roadmap
Phase 1: Core Improvements ⏳
- Paper removal functionality
- Batch paper operations
- Export capabilities
- Enhanced search features
- Custom metadata fields
Phase 2: Advanced Features 🔮
- PDF content extraction
- LLM-powered paper analysis
- Citation graph analysis
- Automated paper discovery
- Web interface
Contributing
Contributions are welcome! Please feel free to submit a Pull Request. Before making major changes, please open an issue first to discuss what you would like to change.
Development Setup
- Clone the repository
- Install dependencies:
cargo build
- Run tests:
cargo test
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- arXiv API for paper metadata
- IACR for cryptography papers
- CrossRef for DOI resolution
- SQLite for local database support
Made for making learning sh*t less annoying.
Dependencies
~33–46MB
~757K SLoC