rookie 0.3.4

Load cookie from your web browsers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

# rookie


[![PyPi Downloads][PyPi-downloads]][PyPi-url]
[![PyPi Version][PyPi-version]][PyPi-url]
[![Crates][Crates-badge]][Crates-url]
[![License][License-shield]][License-url]

Load cookies from any browser on any platform

## Install


```shell
cargo add rookie
```

## Bindings


There's Python bindings to `rookie`

```shell
pip install rookiepy
```

And the usage it similar to original

```python
import rookiepy
cookies = rookiepy.firefox(["google.com"])
for cookie in cookies:
    print(cookie['domain'], cookie['value'])
```

## Examples


`Python` [examples](https://github.com/thewh1teagle/rookie/tree/main/examples)

`Rust` [rookie-rs/examples](https://github.com/thewh1teagle/rookie/tree/main/rookie-rs/examples)

## Docs


`Python`

- [docs/Python.md](docs/Python.md)

`Rust`

- [docs/Rust.md](docs/Rust.md)
- [docs.rs/rookie](https://docs.rs/rookie)  

## Features


- Fast, written in `Rust`
- Bypass `Chrome` restriction like file locking
- Wide platforms and browsers support

## CLI


You can use rookie as a `CLI` tool which will decrypt the cookies and print it as `JSON`  
See [cli](https://github.com/thewh1teagle/rookie/tree/main/cli) folder

## Contribute


So far the following platforms are supported:

- **Chrome:** `Linux`, `MacOS`, `Windows`
- **Firefox:** `Linux`, `MacOS`, `Windows`
- **LibreWolf:** `Linux`, `MacOS`, `Windows`
- **Opera:** `Linux`, `MacOS`, `Windows`
- **Opera GX:** `MacOS`, `Windows`
- **Edge:** Linux, `MacOS`, `Windows`
- **Internet Explorer:** `Windows`
- **Chromium:** `Linux`, `MacOS`, `Windows`
- **Brave:** `Linux`, `MacOS`, `Windows`
- **Vivaldi:** `Linux`, `MacOS`, `Windows`
- **Safari:** `MacOS`

You are welcome to contribute support for other browsers, or other platforms.

## Support new browsers


If you have a browser with which the library isn't working with, it may not have been added to the list of supported browsers configs. You can create a pull request (PR) or an issue with the path to the cookies file on your computer, and I will add it.

look at [config.rs](https://github.com/thewh1teagle/rookie/blob/main/rookie-rs/src/config.rs) to see what configurations is needed.

## Testing Dates  (dd/mm/yy)


Browser  |  Linux    |  MacOS   | Windows  |
:------  | :------:  | :------: | :------: |
Chrome   | 01/10/23  | 25/11/23 |  1/10/23 |
Firefox  | 01/10/23  | 25/11/23 |  1/10/23 |
LibreWolf| 01/10/23  | 25/11/23 |  1/10/23 |
Opera    | 01/10/23  |    -     |  1/10/23 |
Opera GX |   N/A     |    -     |  1/10/23 |
Edge     | 01/10/23  |    -     |  1/10/23 |
IE       |   N/A     |   N/A    |  1/10/23 |
Chromium | 01/10/23  | 25/11/23 |  1/10/23 |
Brave    | 01/10/23  | 25/11/23 |  1/10/23 |
Vivaldi  | 01/10/23  | 25/11/23 |  1/10/23 |
Safari   |   N/A     | 02/10/23 |    N/A   |

[PyPi-downloads]: https://img.shields.io/pypi/dm/rookiepy
[PyPi-version]: https://img.shields.io/pypi/v/rookiepy?color=00aa00
[PyPi-url]: https://pypi.org/project/rookiepy/
[Crates-badge]: https://img.shields.io/crates/v/rookie
[Crates-url]: https://crates.io/crates/rookie/
[License-shield]: https://img.shields.io/github/license/thewh1teagle/rookie?color=00aaaa
[License-url]: https://github.com/thewh1teagle/rookie/blob/main/rookie-rs/MIT-LICENSE.txt