semvec/pypi-packages huggingface dataset:
django-book-manager 0.3.2
Reusable Django app for managing lists of books with ratings.
Keywords: django

# django-book-manager

**Documentation**: https://django-book-manager.readthedocs.org

This reusable Django application provides models suitable for managing a list of
books with ratings, somewhat like a private [Goodreads](https://goodreads.com).

Its real purpose is to provide sample models, with sample data, for use in
testing other Django libraries.  Often, when authoring new Django libraries, we
need a simple example application to use so that we can test out our code.

## Getting It

You can get `django-book-manager` by using pip:

```bash
pip install django-book-manager
```

If you want to install it from source, grab the git repository from GitHub and run `setup.py`:

```bash
git clone git://github.com/caltechads/django-book-manager.git
cd django-book-manager
python setup.py install
```

## Installing It

To enable `book_manager` in your project you need to add it to `INSTALLED_APPS`
in your project's `settings.py` file:

```python
INSTALLED_APPS = (
    ...
    'book_manager',
    ...
)
```

Then, apply the migrations to add the schema to your database:

```bash
./manage.py migrate
```

## Using It

`django-book-manager` provides these models:

* `book_manager.Book`:  a book with title, slug, publishing dates, number of pages, authors, etc.
* `book_manager.Author`:  an author.  `book_manager.Book` has a many to many relationship with this
* `book_manager.BookAuthor`:  this is a many to many through table between `book_manager.Book` and `book_manager.Author` that exists to record billing order of authors on a book (first author, second author, etc.)
* `book_manager.Publisher`:  a publisher.  `book_manager.Book` has a foreign key relationship with this
* `book_manager.Binding`: a binding (hardcover, softcover, ebook, ...).  `book_manager.Book` has a foreign key relationship with this

* `book_manager.Reading`: a reading record of a book by a reader.  This is a many to many through table between `book_manager.Book`  and the `AUTH_USER_MODEL` that records a rating, review, notes, date read, etc. for a particular user.
* `book_manager.Shelf`: a collection of `book_manager.Reading` objects, used by readers to classify books

`django-book-manager` also supplies a command that can be used to load a
[Goodreads](https://goodreads.com) user library export into Django, splitting
it into all the above models as appropriate.

To generate an export from Goodreads, go to your Goodreads account and:

* Click "My Books"
* At the bottom of that page, click "Import and Export"
* At the top of that page, click "Export Library"

To load the CSV thus generated into Django, first create a user for yourself in Django, then:

```bash
./manage.py import_csv <csvfile> <username>
```

A sample Goodreads export is available in this repository as `sandbox/data/books.csv`.
xlsxr 0.1
Read very large Excel XLSX files efficiently

xlsx-reader
===========

Python3 library optimised for reading very large Excel XLSX files, including those with hundreds of columns as well as rows. 

## Simple example

```
from xlsxr import Workbook

workbook = Workbook(filename="myworkbook.xlsx", convert_values=True)

for sheet in workbook.sheets:
    print("Sheet ", sheet.name)
    for row in sheet.rows:
        print(row)
```

## Conversions

By default, everything is a string, and all dates and datetimes will appear in ISO 8601 format (YYYY-mm-dd or YYYY-mm-ddTHH:MM:SS). If you supply the option _convert\_values_ to the Worksheet constructor, the library will convert numbers to ints or floats, and dates to datetime.datetime or datetime.date objects. There is no attempt to handle standalone times.

Empty cells appear as the empty string ''.

## xlsxr.workbook.Workbook class

### Constructor

The xlsxr.Workbook class constructor takes the following keyword arguments:

Argument | Description
-- | --
filename | Path to an Excel file on the local filesystem.
stream | A file-like object (byte stream)
url | The URL of a remote Excel file
convert\_values | If True, convert numbers and dates from strings to Python values (default is False)
fill\_merged | If True, repeat values to fill merged areas (default is False)

You may specify only one of _filename,_ _stream,_ or _url._

### Properties

Property | Description
-- | --
sheets | A list of xlsxr.sheet.Sheet objects
styles | A list of xlsxr.style.Style objects

## xlsxr.sheet.Sheet class

### Properties

Property | Description
workbook | The parent Workbook objet
name | The name of the sheet
sheet\_id | The internal identifier of the sheet
state | The state of the sheet (normally 'visible' or 'hidden')
relation\_id | ??
cols | A list of metadata for each column.
rows | A list of the data rows in the sheet (parsed on demand).
merges | A list of merges in the sheet (parsed on demand).

Each row is a list of scalar values. The will all be strings or None unless you specified the _convert\_values_ option for the Workbook.

Merges appear as strings defining ranges, e.g. "A1:C3".

### Columns

Columns are represented as dict objects with the following properties:

Key | Description
-- | --
collapsed | True if the column is collapsed.
hidden | True if the column is hidden
min | ??
max | ??
style | A key into the _styles_ property of the workbook.

## xlsxr.style.Style class

### Properties

Property | Description
-- | --
number\_formats | ??
cell\_style\_formats | ??
cell\_formats | ??
cell\_styles | ??

## License

This is free and unencumbered software released into the public domain. See UNLICENSE.md for details.
perfect-freehand 1.2.0
Draw perfect pressure-sensitive freehand lines. (Python port)

<!--
SPDX-FileCopyrightText: 2021 Stephen Ruiz Ltd
SPDX-FileCopyrightText: 2022 Calvin Walton

SPDX-License-Identifier: MIT
-->

# Perfect Freehand Python _(perfect-freehand-python)_

![banner](docs/_static/perfect-freehand-logo.svg)

Draw perfect pressure-sensitive freehand lines. (Python port)

This is a Python port of the 
[perfect-freehand library](https://github.com/steveruizok/perfect-freehand)
originally written by Steve Ruiz in TypeScript. Please reference the
documentation for that library for additional usage examples, links to
other implementations, and to support the original author.

When published to PyPi, the package name is "perfect-freehand" (since the "python" is redundant).
The library name when importing into python code is `perfect_freehand`.

* Documentation: https://docs.bigbluebutton.org/perfect-freehand-python/

## License

This library's code and documentation is released under the terms of the [MIT](LICENSES/MIT.txt) license.
Certain build system files are under the terms of the [CC0-1.0](LICENSES/CC0-1.0.txt) license.