Tgbox

This is a **TGBOX** version **1.6**. The `v1.6` includes important changes & bugfixes!

**!! WARNING !!**

If you use/d `tgbox` on Windows or if your *Box* have files with Windows-like paths, —
you **MUST update file fingerprints** in your *LocalBox*. Please apply [**this quick patch script**](https://gist.github.com/NotStatilko/52ffceb81f8a72c10bc0286474767789).

More details in [**this commit message**](https://github.com/NonProjects/tgbox/commit/e944b12665a11d1fbe74c70938b37abcca54f716).

**What's new in this release:**

- Fix `OpenPretender.read(-1)` (https://github.com/NonProjects/tgbox/commit/3adfeb3f0fd9cfe8242c1093a1fc487e74c243aa)
- Auto use `make_general_path` in `ppart_id_generator` + (https://github.com/NonProjects/tgbox/commit/8ef6aee2899a8580c338da8b5cb0b7eefafe7f07)
- Update fingerprints (**Windows IMPORTANT**) (https://github.com/NonProjects/tgbox/commit/e944b12665a11d1fbe74c70938b37abcca54f716)
- Fix `AESwState` with `cryptography >= 43`, + (https://github.com/NonProjects/tgbox/commit/cfa048730150de289164982c55afa853f351c2f0)
- Code cleanup plus some fixes (https://github.com/NonProjects/tgbox/commit/9b13842f4a819d7fc7a6538b501ac28d5ad0371d)
- New `sender_id`, `imported_from_id` on RBF (https://github.com/NonProjects/tgbox/commit/16a45a4ec58fa941c296f4283dcaaacddeed2f54)
- `author_messages()`, `sign_messages()`, etc (see ...) (https://github.com/NonProjects/tgbox/commit/11ad93082594bd521c68ede2213a394bd9c0a006)
- Update Fingerprints on Updating Metadata (see ...) (https://github.com/NonProjects/tgbox/commit/2ad6e966b7c2bbfcaa19d90b1da49a3a6bc254e1, https://github.com/NonProjects/tgbox/commit/465a179c3c92bf8840773f61f0f1d2f7566af1eb)
- Prevent duplicate file via changing file name (https://github.com/NonProjects/tgbox/commit/4a521564b87004fcf4bee636d60232fa1d4c4806, https://github.com/NonProjects/tgbox/commit/bde3ad8e04749c3a79f0cfa24d59c7c6adaa900f, https://github.com/NonProjects/tgbox/commit/30108d8500b6dce5958600c825c12591605137c3)
- Bump `cryptography`, `cryptg` (https://github.com/NonProjects/tgbox/commit/6e48b99676048e04d4d7318781845b271b54e4cb)
- Fix bug in Box sync with imported files (https://github.com/NonProjects/tgbox/commit/ea93d8283bbd2cfe85de49308a0b5a6bd41967d8)
- New `sender` filter (https://github.com/NonProjects/tgbox/commit/8b0113f138a4d4d5ee6f2124c17345fae42e80f1)

**This release was supposed to come out earlier but I wasn't near my computer for _quite_ some time. Sorry for that.**
As apology, I can recommend you to try *Stargazer* by *Rainbow*. You won't be disappointed.

**Full Changelog**: https://github.com/NonProjects/tgbox/compare/v1.5.1...v1.6

This is a **TGBOX** version **1.5.1**. The `v1.5.1` is a quick patch.

- **Lock** `cryptography` library version to `< 43.0.0`

**Full Changelog**: https://github.com/NonProjects/tgbox/compare/v1.5...v1.5.1

This is a **TGBOX** version **1.5**. The `v1.5` presents a many important changes, bugfixes, new features and new modules!

- **Protection against the Bit-flipping attack** (HMAC) (https://github.com/NonProjects/tgbox/commit/c3698058f9b68dfdac12a0a0668e4e64dd2e807c, https://github.com/NonProjects/tgbox/commit/4eb8a7d08a626ee6ceba3859a00a09195ad31eaf, https://github.com/NonProjects/tgbox/commit/23696974f8ff8f0c5cb0623a094fd8f15cf5ee4b, https://github.com/NonProjects/tgbox/commit/a340cb92c7ed49dbc768ff97001dac7dcfdb1b1e, https://github.com/NonProjects/tgbox/commit/70bdac83836cdd4712a49eac2488861a40ea3891, https://github.com/NonProjects/tgbox/commit/57cb4317abe16e111fc18e0788c30bcdfd6cd424, https://github.com/NonProjects/tgbox/commit/3904f2ea5a99743b9f8942291e63aa233e083e9b)
- The **new** `abstract` module! `Box`, `get_box`, etc! (https://github.com/NonProjects/tgbox/commit/597d8a922ecb87b71e0c0f2a0ff41f5bcc78c1f0, https://github.com/NonProjects/tgbox/commit/16126f7a54d9a14596c528b466068188d8da6509, https://github.com/NonProjects/tgbox/commit/3955af5dcaa7c957bd4bcd15c9c7c8871c0a17ae, https://github.com/NonProjects/tgbox/commit/aa02df2e92fca33c65d2a0d7648c991343090c6f, https://github.com/NonProjects/tgbox/commit/a1d6ca0f1229c7bf6784f5e741acb6ed81a735df, https://github.com/NonProjects/tgbox/commit/a4413ed052c614b60a73c271a29e617026498b50, https://github.com/NonProjects/tgbox/commit/4fab4ca12fa5c15a79d1c4b4d53ad4681be59efd, https://github.com/NonProjects/tgbox/commit/434b2d3b6f942fa4c57f22889472acc159652b80, https://github.com/NonProjects/tgbox/commit/ce3ad2e8c1e3e72bd834e8cf5dc70ea6c7c8c3f4, https://github.com/NonProjects/tgbox/commit/f2510bf66fc39193c659fc2767af5eb4094dab7d!!)
- The new `tgbox.api.sync` module! (https://github.com/NonProjects/tgbox/commit/a4fe63a4ea239d68748b1cb23117945cfbb8c69c, https://github.com/NonProjects/tgbox/commit/ad478d2d9e5274600d3ab5ba088accbdbc3162f8, https://github.com/NonProjects/tgbox/commit/98db43967b45661781ca1df31ba00733d30baac6, https://github.com/NonProjects/tgbox/commit/fe902c6bcb65acb36b081100a6f7ccd181d51aac, https://github.com/NonProjects/tgbox/commit/3f4bc95872875a561ee7a07612cb5227d02da893)
- **Bugfixes** (https://github.com/NonProjects/tgbox/commit/178a47974ca329b756cbc442f46c850cd6e68d24, https://github.com/NonProjects/tgbox/commit/a6b4dec6f9221dedfbee83de11caec6a6a4d736a, https://github.com/NonProjects/tgbox/commit/9b8cf5939459cb9adeb13826a7613dda3e7ad4db, https://github.com/NonProjects/tgbox/commit/c3cf1aa6c38485d082a6a9d5e6e987aa39daf490, https://github.com/NonProjects/tgbox/commit/7238400d38440bab686c43c70f3c07905f7b0e08, https://github.com/NonProjects/tgbox/commit/13937c233fe2e58c32414f7b8b4b976e4f56c2b0, https://github.com/NonProjects/tgbox/commit/64c3761c4ac88edff882a12cda2d2ac626f2f000, https://github.com/NonProjects/tgbox/commit/30e9b16b611a3d0065e8e65f705bef425d6a9e89, https://github.com/NonProjects/tgbox/commit/d2b68273c104254a8c4634751a6a8474bfd8bfae, https://github.com/NonProjects/tgbox/commit/4d2694e7bbef7d9ea5f4c34da76fbb35c273ed12!!, https://github.com/NonProjects/tgbox/commit/ddfd65911882b978a3e98723a1c6f923ff938b25, https://github.com/NonProjects/tgbox/commit/e3fbe2dc03dc899fed2aa778612f6025d9474ec0, https://github.com/NonProjects/tgbox/commit/feda5235290ac11a0db1d1d2baae7967b5693805, https://github.com/NonProjects/tgbox/commit/fadb02e7a52120402f42fbfc1f0870052cb98535, https://github.com/NonProjects/tgbox/commit/12e5e4445d8ca89199d3d50ddedee90aef8d4adc!! + https://github.com/NonProjects/tgbox/commit/acc4f2dddae5d2a84ff360a3abee7502527c5550!!, https://github.com/NonProjects/tgbox/commit/2cb71e935e126af660bc8fdd700ac8f8859bc5b5)
- **New** `fetch_count` kwarg on `dlb.files` & `dlb.search_file` (https://github.com/NonProjects/tgbox/commit/3d2d0889c8b1826c514e69eadd589935317fce52)
- Use **scrypt** from `cryptography` if it's not available in `hashlib` (https://github.com/NonProjects/tgbox/commit/9e176890ca73480654e5fc094aa2a14bc4318ecb)
- **Rm** `phone_number` OR `session` check in `TelegramClient` (https://github.com/NonProjects/tgbox/commit/49329451c622f54e64f72da5fb995de6fa28109d)
- **Restrict** changing `file_size` in `update_metadata` (https://github.com/NonProjects/tgbox/commit/43f0574359594ba493975935cc7a376e6ab35853)
- Update **Examples** in Docs to `v1.5` (https://github.com/NonProjects/tgbox/commit/0f2575cc3b0295aca760907cfb79cefe30c30fd4, https://github.com/NonProjects/tgbox/commit/b488971f2814edf1d10356f94446fde8b7a18250)
- **Update** `API_ID` & `API_HASH` in `replace_session()` (https://github.com/NonProjects/tgbox/commit/3872c0ae9e09c7dba31909300f3bd1bdf581e201)
- **New** `minor_version` filter (https://github.com/NonProjects/tgbox/commit/7d2ad21519c3396e65240256981468d0c2e14f85)
- Removing empty Dirs after upload is now Optional (https://github.com/NonProjects/tgbox/commit/8be0af823ce25352be5c2515e2b637e723e7d9d1)
- **New** `updated_at_time` on RemoteBox File (https://github.com/NonProjects/tgbox/commit/3c3d7d820b926cf4fbdeff77855a512e4a8507bc, https://github.com/NonProjects/tgbox/commit/800cc599d981348af47fefa73fcb70f9b93331c5)
- **Enhancing CAttrs support** (https://github.com/NonProjects/tgbox/commit/3a14edf4bc36f56649fabba481ac7d4111d735b1, https://github.com/NonProjects/tgbox/commit/1dd4bf8c46adf8b0ce0dc279b9646c8bcf5fdb60, https://github.com/NonProjects/tgbox/commit/00479cfc14d0270eb44b5e410e28fcbf08982ccb, https://github.com/NonProjects/tgbox/commit/14c2c3df5755d676ef2aae8bda4dabe58a1342a3, https://github.com/NonProjects/tgbox/commit/349bc306be7e7532848300201f131166e7ebc9bd)
- Support **Description** in **RemoteBox** (https://github.com/NonProjects/tgbox/commit/e5f6a90e390d40aa78f9cc0d0cb8be6e6129709a)
- **Enhance** Metadata Updates support on Fast/Deep **Sync** (https://github.com/NonProjects/tgbox/commit/7e8a56fb7d95d476767c41b57fce19ff4215fe80)
- Use `regex` module if it's installed (https://github.com/NonProjects/tgbox/commit/2c7e1ced28a39291aef8699e6d97ef6d3d161c8d)
- **Improve** `make_general_path()` + (https://github.com/NonProjects/tgbox/commit/0eb0b6982481bc001c7d16f05101f26494dcd66d)
- Pass `dlb=self` to `drb.files` in `_deep_sync()` (https://github.com/NonProjects/tgbox/commit/d9e9d36e3b25b23a5a7393f05b2438a8786b9cc7)
- Add `__eq__` to `Salt` & `IV` to fix bug in Deep Sync (https://github.com/NonProjects/tgbox/commit/5ba2b22e12273967f86a071df2e7e328d6214ce5)

**NOTE**: **The Version 1.4 will not be able to decrypt & read files uploaded from Version 1.5**!
If you share Box with someone else, then both of you **should** have the same *Protocol* ver.
~
The **Version 1.5 is backward compatible with the files uploaded from v1.4**.

**See Full Changelog**: https://github.com/NonProjects/tgbox/compare/v1.4...v1.5

**P.S**.

The [**TGBOX-CLI**](https://github.com/NotStatilko/tgbox-cli) will be **updated** to support changes of _v1.5_ soonely!
Give it some love too (it even has basic **Chat** now :)

This is a **TGBOX** version **1.4**. The `v1.4` include some improvements and new features

- **Support** file downloading from specified `offset` (c081297aef6c2803e192bff68326c9fb6aa23596, b3396e7c5b013a0c49b49ba4289be41f29825a5c)
- **Add** `__repr__` to all classes (9e645486b3ad4a7f7da8f7e35b3b01ba73d116c9)
- **Add** `use_slow_upload` & `use_slow_download switches` (d264297e3295688fca11d83dd9f72363300097df)
- Minor docs **update** plus `sphinx-book-theme` (0d8b5476ae4da9d399b9538a84809f3cd836082a)


**Full Changelog**: https://github.com/NonProjects/tgbox/compare/v1.3.1...v1.4

**Changelog**: https://github.com/NonProjects/tgbox/compare/v1.3.1...v1.4.0b1

This is a **TGBOX** version **1.3.1**. The `v1.3.1` include some patches to `v1.3`

- Fix `ppart_id_generator` with Windows-like Path on Linux (f6f3b5c)
- Fix incorrect `DirectoryKey` gen on file from another OS (9fa286a)
- Fix bug on changing Metadata of Remote File (d086363)

**Full Changelog**: https://github.com/NonProjects/tgbox/compare/v1.3...v1.3.1