semvec/pypi-packages huggingface dataset:
shouldersurfscore 1.0.3
A python library intended to help researchers build more practical measures for shoulder surfing attack efficacy.
Requires Python: >=3.10

# `shouldersurfscore`

This library helps researchers in lab settings develop better metrics to understand the practical password guess quality of shoulder surfing and password guessing attacks.

The library provides the following (their complexity for you to use in parentheses):

- (Advanced): a nuanced set of classes to build an experiment environment including different keyboard layouts, device lockout patterns, and different styles of attackers that can help to better estimate different
- (Medium): predefined equipment to make it easier to get up and running (e.g. an iPhone, with common login restrictions).
- (Easy): defined scores to make it easier to reproduce other researchers' experiments (and when you're ready, hopefully yours too!).
- (Easy): implementations of a few other common metrics for assessing password quality.

## Installation

To install, simply use:

```console
pip install shouldersurfscore
```

## How-To Use

### Defined Labs

Pre-defined labs can be used to recreate scores used in others' experiments.

For example:

```python
from shouldersurfscore.defined_experiments.built_labs import InitialShoulderSurfScorePaperLab

analysis = InitialShoulderSurfScorePaperLab.run(
    actual_password='9163',
    observed_password='9613'
)
print(analysis)
```

```console
Break In Analysis
------------------
actual_password: 9163
observed_password: 9613
password_index: 2
password_index_percent: 1.9801980198019803e-06
elapsed_time: 0s
device_unlocked: True
```

### Other Metrics

### Predefined Objects

```python
from shouldersurfscore.analysis.breakin_analysis import BreakInAnalysis
from shouldersurfscore.classes import guessing_strategies
from shouldersurfscore.classes.lab import Lab
from shouldersurfscore.equipment.devices import Devices

device = Devices.get_iphone()
# Define strategies
pin_lengths = [4, 6]
# If the observed password doesn't work
# then all possible passwords will be tried in sequential order
# until successful or device goes into lock out.
strategies: list[guessing_strategies.GuessingStrategy] = [
    # Initialize brute force method with which characters are valid
    # and which pin lengths are valid
    guessing_strategies.BruteForceGuessing(device.keyboard.characters, pin_lengths)
]
password = "2290"
observed_password = "9163"
analysis = Lab.run(device, strategies, password, observed_password)
print(analysis)
```

```console
Break In Analysis
------------------
actual_password: 2290
observed_password: 9163
password_index: 1190
password_index_percent: 0.0011782178217821782
elapsed_time: 1h 21m
device_unlocked: False
```

### Classes
mdconv 0.1.3
[MDCONV](http://github.com/Juminiy/mdconv) is markdown to [json, ppt, docx, txt] converter
Requires Python: >=3.11

# SET ENV

```bash
uv venv
source .venv/bin/activate
uv sync
```

## Character
1. parse json to Markdown(HTML or Markdown, `.md`) file

## Improvement
1. lines split by '\n' and '\n\n' is different.
2. Sheet cell_value support: trans_word()
3. combination_object: LinkedImage
python-datetil 1.1.2
Demo package to simulate typosquatting (for education only)
Requires Python: >=3.6

# reqeusts-demo

⚠️ This is a safe educational demo simulating a typosquatting package.

## Purpose

To raise awareness about typo-based supply chain attacks (e.g., mistyping `requests` as `reqeusts`).

## What it does

- Prints a warning to the terminal
- Shows local system info (OS, username, hostname)
- Does **not** send data anywhere
types-lunardate 0.2.0.20250828
Typing stubs for lunardate
Requires Python: >=3.9

## Typing stubs for lunardate

This is a [type stub package](https://typing.python.org/en/latest/tutorials/external_libraries.html)
for the [`lunardate`](https://github.com/lidaobing/python-lunardate) package. It can be used by type checkers
to check code that uses `lunardate`. This version of
`types-lunardate` aims to provide accurate annotations for
`lunardate==0.2.*`.

This package is part of the [typeshed project](https://github.com/python/typeshed).
All fixes for types and metadata should be contributed there.
See [the README](https://github.com/python/typeshed/blob/main/README.md)
for more details. The source for this package can be found in the
[`stubs/lunardate`](https://github.com/python/typeshed/tree/main/stubs/lunardate)
directory.

This package was tested with the following type checkers:
* [mypy](https://github.com/python/mypy/) 1.17.1
* [pyright](https://github.com/microsoft/pyright) 1.1.404

It was generated from typeshed commit
[`ff32af2c654e7ee4f2f380a8774d77579b5c0743`](https://github.com/python/typeshed/commit/ff32af2c654e7ee4f2f380a8774d77579b5c0743).
types-PyMeeus 0.5.0.20250828
Typing stubs for PyMeeus
Requires Python: >=3.9

## Typing stubs for PyMeeus

This is a [type stub package](https://typing.python.org/en/latest/tutorials/external_libraries.html)
for the [`PyMeeus`](https://github.com/architest/pymeeus) package. It can be used by type checkers
to check code that uses `PyMeeus`. This version of
`types-PyMeeus` aims to provide accurate annotations for
`PyMeeus==0.5.*`.

This package is part of the [typeshed project](https://github.com/python/typeshed).
All fixes for types and metadata should be contributed there.
See [the README](https://github.com/python/typeshed/blob/main/README.md)
for more details. The source for this package can be found in the
[`stubs/PyMeeus`](https://github.com/python/typeshed/tree/main/stubs/PyMeeus)
directory.

This package was tested with the following type checkers:
* [mypy](https://github.com/python/mypy/) 1.17.1
* [pyright](https://github.com/microsoft/pyright) 1.1.404

It was generated from typeshed commit
[`ff32af2c654e7ee4f2f380a8774d77579b5c0743`](https://github.com/python/typeshed/commit/ff32af2c654e7ee4f2f380a8774d77579b5c0743).